dsh-balance-peek
在 DSH 侧边栏底部用两行极简文字显示 DeepSeek 余额与当前峰/非高峰时段。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:QWHYQ114514-cell/dsh-balance-peek#3b1dcb36d3d529406a7db54895ff6b5f56c2737aBalance Peek 以 dsh-balance-peek 发布，当前版本为 2.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →在 DeepSeek Harness 侧边栏底部，用两行极简文字显示 DeepSeek 余额 和 当前峰谷时段。
余额 ¥5.43
空闲 2h14m 后转峰
GET /user/balance，与 DeepSeek 后台「充值余额」一致。DEEPSEEK_API_KEY；没配 key 时退回已登录的 DeepSeek 账号钱包。为什么没有当日花费：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
把 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） |
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