DeepSeek Harness (DSH) 的核心架構是“一切皆插件”。在長期使用過程中，歷史會話會被歸檔存儲，但這些會話通常只存在於底層數據庫或文件系統中，缺乏直觀的 Web 管理界面。dsh-archived-list 插件解決了這個問題，它爲 Web 設置頁面增加了一個專用的“已歸檔 / Archived”管理入口，允許直接查看、恢復或刪除這些會話。
插件定位¶
- 名稱：dsh-archived-list
- 維護者：Yiklek
- 類別：記憶
- 許可證：MIT
該插件通過一個獨立的 Web 頁面覆蓋了 workspaceRegistry 的恢復寫入路徑，使得歸檔會話的管理操作變得可視化。
核心功能¶
該插件主要提供以下能力：
- 導航與分組：在 Web 設置頁面新增“已歸檔”導航行。列表按工作區分組顯示，每組內按時間倒序排列，並顯示會話總數。
- 會話信息：每一行顯示會話的標題（優先使用日誌回溯標題，降級使用客戶端列表或目錄名）以及完整的 Session ID（支持選中複製）。
- 多選操作：支持單行多選，以及按工作區分組全選。工具欄顯示“已選 N 項”，並提供恢復、刪除和取消選擇操作。
- 恢復機制：點擊恢復後，插件會將 Session ID 從
archivedSessionIds集合中移除，會話狀態恢復爲活躍，但默認不自動打開對話，保持設置頁面的開啓狀態。頁面包含兩個開關，可配置“恢復後自動打開”和“恢復後關閉設置頁”。 - 永久刪除：點擊刪除會觸發二次確認。操作順序爲：拒絕實時會話請求 -> 讀取持久化頭部定位日誌 -> 分離會話會計關係 -> 從歸檔集合中移除 ID -> 刪除磁盤上的日誌目錄。
安裝與啓用¶
使用官方 CLI 進行安裝：
npx @deepseek-ai/dsh plugin --profile web add github:Yiklek/dsh-archived-list
安裝完成後，需要重啓 DSH 服務（dsh web）以加載插件配置。
可以通過以下命令驗證插件是否正確注入配置：
dsh --profile web --dump-config | grep -A2 archived-list
典型用法¶
- 啓動
dsh web。 - 在瀏覽器打開 Web 設置頁面。
- 點擊左側導航欄中的“已歸檔 / Archived”。
- 勾選需要恢復或刪除的會話，使用頂部工具欄執行對應操作。
注意事項¶
- 服務端點：遠程服務命名空間爲
archvList，包含三個端點：archvList/list、archvList/restore和archvList/destroy。 - 依賴檢查：確保項目中的
@deepseek-ai/dsh-typert-protocol和@deepseek-ai/cordis包是 DSH 安裝目錄的符號鏈接（symlinks）。如果這兩個包指向了物理副本而非 DSH 自身，列表中的會話將顯示爲“(無標題)”。 - 會計邏輯：歸檔操作僅移除會話 ID，不影響工作區的會計統計；恢復和刪除操作則是其逆過程。
該插件適合需要在 Web 界面直接管理歷史會話、恢復重要對話上下文的 DSH 用戶。更多細節可參考項目目錄或源碼倉庫。
