用量分析 · Usage Dashboard

把 DeepSeek Harness 的本地会话日志，变成一张能看懂的用量与费用看板。

Token、请求、缓存命中、费用、模型速度、对话耗时——全部从本机日志算出来，不联网、不上传、不需要 API Key。

---

为什么需要它

Harness 默认只记录会话日志，不会告诉你：

• 今天/这周/这个月到底烧了多少 Token、花了多少钱；
• 缓存命中了多少——命中率差 10 个点，账单能差一倍；
• 哪个模型在吃预算，哪些请求其实走了高价档；
• 模型输出速度（tok/s）到底是快是慢，P50 掉到哪儿去了；
• 哪几天干得多、哪几天在空转。

这个插件把这些问题一次性答完：侧边栏点一下，趋势、热力图、模型分布、请求明细全在一起。

功能

多口径总览	今天 / 7 天 / 30 天 / 全部 / 自定义区间，KPI 卡直观对比
趋势图	Token、请求、费用、模型耗时、输出速度五种指标；柱状/折线切换；模型筛选
自动聚合粒度	今天→按小时；7/30 天→按天；更长区间自动按周（周一起算）或按月，绝不糊成一根柱
GitHub 风格热力图	近 53 周每天一格，按请求/Token/费用/耗时着色，点格子即筛选当天
模型分布	按请求/Token/费用/耗时排名的彩色占比条，点图例即筛选
速度面板	速度分布（P25/P50/P75 区间）与速度趋势折线，多模型对比一眼看清
可检索请求明细	按时间/耗时/Token 排序，支持模型与关键词搜索，失败请求有独立视图
隐私模式	一键隐藏会话名、账号、错误详情与敏感模型名，数字不变——适合截图与共享
峰谷计价	按北京时间工作日高峰/低谷两档价格估算，支持第三方中转按官方价假设

界面

模型耗时（全部模型时按模型分段堆叠，和 Token 趋势同宽度，不横向滚动）

速度趋势（多模型用折线对比，筛选单个模型后可切换柱状）

速度分布（P25 / P50 / P75）

安装

前置：DeepSeek Harness 桌面版（开发与验证版本 0.2.1-rc.5）。

1. 下载 Release 里的 dsh-usage-dashboard-<version>.zip，解压到任意目录并记下绝对路径；
2. 在 Harness 会话里执行：

plugin_manager install_bundle target=<解压后的绝对路径>

1. 完全退出并重新打开 DeepSeek Harness（首次加载/替换插件必须重启，浏览器半的客户端模块才会重新组装）；
2. 左侧边栏出现「用量分析」图标，点击进入。

安装后数据自动计算：插件会在后台扫描 ~/.dsh/sessions，增量折叠成按天桶并缓存到 ~/.dsh/usage-dashboard/cache.v1.json，之后每次打开只做增量更新。

隐私模式

点右上角「隐私模式」后：

• 会话标题 → 会话 01、会话 02……（同一次打开的映射稳定，可对照）；
• 账号 → 账号 A、账号 B……；
• 错误信息、搜索关键词 → 隐藏；
• 形如 /Users/...、https://...、sk-... 的敏感模型名 → 模型已隐藏。

统计数字、图表、费用一分不变——所以可以直接截图发群、贴 issue。

插件本身只读本机会话日志，全部计算在本地完成，没有任何网络请求；这份 README 里的截图就是用隐私模式 + 示例数据渲染的。

计价（pricing.json）

插件按 pricing.json 估算费用，改完重启生效：

{
  "peak": {                       // 峰谷时段（北京时间）
    "offsetMinutes": 480,
    "weekdays": [1, 2, 3, 4, 5],
    "windows": [["09:00", "12:00"], ["14:00", "18:00"]]
  },
  "books": {                      // 价目表：单位「元 / 百万 token」
    "deepseek-flash-2026-11": {
      "models": {
        "deepseek-flash": {
          "offPeak": { "cacheHit": 0.02, "cacheMiss": 1, "output": 4 },
          "peak":    { "cacheHit": 0.04, "cacheMiss": 2, "output": 8 }
        }
      }
    }
  },
  "providers": {                  // provider → 价目表映射
    "official": {
      "label": "DeepSeek 官方",
      "book": "deepseek-flash-2026-11",
      "source": "official",
      "models": { "deepseek-flash": "deepseek-flash" }
    },
    "relay": {                    // 改成你自己的 provider 名
      "label": "第三方中转",
      "book": "deepseek-flash-2026-11",
      "source": "assumed-official",
      "models": { "deepseek-v4.1-flash": "deepseek-flash" }
    }
  }
}

要点：

• providers.<p> 的 key 必须和会话日志里 provider/model 的前半段一致，否则该模型显示「未确认价格」；
• books.<b>.models.<m> 的 key 是模型名（provider/ 之后的部分）；
• 只有 offPeak 的模型（例如某些第三方模型无峰谷）在高峰时段按同一档计算；
• 价格未确认的历史请求（早于 effectiveFrom）会在页脚标注，不会硬算。

指标口径

指标	定义
总 Token	input + output + cacheRead + cacheWrite
请求数	成功发出的模型请求数（失败单列）
缓存命中率	cacheRead / (cacheRead + input)
费用	cacheRead×cacheHit + (input+cacheWrite)×cacheMiss + output×output，按峰谷档与 provider 映射计算
模型耗时	该模型请求的 LLM 平均耗时（不含工具调用）
输出速度	output tokens / (耗时 ms / 1000)，逐请求取样本后算 P25/P50/P75

趋势聚合粒度

范围	粒度
今天	按小时
7 天 / 30 天	按天
全部 / 自定义	跨度 ≤1 天→按小时；≤45 天→按天；≤315 天→按周（周一锚定）；更长→按日历月

周桶从区间内第一个周一完整铺到最后一个周一；月桶按统计时区的自然月切分；速度的 P50 在每个桶内用请求级样本重新计算，不是「日 P50 的平均」。

数据来源与准确性

• 唯一数据源是 ~/.dsh/sessions/<workspace>/<session>/session.v*.jsonl.zstd 会话日志，插件只读不写；
• 统计的是本地记录的用量，与供应商账单可能有出入（重试、失败请求、缓存计费口径、免费额度等）；
• fork/副本会话的「播种」请求会去重，避免同一份历史被算两遍；
• 缓存文件可随时删除，下次打开会全量重建。

开发与打包

零运行时依赖（只用 Node 内建与 Harness 自带包），改完直接跑：

npm run check   # 三个 JS 文件的语法检查
npm run pack    # 生成 dist/dsh-usage-dashboard-<version>.zip

结构：

文件	作用
index.js	Host 半：扫描/折叠会话日志，注册两个鉴权路由
fold.js	折叠与聚合核心：分桶、峰谷计价、速度分位
client.js	Web 半：侧边栏图标与看板页面（React）
pricing.json	计价配置
cordis.patch.yml	插件行（bundle patch）
locale/*.json	插件标题与描述（中/英）

路由（均需 Harness 会话鉴权）：

• GET /usage-dashboard/summary?from&to&tz&mode
• GET /usage-dashboard/requests?from&to&tz&view&sort&order&offset&limit&model&q

License

MIT