前言¶
做 DSH 插件或智能体调用链时，token 消耗常被拆散在不同模型、不同日期、不同会话里。想看当天、本周、本月的消耗，或者按会话导出复盘，往往需要自己处理日志。dsh-token-stats 是一个 DeepSeek Harness（DSH）插件，把持久化会话日志里的 token 用量汇总成统计页和 API。
DSH 的理念是「一切皆插件」；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。下面介绍 dsh-token-stats 的功能、安装方式、API 用法和注意事项。
这是什么¶
- 插件名称：
dsh-token-stats - 定位：Token usage & cost statistics plugin for DeepSeek Harness (DSH)
- GitHub owner：
1841220388zzzcccxxx-star - 许可证：MIT，© 2026 quansheng；资料未直接说明
quansheng与 GitHub owner 的关系 - 加载方式：作为外部 DSH profile dependency 安装，并在 DSH 启动时自动加载，无需手动激活
它解决的问题很集中：在 DSH 里查看 token 用量、按模型 / 日期 / 会话拆分，并得到 USD / CNY 的费用估算。
核心功能¶
统计与费用估算¶
资料确认的能力包括：
- 按模型、日期、会话统计 token 用量
- 提供 USD / CNY 费用估算
- 支持按模型和会话筛选
原生设置页¶
安装后可在 DSH 的设置页中找到入口：
Settings → Token Stats
资料说明该页面支持深色 / 浅色主题，以及 zh / en 国际化。
趋势图¶
插件提供日 / 周 / 月趋势的 SVG 折线图，资料注明零依赖。
历史回填¶
启动时会扫描持久化会话日志，使统计在 DSH 重启后仍可保留。
导出¶
插件提供 CSV / JSON 导出能力，并支持按模型和会话筛选。
估算标记¶
当适配器未报告 usage 时，插件会使用 tokenMeter.estimateMessage 估算，并将记录标记为 estimated。
安装与启用¶
资料说明该插件作为外部 DSH profile dependency 安装。给出的安装命令是：
cd ~/.dsh/profiles/web && pnpm install
执行完成后，按下面步骤启用：
1、重启 DSH web。
2、打开：
Settings → Token Stats
3、在页面中查看统计结果，或通过 HTTP API 获取数据。
典型用法¶
HTTP API¶
资料给出的接口路径是：
/token-stats/api
资料列出的 op 包括：
summaryquerymodelssessionsexport
其中 export 支持：
format=csv|json
model=<optional>
sessionId=<optional>
这里的 model 和 sessionId 是可选筛选条件。
开发检查¶
资料给出的本地检查命令包括：
node --check index.js
node --check client.js
node test-plugin.js
.\sync-deploy.ps1
说明如下：
node --check index.js：检查 server halfnode --check client.js：检查 browser halfnode test-plugin.js：运行独立 mock 测试.\sync-deploy.ps1：重新同步源码到 DSH profile，之后重启 DSH web
适用场景与注意¶
适合这些场景：
- 需要在 DSH 内集中查看 token 用量
- 需要按模型、日期、会话拆分消耗
- 需要 USD / CNY 费用估算
- 需要导出 CSV / JSON 做后续复盘
- 希望插件随 DSH 启动自动加载
安装和使用时需要注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证
- 许可证资料写为 MIT © 2026 quansheng
- 分类、星标数、目录页 URL 未在本文已核实资料中确认
- 性能数据为资料中作者机器上的测量结果，不作为通用性能承诺
- 无 usage 上报时会产生估算记录，应关注
estimated标记
链接¶
GitHub 仓库：
https://github.com/1841220388zzzcccxxx-star/dsh-token-stats
目录页 URL 未在本文资料中确认；如需从 DSH 社区目录进入，请以社区目录站点实际展示为准。
