前言¶
DeepSeek Harness (DSH) 的插件生态旨在通过模块化扩展提升终端交互体验。在 dsh-TUI 中，用户常需要实时监控账户余额、区分峰谷计费时段以及追踪 Token 消耗。dsh-peak-balance 插件解决了这些问题，它将峰谷时钟、实时余额、单轮成本以及一个 GitHub 风格的 Token 历史网格集成在状态栏与全屏视图中，由 VviLliAm-qwq 维护。
核心功能¶
该插件在 dsh-TUI 中提供以下能力：
- 峰/谷计费时钟：显示当前生效的计费窗口（如工作日 09:00-12:00）及距离下一个计费时段的倒计时。周末全天为非峰时。
- 提供商中立读数：读取当前对话实际使用的提供商余额（如官方余额、订阅额度、中继信用池）。如果提供商无读数接口，则不显示数值。对于自动路由的会话，它会尝试读取已保存的
/model路由信息。 - 单轮成本测量：显示上一轮对话的消耗。如果提供商提供计数器（如命令代码积分、OpenRouter 用量），则直接测量；否则从费率卡估算；若无费率则显示未评级。
- 配额诊断：执行
/quota命令可查看读取状态、适配器响应、失败原因及所有可探测的提供商路由。可使用/quota check <provider>单独检查。 - 峰时警告：当处于峰时窗口时，状态栏可切换为带脉冲边框和波形动画的三行警告框，支持七种颜色。
- 历史网格 (
/hist)：全屏展示 GitHub 风格的贡献图，每个方块代表一天，颜色深浅代表使用量。支持键盘导航。 - 总计与模型统计：显示所有历史数据的总计（Token、预估成本、缓存命中率等）及按模型的细分统计。
- 自定义费率 (
/th price)：为未列出的模型设置费率，否则显示未评级标记。 - 语言跟随：状态行、历史场景和命令回复会随 TUI 的
/lang设置即时切换语言。 - 设置子页面：在
/settings的“Peak & Balance”卡片下提供“Token history”子页面，包含十个选项。
安装与启用¶
使用 npm 安装：
dsh plugin --profile dsh-tui add dsh-peak-balance
或直接从本地仓库安装：
dsh plugin --profile dsh-tui add file:/absolute/path/to/dsh-peak-balance
安装命令会将插件行追加到 dsh.profile.bundles。安装后，需在 dsh-TUI 中执行 /restart 以加载新插件，设置卡片随即出现在 /settings 下。
典型用法¶
状态栏显示示例：
⚡ 峰时 09:00-12:00 · 距谷时 1h23m · 本轮 ¥0.0234 · 余额 ¥42.10
进入历史网格：
* 快捷键：/hist（或 /tokenhistory、alt+h、/th 后加空格）。
* 导航：←/→ 切换日期，↑/↓ 切换周数，m 切换指标，w 切换跨度，s 切换子代理，r 重新扫描，q 或 Esc 关闭。
* 自定义费率：/th price 后接模型名称和价格。
检查配额：
/quota check <provider>
注意事项¶
- 安装方式：不推荐使用符号链接（
link:协议或目录连接点）安装。Node.js 会解析插件的真实路径，且@deepseek-ai/*依赖必须保持可访问。file:和 npm 安装会在配置目录中保留真实目录副本，这是宿主预期的布局。 - 更新文件：如果通过
file:安装，直接运行add或update不会拾取本地源码的修改。必须先移除插件，再重新添加。 - 重启要求：安装或移除后，必须重启 TUI 才能生效。
结语¶
dsh-peak-balance 是一个专注于计费监控与使用统计的实用工具，通过将复杂的数据展示简化为 TUI 中的状态栏与网格，帮助开发者更直观地管理资源与成本。
