dsh-clinepass-deepseek

dsh-clinepass

把 Cline Pass 接进 DeepSeek Harness：注册一条 OpenAI 兼容的 pi-ai 路由 cline-pass，并做两件事 ——

1. 观察真实 Provider：只读地看这条路由的聊天响应，读出上游到底是谁（含网关的匿名标签

openai-compatible-private），写进状态文件，供 composer 底部的 Provider 胶囊显示；

2. 画用量卡：设置 → 模型 → Cline Pass 卡片上的 5 小时 / 每周 / 每月用量条。

它不改写任何请求。 不碰 body、不碰 headers、不重试、不另发请求；SSE 响应逐帧转发，

不在本地缓冲整包。这是 0.12.0 的形态，也是它和 0.11.x 最大的区别（见「迁移」）。

• 环境要求：node ≥ 20，dsh 0.1.7 及以上。宿主半边只用 node 内置模块，浏览器半边只向

web shell 的静态模块表要 React；没有任何第三方依赖，也没有构建步骤。

• 分享性质，非长期维护项目：按 MIT 原样提供，不承诺持续维护、也不承诺跟进上游 dsh 的接口

漂移。发版清单见 [RELEASING.md](./RELEASING.md)（tag 和 GitHub Release 是两件事）。

pi 版本：[pi-clinepass-deepseek](https://github.com/BreakFree003/pi-clinepass-deepseek) 把同一套模型定义、

Provider 观察与用量报告搬进 pi；两边按发布版本互相同步，这个插件是它的行为基准（见

[RELEASING.md](./RELEASING.md) §7）。

---

安装

三种方式，选一种，别混用。装完都要重启 dsh（profile 只在启动时读一次）。

方式 A：一条命令（bundle 包，推荐）

dsh plugin --profile web add github:BreakFree003/dsh-clinepass-deepseek
# 钉某个 tag：同上，末尾加 #v0.18.18

包自己声明了 dsh.bundle.patch，所以 dsh plugin（pnpm 的转发器）装上它之后会把这个包追加到

profile 清单的 dsh.profile.bundles 里 —— 那两行配置（- id: clinepass 的 loader 行，以及声明

Cline Pass 卡片的 - id: llm-pi-ai 行）随包生效，不需要手写任何东西。卸载同样干净：

dsh plugin --profile web remove dsh-clinepass。

方式 B：安装器（不需要 pnpm，离线可用）

node install.mjs                 # 默认装进 $DSH_HOME/profiles/web/plugins/dsh-clinepass
node install.mjs --dry-run       # 只打印会做什么

它把插件文件复制进 profile 的 plugins/dsh-clinepass/，给 cordis.patch.yml（会先备份）追加一行

loader 行（name: './plugins/dsh-clinepass/index.js'），并追加 llm-pi-ai 的 provider 行；如果你

自己的补丁里已经声明了 llm-pi-ai，它不动你那一行，只提示你把 cline-pass: 段自己写进去

（下面的 YAML 可以直接粘贴）。其它开关：--dsh-home / --profile /

--name / --no-patch。

方式 C：手动

把 index.js / client.js / package.json / cordis.patch.yml 复制进

/plugins/dsh-clinepass/，再照 [patch.example.yml](./patch.example.yml) 自己写 loader 行。

卡片从哪来

「Cline Pass」卡片就是一个普通的 pi-ai provider（llm-pi-ai.providers.cline-pass），有两个来源：

• 随包/随安装器声明的静态行（方式 A / B 都写了这一行）—— 重启即有卡片，不看服务时序；
• 插件运行时的 provisionProfile() —— 它认得出自己写的那张卡，只把模型条目的

contextWindow / maxTokens 对齐成配置值，绝不覆盖别人的卡，也不改档位声明。

在 dsh 0.1.7 上这次写入并不可靠（冷启动时 settings 服务还没起来；全新 profile 的写入会等

清单写锁），所以别只依赖它。

> 自己写 llm-pi-ai 行的人必读：静态卡声明了 reasoningEfforts: {high, max} **和

> reasoning: high，而运行时的 provisionProfile() 只**对齐 contextWindow /

> maxTokens —— 它既不声明档位、也不写默认档、也不改写你写下的值。而 patch 行是**整行替换

> config、不合并**，所以自己写就必须把这两个字段一起写上：

>

> - 少了 reasoningEfforts，这个模型在 composer 里没有任何思考档可选；

> - 少了 reasoning，选择器会多出一个 「Provider default / 跟随 Provider」 条目（客户端

> 只在模型目录没有 defaultEffort 时才插入它），而且未显式选档的会话会落到上游自己的默认

> 档。写上 reasoning: high 就只剩 High / Max，默认 High。

>

> 可粘贴：

- id: llm-pi-ai
  config:
    providers: