前言¶
DeepSeek Harness (DSH) 的 Web GUI 支持歸檔會話，但側欄菜單隻能隱藏它們，沒有取消歸檔的入口，也無法刪除會話日誌。這個插件由 JIUYUE-SEP 維護，補上了這一頁：列出所有已歸檔會話，並提供還原、排隊刪除和徹底刪除等缺失的操作。
核心功能¶
插件提供以下能力：
* 列表查看：列出所有已歸檔會話，顯示標題、工作區、目錄、歸檔時間與磁盤佔用。
* 還原會話：將歸檔會話移除並回到側欄原位。
* 徹底刪除：二次確認後刪除會話日誌目錄、投影緩存與工作區記賬。
* 排隊刪除 / 取消排隊：將無法立即刪除的會話排隊，下次啓動時自動刪除；可隨時取消。
* 釋放會話：需宿主提供 agents.release(id) 能力，用於卸載常駐會話。
* 清理失效記錄：移除磁盤上已不存在的記錄。
安裝與啓用¶
使用官方安裝命令即可完成依賴掛載：
dsh plugin --profile web add github:JIUYUE-SEP/dsh-plugin-archive-shelf
安裝後，必須重啓 DeepSeek Harness（Ctrl+C 後重新執行 dsh web）並刷新頁面。靜態客戶端插件隨頁面 boot graph 下發，單純刷新不保證生效。
典型用法¶
- 打開 設置 頁面，在 歸檔架（位於「Agent 預設」下方）查看已歸檔會話列表。
- 點擊 「還原」 將會話恢復到側欄原位。
- 點擊 「徹底刪除」 移除會話日誌。
- 點擊 「排隊刪除」 處理無法立即刪除的會話（如正在運行或常駐的會話）。
- 點擊 「清理」 移除磁盤上已不存在的記錄。
重要說明¶
- 內部 API 依賴：取消歸檔依賴 DSH 的內部 API，若產品內部結構變更，插件會報錯。
- 會話刪除限制：常駐或運行中的會話無法直接刪除。需使用“排隊刪除”（下次啓動時生效）或宿主提供的“釋放”能力。
- 釋放能力要求：“釋放”按鈕需宿主提供
agents.release(id)能力。若宿主未提供此能力，按鈕不會出現。 - 附件與不可恢復：刪除操作不回收附件，且不可恢復。
- 運行中歸檔：產品允許歸檔正在運行的會話，歸檔架中的“運行中”徽標用於提示。
開發與維護¶
插件無構建步驟，直接發佈純 JavaScript 代碼。開發測試可通過 npm test 運行兩套件（客戶端契約/渲染 + 宿主行爲）。
- 許可證：MIT
- 維護者：JIUYUE-SEP
