前言¶
在 DSH Web GUI 裏，會話被歸檔後，如果還要回看對話、恢復會話、整理標籤，或者關閉當前 dsh 進程，單純依賴側邊欄和日誌文件會比較分散。下面介紹的 dsh-archive-viewer 是一個面向 DSH Web GUI 的插件：它提供一個「已歸檔會話」面板，用於查看、搜索、篩選、恢復已歸檔會話，並在右上角提供一鍵關閉 dsh 的入口。
這是什麼¶
keepermttl/dsh-archive-viewer 是一個 MIT License 的 DSH Web GUI 插件，當前版本爲 3.0.0-test（測試版）。
它解決的主要問題是：已歸檔會話缺少集中查看和恢復入口，標籤整理、日誌查看、日誌導出、關閉 dsh 等操作分散在不同地方。這個插件把這些能力放到一個側邊欄面板裏。
核心功能¶
查看 / 恢復歸檔會話¶
插件會在側邊欄底部、設置按鈕上方提供「已歸檔會話」入口。打開後，可以查看歸檔會話的標題、最後活躍時間、所屬工作區、運行中/空白狀態等信息。
「恢復會話」會把已歸檔會話放回原工作區分組，位置原樣保留。
搜索、排序與標籤篩選¶
搜索框支持關鍵詞即時過濾，範圍包括標題、會話 ID、工作區，不區分大小寫。開啓「內容」模式後，會逐頁掃描每段會話最近的對話，每會話掃描頁數可在設置中調整。
工具欄支持按以下方式排序：
- 最近更新
- 名稱
- 會話 ID
排序可切換升序/降序。
標籤篩選收納在「篩選」按鈕菜單內，支持：
- 多選標籤
- AND / OR 模式
- 標籤搜索
標籤篩選可以和關鍵詞搜索疊加使用。
歸檔會話自定義標籤¶
用戶可以爲每個歸檔會話添加或刪除自定義標籤。標籤數據持久化在 DSH profile 目錄下的 dsh-archive-viewer-tags.json，並通過本地 HTTP API 讀寫：
GET /api/archive-viewer/tags
POST /api/archive-viewer/tags
POST /api/archive-viewer/tags 支持 add、remove、clearHidden 等操作。
內嵌 AI 助手¶
面板底部提供可摺疊的 AI 助手小窗口，用於調用 DSH 標準模式 agent，幫助檢索會話、添加標籤、整理歸檔。
AI 助手默認工作區爲：
E:\dsh-ai-workspace
也可以在設置中修改 AI 工作區。
AI 助手使用的會話會自動歸檔爲內部 helper 會話，不會出現在側邊欄和歸檔面板中。點擊「新對話」會安全刪除上一個 helper 會話，不會誤刪用戶會話。
隱藏臨時檢索標籤¶
agent 檢索命中後，會自動給會話添加隱藏標籤 agent檢索，並切換到對應篩選。該標籤不會顯示在會話徽章上，取消勾選後自動清除。
查看對話日誌與導出¶
插件支持查看歸檔會話對話日誌，讀取 session.history，並支持分頁加載更早內容。
日誌導出使用官方 session.export 端點，可下載 ZIP 文件。
界面與設置¶
插件支持列表豎列和橫排網格兩種排列方式。
面板頂部的介紹文本可以關閉，也可以在設置中重新開啓。
設置項即時持久化，保存在瀏覽器 localStorage 中，鍵爲：
dsh-archive-viewer:settings:v1
可設置項包括：
- 語言
- 排序
- 排列
- 內容搜索
- AI 模式
- AI 模型與思考強度
- AI 工作區
- 標籤篩選模式
- 介紹文本顯隱
- 恢復默認
插件支持中英雙語，默認跟隨瀏覽器語言自動切換，也可以在設置中手動覆蓋。
皮膚適配方面，插件使用 shell 設計令牌，並將面板 Portal 到 document.body，避免受皮膚側邊欄作用域的令牌覆蓋影響。
安裝與啓用¶
前置依賴¶
需要：
- Node.js >= 22
- pnpm
DSH 核心補丁依賴¶
「恢復會話」與「關閉 dsh」依賴 DSH 核心新增的兩個 RPC：
workspace.unarchiveSession
host.shutdown
截至 2026-08，官方尚未包含這兩個 RPC。
如果需要使用這兩個功能，使用前需先應用補丁，並重啓 dsh web。發佈包安裝用戶需重新構建受影響包。
安裝命令¶
POSIX 環境下的安裝/構建命令如下：
git clone https://github.com/keepermttl/dsh-archive-viewer.git
cd dsh-archive-viewer
pnpm install
pnpm build
dsh plugin --profile web add link:$(pwd)
執行完成後，重啓 dsh web，並在瀏覽器中按 Ctrl+F5 硬刷新。
典型用法¶
1、側邊欄底部（設置按鈕上方）點擊「已歸檔會話」，打開歸檔會話面板。
2、在搜索框輸入關鍵詞，即時過濾標題、會話 ID、工作區；點擊「內容」後，同時搜索對話內容。每會話掃描頁數可在設置中調整。
3、在工具欄選擇排序方式（最近更新 / 名稱 / 會話 ID），並切換升序/降序；點擊「篩選」按鈕打開標籤篩選菜單，可按標籤多選、選擇 AND / OR、搜索標籤。
4、點擊齒輪按鈕打開設置，調整語言、排序、排列、內容搜索、AI 模式、AI 模型與思考強度、AI 工作區、標籤篩選模式、介紹文本顯隱，或點擊「恢復默認」。
5、在單個會話行上執行操作：
查看對話
恢復會話
下載日誌 (ZIP)
複製 ID
標籤
6、在面板底部打開「AI 助手」，直接與 DSH agent 對話，讓它檢索會話、添加標籤或整理歸檔；點擊「新對話」會刪除上一個 AI helper 會話。
7、在會話頭部右上角點擊電源按鈕，確認後關閉 dsh。
適用場景與注意¶
適合已經在 DSH Web GUI 中產生較多歸檔會話、需要集中查看和恢復會話的開發者。
使用這個插件時需要注意：
- 當前版本爲
3.0.0-test（測試版）。 - 「恢復會話」與「關閉 dsh」依賴 DSH 核心新增 RPC，截至 2026-08 官方尚未包含。
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼和許可證。
- 從舊版本升級後，需要重啓
dsh web，因爲 host 半區新增了標籤存儲與/api/archive-viewer/tags本地 API。 - 該插件針對 DSH
0.1.0-rc.5源碼檢出開發驗證。 - 客戶端不 import 任何
@deepseek-ai/*值。
結尾¶
dsh-archive-viewer 把 DSH Web GUI 中較分散的歸檔會話查看、恢復、標籤整理、日誌導出和關閉 dsh 操作集中到一個面板中。它適合作爲 DSH 插件生態中的一個實用工具，用於處理已歸檔會話的日常管理。
項目倉庫：
https://github.com/keepermttl/dsh-archive-viewer
插件目錄線索：
https://www.skillhub.cn/plugins/keepermttl/dsh-archive-viewer
上述目錄頁來自插件線索，社區目錄與 DeepSeek / 幻方無官方從屬關係，不應理解爲官方應用商店。
