dsh-router-loomy
DSH 插件：Loomy（讯飞 Loomy 办公助手云端通道，OpenAI 兼容）供应商 —— 通过 router.suppliers 将 loomy 通道接入 dsh-router。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-router-loomy@0.1.2Router Loomy 以 dsh-router-loomy 发布，当前版本为 0.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把 Loomy（讯飞 Loomy 办公助手云端通道） 作为供应商接入 dsh-router，
供 dsh 使用的插件。参照 dsh-router-traework 的同构范式编写。
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 进插件图）
插件通过 profile 的 package.json 的 dsh.profile.bundles 挂载，与 dsh-router-traework 同构。
以 web profile（C:\Users\Administrator\.dsh\profiles\web）为例：
npm install dsh-router-loomy
npm install "<本工程绝对路径>"
cmd /c mklink /J "node_modules\dsh-router-loomy" "<本工程绝对路径>"
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 就绪后再追加）。[dsh-router-loomy] registered router.suppliers: 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 会自动触发构建，直接发布即可。注意两点：
npm publish 会返回 E403。npm publish --registry https://registry.npmjs.org/
MIT