前言¶
DeepSeek Harness (DSH) 允許通過 Web GUI 管理會話，並提供了基礎的歸檔能力。但在實際開發中，歸檔後的會話往往缺乏有效的管理手段，比如無法重命名、還原或刪除。crack-time/dsh-archive 是一個 Session archive plugin for DSH web GUI，它補齊了原生工具在歸檔會話管理上的缺失，提供了完整的增刪改查能力。
功能¶
視圖與入口¶
插件在側邊欄“添加工作區”按鈕右側新增了一個 28px 圓形按鈕，樣式與原生 iconButton 一致，hover 時顯示氣泡提示。點擊該按鈕可切換歸檔視圖，佈局與原生會話樹一致，覆蓋原工作區列表區域。
歸檔視圖¶
歸檔視圖按工作區分組，支持分組摺疊，列表按時間降序排列。
會話操作¶
每行會話 hover 出現三點菜單，提供以下操作：
- 重命名：使用原生彈窗，支持自動聚焦全選、中文輸入法保護、Enter 確認、Escape/遮罩關閉及錯誤內聯提示。
- 還原：將歸檔會話恢復到原工作區位置。
- 刪除：通過原生確認彈窗（紅色危險按鈕 + 後果說明）執行，會移除日誌文件，操作不可恢復。
API 接口¶
插件提供了以下 API 接口供調用：
- GET /api/archived：獲取歸檔會話列表（按工作區分組）。
- POST /api/rename-session：重命名會話。
- POST /api/unarchive：還原歸檔會話。
- POST /api/delete-session：刪除歸檔會話。
安裝與啓用¶
本插件需要手動鏈接本地包並編輯配置文件註冊。
- 鏈接本地包到 DSH web profile（一次性）：
dsh plugin --profile web add "link:E:\path\to\dsh-archive"
- 編輯配置文件註冊插件。路徑爲
C:\Users\<you>\.dsh\profiles\web\cordis.patch.yml，在文件中追加以下內容：
- insert:
- id: archive
name: '@crack/dsh-archive'
- 重啓 dsh web。
典型用法¶
- 點擊側邊欄新增的歸檔按鈕，切換至歸檔視圖。
- 在歸檔視圖中，通過行菜單對會話進行重命名、還原或刪除操作。
注意事項¶
- 刪除操作會移除對應的日誌文件，不可恢復，操作前請確認。
- 安裝時需要手動編輯
cordis.patch.yml文件，請確保路徑和配置正確。 - 插件以當前 DSH 進程權限運行，建議安裝前檢查源碼與許可證。
總結¶
crack-time/dsh-archive 通過側邊欄入口和原生風格的交互，爲 DSH Web GUI 增加了完整的會話歸檔管理能力，解決了原生工具在歸檔後“只能存、不好管”的痛點。更多詳情請參考項目目錄或 GitHub 倉庫。
