前言¶

在 DeepSeek Harness（DSH）里走 OpenAI 兼容网关时，常见做法是自己在 profile 里写 llm-pi-ai 的 provider 行、再单独查订阅用量。Cline Pass 走 https://api.cline.bot/api/v1，网关背后可能落到不同上游，响应里还会带上匿名标签。若你希望在 composer 里直接用 Cline Pass、并在界面里看到「这一轮实际是谁在推理」以及套餐用量，就需要一条专门的路由和配套的 UI，而不是每次手工对日志。

下面介绍社区插件 dsh-clinepass-deepseek（npm 包名 dsh-clinepass）：由 BreakFree003 维护，在 SkillHub 插件目录 归类为「模型推理」。项目按 MIT 提供，README 明确写明分享性质、非长期维护，不承诺跟进上游 DSH 接口漂移。GitHub 仓库当前约 14 stars。

这是什么¶

一句话：把 Cline Pass 接进 DSH——注册一条 OpenAI 兼容的 pi-ai 路由 cline-pass，API key 在 设置 → 模型 → Cline Pass 填写；插件不改写任何请求（不碰 body、headers，不重试，SSE 逐帧转发），只做观察与展示。

与 0.11.x 相比，0.12.0 起强调「纯透传 + 旁路观测」；package.json 当前版本为 0.12.7。环境要求：Node ≥ 20，DSH 0.1.7 及以上；宿主侧仅用 Node 内置模块，浏览器侧从 web shell 静态模块表加载 React，无第三方依赖、无构建步骤。

核心功能¶

1. Provider 胶囊（真实上游观察）¶

在 composer 底部显示该路由最近一次从聊天响应里读到的真实上游（例如 Provider: deepseek）。数据写入状态文件（默认 <DSH_HOME>/dsh-clinepass-status.json），经宿主路由 ?status=1 暴露；按 session → model 两级记忆。

• 网关返回匿名标签 openai-compatible-private 时，界面用警示样式与专门 tooltip（contributor 档相关说明）。
• 尚未观察到结论时显示 Provider: --。
• 读不到可用于判断的元数据时不给新结论，只计 seen，胶囊保持上一次结果。

服务端在放行终止帧之前写完结论；回合结束后胶囊会补读，运行中约每 2 秒刷新。

2. 用量卡（设置页）¶

在 设置 → 模型 → Cline Pass 卡片上展示三个滚动窗口：5 小时 / 每周 / 每月。网关返回的是已用百分比（percentUsed），卡片显示剩余（100 − percentUsed），并带重置倒计时、读取时间与刷新按钮。

数字由宿主用你保存的 API key 请求 GET https://api.cline.bot/api/v1/users/me/plan/usage-limits 取得；浏览器侧读不到凭据，只通过同源路径拿到数字。README 注明 2026-10-16 前后曾标定过记账单位量级（仅供理解，非官方契约）。

3. 模型与路由登记¶

随 bundle 或安装器会在 profile 中追加 llm-pi-ai 的 cline-pass 声明（含 DeepSeek V4.1 Flash 等模型条目、reasoningEfforts 与默认 reasoning: high）。运行时 provisionProfile() 主要对齐 contextWindow / maxTokens；在 DSH 0.1.7 上冷启动时该写入并不可靠，不要只依赖运行时登记。

可选配置项见 README 表格（如 upstream、provider、model、usage、statusFile 等），未写则使用 withDefaults() 中的默认值。

安装与启用¶

三种方式选一种，不要混用；装完后重启 dsh（profile 仅在启动时读取一次）。

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

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

包声明了 dsh.bundle.patch，安装后会追加 profile 清单中的 loader 与 llm-pi-ai 行，一般无需手写 YAML。卸载：

dsh plugin --profile web remove dsh-clinepass

方式 B：安装器（可不依赖 pnpm）¶

在插件目录执行：

node install.mjs                 # 默认装进 $DSH_HOME/profiles/web/plugins/dsh-clinepass
node install.mjs --dry-run       # 只打印将执行的操作

方式 C：手动¶

将 index.js、client.js、package.json、cordis.patch.yml 复制到 <profile>/plugins/dsh-clinepass/，再按仓库内 patch.example.yml 编写 loader 行。

典型用法¶

填写 API key¶

打开 设置 → 模型 → Cline Pass，在 API key 字段填写并保存。凭据写入 DSH 凭据库，默认键名为 CLINE_PASS_API_KEY（可通过配置项 apiKeyEnv 修改）。

在 composer 中选模型¶

安装并重启后，模型列表会出现 Cline Pass 下的条目（如 cline-pass/deepseek-v4.1-flash）。发消息后留意底部 Provider 胶囊与设置页的用量条是否更新。

自行维护 llm-pi-ai 补丁时¶

若 profile 里已有 llm-pi-ai 行，安装器可能不会覆盖；需自行在 providers.cline-pass 中补全 reasoningEfforts 与 reasoning: high，否则 composer 里可能缺少思考档或出现多余的「Provider default」项。README 提供可粘贴的 YAML 片段，含 baseURL: https://api.cline.bot/api/v1 与模型列表。

进阶（按需）¶

• 会话中途 system 消息：需 profile 模型 compat 与 patch-inhistory.mjs 配合修改 @deepseek-ai/dsh-llm-pi-ai 门禁；升级 node_modules 后应 --check 是否需重打补丁。
• 日期快照模型 deepseek-v4.1-flash-1017 硬钉 DeepSeek 上游：仅在满足 pi-ai 门禁时于模型行写 compat.vercelGatewayRouting.only: [deepseek]；稳定别名路由上该字段会被网关无视，行为不同，勿混用。

适用场景与注意¶

适合谁：已在用或打算用 Cline Pass 订阅、希望在 DSH web profile 里用 pi-ai 统一选模型，并要在界面看到真实上游与套餐用量的开发者。

务必知晓：

1. 插件以当前 dsh 进程的权限运行，安装前请阅读 GitHub 源码 与 MIT 许可证，自行评估信任边界。
2. 项目为分享快照，不承诺长期维护；钉版本可用安装命令末尾 #v0.12.7 等形式。
3. 与 pi 侧姊妹项目 pi-clinepass-deepseek 按发布互相同步，DSH 插件为行为基准之一（见仓库 RELEASING.md）。
4. SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系；Cline 网关策略与额度以 Cline 侧为准。

结尾¶

dsh-clinepass-deepseek 在 DSH 里提供一条透传的 cline-pass pi-ai 路由，把 API key 配置、上游 Provider 胶囊和 Cline Pass 用量卡接到同一套 web 设置与 composer 体验里，且明确不改写推理请求本身。

• 插件目录：https://www.skillhub.cn/plugins/BreakFree003/dsh-clinepass-deepseek
• 源码与完整说明：https://github.com/BreakFree003/dsh-clinepass-deepseek