前言¶
在 DeepSeek Harness（DSH）裏，會話歸檔後通常要從列表裏「恢復」才能繼續看完整對話。若你只想覈對某次歸檔裏的工具調用、壓縮前的原文，或按工作區篩一批歷史會話，反覆取消歸檔再改回去既麻煩，也容易誤改狀態。下面介紹的 dsh-archive-viewer 是維護者 qinu321 發佈的客戶端插件：對已歸檔會話做只讀查看，歸檔標誌在瀏覽期間不會被改動。
這是什麼¶
dsh-archive-viewer（npm 包名 dsh-archive-viewer）是已歸檔 DSH 會話的只讀查看器。它掛在 Web 客戶端「會話管理」一側，打開彈窗即可瀏覽歸檔列表、閱讀完整對話（含工具調用、上下文壓縮點等），無需先取消歸檔。分類屬於 DSH 生態裏的客戶端插件；社區目錄頁見 skillhub.cn，源碼與說明在 GitHub 倉庫。許可證爲 MIT。
核心功能¶
入口與列表¶
側邊欄在「會話管理」右側：展開時顯示圖標與「查看歸檔」整行，收起爲窄條時僅圖標（懸停有同名提示），點擊打開查看器彈窗。
歸檔列表展示標題、創建時間、所屬工作區、日誌大小、缺失標記；支持按標題 / 會話 ID / 工作區搜索，以及按工作區篩選。列表數據來自 DSH 客戶端已有的會話快照，打開即渲染，不設條數上限、不向宿主分頁拉取；界面每次渲染 200 行，點「顯示更多」僅在前端追加行，不發起額外請求。
完整對話與壓縮點¶
右欄可讀用戶消息、助手消息（思考過程可摺疊）、工具調用與結果（參數與結果可展開）、輪次邊界，以及注入的上下文與系統事件摘要。只有用戶親手輸入的內容標爲「用戶」；時間快照、後臺任務通知、技能目錄等系統上下文與「別的會話轉述」分別單獨標註，注入上下文默認摺疊。
若會話發生過上下文壓縮，壓縮處顯示「上下文壓縮」卡片（可展開查看摺疊了哪些記錄及摘要），壓縮前的對話仍按原文展示；被剪枝的舊工具結果也保留原文。
只讀與恢復¶
界面橫幅標明只讀。除「恢復並繼續對話」外無寫操作：該按鈕會取消歸檔並打開會話，在此之前歸檔狀態不會被修改。
界面文案隨 DSH 語言切換，支持中英雙語。
安裝與啓用¶
將插件裝進指定 profile（命令會把參數轉發給該 profile 的 pnpm，成功後登記 dsh.profile.bundles 並自動啓用）：
dsh plugin --profile <你的 profile> add dsh-archive-viewer
重啓 dsh web 後生效（宿主側在啓動時加載 bundle）。
也可在 DSH 插件面板安裝，或使用工具：
plugin_manager { action: "install_bundle", target: "dsh-archive-viewer" }
本地開發時，把 target 換成插件目錄的絕對路徑，會裝成 link: 依賴；僅改 client.js 且 pnpm run dev:web 在跑時，前端可熱更新。
卸載：
dsh plugin --profile <你的 profile> remove dsh-archive-viewer
或 plugin_manager { action: "remove_bundle", target: "dsh-archive-viewer" }。移除後入口與面板消失，歸檔狀態與會話內容不受影響。
配置¶
插件默認不帶 Config 面板（零依賴、不引入 Schemastery）。若數據目錄或排除名單與默認不一致，可在 profile 的 patch 裏寫：
- id: dsh-archive-viewer
config:
dshHome: 'D:\dsh-home' # 非標準數據目錄；默認 $DSH_HOME，再退回 ~/.dsh
excludeWorkspacePaths: [] # 覆蓋默認的內部會話排除名單（默認 ["aik_auto_memory_use"]）
典型用法¶
- 按上文命令安裝並重啓
dsh web。 - 在 Web UI 側邊欄「會話管理」旁打開「查看歸檔」。
- 用搜索或工作區篩選定位目標歸檔，選中後在右側閱讀對話與工具軌跡；需要繼續編輯時再點「恢復並繼續對話」。
更細的數據來源、路由與只讀保證見倉庫內 docs/INTERNALS.md。
適用場景與注意¶
適合需要審計或回顧已歸檔會話、又不想動歸檔狀態的 DSH 用戶（例如對照某次工具鏈、查看壓縮前後原文）。
兼容性：README 寫明已在 DSH 0.2.2-alpha.2（Web UI）驗證；package.json 要求宿主 dsh 版本 >=0.2.0-rc.1。若宿主缺少 webServer / workspaceRegistry / sessionQuery 任一能力，插件保持未激活且不拋錯。
DSH 生態主張「一切皆插件」；skillhub.cn 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。插件隨當前 DSH 進程權限訪問本地會話數據，安裝前建議瀏覽源碼與 MIT 許可證後再決定是否啓用。
結尾¶
dsh-archive-viewer 把歸檔會話從「必須先恢復才能看」變成「只讀打開即可查」。目錄頁：https://www.skillhub.cn/plugins/qinu321/dsh-archive-viewer；倉庫：https://github.com/qinu321/dsh-archive-viewer。
