DeepSeek Harness (DSH) 采用了“一切皆插件”的架构。在使用 ClinePass 等第三方服务时，开发者常面临动态模型发现失败、特定模型前缀配置繁琐以及配额管理不直观的问题。dsh-clinebot 是一个原生 DSH 插件，旨在解决 ClinePass 在 DSH 中的集成痛点，提供动态配额追踪、安全凭证存储和可视化管理能力。
插件定位¶
这是一个为 ClineBot / ClinePass 提供原生支持的 DSH 插件，由 GooDAnDReaDY 维护，属于“模型推理”分类。它通过插件补全了上游 API 缺失的 /v1/models 发现机制，并提供了基于 SWR 的配额缓存与多账户自动切换功能。
核心功能¶
-
动态模型同步与特定前缀支持
插件自动从 ClinePass 计划接口 (GET /api/v1/users/me/plan) 拉取模型列表，并强制要求使用cline-pass/前缀（如cline-pass/deepseek-v4-flash）。由于上游 API 不提供原生的/v1/models端点，插件通过动态解析解决了模型列表为空的问题。 -
可视化管理与安全存储
插件提供配置页面（位于插件行内，非侧边栏），支持直接在 UI 中粘贴并保存 API Key。Key 会被安全地写入~/.dsh/.credentials.yaml。同时提供模型选择器，允许开发者精细化勾选哪些模型出现在聊天拾取器中。 -
配额监控与告警
集成 5 小时滚动配额与周限额的实时仪表盘，并在配额达到 80%（警告）和 95%（耗尽）时显示警告横幅与重置倒计时。 -
智能故障转移
支持多账户配置，在遇到 429 错误或配额耗尽时，自动切换至下一个可用账户。机制包含 30 秒的风暴保护（当前请求不重试，后续请求切换）。 -
会话遥测与命令
提供/cline斜杠命令，可在聊天控制台查看实时延迟、Token 消耗、错误数等会话指标；支持会话指标的实时遥测记录。
安装与启用¶
使用官方安装命令添加插件：
dsh plugin --profile web add @goodandready/dsh-clinebot
安装完成后，请重启 DeepSeek Harness 实例并刷新浏览器。
典型用法¶
- 查看状态: 在 DSH 聊天窗口输入
/cline，即可查看配额、限制、会话遥测和当前活跃模型。 - 配置: 点击已安装的 ClineBot 插件行，选择“配置”进入设置页，在此处粘贴 API Key、同步模型计划并查看使用限制。
适用场景与注意¶
该插件适合需要稳定、可视化管理第三方 API 配额的开发者。由于插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。API Key 存储在本地文件 ~/.dsh/.credentials.yaml 中，请确保该目录权限安全。
生态链接¶
- 插件目录: https://www.skillhub.cn/plugins/GooDAnDReaDY/dsh-clinebot
- 源码仓库: https://github.com/GooDAnDReaDY/dsh-clinebot
