前言¶

在使用 DeepSeek Harness（DSH）时，订阅服务（如 Cline / ClinePass）的额度、余额与消耗往往分散在不同界面。开发者需要频繁切换上下文查看资源状态，打断工作流。下面介绍一个能在会话页头实时展示这些信息的 DSH 插件。

这是什么¶

dsh-cline-quota 是一个为 DeepSeek Harness 提供的客户端插件，由维护者 Wei-l-w 开发。它把 Cline / ClinePass 的订阅额度、Credits 余额与 token 消耗直接显示在 DSH 会话页头，并支持多账号切换。零依赖、无构建步骤，使用 Node 内置模块与手写模块包。

核心功能¶

插件在会话页头显示一个 chip，展示最紧的 5 小时窗口占用百分比。按压力变色：超过 70% 为琥珀色，超过 90% 为红色。鼠标悬停会给出三个窗口（5 小时 / 本周 / 本月）的进度条、百分比与重置倒计时，以及 Credits 余额。多账号时会带上账号名。

点击 chip 会弹出详情面板，包含：
- 三个窗口的进度条、百分比与重置倒计时
- Credits（按量付费）余额
- Token 消耗：支持日期区间选择（预设 24h / 7 天 / 14 天 / 30 天），显示合计 token 与金额、柱状图，以及可点选的模型列表

插件统计 aiModelTypeName === 'cline-pass' 的用量，与 ClinePass 额度口径一致。

安装与启用¶

插件已发布到 npm 与 GitHub，两个源内容一致。

方式一：插件面板（推荐）

DSH 侧边栏 →「插件」→「添加插件」，填 dsh-cline-quota（或 github:Wei-l-w/dsh-cline-quota；也可以填本地目录 / .tgz 的绝对路径）。

方式二：命令行

dsh plugin --profile <profile> add dsh-cline-quota

桌面版占用的 desktop profile 不能从命令行管理（会报 profile "desktop" is managed exclusively by the Electron application）；这种情况请用上面的插件面板。

安装完成后刷新窗口即可看到 chip；host 半边的改动需要重启 DSH 才会重新加载。

配置账号¶

插件不自带任何账号，也不依赖你 DSH 里配置了 cline provider。打开面板点击 ＋ 粘贴一个 Cline API key 就能用。

方式一：面板里粘贴（默认，推荐）

在账号行右侧 ＋ → 粘贴 key → 保存。插件会用 GET /users/me 验证这个 key，通过后：

• key 存进插件自己的名单文件 $DSH_HOME/cline-quota.accounts.json（权限 0600，与 $DSH_HOME/.credentials.yaml 同为明文，但完全不会触碰 DSH 凭据库）
• 面板自动切换到这个新账号，账号名默认取该账号邮箱
• 删除账号（行尾 ✕）会连同保存的 key 一起删除

方式二：复用 DSH 凭据库的引用（可选）

如果你已在 DSH 凭据库里配置了 Cline 的 key，也可以让插件按引用名去取：

- id: cline-quota
  config:
    accounts:
      - label: 主号
        keyRef: CLINE_API_KEY

key 本体放在 $DSH_HOME/.credentials.yaml 的 refs: 下，或 $DSH_HOME/.env（只读回退层）。配置改完不必重启（loader 会带新配置重新 apply）。

没有任何配置、也没添加过账号时，面板显示「还没有账号 · 点 ＋ 粘贴 Cline API key」——这是正常的初始状态。

关于金额¶

三个百分比是 Cline API 提供的（按参考价加权的配额占用），不是本地用 token 数算的。Token 消耗块里的 $ 是 Cline 按参考价折算的用量价值，不是账单：ClinePass 是订阅制，参考价不等于实付金额。

对 cline-pass/deepseek-v4.1-flash，Cline 的参考价 = DeepSeek 官方高峰价（输入 $0.30 / 缓存命中 $0.006 / 输出 $1.20 每百万 token）；DeepSeek 空闲价是它的一半。

版本 0.1.0 曾把 Cline 的 usage/caps 金额字段当成 micro-USD，金额放大 100 倍；0.2.0 已修正（usage/caps 按 1e-8 折算，Credits 余额仍是 micro-USD）。

上游口径变化：Cline 在 2026-10 把订阅用量的 aiModelTypeName 从 cline-pass 改成了 cline（模型名仍是 cline-pass/deepseek-v4.1-flash-1017，creditsUsed 为 0、走 vercel 推理）。0.2.3 起，「类型是 cline-pass」或「模型名以 cline-pass/ 开头」都算订阅用量，否则新一天的数据会被整段漏掉。

安全与隐私¶

面板粘贴的 key 存在插件自己的 $DSH_HOME/cline-quota.accounts.json（0600）；配置的账号才按引用名从 DSH 凭据库取。浏览器只会拿到额度数字、账号邮箱与标签，任何 key 都不会回传给浏览器。

粘贴时 key 只在本机 loopback 的 POST body 里出现一次：不回显、不写日志（诊断日志只记方法、是否强制刷新、账号名、区间、UA、origin）。

插件不做任何遥测；host 进程只直连 https://api.cline.bot。路由在本机 loopback 上无鉴权（与 DSH 中其它精确路由一致）：同机进程可以读到额度数字与邮箱，但读不到 key。

兼容性¶

需要带 conversation.session.header.utilities 座位的 DSH；在版本 0.2.1-rc.2（桌面版内置版本）上验证。需要 Node >= 22。

适用场景¶

适合使用 Cline / ClinePass 作为推理服务的开发者，尤其是需要同时管理多个账号、频繁查看额度与消耗的场景。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证（MIT）。

短结尾¶

这个插件让 Cline / ClinePass 的资源状态一目了然，减少切换成本。更多细节可在社区目录查看：https://www.skillhub.cn/plugins/Wei-l-w/dsh-cline-quota，源码在 GitHub：https://github.com/Wei-l-w/dsh-cline-quota