DeepSeek Harness 允許並行管理多個會話，但在全局範圍內查看所有會話的交互歷史（用戶消息、助手回覆、工具調用）通常比較困難。現有的界面通常侷限於當前會話。dsh-calendar 插件提供了一個根作用域的日曆表面，將 Harness 中所有會話的交互事件聚合到一個視圖中。
插件定位¶
- 插件名稱：
dsh-calendar - 維護者：
necokeine - 許可證：MIT
- 核心價值：爲 DeepSeek Harness 提供一個跨會話的交互事件日曆，替代僅關注當前會話的單一視圖。
核心功能¶
- 全 Harness 視圖：提供統一的日曆界面，展示所有會話的交互事件（用戶消息、助手回覆、工具調用、回合邊界），而不僅限於當前會話。
- 實時更新：主機端通過 SSE 通道在事件被追加到日誌時，立即將新事件推送到打開的日曆中。
- 歷史回填：在啓動時填充已存在的會話，並通過
sessionPersistence盡力讀取持久化的日誌。 - 可擴展的合併：對於未知的（插件合併的）事件類型，插件會將其回退到類型名稱；無需維護每個類型的註冊表。
- 有界內存：採用滾動 90 天窗口策略，並限制每天最多保留 2000 個事件。
安裝與啓用¶
插件僅針對 DeepSeek Harness 的 Web 表面（dsh web）生效。
安裝命令如下：
dsh plugin --profile web add @necokeine/dsh-calendar
安裝完成後，重啓 dsh web 並刷新頁面，側邊欄底部會出現 Calendar 條目。該 Bundle 貢獻了一個唯一命名的 Loader 行；當前版本的 @deepseek-ai/dsh-web-app 組成部分不包含需要禁用或替換的日曆行。
若需移除：
dsh plugin --profile web remove @necokeine/dsh-calendar
典型用法¶
- 查看全局視圖：在側邊欄底部點擊 Calendar，即可查看全月視圖。每一天的單元格顯示當天的活躍會話數量，點擊某一天會列出該天的所有活躍會話及其標題、持續時間和事件數，展開後可查看原始事件列表。
- 查詢 JSON 數據：通過 HTTP 接口查詢指定日期範圍內的每日會話分桶數據：
GET /calendar/events?from=2026-09-01&to=2026-09-18
- 接收實時流：通過 SSE 通道接收實時事件幀：
GET /calendar/stream
注意事項¶
- pnpm 版本依賴：如果使用 pnpm ≥ 10，安裝 Git 源碼版本時會阻塞構建，除非在 profile 的
pnpm-workspace.yaml中將該包加入allowBuilds列表，且檢出目錄必須生成lib/。 - 無模型交互影響：該插件僅索引持久化的會話事件並暴露給 Web 日曆 UI，不會改變模型輸入或 KV-cache 行爲，也不會添加工具或提示詞部分。
- 插件兼容性：安裝過程不會自動覆蓋現有的日曆行，需確認當前 UI 組成部分未包含衝突的日曆組件。
總結¶
dsh-calendar 解決了 Harness 用戶在多會話並行開發時難以快速定位和回顧交互歷史的問題。它通過根作用域的日曆表面和實時 SSE 流，爲開發者提供了一個事實優先的全局交互視圖。更多細節可查閱 GitHub 倉庫 或 社區目錄。
