dsh-heatmap-cost
DeepSeek Harness 插件：Token / 费用消耗热力图。
预览
在 dsh Web UI 输入框下方的统计条（命中率 / 输入输出 token 所在行） 实时显示：
- 账户余额（三色状态点：绿=充足 / 黄=偏低 / 红=告急，点击弹层内的「刷新余额」可手动强刷）
- 本会话估算消耗（按模型、按 DeepSeek 官方单价估算，含谷峰计费）
- 📊 热力图按钮：点击打开 GitHub 风格弹层 —— 近 N 天（默认 365 天）每日 token / 金额网格，附今日 / 近 7 / 30 / 365 天 / 累计汇总、余额、分模型成本。
特性
- 多 Agent 全量计费：聚合本机所有 coding agent 的持久化消耗记录，从开始使用起累计：
| 数据源 | 位置 | 成本 |
|---|
| DSH | ~/.dsh/sessions（zstd JSONL） | 按 V4 定价估算 |
| Claude Code | ~/.claude/projects（JSONL） | 按模型估算 |
| Codex | ~/.codex/sessions（JSONL，会话累计去重） | 按模型估算 |
| OpenCode | ~/.local/share/opencode/opencode.db（SQLite） | 真实 cost |
| OMP | ~/.omp/agent/sessions（JSONL） | 真实 cost |
- 四维聚合：累计消耗（总金额 / 总 token / 请求数 / 会话数）+ 按 Agent 数据源消耗 + 按模型调用费用 + 按天热力图。
- 持久化账本：按会话缓存聚合结果到
$DSH_HOME/storages/dsh-heatmap-cost/ledger.json，以文件指纹（size + mtime）增量重扫，重启不丢、秒级返回。
- 模型筛选：热力图可按模型着色查看（全部 / 具体模型）。
- 日历年对齐：热力图每列 = 一个完整日历周（周日~周六），同周日期不会跨列错位。
- 内置多模型定价表（deepseek-v4-* / gpt-5.x / claude-*，CNY / USD，谷峰自动切换），无真实 cost 的源按模型估算。
- 密钥复用 Harness credentials（
DEEPSEEK_API_KEY），无需在配置里写密钥。
- 纯 CSS 网格热力图，自适应明暗主题（CSS 变量），无额外依赖（Node 内置 zstd + SQLite，需 Node ≥ 22.5）。
安装
dsh plugin --profile desktop add <本目录>
# 或 dsh plugin --profile web add <本目录>
重启 dsh web 后生效。
配置（可选）
写进 $DSH_HOME/profiles/<profile>/cordis.patch.yml：
- id: dsh-heatmap-cost
config:
warningThreshold: 10 # 余额预警阈值(低于此值显示黄色)
dangerThreshold: 5 # 余额告急阈值(低于此值显示红色)
refreshIntervalMs: 300000 # 服务器向 DeepSeek 查询余额的频率(毫秒)
heatmapDays: 365 # 热力图覆盖的天数(7~400)
currency: CNY # 计价货币(CNY / USD)
apiKeyRef: DEEPSEEK_API_KEY # credentials / 环境变量引用名
baseUrl: https://api.deepseek.com
自定义单价（每 100 万 tokens）：
prices:
my-model:
cacheHit: 0.2
cacheMiss: 2
output: 8
HTTP 路由
GET /cost-heatmap — 余额 + 当前会话投影 + 热力图数据（浏览器轮询用）POST /cost-heatmap?force=1 — 强刷余额GET|POST /cost-heatmap/config — 读写运行配置
说明
- 若请求走中转 provider（非 DeepSeek 官方 API），
/user/balance 可能查不到真实扣费，余额显示会失效；热力图（token 用量）不受影响。
- 热力图数据来自宿主内存中的会话日志，重启后自动重建。
