dsh-clinepass-pin

给 DeepSeek Harness 的 cline-pass 路由硬钉一个上游 Provider（默认第一方 deepseek）。

做法是在发往网关的 JSON body 里加一个字段：

"providerOptions": { "gateway": { "only": ["deepseek"] } }

配套 dsh-clinepass 使用：那个插件只观察网关真实用了谁，本插件负责让它一直是 DeepSeek。

它解决什么

api.cline.bot 是个多上游网关。对日期快照 cline-pass/deepseek-v4.1-flash-1017，它默认在十几个渠道里挑一个（deepseek、pareto、fireworks、alibaba、baseten …），同一个进程里几分钟就能从 pareto 飘到 deepseek；稳定别名 cline-pass/deepseek-v4.1-flash 甚至可能落到匿名回退网 openai-compatible-private（contributor 档：数据可能用于训练、无 ZDR）。

实测（2026-10-19，同一把 key）：

请求	finalProvider	fallbacksAvailable
不钉	deepseek，但抓到过 pareto	14
only: ["deepseek"]	deepseek	0
only: ["__no_such_upstream__"]	—	500 No available providers match the 'only' filter

负控制那一行说明：1017 这条快照上网关真的执行 only。稳定别名则无视它（only 无效），所以 models 里别写别名。

为什么不走官方那条路

官方做法是 profile 里写 compat.vercelGatewayRouting.only，再把 pi-ai 的 COMPLETIONS_COMPAT_GATE.vercelGatewayRouting 从 "withhold" 改成 "offer"。在 Desktop 版上这条路是死的：

• 门禁代码在 resources/app.asar/dsh/node_modules/@deepseek-ai/dsh-llm-pi-ai/lib/index.js 里，而 asar header 对每个文件都带 SHA256 integrity，就地改字节过不了完整性校验，且每次应用更新都会被覆盖；
• 随包脚本 patch-gateway-routing.mjs 找的是 <DSH_HOME>/profiles/<profile>/node_modules/@deepseek-ai/dsh-llm-pi-ai/...，Desktop 安装里这个路径不存在（profiles/node_modules 下的那份只是指向全局 npm 安装的 junction，不是运行中 app 加载的那份）。

所以本插件改在比配置门禁更低一层的 globalThis.fetch 上 —— 正好是 dsh-clinepass 观察用的同一个缝。

安装

环境：dsh ≥ 0.2.0-rc.2、node ≥ 20。装完要重启 dsh。

方式 A：从 GitHub 装

dsh plugin --profile desktop add github:liujuntao123/dsh-clinepass-pin

它声明了 dsh.bundle.patch，所以包被追加进 profile 的 dsh.profile.bundles 后配置行随包生效，不用手写。

挂载顺序：如果同时用 dsh-clinepass，请把这行挪到 dsh-clinepass 之前。顺序决定谁在最外层：本插件先装、dsh-clinepass 后装，后者才继续 owns() 着 globalThis.fetch，状态文件里 hook 才会是 installed。反过来钉选照样生效，但 dsh-clinepass 的状态文件会写 hook: "foreign" 并告警。

方式 B：离线手装（不用 pnpm）

$prof = "$env:USERPROFILE\.dsh\profiles\desktop"
Copy-Item . "$prof\plugins\dsh-clinepass-pin" -Recurse
New-Item -ItemType Junction -Path "$prof\node_modules\dsh-clinepass-pin" -Target "$prof\plugins\dsh-clinepass-pin"

然后在 $prof\package.json 的 dsh.profile.bundles 里加一行 "dsh-clinepass-pin"（同样建议排在 dsh-clinepass 之前），重启。

配置

键	默认	作用
upstream	https://api.cline.bot	网关 origin；路由自己拼 /api/v1/chat/completions
models	['cline-pass/deepseek-v4.1-flash-1017']	只有这些 model id 会被加钉
only	['deepseek']	允许的上游列表，必须非空（空列表会让网关 500）
statusFile	$DSH_HOME/dsh-clinepass-pin-status.json	运行证据；false 关掉
log	true	宿主日志

改配置写在 profile 的 cordis.patch.yml 里（patch 是整行替换 config）：

- id: clinepass-pin
  config:
    models: [cline-pass/deepseek-v4.1-flash-1017]
    only: [deepseek]

行为边界

• 只处理 POST <upstream>/api/v1/chat/completions，且 body 是 JSON 字符串、model 在 models 里；其它请求原样透传。
• 只加 providerOptions.gateway.only；已存在非空 only 时不动（让 profile 侧 compat 优先）。已有的 gateway.order 会保留。
• 任何解析/形状异常都回落成原请求 —— 它不该成为一次对话失败的原因（counters.errors 可见）。
• 不缓冲流、不改 headers、不重试、不加请求。

验证

npm test     # 离线，不需要网络也不需要 dsh

跑起来之后：

Get-Content "$env:USERPROFILE\.dsh\dsh-clinepass-pin-status.json"

{ "hook": "installed", "counters": { "pinned": 12, "skippedRequestShape": 0, "errors": 0 } }

pinned 在涨 = 请求确实被改写了；hook 不是 installed = 有别的插件先占了 globalThis.fetch。

代价

硬钉就是硬钉：deepseek 不可用时请求直接失败（500），不会回落到 pareto / fireworks / 匿名网。想要「优先 deepseek、挂了再回落」得用网关的 gateway.order（本插件未暴露；only 是唯一实测被 1017 执行的形状）。

卸载

从 dsh.profile.bundles 去掉 dsh-clinepass-pin → 删 node_modules\dsh-clinepass-pin junction → 删插件目录 → 重启。

---

English

dsh-clinepass-pin pins the cline-pass route in DeepSeek Harness to a single upstream provider by adding providerOptions.gateway.only to the outgoing chat body. It exists because the documented route — a model-level compat.vercelGatewayRouting.only plus flipping pi-ai's COMPLETIONS_COMPAT_GATE — cannot be applied to the desktop build, where that gate lives inside an integrity-checked app.asar.

It is the write-side companion to dsh-clinepass, which only observes. It touches nothing but the JSON body of matching chat requests, never buffers a stream, never retries, and falls through to the untouched request on any surprise. npm test runs offline.

Trade-off: a hard pin means requests fail (500) when the pinned upstream is unavailable instead of falling back.

License

MIT