dsh-balance-chip

侧边栏左下角的两行：实时账户余额，以及当前 DeepSeek 计费时段（高峰 / 空闲）和它几点结束。

English · Agent 安装指南 · MIT 许可

┌─ 侧边栏底部 ─────────────────┐
│  余额                   ¥12.34 │  ← 余额行
│  空闲            09:00 结束    │  ← 峰谷时段行
│  🟣 账号                       │  ← 既有账号行
└──────────────────────────────┘

余额行在头像 / 账号行的正上方，峰谷行紧随其下。两行都注册在 sidebar.footer.action（kind: list）里，不改动、不包裹任何既有界面。

> 为什么不在头像行里：头像行是 settings.trigger，kind: single，已被 dsh-client-ui-settings-general 独占。可用的最近插槽是它上方的 sidebar.footer.action。

显示什么

每个状态都渲染可见内容 —— 读取中 …、未登录、没有钱包、读取失败 —— 所以「插件没加载」和「加载了但没数据」永远不会看起来一样。

计费时段

峰谷行照搬 DeepSeek 公开规则，按北京时间（UTC+8）：

• 高峰：周一至周五 09:00–12:00、14:00–18:00，不含中国法定节假日；
• 空闲：其余全部时段 —— 12:00–14:00、18:00 之后、周末与法定节假日全天；
• 空闲价格为高峰的一半。

来源：模型 & 价格（中文） · Model & Pricing (EN) · 2026 年放假日期依据国务院办公厅关于 2026 年部分节假日安排的通知（国办发明电〔2025〕7号）。价格与时段可能调整，以官方页面为准。

判断是纯本地算术（Date.now() + 上面的规则），全程按北京挂钟计算，因此结论与机器时区无关。机器不在 UTC+8 时，行内会加上 北京 前缀，悬停里另给本地时间。

节假日表编译在 lib/client.js 的 HOLIDAY_TABLE，当前收录 2026 年。调休上班的周末仍按周末计，所以不需要单独维护调休表。表外年份（如 2027 年通知尚未发布时）退化为「只看工作日」，并在悬停里标注。

安装

需要 DSH 0.2.x。推荐走插件面板（不需要 Python）；下面的脚本方式是可选的旧路径。

从插件面板安装（推荐）

本包是一个标准 DSH npm 插件，已被 DSH 的插件管理器识别为 profile bundle：

1. 打开 插件 面板 → 添加插件 → 安装第三方插件
2. 在「包名或地址」里填下面任一条：
   - dsh-balance-chip —— 发布到 npm 之后可用
   - 仓库目录的绝对路径，如 C:\Users\你\GitHub\dsh-balance-chip
   - 打包文件的绝对路径，如 C:\Users\你\Downloads\dsh-balance-chip-1.2.0.tgz
3. 安装后按提示刷新或重启 DSH。

DSH 会把包名写进该 profile 的 dsh.profile.bundles，再由包内 cordis.patch.yml 的 insert 注册 balance-chip 条目 —— 不需要手工改任何配置文件。用目录形式安装时 pnpm 记录的是链接，源目录要保留；用 .tgz 则解包复制，源文件删掉也不影响。

交给 AI 助手

把仓库（或 Release 里的 zip）交给你的助手，让它读 AGENT-INSTALL.zh.md。那份指南覆盖环境检查、离线校验、安装、激活、回报、排查、回滚，以及没有 Python 时的手动路径。

手动安装（旧方法）

需要 Python 3。这条路径把包直接复制进 node_modules 并手改 profile 的 patch，没有把包声明成 profile 的依赖：之后用插件面板安装别的插件时，pnpm 会把它当作多余包清理掉（会移进 node_modules/.ignored/），插件就静默消失。除非有特殊理由，请用上面的插件面板。

python3 install.py          # macOS / Linux
python install.py           # Windows

