前言¶
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 仓库。
