前言¶
用 DeepSeek Harness 切换多家模型提供商时，额度窗口、重置时间和账户余额往往分散在各家的控制台或 CLI 里。对话进行到一半，为了确认「这周还剩多少」「余额够不够续跑」，需要反复切应用，打断上下文。DSH 社区里有不少按厂商拆分的客户端能力；若希望在一个界面里统一查看多家入口的用量，并在输入区旁得到简要提醒，可以安装维护者 KouzakiUmi 发布的客户端插件 dsh-subusage（npm 包名 dsh-subusage，GitHub：KouzakiUmi/dsh-subusage）。下面介绍它的定位、能力与使用步骤。
这是什么¶
dsh-subusage 是 DeepSeek Harness 的订阅用量显示插件，分类为客户端。它不注册模型路由，只读取各提供商的额度或余额接口并在 UI 展示；查询失败时会说明原因，不把未知状态当成「充足」。
当前 npm 版本为 0.14.3（以仓库 package.json 为准），许可证 MIT，要求 Node.js >= 22.19.0，与 DSH Core 0.2.x 兼容（peer 依赖 @deepseek-ai/dsh 等 0.2 系列）。
核心功能¶
余量药丸与弹层明细¶
在模型选择器旁的输入区会出现用量药丸。正常时保持简洁；当周窗偏少、额度耗尽或读取失败时，药丸会给出明确提示。点开后可查看百分比、适用范围与重置倒计时等明细。
额度窗口与余额分开展示¶
有订阅窗口时，一个窗口对应一根余量条，优先展示最紧张的窗口。无套餐窗口且数据完整时，药丸可直接显示金额；人民币、美元与 credits 按各自规则展示。文档强调：余额不等于订阅额度，也不能盖过已耗尽的套餐。DeepSeek 提供 deepseek（独立 API Key） 与 deepseek-account（本机 DSH 登录态） 两个入口，凭据与余额互不替代、不相加。
统一设置页¶
路径为 设置 → 订阅用量 → 提供商管理。可填写 API Key，或复用对应提供方插件的登录态；MiMo 支持「登录并自动导入」。Codex（openai-codex）默认关闭，避免与提供方自带药丸重复，需要统一展示时可手动开启。
只读 Agent 工具¶
模型可调用只读工具 subusage_quota，读取与界面同源的额度与余额，可按提供商筛选；Command Code 可分别返回各账户状态。该工具不会修改设置。典型用法例如在对话中说：「看一下 Kimi 和 Codex 还剩多少额度。」
支持的数据入口¶
共 29 条 provider id；新安装默认开启 11 条、默认关闭 18 条（清单以仓库 lib/index.js 的 PROVIDERS 为准）。按场景大致包括：
| 你想看什么 | 代表提供商 |
|---|---|
| 订阅窗口与重置时间 | Kimi、MiMo、Codex、SuperGrok、MiniMax、Z.ai、OpenCode Go、OpenDesign |
| 账号钱包与 API 余额 | DeepSeek API / 账号、SiliconFlow、Novita、Hyperbolic、DeepInfra |
| 套餐、余额与多层预算 | Command Code、NanoGPT、OpenRouter、ZenMux、LiteLLM |
| 账号级套餐与企业席位 | 火山方舟 Agent Plan / Coding Plan（arkcli） |
各家的窗口语义、字段与单位换算见仓库 docs/providers.md。私有额度接口可能变化，界面数字仅供参考，不是计费依据。
文档记录的真实账号实测覆盖包括：火山方舟 Agent / Coding Plan（个人版）、Kimi Coding、小米 MiMo、Command Code、SuperGrok、Codex 等；其余入口较多依赖桩测试，使用前宜阅读 README 中的「实测覆盖」与凭据指引 docs/credentials.md。
安装与启用¶
安装命令（来自 README「快速开始」）：
dsh plugin --profile web add dsh-subusage
其中 web 仅为示例 Profile，请替换为实际目标。若在 DSH Desktop 环境使用，应通过桌面壳提供的 DSH Desktop CLI 管理插件，不要用独立公共 CLI 去操作保留的 desktop Profile。
经过上面的步骤后：
- 启用插件：按你的部署方式重载，使 Host 与 Client 一并生效；只刷新页面不保证 Host 已升级。
- 配置提供商：在 设置 → 订阅用量 → 提供商管理 中启用并填写所需凭据。
- 回到对话：选择对应提供商的模型，确认输入区出现用量药丸。
已登录 DSH DeepSeek 账号时，默认开启的「DeepSeek 账号」入口可直接读宿主余额，无需复制 token。
使用前须知¶
- 不猜数据：查询失败、缓存与部分覆盖会明确标注；接口读取成功也不保证仍可续用。
- 凭据安全：API Key、Cookie 与 OAuth token 不会回填到界面；但手动配置仍可能明文落盘，本插件不是加密凭据库。
- 插件权限：插件以当前 DSH 进程权限运行，安装前建议在 GitHub 查看源码与 MIT 许可证，自行评估是否满足环境要求。
Command Code 在自动轮换模式下，药丸展示的用量仍对应默认账户，不跟随实际服务中轮换到的账户；需在弹层或设置页查看各账户详情。
结尾¶
dsh-subusage 把多家提供商的额度、余额与重置信息收敛到 DSH 对话界面与统一设置页，并暴露只读 subusage_quota 供 Agent 查询，适合经常混用多家模型、又不想频繁离开对话查控制台的用户。
