前言¶

用 DeepSeek Harness（DSH）做日常对话或智能体开发时，账户余额和当前是否处于峰时计费，往往要切到设置页或打开官网定价页才能确认。侧栏底部本来只有头像与账号入口，没有现成的「钱包 + 计费窗口」展示位。

dsh-balance-chip 是 HugePaint 维护的 DSH 客户端插件：在侧栏 footer 增加两行只读信息——实时余额，以及按 DeepSeek 规则计算的峰时 / 谷时与窗口结束时间。它不替换内置 UI，而是注册到 sidebar.footer.action 列表插槽。

这是什么¶

• 名称：dsh-balance-chip（npm 包名与仓库名一致）
• 维护者：HugePaint（作者 Ivan Chen）
• 分类：客户端插件（platform: web）
• 许可证：MIT（当前包版本 1.2.0）
• 目录页：https://www.skillhub.cn/plugins/HugePaint/dsh-balance-chip
• 源码：https://github.com/HugePaint/dsh-balance-chip

插件在头像 / 账号行上方依次插入「余额行」和「计费窗口行」，与内置账号入口同处侧栏左下角区域。

核心功能¶

余额行¶

• 数据来源与「设置 → 账户」相同：通过现有 account Remote 的 getBalance 与 watch。
• 展示主钱包总额；若有赠送钱包，以 +¥0.50 形式追加。
• 金额保留到分、带千分位；不足一分显示 <¥0.01。
• 读取失败时保留上次数字，避免整行空白。
• 点击打开账户状态流提供的用量页面 URL。

计费窗口行¶

• 按 DeepSeek 公布的规则，在北京时间（UTC+8）下本地计算，不依赖本机时区设置；非 UTC+8 环境会在行前加 Beijing 前缀，悬停时附带本地等价时间。
• 峰时（Peak，琥珀色）：周一至周五 09:00–12:00、14:00–18:00，不含中国法定节假日。
• 谷时（Off-peak，绿色）：其余时段；谷时价格为峰时的一半（说明见官方定价页）。
• 行内显示当前状态及结束时间，例如 12:00、tomorrow 09:00、Mon 09:00、Mar 3 09:00。
• 悬停显示三行简短说明：状态与倒计时、原因（峰时窗口 / 周末 / 法定假日）、定价说明与点击行为。
• 点击打开官方定价页（默认 https://api-docs.deepseek.com/quick_start/pricing，可在配置中改 pricingUrl）。
• 2026 年法定假日表内置在 lib/client.js 的 HOLIDAY_TABLE；未覆盖年份回退为仅按工作日规则判断，并在悬停中提示。

交互与边界状态¶

• 侧栏收起时：余额行只显示金额；计费行只显示 Peak / Idle（文档中的 collapsed 表述）。
• 加载中、未登录、无钱包、读失败等每种状态都有可见文案（如 …），避免与「插件未加载」混淆。

实现要点（便于评估信任边界）¶

• 客户端 lib/client.js 负责渲染与本地计费判断；主机侧 lib/index.js 仅为加载探测，无业务逻辑。
• 除点击时用 window.open(url, "_blank", "noopener,noreferrer") 打开外链外，插件本身不发额外网络请求、不持有凭据。
• 颜色使用 --dsw-alias-* 主题 token，适配明暗主题。

安装与启用¶

要求：DSH 0.2.x。开发对齐版本为 DSH 0.2.0-rc.2 与 @deepseek-ai/cordis 4.0.4。

插件面板（推荐）¶

该包为普通 DSH npm 插件，由插件管理器识别为 profile bundle：

1. 打开 Plugins 面板 → Add plugin → Install third-party plugin
2. 输入以下任一标识：
   - dsh-balance-chip（发布到 npm 后可用）
   - 本地检出目录的绝对路径，例如 C:\Users\you\GitHub\dsh-balance-chip
   - 打包 tarball 的绝对路径，例如 C:\Users\you\Downloads\dsh-balance-chip-1.2.0.tgz
3. 按提示刷新或重启 DSH。

DSH 会把包记入该 profile 的 dsh.profile.bundles；包内 cordis.patch.yml 的 insert 会注册 balance-chip，一般无需手改 profile。目录安装为链接形式，需保留源码目录；.tgz 安装会解压到 profile 内，可删除原压缩包。

生效方式：先在窗口内按 Ctrl+R / Cmd+R；若不够，完全退出并重新打开 DSH（macOS 需 ⌘Q 退出进程，仅关窗口不够）。

遗留脚本安装（需 Python 3，不推荐）¶

未走插件面板时，可用仓库内安装脚本（会复制文件并改 cordis.patch.yml，但不写入 dsh.profile.bundles，后续面板执行 pnpm 可能把包 prune 到 node_modules/.ignored/ 导致插件静默消失）：

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

常用参数：

python3 install.py --list           # 列出检测到的 profile，不修改
python3 install.py --profile web    # 安装到指定 profile，可重复执行
python3 install.py --uninstall      # 移除 patch 条目，保留包目录
python3 install.py --purge          # 同时删除包目录

从 release zip 安装：解压 dsh-balance-chip-<version>.zip 后，在目录内执行上述命令。

智能体协助安装可参考仓库中的 AGENT-INSTALL.md（含环境检查、离线校验、回滚等）。

配置（可选）¶

cordis.patch.yml 里 balance-chip 条目的 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/quick_start/pricing"

典型用法¶

安装并刷新 DSH 后，无需额外命令：侧栏底部应出现两行 chip。日常只需扫一眼余额与当前峰 / 谷；需要充值或查账单时点余额行；核对官方价格时点计费行。

若你自定义峰谷窗口或补充假日，在 profile 的 patch 中按上一节修改 config 后重启或刷新客户端。

适用场景与注意¶

适合：长期在 DSH 桌面端使用 DeepSeek API、希望在不离开主界面的情况下掌握余额与计费时段的开发者或重度用户。

注意：

• 插件以当前 DSH 进程权限运行，安装前请阅读源码与 MIT 许可证，确认接受其读取账户 Remote 与打开外链的行为。
• 峰谷规则与定价以 DeepSeek 官方文档 为准；插件内置规则可能滞后于官网变更。
• 社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；本插件亦非官方应用商店预装项。

结尾¶

dsh-balance-chip 用两行侧栏 footer 信息，把余额与北京时间下的峰谷计费窗口接到 DSH 内置账户数据流上，计算在本地完成，点击才跳转用量页与定价页。需要安装步骤与配置细节时，以仓库 README 与 README.zh.md 为准。

• 目录页：https://www.skillhub.cn/plugins/HugePaint/dsh-balance-chip
• GitHub：https://github.com/HugePaint/dsh-balance-chip