余额小口袋 Li111-div/dsh-balance-pocket

余额小口袋 · Balance Pocket

在 DSH 侧栏底部，随手看一眼 DeepSeek 余额、峰谷时段和今天花了多少。

!

这是什么

一个 DSH（DeepSeek Harness） Web 端插件。它在左侧栏底部（设置按钮旁边）加一个金币图标，点一下向上弹出一个小窗，显示：

- DeepSeek 剩余余额：充值余额 + 赠金，按接口返回的币种显示（¥ / $）；
- 当前是高峰期还是低峰期：按北京时间判定，并显示距离下次切换的倒计时；
- 今日已用：Host 端按余额变化记账得出的真实消费；观测不完整时会标注「自 HH:mm 起观测」。

不新建页面、不占主面板。弹窗打开时每 30 秒刷新一次，也可以手动刷新；关闭弹窗后停止轮询与倒计时，侧栏状态点改为 60 秒低频刷新。
界面的背景、版式和显示项都可以在 设置 → 余额小口袋 里调整，带实时预览，改动立即生效并保存在当前浏览器。

功能特点

| 侧栏入口 | 32×32 金币按钮；宽栏时直接显示余额和峰谷状态点，无需打开弹窗 |
| 向上弹窗 | 贴着侧栏向上弹出，空间不足自动改为向下；点外部 / Esc / 窗口失焦关闭 |
| 峰谷时段 | 周一至周五 09:00–12:00、14:00–18:00 为高峰；周末、法定节假日、夜间为低峰 |
| 今日已用 | 余额是钱包快照而非流水，插件用「当日开盘余额 − 当前余额」观测消费，充值会自动平移不会变成负数 |
| 外观设置 | 跟随主题 / 纯色 / 半透明 / 磨砂 / 透明 / 亚克力；标准 / 紧凑 / 极简三种版式；来源、观测起点、秒数可分别开关 |
| 中英双语 | 跟随 DSH 界面语言实时切换，无需重启 |
| 无构建 | 客户端是手写 React（React.createElement），装好即用，没有打包步骤 |

安装

要求：DSH 桌面端（Web GUI），并且已经登录 DeepSeek 账号或配置了 DEEPSEEK_API_KEY。

方式 A：插件管理器（推荐）

1. 下载或 git clone 本仓库；
2. 打开 DSH 的设置 → 插件，选择安装本地插件，目录指向仓库里的 plugin/；
3. 重载界面（或重启 DSH），侧栏底部出现金币图标。

方式 B：写进 profile 依赖

把下面这行加入 $DSH_HOME/profiles/<profile>/package.json 的 dependencies，然后让插件管理器/包管理器重新安装：

"dsh-balance-pocket": "link:D:/path/to/dsh-balance-pocket/plugin"

发布 GitHub Release 之后，也可以直接装 .tgz：

"dsh-balance-pocket": "https://github.com/Li111-div/dsh-balance-pocket/releases/download/v0.1.0/dsh-balance-pocket-0.1.0.tgz"

发布页同时提供 SHA256SUMS.txt 供校验：把 .tgz 和它下到同一个目录，运行 sha256sum -c SHA256SUMS.txt（Windows 用 certutil -hashfile <文件> SHA256 对比）。

方式 C：开发模式

git clone https://github.com/Li111-div/dsh-balance-pocket.git
在 profile 里 link 到本仓库的 plugin/，改完刷新界面即可

本插件不需要 npm install，也没有构建产物；plugin/ 目录本身就是完整的包。

余额从哪来

| 数据 | 来源 |
| 余额 | ① 已配置的 DEEPSEEK_API_KEY → https://api.deepseek.com/user/balance；② 未配置或失败 → DSH 已登录的 DeepSeek 账号（deepseekAccount.getBalance，充值钱包 + 赠金钱包按币种相加） |
| 峰/谷 | 北京时间：周一至周五（不含中国法定节假日）09:00–12:00、14:00–18:00 为高峰，其余时段为低峰（低峰价 = 高峰价 × 50%） |
| 今日已用 | Host 端按余额观测记账：当日首次观测 = 开盘余额，之后每次观测更新；今日已用 = 开盘 − 当前。跨日重置，不同余额来源/币种分账本 |

余额数据由本机只读路由 GET /dsh-balance-pocket/snapshot 提供，Host 端缓存 20 秒并每 5 分钟后台观测一次。

隐私与安全

- API Key 和账号 token 不会出现在任何响应、日志或 DOM 里。Host 端只在请求 DeepSeek 接口时使用它们。
- 快照路由优先校验回环 Host（localhost / 127.0.0.1 / ::1）与 Origin、Sec-Fetch-Site；
若当前 DSH 提供信任栅栏（connection.requestRejection，它会处理 --trusted-host 与反向代理），非回环请求交给宿主判定，栅栏抛错按拒绝处理（fail-closed）。
- 没有信任栅栏的老版本 DSH，可通过环境变量显式放行 Host： DSH_BALANCE_POCKET_TRUSTED_HOSTS=myhost.lan:8313（逗号分隔）。
⚠️ 一旦放行，同网段任何能访问该地址的设备都能读到余额（充值 + 赠金），请只在可信网络里使用。
- 记账文件位于 $DSH_HOME/dsh-balance-pocket/ledger.json，只保存余额数值和币种，不含凭据。
- 外观设置只写当前浏览器的 localStorage，不上传任何地方。

