dsh-usage-state

中文 | English

版本说明：0.4.5 包含此前的余额解析、凭据覆盖、缓存隔离和失败展示修复，详情见 更新日志。使用0.4.4及更早版本的用户请升级至0.4.5或更新的兼容版本。

在 DSH（DeepSeek Harness） 输入框上方显示当前模型供应商的账户余额或套餐额度。状态行与输入卡片同宽，保留原生统计行和上下文计量器。

z.ai / GLM · ◔ 5h 12% (4h0m) · ◔ 7d 59% (3d17h)
DeepSeek · ¥58.13

功能

• 已识别的供应商默认使用“自动”，复用DSH已有凭据；每个provider配置一次，模型列表用于参考。
• 显示余额、已用百分比、重置倒计时和SVG进度环；默认≥80%琥珀、≥95%红，可调整阈值和隐藏进度环。
• 同一有效账户身份的源请求失败时保留上次成功读数并标记陈旧、年龄和原因；RPC传输失败也会明确标出旧值。
• 悬停查看数据源、模式、重置时刻及余额构成；中英界面跟随DSH语言设置。
• 只显示账户当前读数，不做成本归因、价格目录、预算或历史账单。

安装

要求：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挂载缺陷，应升级至最新兼容版。完整版本记录见 更新日志。

快速开始

1. 打开 设置→用量状态，查看供应商、模型和检测到的数据源。
2. 对已识别供应商保留“自动”，或选择其支持的API、Coding Plan、隐藏。
3. 自建Sub2API在高级区填写实例地址；已配置模型的当前读数显示在输入框上方。
4. “立即刷新”用于主动查询；出错先查看设置页原因及 排查指南。

高级区提供数据源、端点、凭据名和密钥写入入口。显式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及实例地址

百分比表示已用。z.ai的key分国内/国际区域；默认国内地址，失败可尝试镜像。当前缓存按数据源与模式合并，不能将不同密钥/实例视为已支持独立多账户。厂商端点、字段和扩展步骤见 适配器指南。

截图

OpenCode Zen Go三个窗口，独立状态行位于输入框上方：

每个provider一行的设置页，以及高级设置：

刷新与凭据

宿主默认在回合结束2秒后调度刷新，并有5分钟兜底定时器；浏览器每30秒拉取RPC镜像。普通轮询仅在读数缺失或有效身份变化时初始化查询，不把idle查询改成每分钟一次。成功请求的默认最小间隔为60秒，显式刷新可绕过，失败的主动重试不受该成功间隔限制；修改空闲间隔会重调定时器。

插件查询余额/额度并读取当前模型及供应商目录，不写会话日志，也不向第三方上报这些读数。宿主不把已保存的密钥值返回浏览器；用户主动粘贴的草稿经DSH凭据服务写入所用home的凭据文件。环境变量值优先，通常不能在设置页修改。

已知限制

完整整改状态及验证范围见 待办清单。

• 旧版npm0.4.4及更早版本：仍有provider凭据覆盖、pin/缓存身份、legacy隐藏、默认排序和失败展示缺陷；Moonshot≥100元仍会被除以100，DeepSeek非法金额仍可能变0。这些已在0.4.5修复；使用旧版请升级。旧版金额应与 官方接口 核对。
• 账户范围：仍按source+mode选择一个目标；配置身份隔离不等于新增独立多账户支持。
• 未验证范围：Kimi Code/Sub2API真实账户、高阈值视觉、真实凭据写入和OpenCode非零路径仍缺活体验证；本地交互测试不代替这些验收。
• 范围：无模型选择或隐藏时可以不显示；点击状态行不打开设置；不保存历史读数。

开发与文档

开发兼容下界为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原语。

MIT。问题和署名建议通过 Issues 提交。