前言¶
使用 DeepSeek Harness（DSH）時，會話日誌和統計信息通常散落在各自的界面中：會話列表、運行記錄、Token 計數。想要快速瞭解「這週發了多少條消息」「最近一個月 Token 消耗如何」需要在不同頁面之間切換。一種直觀的方式是把每日活動畫成網格圖：一天一個方格，有活動就高亮，不同顏色表示活動強度。這種方式在 GitHub 的貢獻日曆中已經非常成熟，把它引入 DSH 的 Web 界面可以讓使用情況一目瞭然。
這是什麼¶
dsh-conv-calendar 是一個 DeepSeek Harness 插件，由 Leni-More 維護。它在 DSH Web 界面的左側欄增加一個「Conversation calendar」入口，打開後顯示一個 GitHub 風格的貢獻日曆網格。網格按本地時間統計過去 53 周的數據，每個方格對應一天，顏色深淺表示該天的活動量。插件同時提供四種指標切換：Prompts（發送的消息數）、Conversations（活躍會話數）、Tokens（總 Token 消耗）和 Output（模型輸出 Token）。點擊某個方格可以查看當天的詳細統計。
核心功能¶
- 側邊欄入口：在 Web GUI 左側欄顯示一個圖標，點擊打開全頁日曆視圖。
- GitHub 風格網格：顯示最近 53 周，從週一爲起始日，五個顏色深淺，每天一個方格。
- 四種指標：
- Prompts：當天發送的消息數量
- Conversations：當天活躍的會話數
- Tokens：當天總 Token 消耗（輸入 + 輸出 + 緩存讀取）
- Output：當天模型輸出 Token 數量
- 統計卡片：根據當前選擇的指標顯示總活動天數、當前連續天數（含最長連續天數）、本月活動、上月活動和單日最高活動量。
- Token 細分：在 Tokens 或 Output 模式下，鼠標懸停在方格上會顯示
in · out · cached的細分數據。 - 主題適配：顏色來自 DSH 的主題變量，淺色和深色模式都能正常顯示。
- 雙語：跟隨 UI 語言切換中英文。
安裝與啓用¶
安裝前需要確保滿足環境要求：
- DeepSeek Harness 版本 0.2.1-rc.2 或兼容版本
- Node.js 22.15 或更高版本（用於日誌的 zstd 壓縮解析）
從 npm 安裝（推薦）：
dsh plugin --profile desktop add dsh-conv-calendar
從本地 checkout 安裝：
dsh plugin --profile desktop add link:/absolute/path/to/dsh-conv-calendar
安裝後需要重啓 DeepSeek Harness。插件在啓動時從配置文件讀取 bundle 列表，因此必須重啓才能生效。重啓後，左側欄會出現「Conversation calendar」圖標，打開即可看到已填充的歷史數據，當天發送新消息後對應的方格會逐漸加深。
卸載時執行：
dsh plugin --profile desktop remove dsh-conv-calendar
如果插件導致應用無法啓動，可以通過編輯 $DSH_HOME/profiles/<name>/package.json 中的 dsh.profile.bundles 字段刪除 dsh-conv-calendar 行，而不是使用恢復對話框。
典型用法¶
安裝並重啓後，默認顯示最近 53 周的日曆。在左側欄點擊「Conversation calendar」圖標進入全頁視圖。頂部可以選擇四種指標：Prompts、Conversations、Tokens、Output。切換指標時，下方的統計卡片會同步更新。
在 Tokens 或 Output 模式下，將鼠標懸停在某個方格上，會顯示當天的詳細數據：輸入 Token、輸出 Token 和緩存讀取 Token。這對於分析緩存命中率或優化 Prompt 長度很有幫助。
插件會自動從當前的 session/event feed 中實時計數新消息和回覆。對於歷史數據，它會通過 Host 的 ctx.sessionQuery 接口進行回填，每條會話只讀取一次，活動會話每次刷新都會重新讀取併合並。回填過程有 8 秒的時間預算，剩餘部分在下次刷新時繼續。
適用場景與注意¶
適合經常使用 DSH 進行多會話開發的用戶，希望直觀查看每日活動量、追蹤長期使用習慣或分析 Token 消耗模式。
注意以下幾點：
- 插件在 Host 進程中運行，讀取本地會話日誌。確保日誌路徑和權限正確。
- 安裝前建議查看源碼與許可證（MIT）。
- 某些指標可能顯示不同結果。例如，只有模型回覆而沒有用戶發送消息的一天，在 Prompts 指標下爲 0，但在 Tokens 指標下可能有值。
- 狀態文件位於
$DSH_HOME/plugins/dsh-conv-calendar/state.json，刪除該文件會清除所有統計數據，下次啓動時重新構建。
總結¶
dsh-conv-calendar 爲 DSH 用戶提供了一個直觀的方式查看每日對話量和 Token 消耗。通過 GitHub 風格的網格和四種指標切換，可以在 Web 界面中快速掌握使用情況，幫助優化工作流和資源分配。
- 目錄頁：https://www.skillhub.cn/plugins/Leni-More/dsh-conv-calendar
- GitHub：https://github.com/Leni-More/dsh-conv-calendar
