前言¶

在 DeepSeek Harness（DSH）里跑智能体时，模型 provider 往往要单独配 API 地址、密钥，还要自己查套餐用量。若你用的是 ClinePass（api.cline.bot），常见做法是手写 OpenAI 兼容 endpoint，或在 Cline / Cursor 里另存一份 key，和 DSH 的配置对不上。

dsh-clinepass 是社区维护的 DSH 插件，把 ClinePass 的密钥、模型目录和用量限制收进 DSH 的设置侧栏，并注册 provider id clinebot，让会话直接选 ClinePass 模型。下面介绍它做什么、怎么装、日常怎么用，以及安装时要注意的限制。

这是什么¶

• 仓库：xiangnan0811/dsh-clinepass（维护者 xiangnan0811）
• 包名：dsh-clinepass，当前版本 0.6.0（MIT）
• 分类：模型推理（社区目录 SkillHub 条目）
• 定位：DeepSeek Harness 插件，连接 ClinePass——保存 API key、拉取可用模型、展示 5 小时 / 周 / 月用量，并把选中的模型注册进 DSH 的 LLM provider。

配置命名空间为 dsh-clinebot，HTTP 路由前缀为 /dsh-clinebot。同一 DSH profile 里不要再装另一个也注册 clinebot provider 的插件，否则会同时写入 llm-pi-ai.providers.clinebot。

核心功能¶

设置卡片（ClineBot）¶

安装并重启 DSH 后，侧栏会出现 ClineBot 设置项（settings.section 为 dsh-clinebot）；Plugins 页里 dsh-clinepass 行的配置也会打开同一页面。该卡片负责：

1. 保存 ClinePass API 地址（默认 https://api.cline.bot/api/v1）和密钥。
2. 调用 GET /users/me/plan/usage-limits 展示 5 小时、每周、每月用量（百分比、进度条、重置时间），并显示账号、套餐、最近拉取时间；邮箱默认脱敏，可手动显示。
3. 把勾选的模型注册到 DSH；请求预算默认 65536（不作为 max_tokens 发出，而作为 request budget）。
4. 支持模型搜索、快捷选择、可选 verified-plan 过滤、批量默认值与单模型覆盖；显式空选择则不注册任何模型。
5. 可验证密钥但不保存；也可扫描本机 Cline CLI、VS Code、Cursor 相关文件与环境变量导入密钥（发现结果为脱敏展示）。
6. 可选冒烟测试模型；默认 smoke 模型为 cline-pass/deepseek-v4.1-flash。
7. 按 DSH profile 记录请求统计（结果、次数、延迟、token 计数），可筛选、导出 CSV 或重置；不存储 prompt 与密钥明文。
8. 侧栏配额按钮可打开详情（配额、统计、完整配置）；Composer 可显示当前会话 ClinePass 的用量投影（需自行配置每百万 token 的 input/output 单价才能估算费用，默认 USD，改币种不做换算）。

说明：GET /api/v1/models 在 api.cline.bot 上返回 404；有 key 时通过 GET /users/me/plan 做模型发现。ClinePass 模型 id 形如 cline-pass/deepseek-v4.1-flash。

多账号与限流¶

同一卡片可保存多个 CLINEBOT_API_KEY_* 账号；池名称先于密钥保存，若密钥未存则移除该名称。当某轮请求遇到 HTTP 429 或 402 时，会自动切换到下一个已保存账号。账号模式可配 least-used（优先配额余量最低）或 round-robin；亦可通过 modelRoutes 做显式模型/账号路由。

切换账号、轮换、更换 API 地址或主密钥等操作会清空之前的 plan 模型列表，直到下次 plan 读取成功。

CLI 命令¶

插件提供 /cline 系列命令（纯文本输出），例如：

• /cline ping <model> 或 /cline ping default：对指定模型做流式探测（最多 1024 output tokens，30 秒过期）；裸 /cline ping 仍做 API 健康检查。
• /cline account：列出账号；/cline use <name> 固定账号；/cline use auto 恢复自动路由。
• /cline stats、/cline telemetry：与设置卡片中同一 profile 的统计一致。

安装与启用¶

0.6.0 要求 DeepSeek Harness ^0.2.1-rc.2（README 注明对应 2026-10-19 的 next 线）。DSH 用 pnpm 安装插件，官方命令如下：

dsh plugin --profile web add github:xiangnan0811/dsh-clinepass

安装完成后重启 dsh。社区侧栏市场 dsh-market 同样通过 github:owner/repo 规格安装，无需 npm publish；本仓库 private: true，也不依赖 npm 发布。

密钥：不要在启动 dsh 的 shell 里 export CLINEBOT_API_KEY。DSH 将该变量视为只读，若在环境里已有该变量，设置页保存的 key 会被拒绝。应在插件卡片里保存密钥；浏览器通过 http://127.0.0.1:<port>/dsh-clinebot/... 访问本地 DSH 服务，再由插件请求 baseUrl。

在提供 connection.requestRejection 的 host 上，所有 /dsh-clinebot/* 路由需要 DSH 认证（含只读与更新检查）；用 dsh web 打印的地址登录，未认证返回 401。

配置文件示例¶

除 UI 外，可在 DSH 配置中使用 dsh-clinebot 段，例如：

dsh-clinebot:
  enabled: true
  baseUrl: https://api.cline.bot/api/v1
  apiKeyEnv: CLINEBOT_API_KEY
  defaultModel: cline-pass/deepseek-v4.1-flash
  selectionKind: all-except-disabled
  timeoutMs: 15000
  smokeTimeoutMs: 25000

常用字段含义（节选，完整表见仓库 README）：

典型用法¶

1. 按上文命令安装插件并重启 DSH。
2. 打开侧栏 ClineBot，填写 baseUrl（一般保持默认）并在卡片中保存 ClinePass API key；必要时用「验证但不保存」或本机扫描导入。
3. 在模型列表中勾选要暴露给 DSH 的 ClinePass 模型，保存；在 DSH 模式/模型选择里选用 clinebot provider 下的模型。
4. 用设置页或 /cline ping default 确认连通；用侧栏配额或 /cline stats 观察用量与请求统计。
5. 若有多把 key，在同一卡片追加账号；遇 429/402 时插件会按策略轮换（也可 /cline use 固定账号）。

适用场景与注意¶

适合：已在用或计划用 ClinePass，希望 DSH 会话统一走 ClinePass 模型，并在同一界面看额度、选模型、做多 key 轮换的开发者。

注意：

• 插件以当前 dsh 进程的权限运行；安装前请自行查看 GitHub 源码 与 MIT 许可证，确认符合你的安全与合规要求。
• 勿与另一个 clinebot provider 插件同 profile 共存。
• 勿在启动 DSH 的 shell 中设置 CLINEBOT_API_KEY。
• 社区插件目录（如 SkillHub）为独立生态索引，与 DeepSeek / 幻方无官方从属关系；DSH 本身遵循「一切皆插件」的扩展方式。

结尾¶

dsh-clinepass 把 ClinePass 的密钥、模型注册和用量看板放进 DSH，并补上多账号轮换、探测命令与 profile 级统计，适合把 ClinePass 当作 DSH 里的一类标准模型 provider 来用。

• 目录页：https://www.skillhub.cn/plugins/xiangnan0811/dsh-clinepass
• 源码与说明：https://github.com/xiangnan0811/dsh-clinepass（含 中文 README）