前言¶
DeepSeek Harness 用戶通常管理許多會話、後臺任務和計劃提醒，但很難看到這些工作：何時運行、持續多久或何時觸發下一個重複任務。dsh-calendar 將現有的使用歷史轉化爲美觀的日曆視圖。
這是什麼¶
dsh-calendar 是一個 DeepSeek Harness 客戶端插件，由 YLifeOnlyOnce 維護，採用 MIT 許可證。它提供日、7 天、月和年視圖，以可視化 DeepSeek 的操作。插件零配置，無需額外數據存儲，並將歷史記錄在啓動時摺疊和緩存。
核心功能¶
插件提供多種視圖和交互方式：
- 時間軸視圖：提供 7 天時間軸（七列，每列一天，垂直 24 小時軸）和日時間軸（24 小時 Gantt 軸，按 workspace → session 分組）。
- 熱力圖與網格：年度熱力圖（GitHub 風格 52×7 貢獻圖）和月網格（經典日曆，帶每日熱力條和總計）。
- Workspace 頭部：時間軸行包含文件夾圖標、發光強調條和藥丸徽章，顯示會話數和活躍時間。
- 交互與導航：點擊時間軸條可打開實際對話；懸停任何單元格或條目可顯示窗口、持續時間和輪次。
- 可拖動卡片：主 UI 卡片（統計、年、7 天、日、月）浮動在主界面上。拖動
⠿手柄移動，使用▾摺疊，使用×關閉。 - 統計與追蹤：統計條顯示活躍時間、會話、輪次、工具調用和 tokens。Token 使用量按天、會話或 workspace 計費。
- 主題與動畫：跟隨 Harness 主題（淺色/深色），包含溫和的入場效果和解密揭曉標題。
安裝與啓用¶
- 執行安裝命令：
dsh plugin --profile web add dsh-usage-calendar
- 重啓
dsh web。 - 打開 Settings → 📅 Calendar。
典型用法¶
- 視圖切換：使用
‹›和 Today 在日、7 天、月和年視圖間切換。 - 快速跳轉：點擊熱力圖單元格、月單元格或時間軸條以跳轉到特定日期或對話。
- 卡片管理：拖動卡片手柄調整位置，使用
▾摺疊面板，使用×移除卡片。 - 信息查看：懸停任意單元格或條目查看具體窗口、時長和輪次計數。
兼容性與注意¶
- 版本要求：需要 DeepSeek Harness 0.1.1-rc.1（next）或 0.1.0-rc.7。
- 零維護：無需配置或額外數據存儲，插件以當前 Harness 進程權限運行。
- 預覽能力：無需運行 Harness 即可通過演示頁面預覽視覺效果。
總結¶
dsh-calendar 爲 DSH 用戶提供了可視化和追蹤使用模式的方法，將原始日誌轉化爲直觀的時間軸和日曆。有關源代碼和目錄，請訪問提供的 GitHub 鏈接。
