工作树隔离 CSY656/dsh-worktree

dsh-worktree

通过 git worktree 为 DeepSeek Harness 子代理提供文件系统隔离。子代理已经隔离了消息、权限策略和工具集——这个插件隔离的是文件系统：每个子进程都在自己的 worktree 里运行，位置在 <repoRoot>/.dsh/worktrees/ 下，共享仓库对象存储，同时保持工作树私有。

两个入口，一个包：

- dsh-worktree —— ctx.worktree 服务：创建/恢复/列出/删除 git worktree，带严格的 slug 校验、变更保护、尽力而为的创建后设置，以及定期清扫过期的临时 worktree。
- dsh-worktree/commands —— 面向人的 /worktree create <slug> | list | remove <slug> [--discard] 斜杠命令。

安装

需要 DeepSeek Harness 的 next 线（dsh ≥ 0.1.0-rc.6）。从 GitHub 安装：

dsh plugin --profile default add github:you/dsh-worktree

pnpm ≥ 10 会要求你允许构建——把打印出来的包名 key 加到配置档的 pnpm-workspace.yaml：

allowBuilds:
dsh-worktree: true

然后重新跑一遍 add。从 npm 安装（预构建）：

dsh plugin --profile default add dsh-worktree

用法

/worktree create feature/demo → creates .dsh/worktrees/feature+demo, branch worktree-feature+demo
/worktree list → name/path/branch rows
/worktree remove feature/demo → refuses while dirty; --discard forces

服务 API（给插件作者用）：

const lease = await ctx.worktree.acquire('agent-abc1234', cwd) // create/restore at HEAD
// ...run an isolated child with its session header.cwd = lease.entry.path...
const { kept, path, branch } = await lease.release() // clean → removed; dirty → kept + reported

- worktree 放在 <repoRoot>/.dsh/worktrees/<flatSlug>/；嵌套 slug 会把 / 压平成 +（team/alice → team+alice），分支为 worktree-team+alice。
- validateSlug 要求每段符合 [a-zA-Z0-9._-]，长度 ≤ 64，拒绝 .、..、//，以及开头/结尾的分隔符。
- 创建后设置是尽力而为：复制项目的 .dsh 配置，继承 core.hooksPath，为 node_modules/.venv/vendor 建符号链接（Windows 上符号链接失败会降级为警告），复制 .worktreeinclude 里列出的被忽略文件。
- 变更检测是 fail-closed：任何 git 失败都算「有变更」，所以坏掉的 worktree 会保留而不是删掉。
- 同一仓库的改动串行执行；并发 acquire 同一个 slug 是幂等的（快速恢复，不起 git 子进程）。

配置

interface Config {
sweepIntervalMs?: number // default 3_600_000 (1h)
sweepMaxAgeMs?: number // default 86_400_000 (24h); only agent-* temp worktrees are swept
}

子代理自动隔离

一行式集成 —— subagent(..., worktree: true) 为每次子运行创建一个 worktree，并自动清理 —— 需要在 dsh-subagent/dsh-tool-subagent 里加一点上游能力（SubagentStartRequest 上一个可选的 cwd）。具体改动和树内实现见 UPSTREAM-PR.md；在上游接受之前，请在你自己的插件里用 ctx.worktree.acquire()，或者手动执行 /worktree 命令。

已知限制

- 仅限进程内隔离 —— 子会话的 cwd 覆盖由进程内后端打标；进程外后端（acp、claude-code、codex、dsh-sdk）会忽略它们。
- 无法跨进程共享 —— 一个 DSH 实例只拥有自己的 worktree。
- 没有合并策略 —— 合并保留下来的 worktree 是委派智能体的活（git merge worktree-<flatSlug>）。

为生态做贡献

- 打了 dsh-plugin 话题标签 —— 浏览其他插件。
- 跑测试用 pnpm install && pnpm test（真实临时 git 仓库，不联网）。
- 这里移植的行为来自 CsyCode 第 14 章的 worktree 隔离。

License

MIT