已知限制

- 「今日已用」只能观测插件运行期间的变化。如果当天插件是中午才第一次取到余额，之前的消费无法追回，界面会写「自 HH:mm 起观测」，不会假装是全天数据。
- 法定节假日表当前覆盖 2026 年（plugin/holidays.js，依据国务院 2026 年放假安排）。国务院每年 11 月公布次年安排；表里没有的年份，插件会在弹窗里明确提示「节假日表未覆盖 YYYY 年」，而不是默默把假期当工作日。
- 网络抖动时会短暂复用上一次成功读数（最多 10 分钟），此时弹窗会标注「数据延迟 N 秒」，不会当成实时值。
- 余额接口是钱包快照，不等于账单；「今日已用」是观测值，存在最多 5 分钟的采样延迟。
- 高峰期价格倍率（2×）只作为提示展示，不参与任何计费计算。

开发

node --version # >= 18
node check.mjs # 自检：72 项，覆盖峰谷边界、节假日表、账本规则、路由与信任栅栏、客户端渲染

项目结构：

plugin/
index.js Host 端：快照路由、余额来源、缓存、后台观测 peak.js 峰谷时段判定（纯函数） holidays.js 中国法定节假日表（按年份，纯数据） ledger.js 余额观测账本（今日已用 / partial / 充值平移 / 分账本） client.js 客户端：侧栏入口 + 向上弹窗 + 外观设置页（手写 React，无构建） cordis.patch.yml bundle patch（含重复挂载守卫） package.json DSH 插件清单 locale/*.json 插件管理器里的标题/描述 icon.svg 图标 check.mjs 本地自检脚本（不属于发布包） docs/DESIGN.md 架构与数据契约

贡献前请阅读 CONTRIBUTING.md；安全问题请按 SECURITY.md 私下报告。

许可证

MIT © 2026 Li111-div

这是什么

一个 DSH（DeepSeek Harness） Web/桌面端插件。它在左侧栏底部加一枚硬币图标——点一下，一个小弹窗会向上弹出，里面显示：

- 你的 DeepSeek 剩余余额（充值 + 赠金，币种与 API 一致）；
- 当前峰谷计费时段（北京时间），以及距离下次切换的倒计时；
- 今日已用，由余额观测推算得出（当天观测不完整时会明确标注「自……起观测」）。

不新增页面，也不接管主面板。弹窗打开时每 30 秒刷新一次；关闭后停止轮询和倒计时（侧栏状态点改为每分钟刷新一次）。背景、布局和显示行都可以在 设置 → Balance Pocket 里配置，带实时预览，按浏览器分别保存。

安装

需要 DSH 桌面端，并具备 DEEPSEEK_API_KEY 凭据或已登录的 DeepSeek 账号。

1. 克隆本仓库。
2. 在 DSH 里打开 设置 → 插件，从仓库的 plugin/ 目录安装本地插件。
3. 重新加载界面。硬币图标会出现在侧栏底部。

也可以把它加到 $DSH_HOME/profiles/<profile>/package.json：

"dsh-balance-pocket": "link:D:/path/to/dsh-balance-pocket/plugin"

或者，在 GitHub 发布之后，使用打包好的 tarball：

"dsh-balance-pocket": "https://github.com/Li111-div/dsh-balance-pocket/releases/download/v0.1.0/dsh-balance-pocket-0.1.0.tgz"

每次发布还会附带 SHA256SUMS.txt：把它下载到 .tgz 旁边，然后运行 sha256sum -c SHA256SUMS.txt 校验。

隐私

- API key / 账户 token 不会出现在响应、日志或 DOM 里。
- 快照路由先检查回环 Host、Origin 和 Sec-Fetch-Site，再交给 Harness 信任围栏（connection.requestRejection，如果存在的话）；围栏抛错时按失败关闭处理。
旧版 Harness 没有围栏，可用 DSH_BALANCE_POCKET_TRUSTED_HOSTS 显式放行某个局域网主机——这样做等于把余额暴露给网络里任何能访问该地址的人。
- 账本只存金额和币种（$DSH_HOME/dsh-balance-pocket/ledger.json）。
- 外观偏好保存在浏览器的 localStorage 里。

已知限制

- 今日花费只能覆盖插件在观察的那段时间。 当天首次读数来得晚，会标注「observed since …」，绝不当作全天数字展示。
- 法定节假日日历只覆盖 2026 年（plugin/holidays.js）。遇到未覆盖的年份，弹层会明确说明，不会悄悄把节假日当成工作日。
- 刷新失败后复用的缓存读数（最多 10 分钟）会标注它的时效。
- 余额 API 是钱包快照，不是账本，所以今日花费最多滞后一个 5 分钟采样间隔。2× 峰值倍率仅用于展示。

开发

node check.mjs # 72 checks: peak boundaries, holiday table, ledger rules, route + trust fence, client rendering

没有构建步骤：plugin/client.js 是手写的 React，通过 DSH 的模块加载器加载。

许可证

MIT © 2026 Li111-div