DeepSeek Harness (DSH) 採用插件化架構，日常開發中會積累大量會話。隨着時間推移，未歸檔的會話會佔據內存或存儲空間，且難以檢索。現有的歸檔機制較爲基礎。針對這一場景，出現了專門處理會話生命週期管理的插件。
dsh-archive-viewer 是一個歸檔增強插件，由 csiroqa 維護，歸類於「記憶」類別。它的核心功能是自動定期歸檔空閒會話、整理文件夾、沉澱 LLM 摘要經驗庫，並提供歸檔會話的查看、恢復與一鍵關閉 dsh 的能力。
核心功能¶
- 自動定期歸檔：插件會掃描 host 半區，將處於非運行狀態、最後活躍早於設定天數（默認 7 天）、未被 pin 且未被歸檔的會話自動移入歸檔區。歸檔操作是冪等的，日誌、附件與工作區分組位置完整保留。
- 文件夾歸檔整理：提供樹形文件夾結構，包含「全部歸檔」、「自定義文件夾」、「未分類」、「收藏」和「經驗庫」。支持新建、重命名、刪除文件夾，並可將會話在文件夾間移動。歸屬關係持久化在
$DSH_HOME/archive_snapshots/folders.json。 - 批量操作：支持勾選多個會話後進行批量導出 ZIP、生成摘要、恢復（取消歸檔）或移動到指定文件夾。
- 查看與日誌：支持直接讀取歸檔會話日誌（
session.history），也支持下載日誌 ZIP 包，並支持分頁加載更早的歷史記錄。 - 經驗庫沉澱：利用 LLM 生成結構化摘要（目標、關鍵決策、產出、可複用經驗、遺留問題），以 Markdown + JSON 格式寫入
$DSH_HOME/archive_snapshots/。面板提供「經驗庫」視圖，支持全文檢索與重新生成。 - 會話收藏與便籤：支持對會話進行收藏標記和便籤記錄，收藏視圖展示所有收藏會話（含未歸檔），數據持久化在
bookmarks.json。 - 皮膚全適配：插件使用 DSH 的 shell 設計令牌，自動跟隨任意皮膚，避免面板被側邊欄樣式覆蓋。
- 系統控制：提供會話頭部右上角的電源按鈕，支持一鍵關閉 dsh（需核心補丁支持）。
安裝與啓用¶
前置要求：Node.js >= 22 和 pnpm。
git clone https://github.com/csiroqa/dsh-archive-viewer.git
cd dsh-archive-viewer
pnpm install
pnpm build
# 安裝進 web profile（link: 指向本目錄）
dsh plugin --profile web add link:$(pwd)
安裝後需要重啓 dsh web 並執行瀏覽器硬刷新。
典型用法¶
- 打開面板：在側邊欄底部（設置按鈕上方）點擊「已歸檔會話」打開管理面板。
- 瀏覽與操作：在左欄文件夾樹中切換視圖。點擊會話卡片可查看對話、生成摘要、收藏/寫便籤、恢復或導出 ZIP。
- 批量操作：勾選多個會話後，底部會出現批量操作條，可進行批量生成摘要或導出。
- 經驗庫檢索：在面板中切換到「經驗庫」視圖，檢索已生成的 LLM 摘要。
- 關閉 dsh：在會話頭部右上角點擊電源按鈕，確認後關閉當前 dsh 進程。
注意與限制¶
依賴核心補丁：插件中的「恢復會話」和「一鍵關閉 dsh」功能依賴 DSH 核心補丁（workspace.unarchiveSession 和 host.shutdown RPC）。截至 2026-08，這兩個 RPC 尚未包含在官方代碼中。安裝前需在 DSH 源碼目錄應用對應的 .patch 文件（位於插件目錄的 patches/ 下），否則這些功能不可用。若 DSH 官方後續合入這兩個 RPC，補丁將變爲空操作，可安全跳過。
配置項：通過 cordis.patch.yml 中的 archive-viewer 插入行配置。
* autoArchiveEnabled: 控制自動歸檔開關（默認 true）。
* maxIdleDays: 設置空閒多少天后歸檔（默認 7 天）。
* scanIntervalMinutes: 掃描週期（默認 30 分鐘）。
* summarizeEnabled: 控制自動生成摘要（默認 true）。
* provider / model: 配置用於生成摘要的 LLM 路由。
* 注意：生成摘要會消耗模型 token，每次會話完成或點擊生成摘要都會發起一次請求。
數據存儲：插件產生的數據（文件夾結構、書籤、摘要）保存在本機 $DSH_HOME/archive_snapshots/ 目錄下，請勿將該目錄暴露給不可信進程。
總結¶
該插件通過結構化的歸檔管理，幫助開發者長期保存和檢索會話內容。更多細節和源碼請查看項目主頁：GitHub。
