隔离工作树 scccy/dsh-enterworktree

dsh-enterworktree

DSH 版的 Claude Code /enterworktree —— 一个 DSH 宿主（Host）插件，注册 enter_worktree 工具。

等价于 Claude Code 的 EnterWorktree：在隔离的 git worktree 里并行工作，不污染主树。

它做什么

Claude Code 的 EnterWorktree 会创建一个 git worktree，并把智能体切换进去并行工作。
DSH 里每个会话的工作目录（session.header.cwd）是只读的，无法原地改当前会话的目录，所以「进入 worktree」在 DSH 下的等价做法是：

1. 在 .worktrees/<branch>/（嵌套布局）或 ../<repo>--<branch>（兄弟布局）创建一个 git worktree；
2. 用 ctx.remote.session.create({ cwd }) 在该 worktree 路径开一个全新的隔离会话；
3. 把 sessionId + 路径返回给你，你在 Web GUI 打开该会话即等于「进入」。

工具在 Host 进程里通过 ctx.tools.register(defineTool(...)) 注册，与 dsh-speckit-workflow 的注册方式一致。

工具参数（enter_worktree）

| 参数 | 说明 |
| branch | 新分支名；省略自动生成 wt/<timestamp>；已存在本地分支则直接 attach。 |
| base | 切新分支的基点，默认 HEAD。 |
| path | 显式绝对路径，提供后忽略 layout。 |
| layout | nested（默认）或 sibling。 |
| openSession | 是否开隔离会话，默认 true。 |
| inPlace | true 时不开 worktree，直接返回仓库根目录（安全阀）。 |

输出

{
"ok": true,
"branch": "wt/...",
"worktreePath": "/abs/path/.worktrees/wt/...",
"created": true,
"sessionId": "session-xxxxx",
"sessionOpened": true,
"message": "已创建 worktree 并开隔离 session ..." }

安装

方式 A：从 Git 仓库安装（推荐，DSH 原生支持）

在 Web GUI 的 plugin_manager 里用仓库地址安装：

plugin_manager action=install_bundle target=github.com/scccy/dsh-enterworktree

安装后 enter_worktree 即在会话里可用；改 lib 后重启 dsh-desktop 让宿主重载。

方式 B：从 npm 安装（发布后）

plugin_manager action=install_bundle target=dsh-enterworktree

配置

bundle patch（cordis.patch.yml）把插件挂载进配置档，配置项：

| 配置 | 默认 | 说明 |
| layout | nested | nested=.worktrees/<branch>，sibling=../<repo>--<branch>。 |
| dotworktreesDir | .worktrees | worktree 目录名（嵌套布局下）。 |
| autoOpenSession | true | 是否自动开隔离会话。 |

限制

- 当前会话不会被移动；它仍指向原目录。所有后续改动在你打开的那个 worktree 会话里发生。
- 仅当配置档提供 dsh-api-remotes（即 ctx.remote.session）时才能自动开会话；否则只创建 worktree 并返回路径。

许可证

MIT