前言¶
如果你日常用 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
