前言¶
在 DeepSeek Harness（DSH）里长时间跑对话或开发智能体时，你往往要同时关心两件事：当前是不是峰价时段、账户里还剩多少钱。官方控制台可以查余额，但和日常在 Harness 里的操作是分开的；峰谷规则（工作日 09:00–12:00、14:00–18:00 北京时间为峰价等）也需要自己对照时间表。客户端插件 dsh-billing-bar（维护者 Daaaaxianer，分类：客户端）把以当前时刻为中心的 12 小时峰谷条和账户余额嵌在 Composer 输入区域上方，悬停可查看阶段说明与本机估算花费，不离开对话界面。
这是什么¶
dsh-billing-bar 是 DSH 的 Web 客户端插件（npm 包名 dsh-billing-bar，当前版本 0.1.3，许可证 MIT）。它在 conversation.input.dock 注册一块 UI，与 Composer 卡片对齐，并在上方展示：
- 峰谷计费条（前 6 小时 → 现在 → 后 6 小时，按真实峰谷边界着色）
- 账户余额芯片（未登录时显示
—）
花费统计来自本机会话日志的本地折算，不是服务商账单的替代品；下面会单独说明数据来源与局限。
社区目录页：SkillHub - dsh-billing-bar
源码与说明：GitHub - Daaaaxianer/dsh-billing-bar
核心功能¶
12 小时峰谷条¶
条形窗口以「现在」为中心，左右各 6 小时（主机侧默认半宽由 WINDOW_SIDE_MS 控制，默认 6 小时）。着色依据 DeepSeek 公布的峰谷规则在本地计算，而不是按整点切块：
- 峰价（琥珀）：工作日北京时间 09:00–12:00、14:00–18:00
- 谷价（绿色）：其余时段；周末及中国法定节假日全天按谷价
竖线标记当前时刻。悬停峰谷条可看到当前阶段、距离切换还有多久、精确切换时刻和颜色图例。峰谷条仅响应悬停，点击无效果。
账户余额与花费面板¶
余额显示在峰谷条旁边。数据来自 Harness 的 deepseekAccount 服务（getBalance）；充值余额链向官方充值页，地址取自 getState().links，而非插件写死 URL。
悬停余额展开面板，可查看：
- 今日、近 7 日、近 30 日：总花费、调用次数
- 多日范围下的按日柱状图
- 各模型花费明细
点击固定：单击余额或面板内任意位置可钉住面板，鼠标移开不会自动关闭；再次单击余额、点击面板外或按 Esc 关闭。
主题与实现边界¶
界面颜色、边框、标签与阴影使用 Harness 的 --dsw-alias-* 令牌，随 Settings → Appearance（浅色 / 深色）切换，无需插件单独维护配色。
主机侧在 loopback 的 webServer 上注册只读路由 GET /dsh-billing-bar/status?range=today|7d|30d，返回阶段、12 小时分段、余额及所选范围的花费；客户端只渲染自有 DOM，不向峰谷条添加点击目标。插件声明无遥测，除账号服务外无额外外连，也不向插件内存以外写入数据。
安装与启用¶
插件要求 DSH 0.2.x（package.json 中 engines.dsh：>=0.2.0-rc.1 <0.2.2 || >=0.2.2-rc.1 <0.3.0-0）。余额展示需要已登录 DeepSeek 账号。
在终端执行下列命令之一（与 README 一致）：
# npm package
dsh plugin --profile web add dsh-billing-bar
# or straight from this repository
dsh plugin --profile web add github:Daaaaxianer/dsh-billing-bar
安装后重启 Harness 使客户端插件加载。
DSH 生态奉行「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。安装任意插件前，建议在 GitHub 上浏览源码与许可证，并理解插件与当前 DSH 进程同权限运行。
典型用法¶
安装并重启后，打开带 Composer 的对话页即可在输入框上方看到峰谷条与余额，无需额外配置项。
- 判断是否适合开长对话：悬停峰谷条，确认当前是峰价还是谷价，以及下一次切换时刻。
- 快速看余额：直接看余额芯片；需要明细时悬停或点击固定面板，在今日 / 7 日 / 30 日之间切换。
- 核对本机花费趋势：在多日视图下结合柱状图与各模型分项，评估近期 token 消耗（记住下文「本地估算」限制）。
- 充值：在固定面板内使用 充值余额 跳转官方充值页。
若需从外部或脚本读取同源数据，可请求本机 loopback 上的 GET /dsh-billing-bar/status?range=today|7d|30d（由插件 index.js 提供）。
数据来源与适用注意¶
| 展示内容 | 来源 |
|---|---|
| 峰谷阶段与 12 小时条 | 公布的 DeepSeek 资费时段，本地计算 |
| 余额、充值链接 | deepseekAccount（getBalance、getState().links） |
| 花费 | 本机会话日志中 assistant/message 用量，按价目表折算 |
| 单价 | 官方人民币价目：如 deepseek-flash、deepseek-v4-pro；谷价为峰价一半 |
花费是本地估算：只统计本机会话的文本 token；Search / Fetch 等按次计费项不计入；非 DeepSeek 模型若无公开单价则显示「未定价」，不猜测价格。以服务商账单为准。
维护者需在资费或节假日变化时更新插件内常量（README 说明）：index.js 顶部 HOLIDAYS（法定节假日，国务院通知发布后补次年日期）、PRICE_CLASSES（[谷价, 峰价]，元/百万 tokens）、必要时调整 WINDOW_SIDE_MS。
适合谁：常在 DSH Web 客户端里开发或调试、希望一眼看到峰谷与余额、并愿意用本机日志做花费参考的开发者。
不适合当唯一依据的场景：需要与官方账单逐笔对账、或多机汇总会话时，应使用控制台或导出账单。
结尾¶
dsh-billing-bar 把峰谷时间轴、账户余额和按模型/按日的本机花费估算收到 Composer 上方，并与客户端主题一致。安装命令见上文；细节与截图见仓库 README。
- 目录页：https://www.skillhub.cn/plugins/Daaaaxianer/dsh-billing-bar
- GitHub：https://github.com/Daaaaxianer/dsh-billing-bar
