dsh-restore-archived-sessions:查看並恢復 Harness 中被歸檔的會話

前言

在 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