前言¶
在 DeepSeek Harness（DSH）里写提示、选模型时，账户里还剩多少钱、当前算不算高峰价，往往要另开页面或去平台查。高峰与低谷价差可达一半，批量跑任务时若不清楚时段，成本不好预估。dsh-balance 是社区客户端插件，把余额和 DeepSeek 峰谷计费状态放进输入框工具行，与模型选择器并排，减少来回切换。
下面介绍插件定位、能力、安装条件与注意点。插件以你当前 DSH profile 的进程权限运行，安装前建议浏览源码与 MIT 许可证；DSH 社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
@cy2s1ne/dsh-balance（npm 包名，GitHub 仓库 Cy2s1ne/dsh-balance）由维护者 Cy2s1ne 发布，分类为客户端插件。当前 package.json 版本为 0.2.0，要求 DSH >=0.2.0-rc.1、Node >=20.0.0。
一句话：在输入框工具行（模型选择器旁）实时显示 DeepSeek 账户余额与当前峰谷计费时段；点击可展开明细。数据来自 DSH 内置 deepseekAccount 服务，不在浏览器里直接持凭证访问平台。
核心功能¶
工具行胶囊¶
胶囊上显示主钱包余额（人民币优先）。左侧状态灯表示 DeepSeek 当前峰谷计费时段（不是余额查询是否成功）：
| 颜色 | 含义 |
|---|---|
| 绿色 | 低谷价（高峰价的 5 折） |
| 琥珀 | 高峰价（标准价） |
胶囊内另有「低谷 / 高峰」文字标签。悬停或展开面板可看当前时段、下次切换时间与倒计时。
峰谷规则自 2026-08-17 起按 DeepSeek 官方价目表 判定，时区固定 UTC+8，不随浏览器时区变化：
- 高峰：北京时间周一至周五（不含中国法定节假日）9:00–12:00、14:00–18:00
- 低谷：其余时段（含周末、调休上班的周末、法定节假日全天）
节假日表内置在 client.js 的 HOLIDAY_RANGES，已覆盖 2026–2027；未覆盖年份仅按工作日 + 时段判断，周末仍按低谷处理。
余额查询失败时，状态灯外圈会出现红色描边，峰谷底色仍保留，两种信号互不覆盖。
明细面板¶
点击胶囊展开：
- 当前计费时段、下次切换时间与倒计时
- 充值余额（各币种）
- 赠送额度（若平台有下发）
- 用量明细 / 去充值入口
- 最近更新时间
刷新策略：每 20 秒自动刷新；标签页重新可见时立即补一次；打开面板时强制刷新。未登录、服务缺失、查询失败会降级为可读提示，不会让输入框报错。
数据链路与安全¶
浏览器不直接访问 DeepSeek 平台接口，凭证只在宿主侧：
浏览器余额胶囊
└─ GET /api/dsh-balance （本插件宿主端注册的只读路由，仅回环可访问）
└─ ctx.deepseekAccount.getState() / getBalance()
└─ DeepSeek 平台账户接口
宿主端 15 秒缓存与单飞合并，上游查询 10 秒超时。接口只读、响应不含 token；仅接受回环地址（127.0.0.1 / ::1）请求，未走 DSH 令牌鉴权，姿态与同类插件（如 dsh-mcp-manager）一致。
前置条件¶
插件读取 DSH 内置 deepseekAccount 服务，必须在 DSH 中 登录 DeepSeek 账号（平台会话）。
只配置 DEEPSEEK_API_KEY、未在 DSH 里登录账号时，胶囊会显示「余额未登录」——这是预期行为，不是故障。
安装与启用¶
将 <你的profile名> 换成实际 profile。
从 GitHub 安装（推荐）¶
dsh plugin --profile <你的profile名> add github:Cy2s1ne/dsh-balance
从 npm 安装¶
dsh plugin --profile <你的profile名> add @cy2s1ne/dsh-balance
本地源码安装（开发）¶
link: 会把目录软链进 profile，源码改动立即生效：
dsh plugin --profile <你的profile名> add link:/绝对路径/dsh-balance
安装后刷新浏览器页面即可看到胶囊。首次加载余额可能短暂延迟，胶囊会先显示「余额 …」。
卸载：
dsh plugin --profile <你的profile名> remove @cy2s1ne/dsh-balance
典型用法¶
日常使用无需额外配置：登录 DeepSeek 账号并安装插件后，在输入框工具行观察胶囊颜色与余额即可。需要明细、充值或用量时点击胶囊展开面板；利用绿色低谷时段安排大批量调用，可对照官方价目表与面板上的切换倒计时。
维护者本地验证峰谷逻辑可执行：
npm test
测试从 client.js 的 pricing 区域提取规则，覆盖工作日、周末、节假日边界与下次切换点，不依赖浏览器或余额接口。
适用场景与注意¶
适合：长期在 DSH Web 客户端写提示、调模型，希望成本和峰谷时段一眼可见的用户；已使用 DSH 平台账号登录、而非仅 API Key 的场景。
注意：
- 插件随当前 DSH 进程运行，安装前请自行审阅 仓库源码 与 MIT 许可。
- 余额查询为外部网络请求，受缓存与超时策略影响。
- 若需收紧
/api/dsh-balance访问方式，可按 README 说明改为经ctx.connection.authenticatedUrl访问（属进阶改造）。
结尾¶
dsh-balance 把账户余额与峰谷计费时段收进输入框工具行，依赖 DSH 已有登录态，通过宿主只读路由查询，并在失败时友好降级。目录与详情见 SkillHub 插件页，源码与 README 见 GitHub。