脚本扫描 $DSH_HOME/profiles/*（默认 ~/.dsh/profiles），把 4 个文件复制进 /node_modules/dsh-balance-chip/，并在该 profile 的 cordis.patch.yml 末尾追加一条 insert 条目。不碰 profile 的 package.json 与 dsh.profile.bundles，不联网，幂等。

python3 install.py --list           # 只看检测到哪些 profile，不改动
python3 install.py --profile web    # 只装一个 profile（可重复）
python3 install.py --uninstall      # 摘掉条目，保留包目录
python3 install.py --purge          # 连包目录一起删

让它生效：先在窗口里按 Ctrl+R / Cmd+R；不够就完全退出 DSH 再打开（macOS ⌘Q，关窗口不退进程）。

用 Release 的 zip：解压 dsh-balance-chip-<版本>.zip，在目录里跑同一条命令。

配置

条目 config 全部可选；任何一项写错都退回默认值，不会让整行消失。

- insert:
- id: balance-chip
name: "dsh-balance-chip"
config:
windows: ["09:00-12:00", "14:00-18:00"]   # 北京时间；也可写 [[540,720],[840,1080]]
weekdays: [1, 2, 3, 4, 5]                 # 视为工作日的星期（0 = 周日）
holidays: ["2027-01-01", "2027-02-06"]    # 追加放假日，与内置表取并集
ignoreHolidays: false                     # true = 完全忽略节假日
zoneOffsetMinutes: 480                    # 规则所在时区
pricingUrl: "https://api-docs.deepseek.com/zh-cn/quick_start/pricing/"

实现要点

• 两端各一半。 lib/client.js 是浏览器端：渲染两行、走现成的 account Remote 取余额（getBalance 取值、watch 取登录态与用量地址）、本地推算时段。lib/index.js 是宿主端 —— 加载器也会在宿主侧 import 每个包，它只带一个加载探针。
• 一个插槽，用 order 定序。 余额 order: 10、峰谷 order: 20，同在 sidebar.footer.action（kind: list、scope: root）。
• 纯函数 + 薄组件。 periodAt / describeChip 无副作用，通过 exports.period 导出；组件只负责把字符串画出来。加载器只读 apply / inject，多导出不影响加载。
• list 插槽必须带 id。 少了会在运行时抛 list slot ... requires options.id，表现为「插件已启用但界面无痕」。
• inject 必须写全：["slots", "locale", "remote", "remote.account"]。cordis 只把已声明的服务挂到 ctx，访问未声明的会直接抛错（不是返回 undefined）。
• 不联网、不读凭据、无宿主业务代码。 唯一外发动作是点击时的 window.open(url, "_blank", "noopener,noreferrer")；宿主端唯一的写入是 try/catch 里的 /tmp 加载探针。
• 只走主题 token（--dsw-alias-*），明暗主题都跟。
• 启用条目必须写成 insert 形式。 裸条目（- id: X）在 patch 语义里是「覆盖已有条目」，本包不在任何 bundle 里，那样写不会被加载。

悬停说明

悬停用原生 title，按行组织（\n 分隔，Chromium 渲染成多行），每行只说一件事、都不长（实测最长 32 字，上界卡在 44）：

空闲时段 · 明天 09:00 结束（还有 13 小时）
高峰窗口：工作日 09:00–12:00、14:00–18:00
空闲价格为高峰的一半 · 点击查看计费说明

行序固定为 现状 → 依据 →（补充）→ 价格与入口；余额行的悬停是两行（金额 + 入口），失败原因单独一行。aria-label 另给单行版本，读屏不会被价格说明和入口打断。

刷新时机

余额只在消耗 token 时变化，所以不做真正的「推送」；这套组合的效果是回到应用、跑完一轮后数字已是最新。

兼容性

针对 DSH 0.2.0-rc.2 + @deepseek-ai/cordis 4.0.4（本机桌面版实际版本）开发。包本身不声明任何 @deepseek-ai/dsh* peer 依赖，所以不会被 DSH 的兼容性闸门拦住；运行时需要的是 sidebar.footer.action 插槽与 slots / locale / remote.account 三个服务。

开发与测试

node test-client.cjs .                       # 余额行，假 Remote，不需要浏览器
node test-peak.cjs .                         # 时段推算、文案、悬停排版
TZ=Pacific/Kiritimati node test-peak.cjs .   # 换时区应得到同一份结论

两套测试全部离线：自搭最小 React hooks 运行时、假 ctx、假 account Remote。test-peak.cjs 覆盖窗口边界、跨夜、跨周末、2026 年每个假期块、config 回退与悬停行长度，并打印一行 SCHEDULE-FINGERPRINT，该行在不同时区下必须逐字相同。

版本

包内文件

署名

由 Ivan Chen 与 HugePaint 构建。

非 DeepSeek 官方项目。显示的时段与价格来自 DeepSeek，插件只在本地复现公开规则。

许可

MIT © 2026 Ivan Chen, HugePaint