dsh-subusage

dsh plugin --profile web add dsh-subusage

<div align="center">

订阅用量显示

额度与余额，不必离开对话。

在 DeepSeek Harness 的模型选择器旁看余量；点开药丸，查看额度窗口、重置时间与余额。




[快速开始](#快速开始) · [功能预览](#功能预览) · [支持清单](#支持的数据--supported-data) · [兼容插件](#兼容的插件与路由) · [手动匹配](#手动匹配-provider) · [凭据指引](docs/credentials.md)

<img src="https://raw.githubusercontent.com/KouzakiUmi/dsh-subusage/main/assets/title.png" width="1200" alt="dsh-subusage：保留原标题图的深蓝构图，右侧展示真实 Codex 与 OpenCode Go 深浅主题用量弹层；虚构数据离线预览">

_{真实组件 · 虚构数据 · 真实组件离线预览，不是运行中的 DSH 截图}

</div>

0.20.0：Antigravity 用量接入本机 dsh-tool-antigravity——新增 antigravityAuth 通道（与既有 dsh-antigravity-acp 的 agyQuota 双通道自动探测，同一份订阅只出一条），选中 google-antigravity 模型时输入区药丸直接显示 Gemini 与 Claude/GPT 两组的 5 小时 / 周额度。[查看更新记录](docs/changelog.md)。

快速开始

dsh plugin --profile web add dsh-subusage

web 是示例 Profile，请替换为实际目标。Desktop 使用目标桌面壳提供的 DSH Desktop CLI，不要从独立公共 CLI 管理保留的 desktop Profile。

1. 启用插件：按部署方式重载，让 Host 与 Client 一起生效；只刷新页面不保证 Host 已升级。

2. 配置需要的提供商：打开 设置 → 订阅用量 → 提供商管理。填 API Key，或使用对应提供方插件的登录态；MiMo 可“登录并自动导入”，手机上可用小米账号扫码登录（不需要导出 Cookie）。[不知道该填什么？](docs/credentials.md)

3. 回到对话：选择该提供商的模型，输入区出现用量药丸。点开看明细；读取失败会说明原因，不把未知当充足。

已经登录 DSH 的 DeepSeek 账号？ 默认开启的「DeepSeek 账号」直接读取宿主余额，不需要复制 token。独立 API Key 使用另一个「DeepSeek API」入口，两份余额不相加、不互相替代。[两种入口的区别](docs/providers.md#deepseek-api-与-deepseek-账号)

功能预览

<picture>

<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/KouzakiUmi/dsh-subusage/main/assets/readme/features-dark.png">

<img src="https://raw.githubusercontent.com/KouzakiUmi/dsh-subusage/main/assets/readme/features-light.png" width="1200" alt="三块真实组件：Codex 套餐用量、独立 DeepSeek 账号余额、Command Code 多账户轮换池；虚构数据离线预览">

</picture>

看额度：最紧张的窗口，先提醒你

一个窗口一根余量条。正常时保持简洁；周窗偏少、额度耗尽、读取失败时，药丸明确提示。点开后再看百分比、适用范围与重置倒计时，不需要先切到控制台。

看余额：金额直接显示，单位不混淆

无套餐窗口且数据完整时，药丸直接显示金额。人民币、美元与 credits 各按自己的规则展示；余额不等于订阅额度，也不能盖过已耗尽的套餐。DeepSeek API 与本机账号有各自的开关、凭据来源与余额。

管账户：需要时展开，不让长列表占满界面

Command Code 可在弹层和设置页切换固定账户，或查看自动轮换池的健康度。逐账户详情默认折叠，受限周期明确标注。自动轮换模式的用量仍是默认账户，不跟随实际服务中的账户。

支持什么

31 条数据入口，新安装默认开启 11 条。 按使用场景，主要分为：

你想看什么 · 代表提供商

订阅窗口与重置时间 · Kimi、MiMo、Codex、GitHub Copilot、SuperGrok、MiniMax、Z.ai、OpenCode Go、OpenDesign

账号钱包与 API 余额 · DeepSeek API / 账号、SiliconFlow、Novita、Hyperbolic、DeepInfra

套餐、余额与多层预算 · Command Code、NanoGPT、OpenRouter、ZenMux、LiteLLM、APIGOTO

账号级套餐与企业席位 · 火山方舟 Agent Plan / Coding Plan

[查看完整支持清单](#支持的数据--supported-data) · [查看哪些经过真实账号验证](#support-status--实测覆盖)

本插件只显示用量，不注册模型路由。Codex 默认关闭，避免与提供方自带药丸重复；需要统一展示时可手动开启。私有额度接口可能变化，数字仅供参考，不是计费依据。

手动匹配 provider

模型能够调用，但药丸没有显示，可能是模型路由的 provider 名与订阅入口不同。打开 设置 → 订阅用量 → 提供商管理 → 手动匹配 provider：

1. 开启开关（默认关闭）。

2. 在对应订阅项的下拉列表中选择本机已注册的 provider；同一订阅可连续添加多个，适合不同协议或端点拆成多条路由的情况。

3. 选择后立即保存；点击绑定旁的 × 可移除。一个 provider 只能绑定一个订阅，已绑定项不会出现在其他下拉列表中。

只改变药丸显示哪份订阅数据，不改变模型路由、凭据来源、额度查询端点或检测开关。手动绑定优先于内置匹配，未绑定的 provider 继续自动匹配；关闭开关会恢复自动匹配，但保留已保存的绑定。目标订阅仍需启用检测并配置其所需凭据。绑定关系不会校验两个账号是否相同，请选择与该模型实际使用账号对应的订阅。

兼容的插件与路由

以下列出当前代码已适配的插件或工具及具体范围。药丸匹配、登录凭据复用、额度联动是不同能力；支持其中一项不代表接管该插件的登录、账号切换或全部设置，也不代表所有版本均已实机验证。

模型路由与登录凭据

插件 / 工具 · provider → 本插件订阅入口 · 适配范围与条件

dsh-volcengine-provider · volcengine-agent-plan → arkcli-agent-plan；volcengine-coding-plan → arkcli-coding-plan · 自动匹配对应 Agent / Coding 药丸；仅路由别名，不读取该插件账号选择或 OAuth。额度仍使用本插件配置的 IAM AK/SK。

dsh-opendesign-corouter · opendesign-corouter-plan、opendesign-corouter-paid → opendesign · 套餐赠送和付费模型共用 OpenDesign 订阅药丸；不按模型拆分余额，也不读取该插件的登录态。额度仍使用本插件的控制台 Cookie；OpenDesign 检测默认关闭。

@volcengine/ark-plan-api（旧版） · ark-agent-plan-cn → arkcli-agent-plan；ark-coding-plan-cn → arkcli-coding-plan · 保留两条旧国内路由的药丸匹配；额度仍走当前 Ark 订阅入口。

官方 arkcli · arkcli-agent-plan、arkcli-coding-plan、arkcli-agent-plan-team、arkcli-coding-plan-team → 同名入口 · 直接匹配四条路由；个人版与 Team 检测独立，Team 默认关闭；额度需 IAM AK/SK，而非推理 API Key。

@mars-sea/dsh-commandcode-provider · commandcode → commandcode · 复用凭据来源、账户列表与账号切换；支持固定账户和轮换池摘要。自动轮换时的用量不跟随每次请求实际服务账号。

dsh-grok-kit / 官方 Grok CLI · xai-oauth → xai-oauth · 共享 Grok 登录文件；token 过期时可借 dsh-grok-kit 的登录链续约，再读取 X / SuperGrok 额度。

dsh-codex-connect / DSH 内置 Codex 路由 / 官方 Codex CLI · openai-codex → openai-codex · 匹配 Codex 药丸，支持读取 CLI 的 ChatGPT 登录文件；API Key 登录不能读取 ChatGPT 订阅额度。检测默认关闭。

dsh-codex-subscription · 其 OAuth 用于 openai-codex 额度入口 · 优先只读活动账号记录，兼容旧 OAuth 引用；不迁移或续约凭据。不额外假定它注册的模型路由名，名称不同时使用手动绑定。

@inventec/dsh-copilot-auth · github-copilot → github-copilot · 只读该插件写入 DSH 凭据库的 OAuth 记录；登录和续约由提供方负责。检测默认关闭。

OpenDesign 药丸按当前路由标注计费来源：套餐模型显示「使用套餐额度」，付费模型显示「使用余额」；任一套餐窗口确认用尽后，套餐模型也改标「使用余额」，展开药丸可查看续用说明与套餐重置时间。数据过期、缺失或查询失败时，套餐模型显示「计费来源待确认」。原始 opendesign 入口及其他自定义路由不推断模型分类；标注不会改变推理计费或触发余额消费，也不代表余额一定充足。套餐与付费路由仍共享同一份账号用量，展示的套餐窗口不等同于付费模型的余额。

上述火山和 OpenDesign 新别名已根据对应插件源码核对，并通过隔离路由回归；尚未完成安装后的真实 GUI 联调。其他使用标准 provider ID 的模型插件可直接匹配本插件的[支持清单](#支持的数据--supported-data)；自定义名称可使用手动绑定。路由匹配不意味着新增一种额度接口。

额度联动

插件 · 本插件报告入口 · 适配范围

dsh-tool-antigravity · antigravity · 读取其 antigravityAuth 服务的 usage()（QuotaStatusView：Gemini 与 Claude/GPT 两组各带 5h / 周窗口的剩余比例）。选中它的 google-antigravity 模型路由时，输入区药丸直接显示这份额度。

dsh-antigravity-acp · antigravity · 读取其 agyQuota 服务提供的额度快照（分组窗口 + 套餐名 + AI Credits），信息比 antigravityAuth 更全。

dsh-connect-trae · trae、trae-global、trae-enterprise · 国内积分、国际订阅按账号分别读取；企业额度保持不可读说明。

dsh-connect-workbuddy · workbuddy、workbuddy-global · 按区域与账号读取余额；完整积分包只归属已确认的当前账号。

[`dsh

…(truncated)