前言¶
DeepSeek Harness (DSH) 的側邊欄在管理會話時通常採用扁平列表。隨着會話增多，會話會被任意追加，導致層級關係丟失。dsh-branch-workspace-folders 插件旨在解決這一問題，通過構建樹形結構，將分叉的會話按根會話歸組，並提供物理級聯清除等高級功能。
插件簡介¶
這是一個 DSH Web 側邊欄插件，由 The-latest-one 維護，採用 MIT 許可證。它完全重構了側邊欄工作區，支持通用分叉樹、雙軌縮進解耦、摺疊狀態冒泡以及物理磁盤刪除引擎。
核心功能¶
插件提供以下核心能力：
-
通用分叉樹與視覺層級
在workspace、workspace-tree或flat模式下，所有分叉會話均會根據持久血緣聚類在根會話下。支持雙軌縮進解耦，獨立分配--dsh-branch-indent: calc(depth * 16px)和--dsh-workspace-indent，徹底解決目錄樹模式下的負縮進問題。 -
摺疊狀態冒泡
當包含活躍運行任務的會話家族被摺疊時，子級狀態會冒泡到可見的根節點。支持四態優先級有限狀態機（FSM），根據子級狀態在根節點顯示警告、進行中、完成或空閒狀態。 -
物理級聯清除引擎
提供真實的物理磁盤刪除功能，支持.trash-sessions隔離與原子性回滾。提供完整的 REST API 接口進行健康檢查、歸檔查詢和清除操作：
GET /branch-workspace/api/health
GET /branch-workspace/api/archives
POST /branch-workspace/api/purge
POST /branch-workspace/api/restore
- 引擎可靠性
採用堆分配顯式堆棧算法，避免遞歸導致的棧溢出風險，已通過 20,000 深度的測試。支持嚴格視圖排序，僅支持manual和updated兩種模式。
安裝與啓用¶
根據已覈實事實，暫未找到明確的 CLI 安裝命令（如 dsh plugin add），僅有 install:dsh 腳本。建議通過源碼或包管理器進行安裝，安裝後需重啓 DSH 進程。
# 官方提供的安裝腳本（需根據實際環境調整）
npm run install:dsh
典型用法¶
- placeFork 原生聚類：分叉會話會自動重新排序，緊鄰並位於父會話上方，而非被追加到列表末尾。
- 三態歸檔過濾：支持
all（全部顯示）、hide-archived（默認隱藏歸檔）、only-archived（僅顯示歸檔）三種過濾模式。 - 官方插槽集成：支持 DSH v0.2.0-rc.2 的兩級插槽生態系統，包括 Leading 16px 單元格仲裁和 Hover 卡片注入。
適用場景與注意¶
該插件適合需要精細管理大量會話、關注會話層級關係以及需要徹底清理日誌文件的 DSH 用戶。插件以當前 DSH 進程權限運行，安裝前請務必檢查源碼與許可證。插件嚴格限制視圖排序爲 manual 和 updated。
結尾¶
該插件通過堆分配算法和物理刪除引擎提升了 DSH 側邊欄的健壯性和可維護性。更多細節可查閱 GitHub 倉庫。
