实时余额 · Real-time balance

仓库：

DeepSeek Harness 侧栏底部的实时余额卡片：今日花费、账户余额、高峰/低谷时段和切换倒计时。

个人插件，与 DeepSeek 官方无关。余额数据来自本机已登录的 DeepSeek 账户（Harness 的 remote.account），插件不读取、不保存任何密钥。

功能

今日实时花费：按当天观察到的余额下降累计，充值/退款不会计入。
实时余额：充值余额 + 赠送余额；每 30 秒自动刷新，窗口重新聚焦时刷新，也可以点余额右侧的刷新按钮。
价格时段：低谷 / 高峰状态、低谷 5 折标签、24 小时时间轴和当前时刻游标。
两个倒计时：距下一次高峰、距下一次低谷，每秒更新。
跟随主题：全部颜色使用 --dsw-alias-* 主题 token，深色/浅色主题自动适配。
中英文：文案走 Harness locale。
收起侧栏：退化为 36px 图标按钮，悬停显示摘要。

界面示意

┌────────────────────────────┐
│ 今日                  ¥0.00 │
│ ────────────────────────── │
│ 余额                  ¥6.77 ⟳│
│ ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬ │
│ ● 低谷  5折                 │
│ 距高峰 14小时30分  距低谷 … │
└────────────────────────────┘

数据口径

余额：通过 ctx.remote.account.getBalance() 读取已登录 DeepSeek 账户的充值余额和赠送余额，可选依赖，未登录时余额显示 —，价格时段照常显示。
今日花费：从卡片第一次读到余额开始，累计当天余额的下降；充值导致余额上升不计入花费。首次安装之前当天已经花掉的部分无法从余额接口还原，因此首次运行从 ¥0 开始。
本地状态：localStorage 键 dsh.realtime-balance.ledger.v1，按北京时间日期每天重置。
价格规则：
- 高峰：北京时间周一至周五 09:00–12:00、14:00–18:00，不含中国法定节假日。
- 低谷：其余全部时间（含周末和法定节假日全天），价格为高峰的 50%。
- 已内置 2026 年落在工作日的法定节假日；未覆盖年份按工作日估算，并在悬停提示中说明。
- 规则来源：DeepSeek 官方价格页。

兼容性

需要 DSH 0.2.x；在 0.2.2-rc.1（macOS）实测可用。
需要已登录 DeepSeek 账户才能显示余额；仅配置 API Key 时仍显示价格时段。
纯 Web 客户端插件，无原生依赖、无构建步骤；macOS 已实测，Windows 理论通用（未在 Windows 实机验证）。

安装（Windows）

DSH Desktop（Electron 版）

打开 DSH，进入 设置 → 插件。
在安装输入框粘贴仓库地址：https://github.com/sakura6777/dsh-real-time-balance。
安装完成后刷新页面。侧栏底部、账户行上方会出现「今日 / 余额」卡片。

desktop 配置档由 Electron 独占，命令行安装会被拒绝，桌面版请走界面。

CLI / dsh web

dsh plugin --profile web add https://github.com/sakura6777/dsh-real-time-balance

然后重启 dsh web，或刷新页面。首次从 GitHub 安装需要网络和 pnpm；本插件没有 install / build 脚本，不需要编译。

更新与卸载

更新：重新执行安装，或在插件页移除后重新安装。
卸载：设置 → 插件 找到「实时余额」→ 移除。

文件结构

.
├── package.json        # bundle + client 清单
├── cordis.patch.yml    # 插入 real-time-balance 插件行
├── index.js            # Host 半边（空实现）
├── client.js           # 浏览器端单文件模块（预构建，无需编译）
├── locale/
│   ├── zh.json         # 插件市场标题/描述
│   └── en.json
└── icon.svg

开发

client.js 是提交进仓库的预构建浏览器模块，格式为 window.__ModuleLoader__.load(...)，React 从 Harness 的浏览器模块表获取。修改 client.js 后刷新页面即可，无需构建步骤。

样式只使用 --dsw-alias-* 主题 token，不依赖 Harness Client 包。

License

MIT

@local/real-time-balance

Install

README