前言¶
如果你日常用 DSH（DeepSeek Harness）跑智能体任务，大概遇到过这样的问题：token 消耗散落在各个会话里，想知道一段时间内哪个模型用得多、cache 命中率怎么样、哪些工具调用最频繁，只能自己去翻会话记录做统计。
Harness Insights 解决的就是这个问题。它在 Harness 设置下新增一个本地优先的 Usage insights 页面，把本地会话的结构化元数据聚合后展示出来，且不修改上游 Harness 源码。下面介绍它的定位、功能、安装方式和数据边界。
这是什么¶
Harness Insights（mapan0424/deepseek-harness-insights）是由 mapan0424 维护的独立社区插件，并非由 DeepSeek 发布。一句话定位：DeepSeek Harness 的非官方本地优先用量洞察插件（Local-first usage insights for DeepSeek Harness）。
几个基本信息：
- 发布包名：
@anarkhgatsby/deepseek-harness-insights，当前版本 0.1.4 - 许可证：MIT（
package.json中明确声明license: MIT） - 平台：web-only，目标
0.1.1-rc.2的 Harness projection 与 client APIs
核心功能¶
插件安装后，会在 Harness 设置下新增 Usage insights 页面，展示以下内容：
- token activity
- model usage
- active sessions
- cache hit rate
- activity breakdown
- 最常用工具
界面支持双主题：Light 为经典翡翠/森林绿渐变；Dark 为 Codex 风格深黑画布，配霓虹粉/品红（#ff3388）饱和度曲线。页面核心是 Golden Ratio Heatmap Matrix 热力图矩阵，采用 2.7px 网格间距并放大单元格。
图标方面，插件内置 26 对明暗两套 Codex 风格工具图标 SVG，构建时嵌入客户端 bundle，通过 Harness 的 body[data-ds-dark-theme] 契约切换，插件自身不维护单独的主题偏好。
数据如何被处理¶
作为用量插件，数据边界值得单独说明。Harness Insights 仅折叠结构化会话元数据：
assistant/message.data.usageassistant/message.data.message.source.provider/modeltool/call.data.name- 事件时间戳及 session projection identity
历史聚合通过 Harness 官方的 sessionProjectionCache.coldSnapshot() 路径执行。插件不在浏览器请求会话历史、不存储消息内容、不读取 API keys、不上传使用数据，仅持久化 Harness 拥有的 projection checkpoint。
安装与启用¶
插件遵循官方 Harness bundle manifest，通过 dsh plugin 安装到 profile。下面这条命令把插件装到 demo profile：
dsh plugin --profile demo add @anarkhgatsby/deepseek-harness-insights
随后正常启动 DSH：
dsh --profile demo
启动后进入 Harness 设置，即可看到 Usage insights 页面。如果之后想移除插件，执行：
dsh plugin --profile demo remove @anarkhgatsby/deepseek-harness-insights
本地开发¶
如果你在本仓库的 checkout 上做开发，同一个 bundle 也可以直接从本地路径安装：
dsh plugin --profile demo add ./packages/harness-insights
插件保留了 dsh.client 元数据，浏览器入口会随所需的 Harness client 服务一起加载。
打包与加载方式¶
两点值得了解的实现细节：
1、插件不含架构特定的原生模块，其构建产物由 macOS arm64、macOS x86_64、Windows x86_64 共享。
2、Harness Desktop 会将其纯 JavaScript 的 runtime 副本部署到 $DSH_HOME/node_modules 下的标准插件根目录，并通过 --patch overlay 加载。作为 web-only 插件，它注入 dsh-client-runtime、dsh-client-connection、dsh-client-locale、dsh-client-ui-settings 等客户端服务。
适用场景与注意¶
适合这样的场景：经常在 DSH 里跑会话、想在本地直观了解 token 与模型使用情况，又不愿意为此修改 Harness 源码的开发者。
安装前有几点需要注意：
- 这是独立、非官方的社区插件。插件以当前 dsh 进程权限运行，安装前建议先检查源码与许可证（MIT）。
- 插件仅面向 web 平台，目标
0.1.1-rc.2的 Harness projection 与 client APIs。Harness 版本升级后，需留意接口兼容性。 - 社区插件目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不要把它当作官方应用商店。
结尾¶
Harness Insights 的价值在于：不改上游源码，就在 Harness 里补上了一块本地优先的用量视图，数据边界也交代得清楚。如果你在用 DSH 且关心 token 去向，值得一试。
- 目录页：https://www.skillhub.cn/plugins/mapan0424/deepseek-harness-insights
- GitHub：https://github.com/mapan0424/deepseek-harness-insights
