前言¶

在 DeepSeek Harness（DSH）的 web profile 中，會話歸檔後往往需要重新找到它、確認內容，再恢復到原來的工作區。已有做法通常只提供歸檔動作，查看、預覽和恢復歸檔會話的入口並不完整。

uwu9039/dsh-unarchive 是一個面向 DSH 的獨立第三方插件，用於給已歸檔會話提供列表、預覽、恢復，以及可選的歸檔二次確認。下面按功能、安裝、用法和注意事項介紹。

這是什麼¶

dsh-unarchive 可理解爲 DSH 的“歸檔會話回收站”。

• 倉庫：uwu9039/dsh-unarchive
• 許可證：MIT
• 維護者：uwu9039
• 與 DeepSeek 的關係：獨立第三方插件，與 DeepSeek 無隸屬關係

該插件面向 DSH 的 Web 插件場景，資料中給出的目標版本與 profile 如下：

DSH 0.1.0-rc.6
profile web

它不兼容 headless UI。

核心功能¶

歸檔列表¶

插件在右下角提供懸浮按鈕。點擊後打開浮層面板，已歸檔會話按工作區分組，組內按創建時間倒序排列。

面板會顯示空態和總數，並支持中英文界面。

內容預覽¶

在歸檔列表中，可以行內展開會話開頭與最近消息。

預覽規則如下：

• 單條內容不超過 200 字符
• 只提取 text 塊
• 不展示工具參數與附件

單個恢復¶

列表中單個會話可以恢復。

恢復過程具備以下特點：

• 冪等
• 存在性校驗
• 串行寫入

恢復後，側邊欄會即時回到原工作區的原位置，不需要刷新頁面，並支持多標籤頁同步。

全部恢復¶

當歸檔列表不少於 2 條時，可以使用“全部恢復”。

該操作會在面板內再次確認，然後逐個恢復。失敗項不會導致整體回滾。

歸檔二次確認¶

歸檔二次確認默認關閉。

開啓後，從側邊欄右鍵執行歸檔前，會先彈出確認框。確認框支持通過 Esc、點擊遮罩或取消關閉。

資料中說明該能力包裝瞭如下接口，並採用 fail-open 行爲：

workspaces.archiveSession

設置¶

插件面板中的“設置”頁籤提供以下配置項：

confirmOnArchive
showButton
previewEnabled

設置即時生效，並持久化到本地文件：

~/.dsh/unarchive/settings.json

安裝與啓用¶

安裝¶

按資料給出的命令，可以先安裝插件：

dsh plugin --profile web add dsh-unarchive

這一步會在 DSH 的 web profile 下添加 dsh-unarchive 插件。

本地打包安裝¶

如果使用本地打包產物，資料中給出的示例是先執行 npm pack，再安裝生成的 .tgz 文件：

npm pack

dsh plugin --profile web add dsh-unarchive-0.1.8.tgz

這裏的 .tgz 文件名來自資料示例，實際使用本地產物時以實際打包結果爲準。

啓用入口¶

安裝完成後，插件會在右下角提供懸浮按鈕。通過該按鈕打開浮層面板，即可查看、預覽和恢復已歸檔會話。

典型用法¶

下面按操作步驟說明常見用法。

打開歸檔面板¶

1、點擊右下角懸浮按鈕。

2、打開歸檔會話浮層面板。

3、查看按工作區分組的已歸檔會話。

預覽並恢復¶

1、在面板中選擇一個已歸檔會話。

2、行內展開內容預覽。

3、確認會話開頭和最近消息。

4、恢復單個會話。

如果列表中已有多個歸檔會話，也可以在面板內執行全部恢復。該操作會先給出二次確認，然後逐個恢復。

修改設置¶

1、打開面板中的“設置”頁籤。

2、修改以下配置項：

confirmOnArchive
showButton
previewEnabled

3、保存後設置即時生效。

設置會持久化到：

~/.dsh/unarchive/settings.json

開啓歸檔二次確認¶

開啓 confirmOnArchive 後：

1、從側邊欄右鍵執行歸檔。

2、插件先彈出確認框。

3、點擊確認後才繼續歸檔。

如果按 Esc、點擊遮罩或取消，則不會執行歸檔。

適用場景與注意¶

該插件適合使用 DSH web profile、需要經常處理已歸檔會話的場景，例如：

• 誤歸檔後需要找回會話
• 想恢復前先看會話開頭和最近消息
• 需要把會話恢復回原來的工作區
• 希望歸檔前增加一次確認，降低誤操作

需要注意以下邊界：

• 不兼容 headless UI
• 不做刪除或清空歸檔
• 不做歸檔內容搜索
• 不做“恢復並打開”
• 不展示工具參數與附件
• 任一依賴缺失時，相應功能降級，不阻塞原生歸檔

卸載後，資料中說明僅殘留設置文件：

~/.dsh/unarchive/settings.json

其餘內容由插件清理還原。

另外，該插件會以當前 DSH 進程的權限運行，並會訪問本地設置路徑、調用 DSH 插件能力。安裝前應檢查源碼、許可證和依賴關係。

獲取地址¶

已覈實資料中未給出可確認的目錄頁地址。倉庫地址如下：

https://github.com/uwu9039/dsh-unarchive