在 DeepSeek Harness (DSH) 的开发流程中，针对同一仓库的不同开发任务，通常需要频繁切换分支或处理多个并发会话。dsh-worktree 插件通过集成 Git worktree 机制，解决了在 DSH 中隔离任务环境的需求。
这是一套由 alpacachen 维护的插件（npm 包名为 @alpacachen/dsh-simple-worktree），旨在将 Git 的 worktree 功能与 DSH 的工作区系统打通。它允许用户在现有的 Git Workspace 中创建新的 worktree，并将其注册为独立的 DSH Workspace，从而开启隔离的会话。
安装与启用¶
安装该插件需要使用官方的安装命令：
dsh plugin --profile web add @alpacachen/dsh-simple-worktree
安装完成后，必须重启 dsh web 进程才能生效。
核心功能¶
该插件提供了从创建到管理的完整工作流：
- 创建 Worktree：在任意 Git Workspace 的 New Session 中，可以直接创建新的 Git worktree。
- 分支选择：在创建过程中，用户可以选择当前分支，或者直接使用仓库的主分支作为基准。
- Workspace 注册：创建成功后，新的 worktree 会被自动注册为 DSH Workspace，并开启一个独立的会话。
- 任务分支命名：插件会自动将分支命名为
task/<name>格式。 - 统一管理：所有链接的 worktree 都可以在 Settings → Worktree Management 页面进行统一管理。该页面支持扫描所有 Workspace 中的 Git 项目，检查分支状态和是否处于脏状态，并支持移除不再需要的 worktree。
- 零配置：无需额外的服务或项目配置即可使用。
- 多语言支持：支持 DSH 主题，并提供中文和英文界面。
典型用法¶
- 在任意 Git Workspace 中打开 New Session。
- 在 composer 上方选择 Create worktree 选项。
- 输入任务名称。默认情况下，系统会选中仓库的主分支。
- 点击 Create and open 按钮。系统将创建 worktree，注册新的 Workspace，并打开隔离的会话。
- 在 Settings → Worktree Management 中，可以查看当前所有关联的 worktree 信息，并执行清理操作。
适用场景与注意¶
- 版本兼容性：该插件基于 DSH 0.1.5 客户端契约开发，仅支持
0.1.5-rc.1或0.1.5-rc.2版本，且仅适用于 web profile。 - 数据安全：在 Worktree Management 中删除对应的 Workspace，只会移除 DSH 的链接，不会删除底层的 Git 分支。
- 许可证：插件遵循 MIT 许可证。
- 生态背景：DeepSeek Harness 生态遵循“一切皆插件”的理念。该插件由社区开发者维护，其官方目录地址为 skillhub.cn，与 DeepSeek 官方无直接隶属关系。
使用 dsh-worktree，可以在不离开 DSH 界面的情况下，利用 Git worktree 管理多任务并行开发环境，提升本地开发效率。
