前言¶
DeepSeek Harness (DSH) 的 Web 界面在本地处理交互，但通常缺乏详细的 Token 消耗追踪和账户余额监控。dsh-cost-meter 插件通过在底部状态栏直接展示 DeepSeek 会话成本估算和账户余额，解决了这一痛点。
插件介绍¶
由 AnakinCao 维护的 Web GUI 插件。它不参与模型推理，而是读取本地会话日志和官方定价接口，将成本估算和余额信息实时反馈给用户。
核心功能¶
1. 实时模型价格
插件通过 session.models RPC 获取当前选中的模型，并显示其实时价格（单位：CNY/1M tokens）。价格顺序为：缓存命中 / 缓存未命中 / 输出。插件支持自动切换高峰与非高峰定价（北京时区，工作日 9-12, 14-18 为高峰，周末全天为非高峰），模型切换后约 2.5 秒内更新。
2. 成本聚合与去重
插件扫描 ~/.dsh/sessions 目录下的会话文件，按会话聚合今日成本。
* 会话合并：通过 parentSession 自动将子会话（Subagent）合并到根会话中。
* 去重机制：DSH 子会话文件包含父会话的完整事件，插件通过（时间、轮次、步骤、计数）指纹进行全局去重，防止重复计费（此前可能导致成本虚高约 5 倍）。
* 工作区显示：Tooltip 中显示会话的工作区目录名称。
3. 今日与会话成本
成本数据从官方定价页实时抓取（缓存 1 小时），并依据生效日期（2026-08-17 生效）和时间段自动选择价格。若抓取失败，则回退到内置常量。
4. 余额监控
插件每 60 秒查询官方 GET https://api.deepseek.com/user/balance 接口。当余额低于默认阈值（BALANCE_WARN_CNY，默认 50 CNY）时，状态栏整行变红。
5. Token 类型统计
Tooltip 中展示了历史会话按内容类型分类的 Token 消耗分布（如代码、推理、工具输出等），帮助进行 Token 优化。
安装与启用¶
使用官方 CLI 安装：
dsh plugin --profile web add https://github.com/AnakinCao/dsh-cost-meter.git
# restart dsh web
配置¶
插件需要 API Key 才能查询余额。解析顺序如下：
1. 插件配置 config.apiKey
2. 环境变量 DEEPSEEK_API_KEY
3. ~/.dsh/.credentials.yaml 中的 DEEPSEEK_API_KEY
若未配置 Key，状态栏仅显示“balance fetch failed”，但成本估算仍正常显示。
典型用法¶
在底部状态栏，你会看到类似以下信息：
stats row · TPS Flash off-peak 0.05/1.5/4.5 · Today ¥11.52 (5 sessions) · Session ¥0.08 · Balance ¥365.36
鼠标悬停在状态栏上可查看详细的会话成本分解和价格来源。
注意事项¶
- 成本估算：显示的是估算值（官方单价 × 使用量），权威账单以 DeepSeek 平台为准。
- 安全性：余额和定价查询在主机进程运行，API Key 从不离开浏览器。
- 资源占用：插件不消耗 Token，仅读取日志；余额查询有 1 小时缓存。
- 卸载：删除插件目录
node_modules/dsh-cost-meter并移除配置文件中的 patch 插入项。
