在 DeepSeek Harness (DSH) Web 的开发与使用过程中，需要监控 API 账户余额和实际消耗。DeepSeek 官方接口仅提供余额查询，但“今日花费”通常需要手动统计或等待账单。dsh-deepseek-cost-live 解决了这一缺口，通过官方接口获取余额，并解析本地会话日志估算今日花费。
这是一个社区开源插件（MIT 许可证），由 xtd1145 维护。它不修改 DSH 源码，基于官方运行时能力开发。
核心功能¶
1. 余额实时（官方接口）
插件调用 GET https://api.deepseek.com/user/balance 获取余额。API Key 仅在宿主进程内解析，绝不进入浏览器、日志或请求参数。如果刷新失败，会保留上次成功的数据并标记为 stale。
2. 今日花费（本地估算）
插件监听 DSH 本机会话日志，将每次模型请求的 usage（缓存命中、未命中、输出、推理）按分模型价格表（元/百万 token）换算为人民币。由于 DeepSeek 官方不提供“今日已消费”查询接口，因此花费为本地估算口径，非账单。
3. 三处实时展示
可在三处同时启用实时展示：
* 输入框下方 composer dock 条：显示余额、今日花费及手动刷新按钮。
* 右下角常驻悬浮徽标：可收起，状态由 localStorage 记忆。
* 设置页完整面板：余额明细、今日/近7日 Token 与花费、分模型花费、价格表/时区/轮询配置、历史重扫。
4. 其他能力
* 支持中英双语。
* 计数仅计入官方 DeepSeek 路由（默认 deepseek-official provider）。
* 支持历史会话扫描与重扫。
安装与启用¶
使用官方安装命令：
dsh plugin --profile web add <本仓库路径或 dsh-deepseek-cost-live.tgz>
安装后需重启服务以生效：
powershell -NoProfile -ExecutionPolicy Bypass -File $env:USERPROFILE.dshrestart-dsh-web.ps1
重启后，在浏览器（建议无痕/强刷一次）打开 Web 界面，即可看到悬浮徽标与输入框下方小条。访问设置页的「用量与余额」可查看完整面板。
验证安装是否成功：
Invoke-WebRequest -Uri 'http://127.0.0.1:3080/dsh-deepseek-cost-live/stats' -UseBasicParsing | Select-Object -ExpandProperty Content
配置与数据¶
API Key 来源
插件通过以下优先级解析 API Key：
1. 插件配置文件 $DSH_HOME/dsh-deepseek-cost-live/config.json。
2. 环境变量（默认 DEEPSEEK_API_KEY，可在配置中修改 apiKeyEnv）。
3. DSH 凭据文件 $DSH_HOME/.credentials.yaml。
4. 官方 ctx.credentials 服务。
数据目录
插件在 $DSH_HOME 下创建以下文件：
* dsh-deepseek-cost-live/ledger.json：用量记录（sessionId:seq 幂等去重，保留 keepDays 天）。
* dsh-deepseek-cost-live/config.json：配置文件。
* dsh-deepseek-cost-live/balance.json：最近一次成功余额快照。
HTTP 路由
仅限本机回环访问：
* GET /dsh-deepseek-cost-live/stats — 汇总数据。
* POST /dsh-deepseek-cost-live/refresh — 立即刷新余额。
* POST /dsh-deepseek-cost-live/scan — 立即重扫全部会话历史。
注意事项¶
- 非官方产品：与 DeepSeek 官方无关，为社区开源插件。
- 花费口径：花费为本地估算，非官方账单，需按官网价目表核对。
- 环境要求：需要 Node.js >= 22.19.0。
- 路由限制：HTTP 路由仅支持本机回环访问。
