余额速览 QWHYQ114514-cell/dsh-balance-peek

dsh-balance-peek

在 DeepSeek Harness 侧边栏底部，用两行极简文字显示 DeepSeek 余额 和 当前峰谷时段。

余额 ¥5.43 空闲 2h14m 后转峰

- 极简：纯文字，没有图标、没有图表、没有动画。宽栏两行；收起成 56px 窄栏时退化为「¥5.43 / 谷」两格。
- 只读余额：数字来自官方 GET /user/balance，与 DeepSeek 后台「充值余额」一致。
- 零配置：直接复用 DSH 已保存的 DEEPSEEK_API_KEY；没配 key 时退回已登录的 DeepSeek 账号钱包。
- 实时：余额每分钟自动刷新（Host 侧另有 25 秒缓存）；峰/谷状态与倒计时由浏览器本地时钟每秒计算，不产生任何额外请求。
- 点击展开：点这两行会强制刷新余额，并展开明细（当前时段、余额更新时间、数字来源）。

为什么没有当日花费：2.0.0 起移除了该功能。要算准「今日」必须回放当天全部会话日志（一天往往在 DSH 启动之前就开始了），而且仍然统计不到在 DSH 之外用同一把 key 发起的调用——数字天生偏低且容易被误读。余额是官方口径、绝对可靠，所以这个插件只报余额。想看花费请用 dsh-cost-meter 或 DeepSeek 后台的用量页。

安装

从 npm 安装（推荐）
dsh plugin --profile desktop add dsh-balance-peek

从 GitHub 安装
dsh plugin --profile desktop add github:QWHYQ114514-cell/dsh-balance-peek

从本地目录安装
dsh plugin --profile desktop add link:/path/to/dsh-balance-peek

当前版本 2.0.0

把 desktop 换成你自己的 profile 名（Web 版通常是 web）。装好后刷新页面即可看到。

只加依赖是不够的。 DSH 通过 profile 的 dsh.profile.bundles 决定挂载哪些插件；本包在 package.json 里声明了 dsh.bundle.patch，所以只要它在 bundles 列表里就会被挂载。dsh plugin add 会自动把它加进去；如果你手工编辑过 package.json，请确认列表里有 dsh-balance-peek。

卸载：

dsh plugin --profile desktop remove dsh-balance-peek

峰谷规则

按 DeepSeek 官方定价页（模型 & 价格）：

| 时段 | 判定 |
| 高峰 | 北京时间周一至周五（不含中国法定节假日）9:00–12:00、14:00–18:00 |
| 空闲 | 其余全部时段，含周末、调休上班的周末、法定节假日全天 |

高峰单价 = 空闲单价 × 2。插件只显示当前处于哪个时段以及距离切换还有多久，不参与计价。

⚠️ 年度维护：法定节假日清单写在 lib/index.js 与 lib/client.js 的 HOLIDAY_VALLEY 常量里，目前覆盖 2026 年。国务院每年 11 月发布次年安排后需要补录，否则次年的法定节假日会被当成普通工作日显示（只影响显示）。

数据来源

- 余额：调用官方 https://api.deepseek.com/user/balance，凭据来自 DSH 的 credentials 服务；取不到 key 时退回 deepseekAccount.getBalance()（登录账号的钱包）。展开明细里的「来源」会写明这次用的是哪一种。
- 不落盘：插件不写任何文件、不留账本，重启无状态。
- 余额是总额（充值 + 赠送钱包合计，取接口返回的 balance_infos[0]）。如果你的账号同时有赠送额度，这个数与后台单看的「充值余额」可能有差别。

结构

dsh-balance-peek/
├─ package.json 声明 dsh.bundle.patch 与 dsh.client ├─ cordis.patch.yml 把插件插入 profile 的加载树 ├─ lib/ │ ├─ index.js Host 半区：取余额、暴露只读路由（约 280 行） │ └─ client.js 浏览器半区：注册到 sidebar.footer.action 的 React 组件 └─ _tools/ 离线验证脚本（不进 npm 包）

lib/client.js 是手写的 window.__ModuleLoader__.load({ id, factory }) 注册行 —— 这正是 @deepseek-ai/dsh-client-modules 在 /plugins 上提供的、由外壳惰性加载的唯一入口形态。factory 内的 require 走外壳的平台模块表，React 由页面本身提供，因此本插件没有任何构建步骤，两个半区都是可直接阅读的源码。

Host 半区暴露一个只读接口：

GET /dsh-balance/state.json[?refresh=1]

兼容性

| 依赖 | 说明 |
| DeepSeek Harness | 开发与验证于 0.2.0-rc.2（桌面 profile）。用到的服务是 credentials / deepseekAccount / webServer，插槽是 sidebar.footer.action。 |
| 浏览器半区 | 走 dsh.client 客户端模块体系：platform: web |
| Node | ≥ 20（只用全局 fetch 与 node:os） |

安全说明

- 只读接口，没有任何写入能力或设置项，也不写任何文件。
- API key 只在 Host 进程内用于请求官方接口，从不下发到浏览器；发出去的数据只有余额数字和时段状态。
- 请求经过三层校验：回环/同源自检，然后委托 DSH 自己的 connection.requestRejection（含浏览器会话鉴权）。栅栏缺失时自检仍然生效，不会静默放行。确需从别的 Host 名访问（反代/局域网），设 DSH_BALANCE_TRUSTED_HOSTS（逗号分隔 host:port）。

排查

| 现象 | 原因 / 处理 |
| 侧边栏底部什么都没有 | 包名没进 profile package.json 的 dsh.profile.bundles（只 add 依赖不算挂载）。补上后刷新页面。 |
| 显示 未配置 DEEPSEEK_API_KEY… | 该 key 不在 DSH 凭据里，且当前未登录 DeepSeek 账号。到「设置 → 模型」配置 API Key。 |
| 余额是 — | 接口请求失败，展开明细能看到具体错误（HTTP 状态、超时等）。 |
| 数字不刷新 | 插件每分钟轮询一次；点一下那两行可强制刷新。 |
| 与后台「充值余额」对不上 | 接口返回的是总额（含赠送钱包）。展开明细看「来源」，可用 ?refresh=1 强制取最新值。 |

开发

没有构建步骤：直接改 lib/ 下的两个文件，然后刷新页面（客户端半区由 HMR 重新发布）。

仓库自带离线验证脚本（在 _tools/ 中），不依赖浏览器：

node _tools/verify-balance-host.mjs # 数据链路 + 峰谷/节假日/切换点断言
node _tools/verify-balance-client.mjs # 插槽注册契约与两行结构
node _tools/audit-client-quotes.mjs # 手写客户端的引号配平与可解析性

verify-balance-host.mjs 在设有 DSH_BALANCE_VERIFY_KEY 时会真的请求一次官方接口（用来验证凭据链路），未设时只验证降级路径。

许可

MIT