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 下的等价做法是：
- 在
.worktrees/<branch>/（嵌套布局）或 ../<repo>--<branch>（兄弟布局）创建一个 git worktree；
- 用
ctx.remote.session.create({ cwd }) 在该 worktree 路径开一个全新的隔离 session；
- 把
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
