前言¶
DeepSeek Harness (DSH) 采用插件化架构。团队在本地或内网环境开发时，需要监控每一步真实的 Token 消耗与成本，以便进行预算控制和成本核算。dsh-team-reporter 插件将本机的使用数据上报到你自建的团队看板，数据隐私由你自己掌控。
插件简介¶
这是一个由 CHENKEYI-MAKER 维护的 DSH 插件（MIT 协议）。它的作用是收集本机的 Token 使用记录，上报到你自行搭建的团队看板上，以便团队统一查看用量和成本。
核心功能¶
- 按次采集：从本机的
session/event流中收集单次调用的数据，包括 input_tokens、cache_read_tokens、output_tokens、模型名称和项目目录。 - 离线队列：记录会写入磁盘队列。即使进程重启或网络中断，数据也能在恢复后重放，且通过幂等设计防止重复计数。
- 隐私安全：仅发送 Token 计数和成本信息。插件绝不会发送 Prompt、回复、文件内容或任何凭证。
- 技能同步：支持从服务器同步团队技能。插件每 30 分钟同步一次，采用原子替换策略。服务器是技能权威，同步失败不会删除本地已安装的技能。
安装与启用¶
-
获取插件包
从团队下载页或 Releases 标签页下载dsh-team-reporter-0.2.0.tgz。 -
安装插件
使用 DSH 的 CLI 命令安装，路径必须使用绝对路径（相对路径会被 pnpm 拒绝）：
dsh plugin --profile desktop add "C:\Users\you\Downloads\dsh-team-reporter-0.2.0.tgz"
或者在 DSH 侧边栏中：**插件** -> **添加插件** -> 粘贴文件绝对路径 -> 安装。
- 重启与绑定
安装后需要重启 DSH。重启完成后，右下角会出现一个灰点，点击打开，输入团队服务器 URL 和管理员分配的注册码（Enrollment Code），点击“绑定”。绑定成功后，灰点变绿，开始上报。
配置与注意事项¶
- 环境要求：需要 Node.js >= 22.5.0。
- 配置来源：服务器配置（如价格表、刷新间隔）通过本地的
/api/v1/config接口从服务器学习，本地无需手动配置。 - 隐私细节：离开本机的数据只有 Token 计数和 session ID 的哈希值。Workspace 字段仅为项目目录的名称，不包含完整路径。
- 注册码：注册码是一次性的，属于特定个人。重新安装或更换机器需要向管理员申请新的注册码。
- 技能目录：服务器同步的技能存放在
~/.dsh/skills/dsh-team/，本地个人技能存放在~/.dsh/skills/my-skills/，两者互不干扰。
总结¶
如果你需要在本机运行 DSH，同时希望团队负责人能看到本机的真实 Token 消耗与成本，且坚持数据隐私，可以安装此插件。它通过本地队列和幂等重放机制保证了数据的可靠性，通过仅传输计数保证了隐私安全。
