dsh-token-usage：DeepSeek Harness 本地 Token 用量统计

前言¶

DeepSeek Harness 的核心设计理念是「一切皆插件」。在使用本地大模型时，如果不关注用量，很容易产生意外费用。dsh-token-usage 插件通过读取本地的会话日志，在设置页提供可视化的统计面板，帮助开发者掌握跨模型、跨供应商的 Token 消耗情况。

这是什么¶

这是一个 DeepSeek Harness 客户端插件，由 Gnatnaituy 维护，采用 MIT 许可证。

它不依赖第三方计费接口，而是直接读取 Harness 自身的会话日志。安装后，会在「设置」里新增一个 Token 用量 页面，展示总用量、GitHub 风格的用量日历，以及按供应商分组的逐模型用量。

核心功能¶

插件主要提供以下三类数据视图：

1. 总用量

   • 跨所有模型供应商、所有模型的 token 汇总。
   • 时间维度：今日 / 近 7 日 / 近 30 日 / 全部。
   • 分项统计：输入、输出、缓存读、缓存写、推理。

2. 用量日历

   • GitHub 贡献图风格的热力图，每天一格。
   • 悬停可查看当日 token 明细与请求数。
   • 配色跟随当前主题（深色/浅色自适应）。

3. 按供应商分组的模型用量

   • 每个供应商一张表。
   • 列出每个模型今日、近 7 日、近 30 日的用量与占比。

安装与启用¶

使用官方提供的安装脚本进行安装：

node tools/install-into-profile.mjs            # 安装
node tools/install-into-profile.mjs --dry-run  # 预览会做什么
node tools/install-into-profile.mjs --uninstall # 卸载

脚本执行后，等待一两秒，刷新浏览器页面，打开 设置 → Token 用量 即可看到数据。

典型用法¶

• 查看用量：安装完成后，刷新页面进入设置页的 Token 用用量板块查看汇总数据。
• 临时停用：如果想在不卸载插件的情况下停用，在 profile 的 cordis.patch.yml 文件中添加以下配置：

- id: token-usage
  name: dsh-token-usage
  disabled: true

注意事项¶

• 数据权限：插件只读取 <home>/sessions 里的会话日志，只写插件自己的目录；从不删除或改写任何用户数据。
• 统计口径：汇总口径与 DSH 持久日志一致。只有 provider 上报了 usage 的 assistant/message 才计为一条；assistant/attempt、重试事件不带 usage，不重复计数。
• 供应商显示：没有供应商目录信息时，供应商 id 会做标题化显示；归属不明的记录归到「未标注」。
• 开发调试：改 lib/index.js 等 host 半代码后，需要重启 DSH Desktop，因为模块热重载默认关闭。

总结¶

dsh-token-usage 插件通过读取本地日志实现了无侵入式的用量统计，适合需要精细化控制本地模型调用成本的开发者。它不自己计算，而是复用 Harness 的路由与数据源，保证了统计口径的一致性。

• GitHub 仓库
• 插件目录页