前言¶
在 DeepSeek Harness 官方版本里,會話一旦歸檔,就會從所有分組視圖中消失,且沒有查看或恢復入口。也就是說,目前唯一的“已有做法”就是:歸檔即消失,誤歸檔的會話找不回來。
dsh-restore-archived-sessions 補上這塊缺口:把所有已歸檔會話集中列在一個設置頁裏,顯示基本信息,並支持一鍵恢復。
這是什麼¶
一句話定位:查看並恢復 Harness 中已被歸檔的會話。項目由 le-soleil-se-couche 維護,許可證爲 MIT,目錄頁將其歸入「記憶」分類(package keywords 爲 session-management、archive-restore)。
先說清交付形態,這直接決定安裝方式:
1、它不是可以經 dsh plugin add 安裝的獨立插件,而是定製 Harness 的 prebuilt host/client 替換包。dist/ 會替換 sibling package layout 下的 dsh-workspace、dsh-host-apiproxy 和三個 client bundle。
2、之所以這麼做,是因爲恢復功能依賴 Harness 主線的 workspace.unarchiveSession RPC,舊版本官方 Harness 沒有這個接口,因此項目以「補丁包 + 安裝腳本」的方式交付。
核心功能¶
已覈實的能力有六項:
- 在設置頁集中列出所有已歸檔會話
- 顯示會話標題、所屬工作區(或“未分組”)和最後活動時間
- 恢復:僅把會話移出歸檔,會話回到原工作區位置
- 恢復並查看:恢復後直接打開會話,並自動關閉設置面板
- 歸檔與恢復使用完整快照同步,多標籤頁狀態一致
- 歸檔集合持久化保存,重啓 Harness 後仍然有效
其中「恢復」和「恢復並查看」是兩個獨立動作:前者只改歸檔狀態,後者恢復完直接進入會話。
安裝與啓用¶
安裝分三步:先克隆倉庫,再跑只讀預檢,預檢通過後才執行安裝,最後啓動。
git clone https://github.com/le-soleil-se-couche/dsh-restore-archived-sessions.git
cd dsh-restore-archived-sessions
bash install.sh --check
# 僅在定製 host 的預檢與隔離驗證均通過後:bash install.sh --install
dsh web --host 127.0.0.1 --port 3080
bash install.sh --check 是隻讀預檢:失敗時會在創建 backup 或覆蓋任意安裝文件前退出。本機已有舊 build 是獨立候選,只有其 package layout 與 archive-state anchor 都通過預檢,並在隔離 profile 做過 synthetic archive/restore 驗證後,纔可評估安裝。
bash install.sh --install 執行替換:安裝腳本僅替換 dsh-workspace、dsh-host-apiproxy 和三個客戶端 bundle,安裝前自動備份。裝完後以 dsh web --host 127.0.0.1 --port 3080 啓動。
兩個不能省略的前提:
1、預檢不證明源碼 provenance 或完整 ABI 兼容,也不會讀寫真實 archive record。
2、發佈版 @deepseek-ai/dsh@0.1.2-rc.1 不暴露 dsh-host-apiproxy 這個替換目標,禁止直接複製;固定的 0.1.3-alpha.1 源碼點 d347e703908d0406b7a7ef80e3a0e594d86b2215 使用 dsh-api-workspace-controller 等不同 transport seam,也不能把本 dist/ 當作兼容產物。
典型用法¶
1、在會話列表中歸檔任意一個會話。
2、打開左下角「設置」。
3、進入「已歸檔對話」。
4、點擊「恢復」只恢復歸檔;點擊「恢復並查看」則恢復並打開會話。
經過上面的步驟,歸檔的會話會回到原工作區位置。歸檔與恢復使用完整快照同步,多標籤頁打開時狀態一致;歸檔集合持久化保存,重啓 Harness 後仍然有效。
回滾¶
bash install.sh --rollback
--rollback 會驗證 backup 與精確目標路徑,不要求當前待恢復文件仍通過 archive ABI 預檢——損壞的安裝正是需要回滾的場景。
適用場景與注意事項¶
適合的用戶:習慣用歸檔整理 Harness 會話列表、但擔心歸檔後找不回會話的人。前提是你的環境能通過預檢與隔離驗證。
下面幾條務必留意:
1、兼容性範圍有限。原始 artifact 僅在定製 DeepSeek Harness master 源碼環境驗證過,不構成對當前發佈版或本機任何舊 build 的兼容性承諾。
2、若要遷移到 0.1.3-alpha.1,應從該源碼點通過 dsh-api-workspace-controller 和 dsh-client-ui-workspace 重建恢復界面及 workspace.unarchiveSession transport,保留 archive set 的位置語義與跨 tab snapshot 通知;靠覆蓋發佈版 package 或去掉恢復動作來聲稱兼容,是行不通的。
3、權限與審查。該補丁包以當前 dsh 進程的權限運行,安裝前應檢查源碼與許可證(本項目爲 MIT)。
4、DSH 的理念是「一切皆插件」,但像本文這類涉及 host/client 替換的包,安裝門檻和風險都高於普通插件,按「先預檢、再隔離驗證、最後安裝」的順序走。
順帶說明:文中提到的社區目錄(skillhub.cn)是獨立站點,與 DeepSeek / 幻方無官方從屬關係。
結語¶
dsh-restore-archived-sessions 做的事不復雜:給 Harness 中“歸檔即消失”的會話一個集中查看和恢復的入口。由於它以替換包形式交付,預檢、備份與回滾是使用流程的一部分,按文檔順序執行即可。
- 目錄頁:https://www.skillhub.cn/plugins/le-soleil-se-couche/dsh-restore-archived-sessions
- GitHub:https://github.com/le-soleil-se-couche/dsh-restore-archived-sessions