DeepSeek Harness (DSH) 采用插件化架构，在使用过程中，开发者往往需要追踪 Token 消耗、模型调用频率以及技能的使用模式。DSH 原生环境缺乏细粒度的可视化分析入口。dsh-usage-analytics 插件通过本地索引计算，在设置页提供可视化的用量洞察，满足个人或小团队对使用数据的追踪需求。
插件定位¶
这是一个本地优先的个人用量分析插件。作者为 3361805598-gif，采用 MIT 许可证。它不依赖远程服务，直接在本地生成 1/7/30 天的统计视图，包括热力图、模型分布和技能调用明细。
核心功能¶
- 设置页集成：在 DSH 的设置页新增「个人分析」分区，提供统一的入口查看数据。
- 多维度统计窗口：支持在 1 天、7 天、30 天三个时间窗口之间切换。
- 可视化图表：
- 今日小时柱图。
- 7 天小时热力图。
- 30 天可点击日历，点击日期可查看当日用量明细。
- Token 构成分析：显示 Token 构成条与分类占比，推理用量作为输出子集单独说明，不重复累加。
- 模型与技能分布：
- 模型分布：显示提供方、调用次数、Token 与用量占比。
- 技能调用：区分自动 / 显式来源，显示成功、失败、未完成数量及成功率。
- 数据维护：提供「重建统计缓存」功能，用于重新归集数据。
安装与启用¶
前置条件：Node 版本 ≥ 20，且 dsh web 可正常运行。
- 从 GitHub Releases 下载对应版本的
.tgz安装包（每个 Release 说明中都附有该包的 SHA-256 校验值）。 - 将下载的
dsh-usage-analytics-0.2.1.tgz放置到~/.dsh/profiles/web/vendor/目录下。 - 执行以下命令添加插件：
dsh plugin --profile web add file:vendor/dsh-usage-analytics-0.2.1.tgz
- 安装完成后重启
dsh web，并在浏览器中硬刷新页面。
典型用法¶
- 打开 DSH 设置页，找到「个人分析」分区。
- 点击时间窗口切换器，查看 1 天、7 天或 30 天的统计视图。
- 在 30 天日历视图中，点击具体的日期，查看当天的 Token 用量明细和技能调用情况。
适用场景与注意¶
- 适用平台：仅支持 Web 平台。
- 样式适配：UI 样式跟随 DSH Appearance（Light / Dark / System），读取官方
--dsw-alias-*token。 - 安全机制：API 受本机同源 trust-fence 保护；
POST /rebuild接口在 fence 之外无额外鉴权。 - 隐私保护：插件只写入自己的派生索引（时间戳、数值型 Token 用量、模型标识、技能名、调用来源和结果）。它不会写入提示词、模型回复、工具参数、工具结果、工作目录或密钥。Token 与技能明细按 90 天窗口清理。
- 语言支持：UI 为全中文，无国际化层。
总结¶
dsh-usage-analytics 为 DSH Web 平台提供了一个轻量级、本地化的数据透视工具。它通过重建缓存的方式确保数据准确性，同时严格限制数据写入范围，在提供可视化洞察的同时保障隐私安全。
