前言¶
用 DeepSeek Harness（DSH）跑智能體，對話會不斷累積：同一工作區下分叉、子代理、歸檔與未歸檔會話混在一起，側邊欄只能逐條點選，批量整理和查看磁盤佔用都不方便。官方側邊欄在 0.1.0-rc.8 起也收緊了行菜單，刪除入口不再向插件開放。
dsh-archived-sessions 是社區維護者 Zephyr-vibe 發佈的 DSH Web 插件（SkillHub 分類：記憶）。它在「設置」中提供「會話管理」面板，把本機所有對話集中瀏覽、搜索、歸檔、恢復與刪除，並支持打開會話記錄目錄。當前版本 0.1.5，MIT 許可證，GitHub 約 17 stars。
這是什麼¶
一句話：DSH Web 端的會話管理器，零配置讀取官方會話目錄佈局，不修改 DSH 核心。
插件按 $DSH_HOME/sessions/<project-key>/<session-id>/ 自動識別會話，歸檔與恢復走與官方 archiveSession 相同的 registry 狀態原語；刪除、詳情查詢等自定義邏輯通過插件自有 API 完成，且僅信任本機請求（127.0.0.1 / localhost / ::1），只調用官方公開 API（workspaceRegistry、sessionPersistence 等）。
核心功能¶
雙標籤與兩種視圖¶
設置面板分兩個標籤頁：
- 所有對話：未歸檔會話
- 歸檔會話：已歸檔記錄，可「移出歸檔」回到所有對話
每種標籤下可切換視圖：
- 單列表：按標題與相對時間排列，最近的在最前
- 按工作區分組：無工作區歸屬的會話歸入「未分組」
頂部搜索框支持按標題或 ID 即時過濾。
批量操作與詳情展開¶
支持勾選、拖動批量勾選、全選，以及批量歸檔（記錄保留）和批量刪除（永久刪除，帶確認彈窗）。大批量操作分批執行（每批 20 個），避免一次選中數百條時壓垮瀏覽器。
每行可展開詳情（默認收起），內容包括：
- 磁盤佔用、最後更新時間
- 活動統計：輪次、步驟、消息數、工具調用分佈、fetch 記錄
- 產出/下載文件列表（樹形文件夾、可切換顯示完整路徑）
- 父會話與子會話（分叉）關聯；子代理會話嵌套在父行下方（縮進 +「子代理」徽標），父會話缺失時自動浮爲頂層行
當前打開的會話顯示「當前會話」徽標，且不可刪除。
安全刪除¶
刪除父會話默認不級聯：子代理、分叉、下載/產出文件均保留，除非你顯式勾選。設置面板與批量刪除均帶確認彈窗。
自 DSH 0.1.0-rc.8 起，官方側邊欄行菜單（⋮）不再開放插件注入點（僅保留重命名、分叉、歸檔），插件將刪除會話入口放到已打開會話的標題欄（垃圾桶圖標），通過官方 conversation.session.header.actions slot 注入。確認彈窗可細粒度勾選：
- 子對話（子代理，含孫級）
- 下載/產出文件（可按文件夾整刪；工作區根目錄絕不可整刪）
默認均不勾選，只刪會話本身。運行中的會話拒絕刪除（409）。
打開記錄文件夾¶
選中會話後，可點擊「打開記錄文件夾」，在系統文件管理器中打開該會話記錄目錄。跨平臺調用 explorer（Windows）、open（macOS）、xdg-open（Linux）；無工作目錄的會話也支持 _no-cwd 佈局。
安裝與啓用¶
下面介紹兩種安裝方式，任選其一。
方式一：tarball 直接安裝¶
dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-archived-sessions/tar.gz/refs/heads/main
若 pnpm 攔截構建腳本，在命令末尾加 --ignore-scripts：
dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-archived-sessions/tar.gz/refs/heads/main --ignore-scripts
方式二：讓智能體安裝¶
告訴 DSH 智能體：
幫我把這個項目安裝爲插件：https://github.com/Zephyr-vibe/dsh-archived-sessions
智能體會下載項目、放入 profile 的 node_modules 並註冊到 dsh.profile.bundles。
安裝後重啓 Web 端，在「設置」中即可看到「會話管理」入口。插件要求 Node.js >= 20，peer 依賴 DSH 0.1.0-rc.6 及以上客戶端/宿主組件。
典型用法¶
整理歷史對話：打開設置 → 會話管理 →「所有對話」，切換到「按工作區分組」，勾選某個工作區下不再需要的會話，點「歸檔」；記錄保留，側邊欄不再顯示。
找回歸檔：切到「歸檔會話」標籤，選中條目，點「移出歸檔」。
查看會話產出：展開某行詳情，在活動統計與文件列表中確認工具調用與產出路徑；需要手動檢查時，選中會話點「打開記錄文件夾」。
刪除單條會話（rc.8+）：在 Web 端打開該會話，點標題欄垃圾桶圖標，在彈窗中按需勾選子對話或文件，確認刪除。
按 ID 定位：在搜索框輸入會話 ID 片段，列表即時過濾到目標行。
適用場景與注意¶
適合需要集中管理本機 DSH 對話的開發者：長期跑多工作區、頻繁分叉與子代理、磁盤佔用需要可見、或希望在 rc.8 之後仍能安全刪除會話。
使用前請注意：
- 插件以當前
dsh進程權限運行，可讀寫會話目錄與調用宿主 API；安裝前應閱讀 源碼 與 MIT 許可證，確認符合你的安全策略。 - 批量刪除不可恢復；確認彈窗中的子對話與文件選項務必看清再勾選。
- 詳情 API 對文件與 fetch 記錄有上限（文件 ≤ 200、fetch ≤ 50），極大單會話可能無法一次展示全部條目。
- 本插件來自社區目錄 SkillHub，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」，社區插件需自行評估兼容性。
鏈接¶
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/Zephyr-vibe/dsh-archived-sessions
- GitHub 倉庫：https://github.com/Zephyr-vibe/dsh-archived-sessions
若你已在用 DSH 且會話數量開始變多，這個插件把歸檔、搜索、詳情與安全刪除收到設置頁一處，比只在側邊欄逐條操作更可控。
