前言¶
DeepSeek Harness (DSH) 的理念是「一切皆插件」。當會話被歸檔後,它們會從側邊欄中隱藏,但 DSH 並未提供專門的 Web 界面來管理這些已歸檔的會話。dsh-archive-manager 是一個由 Ycet 維護的 Web 界面插件,它在 DSH Web 的設置窗口中新增了一個「歸檔」頁面。你可以通過這個頁面查看、篩選、排序已歸檔的會話,將其取消歸檔以恢復到側邊欄,或者徹底刪除它們。
核心功能¶
- 按工作區分組查看:已歸檔的會話會按所屬工作區分組展示,不屬於任何工作區的會話歸入「(未分組)」。
- 篩選與排序:支持按「全部工作區」、「具體工作區」或「未分組」進行篩選;支持按會話名稱或創建時間進行排序。
- 取消歸檔:將選中的會話從歸檔集合中移除,它會重新出現在左側邊欄對應的工作區分組中。
- 徹底刪除:支持刪除單個會話或「刪除全部」。所有刪除操作均需二次確認。刪除會移除會話日誌文件、歸檔標記及工作區記賬,不可恢復。
- 多語言界面:界面文案跟隨 DSH 的活動語言(中文 / English)。
安裝與啓用¶
在安裝前,請確保已安裝 DSH CLI 和 pnpm(dsh plugin 內部會調用 pnpm)。
使用以下命令安裝插件:
dsh plugin --profile web add github:Ycet/dsh-archive-manager
安裝後,重啓 DSH Web 應用即可生效。
使用步驟¶
- 重啓 DSH Web 應用(
dsh web)並打開 http://127.0.0.1:3080。 - 點擊左側邊欄底部的 設置。
- 在設置窗口左側選擇 歸檔 頁面。
- 使用工具條上的篩選下拉菜單過濾工作區或未分組會話,使用排序下拉菜單調整順序。
- 點擊「刪除全部」按鈕或單個會話的刪除操作,在彈出的二次確認窗口中點擊確認即可。
注意事項¶
- 無官方 API:由於 DSH 沒有提供官方的 unarchive 或刪除會話 API,本插件直接讀寫
storageDomain(即~/.dsh/storages/workspace.json),嚴格保持其 schema 結構。 - 徹底刪除:刪除操作會移除會話日誌文件(如
session.jsonl.zstd)、歸檔標記及工作區記賬,不可恢復。 - 二次確認:所有刪除操作(單個或全部)都需要二次確認。
- 無需配置:插件無需環境變量或配置文件,開箱即用。
- 版本兼容:插件依賴 DSH 0.1.0–rc.6 或更高版本。