dsh-budget-view

DSH Budget View

DSH Budget View 是一个 DeepSeek Harness 插件，在输入框下方和新会话页展示：

• Codex 5 小时 / 7 天剩余额度
• OpenCode Go 5 小时 / 7 天剩余额度（读取 OPENCODE_API_KEY 环境变量）
• DeepSeek API 账户余额
• DeepSeek 波峰 / 波谷 状态
• 按 DeepSeek 官方人民币峰谷价估算的本次会话费用

0.4.0 沿用面向 DSH Desktop 0.2.1-rc.2 的原生 Slot、Projection、主题变量和 RPC 接口。配置对应服务的凭据后即可显示额度或余额；启用 dsh-context 后可按请求精确计算 token 与费用。

功能

输入框下方

最左侧显示 DeepSeek 波峰 / 波谷徽标，随后是余额与本次费用：

● 波峰   余额 ¥6.45 · 本次 ≈¥6.10

• 波峰为琥珀色，波谷为绿色；每 30 秒自动刷新
• 悬停可查看北京时间峰谷规则
• 仅 DeepSeek 官方模型显示峰谷徽标
• Codex 模型显示 5h / 7d 剩余额度
• opencode-go 提供商的模型显示 OpenCode Go · 5h 69% · 7d 95%，悬停查看重置时间

新会话页

在工作区、预设模式同一行的右侧显示紧凑胶囊：

• Codex：星标 + 5h 69% + 7d 95%
• OpenCode Go：OpenCode Go + 5h 69% + 7d 95%
• DeepSeek：钱包 + 余额 ¥6.45 + 波峰 / 波谷 徽标
• 支持胶囊 / 纯文本两种样式，紧凑 / 标准两种密度
• 窄窗口自动换行

插件详情设置

打开 设置 → 插件 → dsh-budget-view，在插件详情页调整并自动保存：

设置保存在 $DSH_HOME/storages/dsh-budget-view.json。

OpenCode Go 凭据

在运行 DSH 的环境中设置 OPENCODE_API_KEY，然后完全退出并重新启动 DSH，让 Host 进程读取新的环境变量。Windows PowerShell 可持久化为用户环境变量：

[Environment]::SetEnvironmentVariable('OPENCODE_API_KEY', '你的 OpenCode API Key', 'User')

额度由 Host 使用 Bearer 认证查询 https://opencode.ai/zen/go/v1/usage。接口来源见 OpenCode 官方用量接口 PR。当前响应的 usage.rolling / usage.weekly 对应 5 小时 / 7 天窗口，percent 是已用百分比；插件显示 100 - percent，并兼容旧版 rollingUsage / weeklyUsage 响应。

• Key 只从 Host 的进程环境读取，不写入插件设置，也不会返回浏览器。
• 使用既有刷新间隔，Host 对成功结果缓存最多 30 秒；更换 Key 会使用独立缓存。
• rate-limited 窗口显示 0% 剩余；缺少 Key、认证失败或查询失败时显示 —，悬停查看原因。
• opencode-go 下的 DeepSeek 模型显示 Go 订阅额度，不展示 DeepSeek 官方账户余额或会话费用。

计价规则

费用按 DeepSeek 官方价格页 的人民币价计算（元 / 百万 tokens）：

• 波峰：北京时间周一至周五 9:00–12:00、14:00–18:00
• 波谷：其余时间、周末、中国法定节假日全天
• 调休上班的周六 / 周日仍按官方“周末全天”规则计为波谷
• 内置国务院 2025 年放假通知 与 2026 年放假通知 的完整放假日期
• 可通过设置 JSON 的 cnHolidays 追加日期：

{
  "cnHolidays": ["2027-01-01"]
}

Token 来源

优先读取 dsh-context 的按日 contextActivity 账本，并把节假日工作日的 peak token 重新按波谷价计价；普通工作日继续使用 contextTimeline 的 peak / off 分桶。

如果 dsh-context 不可用：

1. 回退到 contextTimeline.cost（不能重新归类历史节假日）
2. 再回退到 DSH tokenUsage，按当前模型和当前时段估算

费用是估算值，不等同于 DeepSeek 账单。

汇率

仅支持 USD → CNY。fxMode: "auto" 时 Host 从 ECB 参考汇率（Frankfurter）获取，缓存 6 小时；失败时回退到手动备用汇率。设置页显示当前汇率、日期和刷新按钮。

DeepSeek 价格本身为人民币；美元显示按 CNY 成本 ÷ USD→CNY 汇率 计算。

安装

通过插件页面

1. 打开 DSH Desktop 的“插件”页面，添加插件。

2. 输入 npm 包名：

   dsh-budget-view@0.4.0
   

3. 安装后完全退出并重新打开 DSH。

4. 在输入框下方和新会话页查看预算信息。

安装源可选择 npm 官方源或镜像源。镜像同步可能延迟，固定版本可使用 dsh-budget-view@0.4.0。

使用 dsh 命令

先启动一次 DSH Desktop 完成初始化，再完全退出，在终端运行：

dsh plugin --profile desktop add dsh-budget-view@0.4.0

安装后重新打开 DSH。

从 Release 或本地包安装

从 v0.4.0 Release 下载 dsh-budget-view-0.4.0.tgz，在插件页面选择本地安装。也可以使用版本标签：

github:SuShuheng/dsh-budget-view#v0.4.0

本地开发目录可直接添加；安装后同样需要重启 DSH。

从 0.3.1 升级

更新到 dsh-budget-view@0.4.0，设置 OPENCODE_API_KEY 后完全重启 DSH。既有设置会保留；新会话页原来的“Codex 与 DeepSeek”（heroMode: "both"）现在显示全部三项，也可在插件设置中选择“跟随当前模型”或“仅 OpenCode Go”。

兼容性与依赖

• DSH Desktop：0.2.1-rc.2（使用公开 Slot、Projection、主题 token 与 Host RPC）
• dsh-context：可选，建议启用，用于精确 token 与按日峰谷重算
• dsh-codex-auth：可选，用于读取 Codex 凭据；未安装时回退 ~/.codex/auth.json
• 不需要额外 npm 依赖

网络接口：

• Codex：https://chatgpt.com/backend-api/wham/usage
• OpenCode Go：https://opencode.ai/zen/go/v1/usage
• DeepSeek：https://api.deepseek.com/user/balance
• 汇率：https://api.frankfurter.app/latest?from=USD&to=CNY

DeepSeek API Key 通过 DSH credentials 服务读取，Codex 凭据通过 codexAuth 服务或本地 auth.json 读取，OpenCode Go Key 从 OPENCODE_API_KEY 环境变量读取，不会返回给浏览器。

开发与验证

npm run check
npm test

npm test 覆盖：

• 2025 / 2026 国务院节假日与调休上班日
• 波峰 / 波谷边界（9:00、12:00、14:00、18:00）
• 节假日按波谷重算、普通工作日按波峰计算
• cnHolidays 追加日期
• contextActivity / contextTimeline / tokenUsage 三级回退
• CNY / USD 显示
• OpenCode Go 的 Host RPC、Bearer 认证、剩余额度换算、新旧响应、缓存与换 Key
• OpenCode Go 的缺失凭据、认证失败、超时、无效响应及汇总查询隔离
• OpenCode Go 的输入栏、新会话页显示模式、胶囊 / 纯文本及中英文文案

发布前会执行 prepublishOnly 的语法检查与测试。

版本记录

License

MIT © 2026 SuShuheng