用量计费面板 Hann428/dsh-hann-usage-dashboard

dsh-hann-usage-dashboard

DeepSeek Harness Web 的 DeepSeek 用量与计费面板。

它会在会话视图里加一个紧凑的 Usage 标签页。标签页展示 DeepSeek 账户余额、当前官方峰谷价格、下一次价格时段切换倒计时，以及 DeepSeek 平台用量页面的直达链接。

从 GitHub 快速安装

在桌面应用的 Add plugin 对话框里，输入完整仓库 URL：

https://github.com/Hann428/dsh-hann-usage-dashboard

下面这条命令会安装到 Web 配置档：

dsh plugin --profile web add github:Hann428/dsh-hann-usage-dashboard

重启 dsh web，然后打开任意会话，选择 Usage 标签页。

桌面应用安装后需要重启应用。这个仓库通过 GitHub 分发；不要把裸 npm 包名当作安装源。

从旧名称升级

0.0.3 版本把仓库、包、客户端模块和 Usage 标签页注册从 dsh-usage-dashboard 改名为 dsh-hann-usage-dashboard。安装这个版本前，先在同一个 Harness 配置档里卸载旧插件，然后重启 Harness。两个版本同时启用会产生重复的 Usage 标签页和余额工具。

在同一个浏览器源下，新存储键不存在时，已保存的告警阈值会从旧存储键复制过来。从 Web 应用换到桌面应用可能使用不同的源，如有需要请重新输入这些设置。API key 仍保存在 Harness 凭据里，这次迁移不会复制。

要求：

- 支持插件的 DeepSeek Harness Web。
- 在 Harness Settings -> Models 里配置好 DEEPSEEK_API_KEY 凭据。
- 能访问 https://api.deepseek.com 和 DeepSeek 官方价格文档。

中文简述：这是一个 DeepSeek Harness 用量面板插件，会在会话页添加“用量”标签页，展示账户余额、官方峰谷价格、切换倒计时、平台用量页入口，并提供可本地保存的余额告警灯设置。

功能

- 从 DeepSeek 官方 GET /user/balance 接口获取账户余额。
- deepseek-flash（DeepSeek-V4.1-Flash）和 deepseek-v4-pro 的当前官方价格。
- 按 DeepSeek 当前北京时间规则判断峰谷状态：高峰时段为周一至周五 09:00-12:00 和 14:00-18:00；周末及其他所有时段为低谷。
- 下一次峰谷切换的实时倒计时。
- Usage 标签页标签上的紧凑余额健康灯：可用时显示绿色，余额低于已启用的金额或百分比告警阈值时显示橙色，两个开关都关闭时显示暗色中性。
- 金额和百分比告警阈值的行内开关与输入框。数值保存在浏览器 localStorage 里，并立即更新标签灯。
- 宿主侧处理 API key：浏览器只收到查询结果，永远拿不到 key。
- 可选的 dev_usage_balance 工具，供智能体查看余额和价格数据。

配置

插件默认使用标准的 DEEPSEEK_API_KEY 凭据引用。

- id: dsh-hann-usage-dashboard
name: dsh-hann-usage-dashboard
config:
keyRef: DEEPSEEK_API_KEY
baseURL: https://api.deepseek.com
platformUsageURL: https://platform.deepseek.com/usage
timeoutMs: 10000
healthCurrency: CNY
alertBalance: 50
alertBalancePercent: 20
balancePercentBase: 100

在 Harness Settings -> Models 里配置密钥。插件通过 Harness credentials 服务读取凭据。

alertBalance 和 alertBalancePercent 是可选默认告警阈值。Usage 面板也提供行内的金额与百分比输入框；这些浏览器本地值会立即覆盖标签页上显示的红灯。把任一阈值设为 0，或把面板输入框留空，即可关闭该项检查。balancePercentBase 是用户自定义的金额，在百分比检查中视为 100%。

说明

- 版本 0.0.5 跟随 Harness 的浅色/深色主题配色，并新增可操作的认证错误，其中会给出凭据来源，但不暴露其值。
- HTTP_401 表示 DeepSeek 拒绝了余额请求所用的密钥。请在 Harness Settings -> Models 中更新 DEEPSEEK_API_KEY，然后刷新 Usage。继承自环境的密钥优先级高于已保存的密钥；如果来源是 env，请更新该环境变量并重启 Harness。第三方网关的密钥无法通过 DeepSeek 官方余额端点认证。
- DeepSeek 平台页面的登录与 Harness 相互独立。「open usage page」链接可能需要浏览器登录。
- 价格表在运行时从 DeepSeek 官方文档拉取，因此价格变动在刷新后即可反映。
- DeepSeek 2026-09-10 的价格文档把 deepseek-flash 列为推荐的 Flash 模型名。在文档所述的过渡窗口期内，旧名 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 会路由到 DeepSeek-V4.1-Flash。
- 如果无法访问或解析文档页面，余额仍会正常渲染，价格行则报告定价错误。

开发

pnpm install
pnpm run typecheck
pnpm run build:client
node scripts/check-rename.mjs
node scripts/check-authentication.mjs

对照已安装的桌面配置档检查宿主导入，不使用旧版依赖别名：

node scripts/check-installed-import.mjs "$env:USERPROFILE\.dsh\profiles\desktop"

构建产物 lib/ 文件已提交，因此从 GitHub 源码安装时无需本地构建步骤。