前言¶

DeepSeek Harness（dsh）是 DeepSeek AI 開源的智能體框架，官方口號是「一切皆插件」：模型、工具、會話、沙箱和 Web 界面都通過插件組合。日常用 Web UI 跑任務時，本機上的對話會越積越多——有的已經結束，有的只是中間分叉，有的還掛着子代理。側邊欄能切換當前會話，但要把整機對話按工作區清點、歸檔、恢復，或安全刪掉不再需要的記錄，默認界面並不夠用。

社區維護者 Zephyr-vibe 做了一個 Web 插件 dsh-archived-sessions：在「設置」裏提供會話管理頁，把本機上的對話集中到一處處理。本文按插件目錄頁、GitHub 倉庫 README / package.json，以及官方 deepseek-ai/deepseek-harness 交叉覈對後整理。社區插件目錄 deepseek-harness-plugin.com 是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不能當成官方應用商店。

這是什麼¶

dsh-archived-sessions 是一款面向 DeepSeek Harness Web 端的會話與消息插件，由 Zephyr-vibe 維護，許可證爲 MIT，主要語言是 JavaScript。倉庫當前版本號是 0.1.2（package.json），GitHub 截至 2026-08-17 顯示 13 個 star；目錄頁收錄時顯示爲 7，星標以倉庫爲準。

它解決的問題很具體：在「設置」中提供會話管理入口，統一管理本機上的全部對話。目錄頁的概括是：管理對話、歸檔 / 恢復、安全刪除、打開記錄目錄。README 寫得更完整——未歸檔和已歸檔分兩個標籤頁，還可以按工作區分組、按標題或 ID 搜索、展開單條詳情。

GitHub 上另有同名倉庫，維護者不同。安裝時請覈對 owner 爲 Zephyr-vibe，不要裝錯來源。

核心功能¶

以下能力來自倉庫 README（中英雙語說明一致）和 0.1.2 更新日誌，不是猜測。

雙標籤與兩種視圖¶

頁面分成兩個標籤：

• 所有對話：未歸檔會話
• 歸檔會話：已經歸檔的會話；在這一頁可以把會話移出歸檔，回到「所有對話」

視圖可以在單列表和按工作區分組之間切換。沒有工作區歸屬的會話會落到「未分組」。列表按標題加相對時間展示，最近的排在最前；相對時間會自動刷新。

搜索與批量操作¶

頂部有搜索框，按標題或會話 ID 即時過濾。選擇方式包括勾選、拖動批量勾選、全選，也支持鍵盤（Tab + Enter / Space）。

批量動作分兩類：

• 歸檔：記錄保留，只改歸檔狀態
• 刪除：永久刪除，帶確認彈窗

0.1.2 把批量操作改成分批執行，每批 20 條，避免一次勾選幾百條時把瀏覽器打滿請求。

詳情、子代理與「不級聯刪除」¶

每一行默認收起，展開後可以看到：

• 磁盤佔用、最後更新時間
• 活動統計：輪次、步驟、用戶 / 助手消息數、工具調用分佈、fetch 記錄
• 該會話產出或下載的文件
• 父會話與子會話（分叉）關係

子代理會話嵌套在父會話下方，帶縮進和「子代理」徽標，默認摺疊，點父行箭頭再展開。父會話被刪或缺失時，子代理會浮成頂層行，在工作區視圖裏仍然可見。

刪除是刻意做成不級聯的：只刪你勾選的那一條。子代理、分叉、下載 / 產出文件都保留，除非你把它們也勾上。當前打開的會話會標「當前會話」，界面不允許刪除。正在運行的會話刪除會被拒絕（HTTP 409）。刪一個不存在的會話則返回 404。

文件刪除也收得很緊：只能刪該會話自己的產出文件，拒絕刪目錄，並帶確認彈窗和失敗彙總。詳情接口還有上限（文件最多 200 條、fetch 最多 50 條），避免超大會話把頁面拖死。

打開記錄文件夾¶

選中會話後可以點「打開記錄文件夾」，用系統文件管理器打開該會話的記錄目錄。Windows / macOS / Linux 分別走 explorer / open / xdg-open。沒有工作目錄的會話走 _no-cwd 佈局，0.1.2 起同樣支持打開。

實現邊界（README 兼容性說明）¶

README 把兼容性寫成四點，和功能承諾直接相關：

• 零配置：會話目錄按官方 DSH 佈局（$DSH_HOME/sessions/ 下的標準路徑）自動識別，不需要對 Harness 核心打補丁
• 歸檔 / 恢復：用和官方 archiveSession 相同的 registry 狀態原語
• 刪除不級聯：只刪所選會話；運行中的會話拒絕刪除
• 本機 API：接口只信任 127.0.0.1 / localhost / ::1，並聲明只使用官方公開 API（workspaceRegistry、sessionPersistence）

