前言¶

DeepSeek Harness（DSH）会把会话写成 ~/.dsh/sessions 下的日志，账户页也能看到余额，但要把「每个模型、每天烧了多少 input/output/cache」从 JSONL 里自己汇总，成本很高。下面介绍社区插件 dsh-token-usage（维护者 GIN0076，GitHub GIN0076/dsh-token-usage）：在 Settings → Token Usage 里用本地数据做日/周/月统计和图表，可选价目表估算费用，数据不出本机。

这是什么¶

dsh-token-usage 是 DSH 的客户端插件（Cordis bundle 名 @local/token-usage，当前资料版本 1.3.0，MIT 许可证）。它在设置面板挂一块 Token 用量仪表盘：按 provider/model 汇总 token，支持 Day / Week / Month 切换与自定义时间范围，折线图、横向排行、汇总卡片；图表为 纯 SVG、零额外依赖。统计来源是会话日志只读扫描，本地优先（local-first），不内置任何单价。

核心功能¶

时间粒度与范围¶

• Day / Week / Month：周从周一开始，月为自然月；底层只存「按日」桶，切换粒度即时、不重复扫盘。
• 预设范围（如最近 7/30 天、12 周、12 月、全部）及自选起止日期。
• 汇总卡片与排行榜对当前选定区间整体生效；随粒度变化的是折线图分组与 Buckets 卡片。

图表与排行¶

• 折线图：粗线表示合计，细线按模型；十字准线悬停看每日明细，图例可点选隐藏/显示模型。
• 横向条形图：模型占比与（配置单价后）费用；可切换 按 model / 按 provider，排行可按 cost 排序。

指标卡片¶

合计、input、output、cache read、cache write、reasoning、cache 命中率、调用次数、模型数等。配置价目表与预算后，还会出现 Cost、Today、This month、Budget（超预算时 Budget 卡片变红）。

费用估算（可选）¶

插件不内置单价。在面板 Prices 中编辑，写入 ~/.dsh/token-usage-prices.json（原子写入）。单位是每百万 token 的价格；currency 默认 ¥；模型键为面板里出现的 provider/model 字符串。

示例结构（来自 README）：

{
  "currency": "$",
  "models": {
    "deepseek-account/deepseek-flash": { "input": 1, "output": 2, "cacheRead": 0.1, "cacheWrite": 1 }
  },
  "default": { "input": 1, "output": 2 }
}

未定价模型会单独统计并在面板提示，不会静默记为 0；清空并保存可再次隐藏费用。费用仅为估算，以服务商账单为准。

配置、导出与刷新¶

• Settings（对应 ~/.dsh/token-usage-config.json）：刷新间隔、预算、数据保留等。
• Export：当前范围导出 CSV 或 JSON（含桶×模型行、小计与总计），支持复制与下载。
• 标签页可见时每 60s 静默刷新；回到标签页立即刷新；隐藏时不发请求。
• Rebuild：一键全量重扫；用水印避免重复计数；若本地 store 里仍有已删会话对应的历史，会先确认（该部分无法重建）。

统计口径（资料摘要）¶

Host 侧从 session 日志做 live fold 与启动回填；脏计数 fail closed；compaction 摘要按自身 provider/model 归因；fork 继承不重复计数。

安装与启用¶

DSH 标准渠道是从 GitHub 安装（桌面端务必用 desktop profile，不要用已过时的 --profile web）：

# desktop app（打包客户端实际加载的 profile）
dsh plugin --profile desktop add github:GIN0076/dsh-token-usage
# 或省略 --profile，作用于当前默认 profile
dsh plugin add github:GIN0076/dsh-token-usage

安装后 硬刷新 页面（Ctrl+Shift+R），打开 Settings → Token Usage。

卸载（README 说明）：plugin_manager remove_bundle → @local/token-usage；主机侧无残留，数据目录可自行保留或删除。

典型用法¶

1. 按上文命令安装并硬刷新，进入 Settings → Token Usage。
2. 用顶部 Day | Week | Month 和时间范围预设（或自定义日期）查看折线与 Buckets。
3. 需要费用与 Budget：点 Prices 填 token-usage-prices.json；在 Settings 里设 budget（可选）。
4. 对比模型消耗：在排行区切换 By model / By provider，有单价时可用 By cost。
5. 需要离线分析：选好转好范围后 Export CSV/JSON。
6. 日志有变动但数字不对：点 Rebuild；若提示历史会话文件已不存在，按说明确认后再重建。

适用场景与注意¶

适合：长期在 DSH 上跑多模型、多 provider，希望在本机快速看 token 结构、cache 占比，并可选地按自有单价估费与控预算的开发者。

注意：

• 插件在当前 DSH 进程权限下读 ~/.dsh/sessions 与写入 ~/.dsh 下配置/缓存；安装前请自行查看 仓库源码 与 MIT 许可证。
• 社区目录 skillhub 插件页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；星标等元数据以各站点当时显示为准（资料中 GitHub 星标为 0）。

结尾¶

dsh-token-usage 把 DSH 会话日志变成可交互的本地仪表盘：按日存储、按周/月即时聚合，纯 SVG 图表，可选价目与预算。目录与源码：

• https://www.skillhub.cn/plugins/GIN0076/dsh-token-usage
• https://github.com/GIN0076/dsh-token-usage