dsh-enterworktree

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

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

它做什么

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

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

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

工具参数（enter_worktree）

参数	说明
branch	新分支名；省略自动生成 wt/<timestamp>；已存在本地分支则直接 attach。
base	切新分支的基点，默认 HEAD。
path	显式绝对路径，提供后忽略 layout。
layout	nested（默认）或 sibling。
openSession	是否开隔离 session，默认 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）把插件挂载进 profile，配置项：

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

限制

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

许可证

MIT