讯飞 Loomy 接入 2404723600/dsh-router-loomy

dsh-router-loomy

把 Loomy（讯飞 Loomy 办公助手云端通道） 作为服务商接入 dsh-router，供 dsh 使用的插件。参照 dsh-router-traework 的同构范式编写。

- 上游通道对 OpenAI Chat Completions 完全兼容（单一端点 POST {baseUrl}/chat/completions，SSE 流式）；
- 鉴权用 Authorization: Bearer <session>，session 取自 Loomy 客户端 userData/auth-session.json 的 session 字段；
- 插件只暴露差异化逻辑（status / listModels / chatOnce / dispose / addApiKey / removeLink），选号、冷却、换号、别名、模型启用状态、积分缓存等通用能力全部由 dsh-router 核心统一管理。

安装

npm install dsh-router-loomy

@deepseek-ai/cordis 与 cordis 是 peerDependencies，由 dsh 宿主注入，无需手动安装。
装好后按 装配到 dsh profile 把本包注册进 bundle。

快速开始（本地开发）

在克隆后的仓库里：

1) 安装依赖（peerDependencies 由 dsh 宿主注入，本工程不落地）
npm install

2) 干净构建：先删 lib/ 再 tsdown 打包
npm run build

3) 类型检查 + 单元测试
npm run typecheck
npm test

4) 端到端冒烟（真实调用上游：listModels + 最小 chatOnce，含一次非流式与一次流式）
npm run smoke

目录结构

src/
index.ts 插件 host half：把 factory 追加进 cordis router.suppliers 聚合表 supplier.ts 独立入口（default 导出 factory，供目录投放用） provider.ts LoomySupplier：会话/账号、模型目录、chatOnce 编排 accounts.ts 账号（link）管理与 session 解析 models.ts 模型目录拉取与内置回退清单 contract.ts 结构镜像契约（不 import 宿主类型，离线可构建） types.ts 内部类型 api/ plugin.ts 供应商模块元信息（id/name/priority/icon/apiKeyHint）+ factory http.ts 请求构造与状态码 → AccountState 映射 headers.ts 四个必带追踪头（traceparent / chatid / msgid / loomy-version）+ 会话亲和 sse.ts SSE 帧切分 / 错误嗅探 / 迟到失败上报 / 非流式聚合 errors.ts 错误归一化 constants.ts 常量（上游版本号、端点、默认模型等） lib/ 构建产物（index.js / supplier.js / plugin-*.js chunk） scripts/smoke.mjs 端到端冒烟脚本 docs/loomy-upstream.md 上游契约实测记录（鉴权头、SSE 帧形态、最小请求规格） cordis.patch.yml 声明本包是 DSH bundle（insert dsh-router-loomy 进插件图）

装配到 dsh profile

插件通过 profile 的 package.json 的 dsh.profile.bundles 挂载，与 dsh-router-traework 同构。
以 web profile（C:\Users\Administrator\.dsh\profiles\web）为例：

1. 在 profile 目录安装本插件，二选一：
- 从 npm 安装（推荐）
npm install dsh-router-loomy

- 本地目录（开发调试）
npm install "<本工程绝对路径>"

或直接投放软链： cmd /c mklink /J "node_modules\dsh-router-loomy" "<本工程绝对路径>"

2. 在 profile 的 package.json 里注册包与 bundle： {
"dependencies": { "dsh-router-loomy": "^0.1.0" },
"dsh": {
"profile": {
"bundles": [
"dsh-router-loomy"
]
}
}
}

本地开发时依赖可写成 "file:<本工程绝对路径>"。
dsh-router-traework 和 dsh-router-core 必须出现在 bundles 里；本插件与它们的先后顺序无关（核心用 ctx.inject 延迟注入，等 router.suppliers 就绪后再追加）。
3. 重启 dsh（或重新加载 profile）。启动日志出现 [dsh-router-loomy] registered router.suppliers: loomy 即装配成功。
4. 在 dsh-router 面板的 Loomy 供应商卡片里粘贴登录态会话串（auth-session.json 的 session 字段）。

上游契约

详见 docs/loomy-upstream.md。要点：

| 项 | 取值 |
| 端点 | POST https://loomyad.xunfei.cn/api/v1/chat/completions |
| 鉴权 | Authorization: Bearer <session> |
| 必带头 | traceparent（缺失会挂死）、chatid、msgid、loomy-version、invokeorigin |
| 可选头 | x-session-affinity（会话亲和）；子调用可带 x-parent-session-id |
| 响应 | 200 + text/event-stream，data: chat.completion.chunk 帧 + data: [DONE] |
| 末帧 usage | {prompt_tokens, completion_tokens, total_tokens, ..., points_consumed}（points_consumed 为平台积分字段） |
| 注意 | 响应帧内 model 可能与请求不一致（网关改写），解析以帧内为准 |

发布（维护者）

prepack 会自动触发构建，直接发布即可。注意两点：

- 本机默认 registry 若被设为镜像站（如 npmmirror），需显式指定官方源；
- 账号开启 2FA 时，需使用带 2FA 豁免（bypass 2FA）且具备 Read and write 权限的 Granular Access Token，否则 npm publish 会返回 E403。

npm publish --registry https://registry.npmjs.org/

许可

MIT