DeepSeek Harness (DSH) 是一个基于插件架构的客户端环境。在实际开发或使用中，频繁打开官方定价页或计费页面来核对余额和费用会打断对话流。下面介绍 dsh-ui-balance，它通过直接在界面中展示这些数据来解决这个问题。
插件简介¶
dsh-ui-balance 是一个由 EasyTZ 维护的客户端插件，核心功能是将 DeepSeek API 的余额、花费以及峰谷时段标记直接显示在会话的侧边栏中。它通过解析会话日志和官方定价页，为用户提供实时的费用估算和用量汇总。
核心功能¶
该插件主要提供以下能力：
- 侧边栏概览：在侧边栏显示一行数据，包含余额和当日花费（实时跳动）。
- 详情面板：点击侧边栏行可弹出详情面板，展示 API 供应商、余额、用量汇总、费用汇总及目前单价。
- 多供应商支持：支持 DeepSeek、Kimi (Moonshot) 等多供应商，但仅 DeepSeek 和 Moonshot/Kimi 支持直接查询余额接口。
- 价格同步：从官方定价页自动同步价格。启动时抓取一次，之后每 20 秒或半天再次同步。若同步失败，继续使用最后一份真实价格。
- 峰谷时段与节假日：支持自定义高峰时段规则（
peakDays,peakWindows）和法定节假日配置（peakHolidays）。
安装与启用¶
安装前请确保已配置 DEEPSEEK_API_KEY 凭据。
使用以下命令安装（<name> 为必填的 profile 名，桌面版通常为 web，TUI 为 tui）：
dsh plugin --profile <name> add @easytz/dsh-ui-balance
安装完成后重启 DSH 即可使用。
典型用法¶
侧边栏显示：安装后，侧边栏会出现一行数据，包含“余额：xx 元”和“花费：xx 元/日”。花费会随着消息生成实时跳动。最右侧会显示绿色“谷”或蓝色“峰”，标识当前计费时段。
查看详情：点击侧边栏的该行，会弹出费用详情面板。面板从上到下依次为：API 供应商、余额、用量汇总（支持日/周/月切换）、费用汇总和目前单价。
自定义规则：若需自定义高峰时段，可配置 peakDays（如 1-5）和 peakWindows（如 9:00-12:00,14:00-18:00）。填 none 表示没有高峰时段。
注意事项¶
- 余额查询限制：余额查询仅 DeepSeek 和 Moonshot/Kimi 有公开接口，其他厂商显示“无法查询余额”。
- 费用性质：面板中的费用是按当前单价折算的估算值，并非官方账单。它统计的是本机会话日志中的调用。
- 日志扫描：会话数量多时，首次启动插件会将全部日志扫一遍。之后按文件尺寸增量更新。
- 路径依赖：如果你在本地 patch 中修改了
dsh-session-persistence-l的root路径，请确保将插件的sessionsRoot配置为相同路径，否则费用统计可能全部为 0。
总结¶
dsh-ui-balance 通过将官方定价、实时用量和估算费用集成到界面中，解决了在 DSH 中频繁查看费用的痛点。它支持多供应商、自动同步价格以及自定义峰谷规则，适合需要精细控制 API 使用成本的 DeepSeek 开发者。项目源码位于 GitHub：https://github.com/EasyTZ/dsh-ui-balance。
