dsh-usage-state
DSH 插件：显示账户余额（API 模式）或当前使用模型的编码计划配额（5h/7d/30d）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-usage-state@0.4.6Usage State 以 dsh-usage-state 发布，当前版本为 0.4.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
中文 | English
发布状态：当前版本 0.4.6，增加 Kimi Code provider 自动用量检测，兼容国内/国际端点和新旧套餐响应。安装包及校验文件见 GitHub Release，详情见 更新日志。
在 DSH（DeepSeek Harness） 输入框上方显示当前模型供应商的账户余额或套餐额度。状态行与输入卡片同宽，保留原生统计行和上下文计量器。
z.ai / GLM · ◔ 5h 12% (4h0m) · ◔ 7d 59% (3d17h)
DeepSeek · ¥58.13
要求：DSH版本满足 >=0.2.0-rc.2 <0.3.0-0，运行预构建插件声明Node≥20，安装到正在使用的 web profile。
从npm安装：
dsh plugin --profile web add dsh-usage-state
# 安装后重启DSH；bundle patch在启动时读取
也可从GitHub安装：
dsh plugin --profile web add github:takboo/dsh-usage-state
本仓库提交预构建产物，供DSH的GitHub安装路径直接使用。浮动GitHub分支可能领先于npm；复现问题时记录安装来源和版本/提交。不要把这一行为推广到所有npm Git安装。
也可通过 dsh-market 搜索 usage state 或 takboo 安装；安装后核对实际来源与版本。本插件已进入 精选列表；目录更新的可见时间取决于所用区域与成功构建。
DSH0.1使用历史版本0.3.2；该版本不适配0.2。0.4.0有RPC挂载缺陷，应升级至最新兼容版。完整版本记录见 更新日志。
高级区提供数据源、端点、凭据名和密钥写入入口。显式provider覆盖优先于旧source默认；凭据描述与读取共用候选顺序，保存优先写显式ref。固定端点不试镜像，配置或凭据身份变化后清除旧身份读数。只读配置与凭据写入权限分别处理，保存/清除过程会显示失败并禁用重复操作。
| 来源 | 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及实例地址 |
Kimi Code 的 kimi-code、kimi-coding、kimi-for-coding provider，以及声明 api.kimi.com / api.kimi.ai 的自定义 provider，会自动读取套餐用量。支持 5h、7d、月总额度及编程月用量，仅展示账户实际返回的窗口。Moonshot 国内/国际 API 继续显示人民币余额；可在设置中显式选择模式。
百分比表示已用。z.ai的key分国内/国际区域；默认国内地址，失败可尝试镜像。当前缓存按数据源与模式合并，不能将不同密钥/实例视为已支持独立多账户。厂商端点、字段和扩展步骤见 适配器指南。
OpenCode Zen Go三个窗口，独立状态行位于输入框上方：
每个provider一行的设置页，以及高级设置：
宿主默认在回合结束2秒后调度刷新，并有5分钟兜底定时器；浏览器每30秒拉取RPC镜像。普通轮询仅在读数缺失或有效身份变化时初始化查询，不把idle查询改成每分钟一次。成功请求的默认最小间隔为60秒，显式刷新可绕过，失败的主动重试不受该成功间隔限制；修改空闲间隔会重调定时器。
插件查询余额/额度并读取当前模型及供应商目录，不写会话日志，也不向第三方上报这些读数。宿主不把已保存的密钥值返回浏览器；用户主动粘贴的草稿经DSH凭据服务写入所用home的凭据文件。环境变量值优先，通常不能在设置页修改。
完整整改状态及验证范围见 待办清单。
开发兼容下界为Node22.18+的22线或Node24.11+；规范构建固定Node 24.21.0（.node-version）和npm 11.19.1（packageManager），高于运行产物声明。基本检查：
npm ci
npm run typecheck
npm run build
npm test
本地profile、watch和HMR前提见 开发指南。按任务查找架构、设计、发布、审计和研究材料见 文档导航。
感谢 dsh-cost-meter（Han-1413141，MIT）提供的数据源行为参考。本实现独立编写；端点、字段语义与兼容陷阱的溯源见 上游分析。宿主平台为DSH，使用其设置、凭据、RPC、插槽和UI原语。