dsh-cline-quota

dsh-cline-quota

在 DeepSeek Harness（DSH）的会话页头显示 Cline / ClinePass 订阅额度、Credits 余额与 ClinePass token 消耗，支持多账号切换。

A DSH plugin that shows your Cline / ClinePass subscription quota, credits and ClinePass token consumption in the session header — with multi-account switching.

零依赖、无构建步骤：host 半边只用 Node 内置模块，client 半边是手写的模块包（只用到 shell 提供的 react）。

功能

• 页头 chip：显示最紧的 5 小时窗口占用百分比，按压力变色（>70% 琥珀、>90% 红）；悬停给出三个窗口 + 余额的一行摘要。多账号时摘要里会带上账号名。
• 弹层：
  • 5 小时 / 本周 / 本月三个窗口的进度条、百分比与重置倒计时
  • Credits（按量付费） 余额
  • Token 消耗 块：日期区间选择（含 24h / 7 天 / 14 天 / 30 天 预设）、合计 token 与金额、每日（或每周、24h 下按小时）柱状图、以及可点选的模型列表 —— 点某个模型即可只看它的消耗
• 多账号：在面板里直接粘贴 API key 添加账号，⇄ 循环切换，✕ 移除
• 只统计 aiModelTypeName === 'cline-pass' 的用量，与上面的 ClinePass 额度口径一致

安装

已同时发布到 npm 与 GitHub，两个源内容逐字节一致：

1) 插件面板（推荐）

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

2) 命令行

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 凭据库）
• 所以你以后换 provider、删 provider、清凭据，都不会把这个 key 弄丢
• 面板自动切到这个新账号；账号名默认取该账号邮箱
• 删除账号（行尾 ✕）会连它保存的 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。

开发与测试

npm test

test/accounts.test.mjs 是离线 harness：把真实的 host 半边挂到假 ctx 与假 Cline API 上，覆盖账号选择、粘贴 key（验证 → 写凭据库 → 名单文件）、重复 key/重名、删除、以及金额单位换算。test/range-presets.test.mjs 校验区间预设的高亮映射与"数据已过期"判定（24h / 7 / 14 / 30 天与自定义区间）。

发版（维护者）

npm version patch          # 或 minor / major：改版本号并打 tag
npm publish --access public
git push --follow-tags

品牌新包的首次发布会先进入 npm 的 staged 队列：registry 上先出现 0.0.0-stage 占位版，实测约一分钟后自动上架。若被拦下需要 maintainer 用 2FA 批准 —— npm ≥ 11.15 用 npm stage list / npm stage approve <stage-id>，或在 npmjs.com 的 Staged Packages 页点 Approve。

卸载

插件面板里卸载，或：

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

声明

与 Cline / ClinePass 官方无隶属关系；"Cline" 仅用于说明本插件查询的服务。

License

MIT © Wei-l-w