package.json 把客戶端平臺標成 web，peerDependencies 對準 @deepseek-ai/dsh-* 的 ^0.1.0-rc.6，並要求 Node.js >=20。DeepSeek Harness 本身仍處於開發者預覽，官方 README 寫明未來可能出現破壞兼容性的變更，插件版本需要跟着宿主一起看。

安裝與啓用¶

目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端裏執行即可：

dsh plugin add github:Zephyr-vibe/dsh-archived-sessions

這是目錄頁原文，不要自行拼接倉庫名。需要可復現安裝時，按目錄頁說明把 commit 哈希釘在後面。本文覈對倉庫時，main 最新提交是 1e8d1b55f72438209c1036de82a3455d3d6a657d（2026-08-16），可以寫成：

dsh plugin add github:Zephyr-vibe/dsh-archived-sessions#1e8d1b55f72438209c1036de82a3455d3d6a657d

哈希會隨倉庫更新變化，安裝前請再打開 GitHub 確認一次。

倉庫 README 另外提供了針對 web profile 的 tarball 安裝，適合明確裝到 Web 端的情況：

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

也可以直接對智能體說：

幫我把這個項目安裝爲插件：https://github.com/Zephyr-vibe/dsh-archived-sessions

README 說明：agent 會下載項目、放入當前 profile 的 node_modules，並註冊到 dsh.profile.bundles。

安裝完成後需要重啓 Web 端。官方啓動方式之一是：

npx @deepseek-ai/dsh web

重啓後，在「設置」裏應能看到「會話管理」入口。

典型用法¶

下面步驟來自 README 的功能說明，不是額外編出來的操作手冊。

1. 打開 DeepSeek Harness Web UI，進入「設置 → 會話管理」。
2. 在「所有對話」裏瀏覽未歸檔會話。對話多的時候，用搜索框按標題或 ID 過濾；需要按項目歸類時，切到「按工作區分組」。
3. 勾選已經結束、但仍想留底的會話，執行批量歸檔。歸檔後記錄還在，只是從「所有對話」挪到「歸檔會話」。
4. 以後要繼續某次歸檔對話，到「歸檔會話」裏把它移出歸檔，會話會回到「所有對話」。
5. 確認某條記錄不再需要後，勾選並刪除。先看確認彈窗；不要指望刪父會話會連帶清掉子代理——那是不會發生的，子代理要單獨勾選。
6. 當前正在看的那條會話不能刪；如果刪除按鈕不可用，先換到別的會話再處理。
7. 需要覈對磁盤上的 jsonl 或產出文件時，選中會話，點「打開記錄文件夾」，在系統文件管理器裏直接看目錄。
8. 展開某一行，可以覈對該會話佔了多少空間、跑了多少輪、調用過哪些工具、有沒有下載文件，以及它和父 / 子會話的關係。

倉庫 README 帶了兩組界面截圖：歸檔視圖裏子代理嵌在父會話下，以及批量刪除確認和帶活動統計的詳情面板。需要對照界面時，直接看 GitHub 倉庫即可。

適用場景與注意事項¶

比較適合這幾類用法：

• 同一臺機器上跑過多個工作區，想按項目清點對話，而不是隻靠側邊欄
• 對話已經結束，但記錄還要留着，先歸檔而不是立刻刪
• 子代理、分叉很多，刪除時必須避免誤傷子會話和產出文件
• 需要打開會話目錄，覈對持久化文件或下載產物

使用前有幾件必須看清的事。

插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。這是目錄頁的安全提示，不是客套話。安裝前應閱讀 GitHub 源碼和 MIT 許可證；不信任的來源不要裝。

它是 Web 插件，peer 依賴對準 0.1.0-rc.6 一帶的官方包。Harness 還在開發者預覽，API 和槽位都可能變。裝完如果設置裏沒有「會話管理」，先確認裝的是 web profile，並已經重啓過 Web 端。

刪除是永久的。歸檔只改狀態，刪除會去掉會話目錄。雖然刪除不級聯、當前會話受保護、運行中會話會返回 409，勾選批量刪除前仍應看清選中了哪些行。

管理接口只接受本機迴環地址。不要把 Harness Web 端口暴露到公網後再依賴這層限制；那是本機防護，不是遠程鑑權。

社區裏還有其他「歸檔會話 / 會話管理」插件，能力邊界並不相同。有的只管理已歸檔列表，有的依賴給核心打補丁。dsh-archived-sessions（Zephyr-vibe）在 README 裏明確寫的是：純淨 Harness、官方 API、無核心補丁。選插件時以各自倉庫說明爲準。

小結¶

dsh-archived-sessions 把本機 DeepSeek Harness 的對話收進設置頁：未歸檔和歸檔分開看，能搜索、能按工作區分組，歸檔與恢復走官方同一套狀態，刪除帶確認且不級聯，還可以直接打開記錄目錄。維護者是 Zephyr-vibe，MIT 許可，當前版本 0.1.2。

目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-archived-sessions/

GitHub：https://github.com/Zephyr-vibe/dsh-archived-sessions