前言¶
在 DeepSeek Harness（DSH）里切换智谱、OpenCode Go、Kimi、小米套餐或 DeepSeek 官方模型时，各家额度窗口、余额和 Token 消耗口径并不统一，往往要分别打开控制台或查接口才能对齐「还剩多少、何时重置」。dsh-quota 是社区维护的联网工具类插件，把上述信息聚合到输入框状态栏徽标和明细面板里，数据在本地聚合，凭据按 DSH 凭据服务或环境变量引用，不额外外发。
这是什么¶
dsh-quota（GitHub：shy3130/dsh-quota，npm：@wshylabs/dsh-quota）由维护者 shy3130 发布，定位为 DeepSeek Harness 输入框状态栏 · 多厂商额度与消耗监控插件。覆盖智谱 GLM、OpenCode Go、Kimi For Coding、小米 Token 套餐、DeepSeek 官方（余额 + 今日消耗估算），并附带今日 / 7 天 / 30 天 Token 用量统计。插件为标准 DSH bundle，不修改官方源码；所有宿主路由带 DSH 登录门。许可证 MIT；当前 package 版本为 1.4.1（以仓库 package.json 为准）。README 标明在 DeepSeek Harness 0.2.1-rc.3 桌面 RC 上开发与实测，≥ 0.2 理论兼容。
核心功能¶
状态栏徽标与自动跟随¶
宿主读取 DSH 默认模型与会话模型选择（与输入框模型芯片同源）；切换模型后约 1 秒内切换到对应厂商徽标，未覆盖的厂商徽标隐藏且不占位。客户端约每秒查询一次 GET /quota/active，额度数据每 60 秒刷新；窗口获焦、会话切换、模型保存时会立即查询。
徽标文案示例（README 原文示意）：
GLM 5h 21% ▰ · 周 6% ▰
OpenCode 5h 8% ▰ · 周 3% ▰ · 月 1% ▰
Kimi 5h 24% ▰ · 周 42% ▰
小米 套餐 12% ▰ · 月 17% ▰
DeepSeek 余额 ¥85.31 · 今日 ¥1.26
五家额度来源¶
| 厂商 | 面板侧重 |
|---|---|
| 智谱 GLM | 5 小时窗口 · 本周 · 本月工具额度（含分项） |
| OpenCode Go | 5 小时滚动窗 · 本周 · 本月 |
| Kimi For Coding | 5 小时窗口 · 本周汇总 |
| 小米 Token 套餐 | 套餐额度 · 补偿额度 · 本月总量 |
| DeepSeek 官方 | 账户余额（充值 / 赠送）+ 今日消耗 |
点开徽标可打开明细面板：剩余 / 已用 / 重置倒计时（如 6d 21h）、工具额度分项；底部柱状 / 环状指示器可切换，选择记在浏览器 localStorage（键 dsh-quota:indicator）。
Token 用量与 DeepSeek 费用估算¶
面板内可切换今日 / 7 天 / 30 天：总量、输入 / 输出、缓存命中率、请求数与每日柱状图，均由本地计算。DeepSeek 侧按官方价目表（区分高峰 / 空闲时段）由本地 token 记录估算金额，不依赖官方用量接口。
客户端与布局¶
支持 macOS · Windows · Linux。窄屏（≤520px）下徽标紧凑、弹层横向铺满并限高，触屏点外部关闭。
安装与启用¶
环境要求：DeepSeek Harness 0.2.1-rc.3（README 实测）；Node.js 无需单独安装；各厂商凭据见下文配置。安装或更新后需完全退出并重开 DSH（仅刷新页面不够）。
推荐从 npm 安装：
dsh plugin --profile desktop add @wshylabs/dsh-quota
钉住版本示例：
dsh plugin --profile desktop add @wshylabs/dsh-quota@1.4.1
从 GitHub 跟踪 main：
dsh plugin --profile desktop add github:shy3130/dsh-quota
钉住 git tag：
dsh plugin --profile desktop add github:shy3130/dsh-quota#v1.3.1
更新已安装版本：
dsh plugin --profile desktop update @wshylabs/dsh-quota
卸载：
dsh plugin --profile desktop remove @wshylabs/dsh-quota
版本变更说明见 GitHub Releases。
配置凭据与可选项¶
凭据可放在环境变量，或通过 DSH 凭据服务按下列名称保存（插件只持引用名）：
| 厂商 | 凭据名 | 说明摘要 |
|---|---|---|
| 智谱 GLM | ZAI_CODING_CN_API_KEY |
智谱开放平台 API Key |
| OpenCode Go | OPENCODE_GO_API_KEY |
OpenCode Zen 后台 API Key |
| Kimi For Coding | KIMI_API_KEY 或 DSH Kimi OAuth |
优先 llm-pi-ai/kimi-coding access token |
| 小米 Token 套餐 | XIAOMI_MIMO_SESSION_COOKIE |
浏览器 SSO Cookie，非 tp-... API Key |
| DeepSeek 官方 | 通常无需（DSH 已登录）；或 DEEPSEEK_API_KEY |
账号走 deepseekAccount，Key 走 GET /user/balance |
在 cordis.patch.yml 的插件 config 中可覆盖各来源 baseUrl 与 credentialRef（字段名见 README「来源地址与凭据引用」）。若希望新环境默认环状指示器：
config:
indicator: ring # bar（默认）| ring
修改经宿主路由 /quota/config 读取的默认值后需重启 DSH；面板内切换只需刷新页面。
典型用法与数据刷新¶
- 安装插件并配置所需厂商凭据，重启 DSH。
- 在会话中选择已支持的模型；状态栏右下角（移动端布局见 README）出现对应徽标。
- 单击徽标查看额度明细与 Token 统计；按需切换柱状 / 环状指示器或统计时间范围。
工作原理摘要：/quota/active 将 provider 映射到各家 HTTP 接口（如智谱 GET .../api/monitor/usage/quota/limit、OpenCode GET .../zen/go/v1/usage 等）；未映射的 provider 不显示徽标。
适用场景与注意¶
适合长期在 DSH 桌面端混用多家模型、希望在输入框旁持续看到额度与本地 Token 统计的开发者。插件以当前 DSH 进程权限运行，会代表你调用各厂商用量接口；安装前应阅读仓库源码与 MIT 许可证，并自行保管 API Key / Cookie。DSH 处于 RC/预览阶段时，升级客户端后若徽标或面板异常，可在 GitHub Issues 附上 dsh --version 反馈。社区插件目录（如 skillhub.cn）与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
结尾¶
dsh-quota 把 GLM、OpenCode Go、Kimi、小米套餐与 DeepSeek 官方的额度与消耗信息收拢到 DSH 状态栏，减少在多控制台之间切换的成本。目录与仓库：
- 插件目录页：https://www.skillhub.cn/plugins/shy3130/dsh-quota
- GitHub：https://github.com/shy3130/dsh-quota
