前言¶
在 DeepSeek Harness（DSH）里切换模型、连续开多轮对话时，账户里还剩多少钱、Coding Plan 的 5 小时或 7 天窗口用了多少，往往要另开浏览器去各厂商控制台查。对话界面本身只有 token 统计，不会告诉你「这会儿会不会撞额度」或「余额是否够用」。下面介绍的 dsh-usage-state 是社区插件，由 takboo 维护，在输入框上方增加一条与输入卡片同宽的状态行，对当前在用模型对应的供应商展示 API 余额 或 套餐已用百分比与重置倒计时，并保留 DSH 原生的统计行与上下文计量器。它不做法务意义上的成本归因、价格目录或历史账单，只回答「账户当前读数是多少」这一件事。
这是什么¶
dsh-usage-state 是 DSH 的用量状态插件（npm 包名 dsh-usage-state，当前发布版本 0.4.8，README 写明已验证 DSH 0.2.1-rc.2 兼容性）。分类上常归入 admin-security 一类：和密钥、账户可见性相关，但不替代 DSH 自带的凭据管理。
状态行示例（来自仓库 README）：
z.ai / GLM · ◔ 5h 12% (4h0m) · ◔ 7d 59% (3d17h)
DeepSeek · ¥58.13
插件以 MIT 许可发布；问题与署名建议走 GitHub Issues。
核心功能¶
以下能力均来自仓库 README，安装前请自行核对源码与许可证；插件在 当前 DSH 进程权限 下运行，会按配置访问凭据与厂商端点。
- 自动复用凭据：对已识别的供应商默认使用「自动」，复用 DSH 已有凭据；每个 provider 配置一次，模型列表供参考。
- 读数展示：余额、已用百分比、重置倒计时、SVG 进度环；默认已用 ≥80% 琥珀色、≥95% 红色，阈值与是否隐藏进度环可在设置中调整。
- 失败时的陈旧读数：同一有效账户身份下，若源请求失败，保留上次成功读数并标记陈旧、年龄和原因；RPC 传输失败也会标明旧值。
- 悬停详情：数据源、模式、重置时刻、余额构成等；界面语言跟随 DSH 语言设置。
- 范围边界：只显示当前账户读数，不做成本归因、预算或历史账单；无模型选择或隐藏时可不显示；点击状态行不会打开设置页。
支持的供应商与数据源¶
插件按「来源 + 模式」选择查询目标；显式 provider 覆盖优先于旧 source 默认。下表摘自 README「数据源」一节。
| 来源 | API 读数 | Coding Plan 读数 | 主要凭据 |
|---|---|---|---|
| DeepSeek 官方 | CNY/USD 余额 | — | DEEPSEEK_API_KEY |
| z.ai / 智谱 GLM | — | 5h / 7d 已用% | ZAI_API_KEY 等 |
| Kimi / Moonshot | 人民币余额 | Kimi Code 订阅窗口 | MOONSHOT_API_KEY / KIMI_CODING_API_KEY |
| OpenCode Zen Go | — | 5h / 7d / 30d 已用% | OPENCODE_GO_API_KEY / OPENCODE_API_KEY |
| Sub2API | 余额或 key 配额 | 按实例响应（如 5h / 1d / 7d / 30d） | SUB2API_API_KEY 及实例地址 |
补充说明（README）：百分比表示 已用；z.ai 的 key 分国内/国际区域，默认国内地址，失败可尝试镜像。Kimi Code 相关 provider 与声明 api.kimi.com / api.kimi.ai 的自定义 provider 会自动读套餐用量。当前缓存按数据源与模式合并，不能将不同密钥/实例视为已支持的独立多账户。
安装与启用¶
环境要求（README）：DSH 版本满足 ^0.2.0-rc.2 || ^0.2.1-rc.1（文档已验证 0.2.0-rc.2、0.2.1-rc.1、0.2.1-rc.2）；运行预构建插件声明 Node ≥20；安装到正在使用的 web profile。DSH 0.1 应使用历史版本 0.3.2（不适配 0.2）；0.4.0 存在 RPC 挂载缺陷，应升级到最新兼容版。
从 npm 安装：
dsh plugin --profile web add dsh-usage-state
# 安装后重启 DSH；bundle patch 在启动时读取
从 GitHub 安装：
dsh plugin --profile web add github:takboo/dsh-usage-state
也可通过 dsh-market 搜索 usage state 或 takboo；安装后核对实际来源与版本。插件已进入社区 精选列表；目录页可见性取决于区域与构建，与 DeepSeek / 幻方无官方从属关系。
典型用法¶
- 打开 设置 → 用量状态，查看供应商、模型和检测到的数据源。
- 对已识别供应商保留「自动」，或在其支持的 API、Coding Plan、隐藏 之间选择。
- 若使用自建 Sub2API，在高级区填写实例地址；配置完成后，当前模型的读数出现在输入框上方。
- 需要即时更新时使用「立即刷新」；若出错，先看设置页原因，并参考仓库 排查指南。
高级区提供数据源、端点、凭据名和密钥写入入口。凭据优先级跟随宿主：DSH 0.2.1-rc.1/rc.2 的 Web/桌面端优先已保存凭据，环境变量作回退；0.2.0-rc.2 则优先环境变量。宿主默认在回合结束 2 秒后调度刷新，并有 5 分钟兜底定时器；浏览器每 30 秒拉取 RPC 镜像。成功请求的默认最小间隔为 60 秒，显式刷新可绕过。
适用场景与注意¶
适合谁：长期在 DSH 里混用 DeepSeek、智谱、Kimi、OpenCode、Sub2API 等，希望在同一界面看到 余额或套餐窗口用量，避免频繁切控制台的用户。
安装前建议：DSH 生态理念是「一切皆插件」；社区目录（如 SkillHub 插件页）是独立站点，不等同官方应用商店。插件会查询余额/额度并读取当前模型与供应商目录，README 写明不写会话日志、不向第三方上报这些读数；宿主不把已保存的密钥值返回浏览器。
已知限制（README 摘要）：仍按 source+mode 选一个目标，配置身份隔离不等于多账户并行展示；不保存历史读数。npm 0.4.4 及更早版本存在多项展示与凭据缺陷，应升级；部分路径（如 Kimi Code 月额度真实账户、Sub2API 真实账户等）文档标明仍缺活体验证。完整清单见 待办清单。
结尾¶
dsh-usage-state 把「当前模型对应账户还剩多少」收进对话输入区上方，用自动凭据与可配置的 API/Coding Plan 模式，覆盖 README 列出的主要国内常用供应商。若你要安装或贡献适配，以仓库 README 与 CHANGELOG 为准。
