前言¶
在 DeepSeek-Harness (DSH) 的开发流程中，监控 Token 消耗并按模型或时段进行计费是常见需求。dsh-token-tracker 是一个用于处理这些数据的网页插件，它从持久会话日志中折叠提供者 Token 使用情况，并提供高峰/低谷定价。它会在 DSH GUI 中显示总计，并提供独立概览页面和 JSON API。
插件概览¶
这是一个由 XiaHouSheng 维护的 DSH 客户端插件（MIT 许可证）。插件运行在 DSH host 内，负责监听会话事件、折叠 Token 数据，并在 Web 界面中展示。
核心功能¶
- 数据折叠与展示：从会话日志中折叠提供者 Token 使用情况。
- 时段定价：支持按高峰/低谷时段定价。
- GUI 悬浮元素：在 DSH GUI 头部显示 Token 徽章和周期标签，提供 Tracker 按钮、作曲家停靠线、回合结束尾以及
conversation.viewToken 标签。 - 独立页面与 API：提供独立的概览页面和 JSON API。
安装与启用¶
安装此插件前，必须先安装 DeepSeek-Harness (dsh)，因为它将其作为 peer dependency。插件本身是一个可直接安装的 dsh 插件包，lib/ 目录下包含预构建内容。
- 安装插件：
执行以下命令安装插件包：
dsh plugin --profile web add https://github.com/XiaHouSheng/dsh-token-tracker.git
- 启动 DSH：
启动服务以激活插件层：
dsh --profile web
典型用法¶
-
配置定价：
在 workspace 根目录或 session cwd 中放置token-pricing.json文件，以覆盖默认价格。系统会读取该文件并按缓存/未缓存、输入/输出以及高峰/低谷时段进行计费。 -
访问页面：
* 独立概览页面：访问http://127.0.0.1:<port>/dsh-token-tracker。
* JSON API：访问http://127.0.0.1:<port>/dsh-token-tracker/api。
注意事项¶
- 插件运行在 DSH host 内，利用其运行时环境。
- 从源代码重新构建需要 Node.js >= 20 和 pnpm，但安装插件本身不需要这些依赖。
- 该插件是一个可直接安装的 dsh 插件包，
lib/目录下包含预构建内容。
总结¶
该插件为 DSH 用户提供了可视化的 Token 监控和计费功能。更多详情可查阅 GitHub 仓库。
