dsh-worktree-manager
DeepSeek Harness 插件：在空白会话里选择本机或 Worktree。Worktree 会在仓库里建一个隔离目录，并在会话头部合并、删除和自动清理。
使用
只在仓库主目录的空白会话里出现。工作区右侧有两个 chip：环境、分支。
- 本机：分支 chip 是当前检出。改选会执行
git switch。有未提交改动，或该分支已被其他 worktree 占用时，拒绝切换。 - Worktree：不改本机检出。环境 chip 只显示 Worktree，分支 chip 表示即将使用的基线。
打开分支面板，选定基线，填写名称，点「创建并进入」。
- 名称可用中文。同一段文字同时作为分支名、目录名和工作区标题。
- 不能包含空格或特殊符号。名称里的
/仍是分支层级，目录名会收成-，例如功能/超时的目录是功能-超时。 - 目录固定为
<仓库根>/.agents/worktrees/<名称>。 - 创建后打开这个工作区的空白会话，并带上当前草稿。
- 命名方式为自动短码时，面板里没有输入框，创建时生成
wt-xxxxxx。
进入 worktree 会话后，头部显示 分支 → 基础分支，以及「合并」「删除」。
配置
在「插件」页打开 Worktree 管理。下面是配置和 worktree 列表；列表里可以合并、改标题、删除。
| 配置项 | 默认值 | 说明 |
|---|---|---|
namingMode |
manual |
manual 手动输入名称；auto 自动短码 wt-xxxxxx |
autoCleanup |
true |
合并成功后自动清理。合并对话框里仍可取消 |
deleteBranchOnCleanup |
true |
清理时同时删除分支，也是删除对话框的默认值 |
fetchBaseBeforeCreate |
true |
创建前 git fetch 基线分支的远程最新提交。无远程时跳过，失败则中止创建 |
copyFiles |
[] |
创建后额外复制的文件。另外会读取仓库根目录的 .worktreeinclude |
复制规则：每行一个仓库内相对路径，可以是文件或目录，最后一段可用 * / ?。不覆盖已存在文件，不跟随符号链接，禁止 .. 与 .git。建议只列被 .gitignore 忽略的文件，否则复制过去的未跟踪文件会被算作未提交改动。
合并
预检不通过时直接拒绝，不做自动处理：
- worktree 有未提交改动；
- 主仓库不在目标分支，或主仓库有未提交改动；
- 没有可合并的提交。
合并方式有两种，会记住上次的选择：
- 合并提交：
git merge --no-ff，保留分支上的提交。 - 压缩为一个提交：squash。提交信息优先用 LLM 生成，不可用时预填各提交标题。
冲突时自动回滚，列出冲突文件，可一键「交给 Agent 解决」。squash 之后 git 不认为分支已合并，所以自动清理对分支使用 -D。手动删除未合并分支时需要二次确认。
安装
pnpm install
pnpm run build:all
# 链接到某个 profile（桌面版 profile 名为 desktop）
dsh plugin --profile desktop add "link:$(pwd)"
安装后重启 profile，在「插件」页启用「Worktree 管理」。本插件与 dsh-git-branch-manage 可并存：包名、配置项 id、locale 命名空间、路由前缀、slot id 均独立。
开发
pnpm run typecheck # 宿主侧与客户端
pnpm test # vitest，git 逻辑用真实临时仓库验证
pnpm run build:all # tsc（host）+ tsdown（client bundle）
src/index.ts、src/routes.ts、src/git.ts：宿主侧配置、HTTP 路由与 git 逻辑src/client/：浏览器侧（chips、对话框、配置页、管理列表）src/wire.ts：两侧共享的路由与类型docs/decisions/：设计决策（0001 挂载与创建时机，0002 chip 语义，0003 官方池路径与标题，0004 创建前 fetch 与配置页，0005 中文名称与创建面板）docs/images/：README 用的界面截图
限制
- 只在 macOS 上开发与验证。
- 只管理本插件创建的 worktree（以分支上的 git config
branch..dsh-worktree-base识别）。 - worktree 目录固定为
<仓库根>/.agents/worktrees，不支持自定义。 - 不提供 commit、push、diff 等通用 git 操作。
