dsh-plugin-workspace-archive:一鍵歸檔整個工作區

前言

用 DeepSeek Harness(DSH)做開發,工作區會越開越多:臨時驗證用的、跑一半放棄的、已經交付但不想刪的。官方只提供單條會話的「歸檔會話」,多個會話分佈在一個工作區裏時,只能逐條操作;想從側邊欄整體清掉,往往要挨個點。這個插件解決的就是「一批會話一起歸檔、一起恢復」這件事。

下面介紹 chineseryan/dsh-plugin-workspace-archive 插件。它由 ChineseRyan 維護,接收 DSH 插件,在工作區行的「…」菜單里加一個「歸檔工作區」入口,把該工作區下全部會話歸檔並從側邊欄隱藏,需要時可從側邊欄底部恢復。

核心功能

一次操作範圍是整個工作區,不是單條會話:

  • 歸檔:對工作區下全部會話逐個調用官方歸檔命令,全部成功後寫入歸檔賬本,並從側邊欄隱藏該工作區行。
  • 恢復:按賬本里的會話清單逐個還原,全部成功才刪除記錄。
  • 側邊欄底部提供「已歸檔工作區」面板,帶數量角標,可查看與恢復。
  • 角標顯示方式三檔:常駐顯示、首次顯示、永不顯示,在面板標題右側的三枚圖標切換。
  • 歸檔不會刪除文件、會話或歷史記錄,正在運行的會話無法歸檔,菜單會提示先停止。
  • 只寫本地一個位置的數據:$DSH_HOME/storages/dsh-workspace-archive.json;寫入採用原子 rename 加跨進程文件鎖,多窗口併發不丟記錄;不聯網,不讀取會話內容,只記錄 ID 名單。

里程碑行爲差異(README 明確記載):

  • 0.1.5 起,空工作區歸檔後同樣從工作區列表消失,只在「已歸檔工作區」面板出現;0.1.4 及以前這類工作區會兩處同時顯示(已修復的 bug)。
  • 0.1.6 起,角標偏好保存在宿主狀態文件,重啓 dsh 不會回到默認的「常駐顯示」。

安裝與啓用

安裝命令取自插件 README,按自己的 profile 替換 <profile> 和用戶名:

從 GitHub 安裝:

dsh plugin --profile <profile> add "git+https://github.com/<你的用戶名>/dsh-plugin-workspace-archive.git"

本地開發安裝:

git clone https://github.com/<你的用戶名>/dsh-plugin-workspace-archive.git
dsh plugin --profile <profile> add "link:/path/to/dsh-plugin-workspace-archive"

安裝後需要重啓一次 dsh 宿主,宿主側 JS 不做熱重載;瀏覽器半側刷新頁面即可。如果 profile 由桌面應用獨佔管理,在「設置 → 插件」中安裝,或使用桌面版自帶的 CLI。

卸載:

dsh plugin --profile <profile> remove dsh-plugin-workspace-archive

依賴項:無運行時第三方依賴;要求 dsh 0.2.1-rc.2 及以上。

典型用法

1、歸檔某個工作區:在側邊欄找到該工作區行,點右側「…」,選「歸檔工作區」。插件會先逐個歸檔其下所有會話,全部成功後,工作區行從側邊欄消失。

2、查看已歸檔工作區:點側邊欄底部「已歸檔工作區」面板,右側顯示帶數量角標的總覽。該面板可直接按 Esc 或底欄「關閉」關閉。

3、恢復:在面板中選擇要恢復的工作區並點「恢復」,插件按賬本名單逐個還原,全部成功才刪掉這條記錄;恢復最後一條後面板自動關閉。

歸檔過程中的插件行爲(README 原文):只對工作區行通過 DOM 加隱藏標記,不讀寫、不改寫官方任何視圖數據。查看中的會話在切換焦點後才隨工作區一同隱藏。

適用場景與注意

適合側邊欄工作區數量堆積、希望按工作區整體歸檔的 DSH 使用者。它對單條會話沒有更細的操作,只需要歸檔某條會話時用官方自帶的「歸檔會話」即可。

使用前按慣例檢查源碼與許可證(MIT)是否滿足需求。插件以當前 dsh 進程的權限運行,角標偏好、歸檔賬本都寫在 $DSH_HOME 下的狀態文件裏,刪除該文件即放棄恢復入口(已歸檔會話仍在官方歸檔裏,可從官方入口恢復)。安裝後記得重啓宿主,否則入口不會生效。

小結

這個插件的定位很窄:把官方已有的「歸檔會話」能力按工作區批量執行,再用賬本記錄名單實現一鍵恢復,不改動歷史數據,也不引入額外運行時依賴。如果你的痛點正是側邊欄工作區太多,值得裝上一試。

  • 目錄頁:https://www.skillhub.cn/plugins/ChineseRyan/dsh-plugin-workspace-archive
  • GitHub:https://github.com/ChineseRyan/dsh-plugin-workspace-archive
羽毛球分组比赛记分
小程序二维码

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

小夜