前言¶
用 DeepSeek Harness 做日常對話和開發時，會話日誌裏其實已經有 token 與模型信息，但客戶端默認不會把這些彙總成「哪天用了多少、大概花了多少錢」。若只靠翻歷史會話或外部記賬，很難一眼看出近一年的使用節奏。
下面介紹社區插件 dsh-activity-heatmap（維護者 ZhouXiaoXian233，分類爲客戶端）。它在 Harness 裏實現類似 GitHub 個人主頁的日曆熱力圖：一格代表一天，顏色反映當天使用強度，並附帶 token 統計與按模型拆分的估算金額。數據只讀會話事件，不改會話內容。
這是什麼¶
dsh-activity-heatmap 是 DeepSeek Harness 的客戶端插件，npm 包名同爲 dsh-activity-heatmap，當前版本 0.1.0，許可證 MIT。運行環境要求 Node.js >= 20、DSH >= 0.2.0-rc.1。
插件通過 dsh.bundle.patch 與 dsh.client 接入：裝好後側邊欄會出現入口，無需額外改 Harness 主配置即可打開整頁熱力圖。
核心功能¶
日曆熱力圖¶
- 側邊欄底部圖標行最右側增加熱力圖圖標，點擊進入「活動熱力圖」整頁。
- 默認展示近 365 天的格子，並自動鋪滿窗口寬度；右上角可切換「近 365 天 / 近 90 天 / 近 30 天 / 全部」，格子數量與統計範圍同步變化。
- 統計卡片與「按模型統計」表均跟隨當前所選時間段。
格子顏色含義¶
| 顏色 | 含義 |
|---|---|
| 灰 | 當天沒有任何記錄（含未打開應用） |
| 最淺綠 | 當天打開過應用，但沒有發起對話 |
| 淺綠 → 深綠（4 檔） | 當天活躍度按近 365 天活躍日的 25 / 50 / 75 分位分檔 |
活躍度分計算公式：
對話輪數 + 模型調用次數 + 計費 token ÷ 10000
其中計費 token = input + output + (cacheRead + cacheWrite) × 0.1（緩存讀寫按 1/10 權重，避免長上下文把分數拉高）。活躍日不足 4 天時，退化爲按當期最大值線性分檔。
數據來源與賬本¶
插件只讀會話日誌裏 assistant/message 事件的 usage 與 provider:model，不修改任何會話內容。
- 歷史會話在首次請求時自動回放補齊；之後通過
session/event實時累加。 - 每個會話記錄已摺疊到的事件序號，重複掃描不會重複計數；fork 出來的會話會跳過繼承事件。
- 「打開過應用」由側邊欄圖標每 5 分鐘發一次心跳記錄。
本地狀態與診斷文件位於 $DSH_HOME/storages/activity-heatmap/：
state.json：賬本（刪除即可清零，重啓後重新回放）probe.log：請求記錄last-payload.json：最近一次下發的數據
單價與估算金額¶
頁面「價格設置」可改默認價與各模型單價，保存後立即生效，寫入 $DSH_HOME/storages/activity-heatmap/config.json，無需重啓。
- 單位：元 / 1M tokens，分「緩存命中 / 緩存未命中 / 輸出」三檔。
- 未單獨配置的模型使用默認價，默認值爲 DeepSeek 官方參考價 0.2 / 2 / 3（cacheHit / cacheMiss / output）。
custom-api:*爲私有網關，無公開價，若要準確金額需在彈窗或配置裏填寫自有單價。
也可直接編輯配置文件（同樣即時生效）：
{
"currency": "CNY",
"default": { "cacheMiss": 2, "cacheHit": 0.2, "output": 3 },
"models": {
"custom-api:deepseek-flash": { "cacheMiss": 4, "cacheHit": 1, "output": 16 }
}
}
安裝與啓用¶
任選其一即可。
插件市場：在 DSH 插件市場中搜索 dsh-activity-heatmap 或「活動熱力圖」，一鍵安裝。
npm：安裝包名 dsh-activity-heatmap（含 dsh.bundle.patch 與 dsh.client），裝完即出現在側邊欄。
本地開發：將倉庫路徑以 link: 形式寫入 profile；改完文件後停用/啓用一次插件即可熱重載。
典型用法¶
- 完成安裝後，在側邊欄底部找到熱力圖圖標並打開整頁視圖。
- 根據需要切換「近 365 天 / 近 90 天 / 近 30 天 / 全部」，查看對應時段的格子與彙總。
- 若使用
custom-api:*或需要更貼近賬單的單價，點擊「價格設置」或編輯config.json後保存，頁面估算會立即更新。 - 若要清空統計從頭回放，刪除
$DSH_HOME/storages/activity-heatmap/state.json後重啓 DSH。
適用場景與注意¶
適合：長期在 DSH 裏對話、希望用日曆直觀看到使用節奏，並希望在客戶端內做 token 與粗略費用估算的開發者。
注意：
- 插件在當前 DSH 進程權限下運行，會讀取本地會話日誌並寫入
$DSH_HOME/storages/activity-heatmap/。安裝前建議瀏覽 GitHub 倉庫 源碼並確認 MIT 許可證是否滿足你的環境要求。 - 社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」，本插件爲社區貢獻的客戶端擴展。
結尾¶
dsh-activity-heatmap 把 Harness 裏分散的 usage 事件彙總成可切換時間範圍的 GitHub 式熱力圖，並在同一頁完成按模型的 token 與估算費用展示；只讀日誌、本地賬本，適合作爲日常使用的自檢視圖。
- 目錄頁：https://www.skillhub.cn/plugins/ZhouXiaoXian233/dsh-activity-heatmap
- GitHub：https://github.com/ZhouXiaoXian233/dsh-activity-heatmap
