工作树分支切换 Qcsj777/dsh-worktree-branch

dsh-worktree-branch

在 DeepSeek Harness 的「新建会话」页，给 git 工作区加一块 Codex 风格的「工作位置 / 分支」切换器。

在 DSH「新建会话」页给 git 工作区加一块 Codex 风格的「工作位置 / 分支」chip：直接切 worktree、切分支、新建分支。git 事实与副作用全部由 Host 半执行（写操作走该会话的沙箱策略）。

功能

- 检测会话的工作目录是否在 git 仓库内；不在就什么都不渲染。
- 显示当前分支（HEAD 分离时显示短哈希）、所有本地分支、所有关联 worktree。
- 操作：新建 worktree、切到另一个 worktree、切分支、新建并切换分支。
- 名称校验两道：本地白名单快速过一遍，再用 git check-ref-format 校验。
- 每次调用 git 都剥掉继承来的 GIT_* 选择器（GIT_DIR、GIT_WORK_TREE、 GIT_INDEX_FILE 等），防止用户 shell 把命令重定向到别的仓库；写操作（switch、switch -c、worktree add）包在会话的沙箱策略里执行。

安装

从 GitHub 安装：

dsh plugin --profile desktop add github:Qcsj777/dsh-worktree-branch

开发时用本地链接：

// ~/.dsh/profiles/<profile>/package.json
"dependencies": {
"dsh-worktree-branch": "link:D:/path/to/worktree-branch"
}

包自带 Cordis 补丁（cordis.patch.yml），插入 id 为 worktree-branch 的 host 半。git 必须在 PATH 上。

工作原理

第三方 bundle 加不了 Remote 命名空间，已安装 bundle 的 client 半也没法通过 host.call 调自己的 host 半，所以两半走同源 HTTP 通信：

GET /worktree-branch/state?session=<id>&cwd=<path>
POST /worktree-branch/action { sessionId, cwd, action, name?, path? }

action 取 create-worktree、use-worktree、switch-branch、 create-branch 之一。state 载荷为 { repo, cwd, repoRoot, currentBranch, head, branches[], worktrees[], mainPath, atMain }。

- client 半（client.js）：在 conversation.hero.options 上注册 chip，只在「新建会话」页出现。
- host 半（index.js）：注入 webServer、subprocess、sandbox、 sandboxPolicy、worktrees、sessionController、sessions、 workingDirectory；上面这些路由由它负责。

非目标

- 不做网络操作（不 fetch/pull/push），不删除，不 merge/rebase。
- 切到另一个 worktree 会改掉该会话的工作目录——这就是功能本身，不是副作用。
切换动作本身不移动任何文件。

开发

node check.mjs # self-check for git-parse.mjs

许可证

MIT