前言¶

DSH 的理念是「一切皆插件」，Web GUI 能力可以通過插件擴展。對於已經有歸檔會話的使用者，常見的問題是缺少一個集中的管理入口：需要確認某條歸檔會話是否還要繼續，或在確認無用後清理磁盤上的會話日誌。

下面介紹 @chushiz/dsh-archive-manager。它是 DeepSeek Harness Web GUI 的歸檔會話管理插件，用於瀏覽、恢復或物理刪除已歸檔會話。該插件由 ChuShiZ 維護，許可證爲 MIT。

這是什麼¶

@chushiz/dsh-archive-manager 是一個 DSH Web GUI 插件，入口在 設置 > 歸檔會話。

它主要提供三類操作：

• 瀏覽與搜索：按工作區查看已歸檔會話，並支持標題、目錄、id、預設、會話正文全文搜索。
• 恢復：取消歸檔並打開會話。
• 刪除：物理移除會話日誌目錄，不可逆。

核心功能¶

瀏覽與搜索¶

• 按工作區分組瀏覽已歸檔會話。
• 支持標題、目錄、id、預設、會話正文全文搜索。
• 基於 harness 的 sessionQuery SQLite FTS5 索引搜索用戶消息、AI 回覆、工具調用與參數、todo。
• 搜索結果命中高亮、關鍵詞居中短窗口、每會話最多 5 條，並可按類型篩選。

預覽、恢復與批量刪除¶

• 點擊標題展開最近 4 句對話預覽。
• “恢復並打開”會取消歸檔並打開會話。
• 多選複選框 + 頂部批量刪除。
• 刪除前自動停掉活着的 agent。
• 刪除會物理移除會話日誌目錄，操作不可逆。

安裝與啓用¶

先確認 DSH 版本與 Node.js 版本滿足下文要求，再執行安裝。

在 DSH 插件環境中執行官方安裝命令：

dsh plugin --profile web add @chushiz/dsh-archive-manager

安裝後重啓 dsh web。

啓用後進入 設置 > 歸檔會話 頁面，即可使用本插件。

典型用法¶

下面按實際操作順序說明。

1、進入 設置 > 歸檔會話，按工作區瀏覽已歸檔會話。

2、輸入關鍵詞搜索。搜索範圍包括標題、目錄、id、預設、會話正文全文。

3、需要確認目標會話時，點擊標題查看最近 4 句對話預覽。

4、如果會話仍有用，選擇“恢復並打開”，插件會取消歸檔並打開會話。

5、如果會話無用，先使用多選複選框選擇目標會話，再通過頂部批量刪除執行刪除。

6、批量刪除前會自動停掉活着的 agent；刪除會物理移除會話日誌目錄，不可逆。

版本與運行環境¶

已覈實資料給出的版本與依賴要求如下：

dsh >= 0.1.0-rc.7：支持（FTS5 搜索 + 服務直連）
dsh < 0.1.0-rc.7：未驗證（依賴 sessionQuery.searchSessions 與 webServer 載體）
Node.js ^22.19 || >=24（隨 dsh 要求）
peerDependencies:
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-client-runtime ^0.1.0-rc.8

運行時的回退行爲：

• 無 FTS 後端（openAt: never）時自動回退逐會話掃描。
• 服務未代理到瀏覽器時自動回退 HTTP API。

權限邊界¶

插件的 host 側與 client 側邊界如下：

• host 側操作工作區註冊表的歸檔集合與持久化狀態：list 只讀、unarchive 反向歸檔、delete 經 shell 移除日誌目錄。
• 不寫日誌、不註冊面向模型的工具。
• client 側註冊設置頁 settings.section，通過 archiveManager 服務調用以上操作。

由於 delete 會經 shell 移除會話日誌目錄，因此需要按當前 DSH 進程權限理解其影響。安裝前建議先檢查源碼與許可證，再執行物理刪除。

結尾¶

@chushiz/dsh-archive-manager 把歸檔會話的常見管理動作集中在 DSH Web GUI 的設置頁裏：按工作區瀏覽、全文搜索、預覽、恢復並打開，或在確認無用後物理刪除。

已覈實資料未提供目錄頁 URL。項目 GitHub 倉庫：

https://github.com/ChuShiZ/dsh-archive-manager