BreakFree003/dsh-clinepass-deepseekv4.1

dsh-clinepass

把 Cline Pass 接进 DeepSeek Harness（dsh），并把每条请求钉死在 DeepSeek 官方渠道上（不回退）。 API key 在 设置 → 模型 里直接填，卡片上还带一条 5 小时 / 每周 / 每月 的用量条（显示剩余量）。默认不开任何本地端口。

Cline Pass for DeepSeek Harness. One provider route, pinned to the DeepSeek upstream channel, with the API key entered on Settings → Models — plus a usage card for the 5-hour, weekly and monthly windows.

分享性质，非长期维护项目。 这是作者自用插件的公开快照：按 MIT 原样提供， 不承诺持续维护，也不承诺跟进上游 dsh 的接口漂移。插件依赖 dsh 的内部行为 （pi-ai 每次请求新建 client、不传自己的 options.fetch，因此真正发请求的是全局 fetch）；上游哪天改掉这一点，插件会静默失效——下面的状态文件 （hook: installed）就是为这件事准备的报警器。装之前建议先读「验证」一节。 能跑测试不代表上游永远不变。

维护者发版走 RELEASING.md 里的清单 —— tag 和 GitHub Release 是两件事， 只推 tag 的话 Releases 页面会是空的。

它做了什么（架构）

四件事各由最合适的部分负责：

1. 路由本身是一个普通的 pi-ai provider profile（llm-pi-ai.providers.cline-pass）：OpenAI 兼容协议 + 一个存在凭据库里的 key。 正因为如此，它才会**原生出现在「设置 → 模型」**里 —— key 输入框、模型目录、地址都是 dsh 自带的界面，不需要自写 UI，也不需要一个可能随 dsh 升级而漂移的手写流式 adapter。

2. 本插件只做一件事：给请求体加上渠道钉选字段。 Cline Pass 的钉选是请求体里的 providerOptions.gateway.only，而 dsh 刻意屏蔽了 pi-ai 的 openRouterRouting / vercelGatewayRouting 兼容开关 —— settings 里写不了。插件把这个字段加在出去的请求上，字节层面其它什么都不動，SSE / 工具调用 / 推理 / 用量 / 图片全部走 pi-ai 已验证的通路。

3. 提示词里的模型名去前缀（0.6.2 起）。网关要求请求体的 model 是 type/model 形状（裸 id 会被拒： invalid model format. Expected format: modelType/model），而 dsh 把 catalog 的 models[].id 原样发给线上 —— 所以这条路由的 id 必须写成 cline-pass/deepseek-v4.1-flash。前缀是传输层的要求，但 {{model}} 会把它当模型名渲染进 persona，而官方部署的提示词里是没有前缀的（官方 deepseek 路由的 id 本身就是裸 id）。 插件因此在提示词装配时把 persona 两段模板里的 {{model}} 换成 deepseek-v4.1-flash：线上 id、 会话记录、选择器都不动，只改提示词显示。详见下面的 plainModelId 选项。

4. Cline Pass 卡片上的用量条（0.7.0 起）：5 小时 / 每周 / 每月三条，显示剩余百分比、重置倒计时和读取 时间，带一个刷新按钮。数据由宿主半边用凭据库里的 key 去问网关 （GET https://api.cline.bot/api/v1/users/me/plan/usage-limits，与开源的 CodexBar 同一个端点），挂在一条同源路径上给浏览器读 —— 浏览器永远拿不到 key。详见下面的「用量条」一节。

dsh ──pi-ai──> https://api.cline.bot/api/v1   （进程内改写请求体，无监听、无端口）

注入方式是进程内的：包一层 globalThis.fetch，只改写发往本网关的 chat/completions 请求体。 依赖的是 pi-ai 的既有行为（它每次请求新建 client、不传自己的 options.fetch，所以真正承载请求的就是全局 fetch）；万一将来 dsh 改成自带 fetch，就会静默失效 —— 下面的状态文件就是为此存在的。