dsh-tauri-worktree

dsh-tauri-worktree 为 DSH 会话提供 Git worktree 隔离。每个工作树会话拥有独立目录，Agent 可以安全地修改代码，而不会影响本地主工作区。

功能

• 按项目路径和会话 ID 创建稳定、可复用的隔离工作树。
• 注册 create_worktree、checkout_worktree 工具。
• create_worktree / checkout_worktree 支持可选 carry_staged 参数（默认 false）：把已暂存（index）改动携带进新工作树、或携带回本地检出，避免暂存内容在隔离/移除工作树时丢失。
• 提供创建、状态、检出和放弃 API：/api/dsh-worktree/*。
• 将工作树状态注入系统提示：is_worktree: true。
• 检出时创建或切换本地分支，并带回完整会话历史。
• 放弃工作树时清理临时分支和 ledger 记录。

携带暂存（carry_staged）

git worktree 的 index 与暂存状态是每个工作树私有的：git worktree add 从 HEAD 干净检出， 未提交改动不会跟随；移除工作树时未提交改动也随之删除。为避免「有暂存时创建/检出工作树 导致内容丢失」，两个工具都提供开关：

// 创建时把源仓库已暂存改动带入新工作树（不携带未暂存/未跟踪改动）
create_worktree({ branch_name: 'dsh/feature-xyz', carry_staged: true })

// 检出时把工作树已暂存改动带回本地分支，再移除工作树
checkout_worktree({ worktree_hash_dirname: '[hash]/[dirname]', branch_name: 'dsh/feature-xyz', carry_staged: true })

语义说明：

• carry_staged 只移动「已暂存（index）」状态：修改、新增、删除的暂存条目会在目标目录 重建为同样的暂存状态（文件内容同步到 index，git status 分布一致）。
• 未暂存与未跟踪改动按 git worktree 的设计不携带：创建时留在源仓库，检出时随工作树移除。
• 实现基于 git diff --cached --binary + git apply --cached，只触碰补丁涉及的路径， 不使用仓库级共享的 git stash，避免跨 worktree 污染 stash 列表或覆盖目标目录无关改动。
• 创建时携带失败会回滚刚创建的工作树；检出时携带失败会回滚到检出前分支并保留工作树。

用户流程

1. 用户明确要求使用 worktree 后，Agent 调用 create_worktree。
2. 插件创建 ~/.dsh/worktrees/[hash]/[dirname]，并把会话交接到新工作树。
3. 在工作树会话中修改、测试和提交代码。
4. 用户明确请求或批准后，才能调用 checkout_worktree；该操作会把改动带回本地分支并移除工作树。
5. 如果不需要保留改动，可从面板执行放弃操作。

checkout_worktree 是用户授权操作。任务完成、PR 合并或 Agent 的便利性都不能代替用户授权。

要求

• 项目目录必须是 Git 仓库。
• 宿主环境需要可执行的 git。
• 插件需要 DSH 的 tools、systemPrompt、webServer、sessions、workspaceRegistry 和 agents 服务。

许可证

MIT © Hairyf