前言¶
在使用 DeepSeek 进行开发时，实时掌握账户余额及计费时段（高峰/非高峰）是控制成本的关键。现有的方式往往需要手动查询或依赖第三方工具。harness-accountant 插件旨在解决这一痛点，将实时监控功能直接集成到 DSH Web GUI 中。
插件定位¶
这是一个轻量级插件，用于监控 DeepSeek 代币余额和用量，并指示当前小时属于高峰还是非高峰计费。
核心功能¶
插件主要提供以下能力：
- 实时监控余额：通过轮询接口获取账户当前余额。
- 用量统计：提供 1 天、7 天、1 个月的用量统计，以及每日消费明细。
- 高峰/非高峰指示：显示当前小时是按高峰时段还是非高峰时段计费，并以颜色区分（黄色为高峰，绿色为非高峰）。
- 可视化展示：在 DSH 侧边栏显示当前消费卡片，在设置面板提供详细分析。
工作原理¶
插件通过以下机制运行：
- 数据获取：默认每分钟轮询一次 DeepSeek 的
GET /user/balance接口获取余额。 - 本地记账：读取结果被写入本地文件
$DSH_HOME/harness-accountant/ledger.json，作为每日记账本。 - 精度处理：为避免浮点数计算误差，所有金额均解析为带符号的整数微单位（1 单位 = 1e-6 货币单位），仅在边缘格式化输出。
- 高峰判断：高峰时段判断逻辑在浏览器端执行，基于 UTC 时钟与 DeepSeek 发布的计费表对比。高峰时段为 UTC 01:00 - 04:00 和 06:00 - 10:00（周一至周五），其余时间为非高峰（周末包含在内）。
使用限制¶
在使用前需注意以下事实：
- 语言支持：仅支持英语界面，不支持多语言。
- 货币处理：支持 USD 和 CNY 两种货币，但不支持汇率换算。切换货币会丢弃已积累的日统计数据。
- 时钟依赖：高峰时段的判断完全依赖于浏览器当前的系统时钟，而非服务器端计算。
安装与获取¶
由于安装命令未在资料中明确提供，建议通过以下渠道获取插件源码或进行安装：
- 目录页：https://www.skillhub.cn/plugins/its0din-ai/harness-accountant
- GitHub 仓库：https://github.com/its0din-ai/harness-accountant
该插件遵循 MIT 许可证。
