Skip to content

[Feature] 原生 /worktree 命令 + 并行隔离工作模式(worktree as a first-class platform primitive) #220

Open

Description

@earneet

提交前确认 · Pre-submission checklist

  • 我已搜索过现有 issue,确认这不是重复提议 / I searched existing issues and confirmed this isn't a duplicate.
  • 我已阅读 CONTRIBUTING.md / I've read CONTRIBUTING.md.

问题类别 · Category

工具调用 / MCP · Tool use / MCP

涉及的 Agent 框架 · Agent framework

ZCode Agent(自研)

使用场景 · Use case

我已经看过issue 132,我们说的不是第一个东西

类别 · Category

功能需求 / Feature request · 平台能力(Platform capability)

是否已有相关 issue

相关但不重复:#132。#132 聚焦于给现有 using-git-worktrees skill 补 UX(worktree
切换器 + 减少权限弹窗),其原文也指出 "No native worktree tool available in ZCode
platform"。本 issue 的诉求更根本:希望 worktree 成为平台一等公民,而不仅是 skill,
并提供原生命令与"并行工作模式"。

背景与动机 · Motivation

当前要在 ZCode 里并行跑多个 agent(不同特性、实验性改动、长任务),它们会共享同一个
工作目录与 git 索引,极易互相覆盖文件、争抢同一分支。git worktree 是解决这类并行隔离
的事实标准,但目前在 ZCode 中:

结果:用户要么放弃并行,要么手动在终端建 worktree 再 File → Open Folder 打开,发现性
和可用性都很差,无法体现 ZCode 作为 ADE(Agentic Development Environment)在多 agent
编排上的优势。

建议方案 · Proposal

期望 · Proposed Behavior

提供原生 /worktree 命令族(不依赖 skill 的 git fallback),并把 worktree 作为
"并行工作模式"的基础单元,且提供给LLM对它的调用能力(参考ClaudeCode的WorkTree相关功能):

  • /worktree create [<name>] [-b <branch>]:创建隔离工作树(单次授权完成"建树 + 切分支
    • 项目初始化"),消除多段权限弹窗。
  • /worktree list:列出当前仓库的所有 worktree 及其绑定状态(分支、关联 agent / 任务)。
  • /worktree switch <name>:在 app 内一等切换(非 Open Folder)。
  • /worktree remove <name>:清理工作树与分支(带保护:有未提交改动时阻断或提示)。
  • /worktree run <name> ...(进阶):在指定 worktree 中启动一个独立 agent / 后台任务,
    实现"一个 worktree 绑一个 agent 上下文"的并行隔离。

配套的"并行工作模式"开关:进入后,新开的 agent 默认落到独立 worktree,互不干扰,状态/
日志在统一的 worktree 面板里聚合查看。

与现有能力的衔接

参考 · References

环境 · Environment

  • ZCode Desktop,Windows
  • 模型:builtin:bigmodel-coding-plan/GLM-5.2

预期价值 · Expected value

将明显加快开发速度

一般的使用情况是,在同一个目录里,一个Agent在修改代码的时候,其他Agent往往不能并行修改,如果有了worktree来进行隔离,那么多个功能就可以同时开展,当完成后把它们合并到主分支当中即可。我就可以一次做更多的事情,而不需要我手动创建副本分支目录再去对应目录里启动Agent了

你认为的优先级 · Your perceived priority

高 · High

你使用的 ZCode 版本 / 环境 · ZCode version / environment

Windows/ 8月6日的最新版本,工具未提及具体版本号

补充材料 · Additional context

No response

Activity

  1. github-actions commented on Aug 6, 2026

    @github-actions

    👋 感谢你的反馈,我们已经收到。

    • 维护者会在 3 个工作日内 给出首次响应。
    • 状态保持为 status: 待评估,你可以随时补充信息。
    • 信息不全时我们会打上 needs: 更多信息 标签并 @ 你。

    👋 Thanks — we've received your issue.

    • A maintainer will respond within 3 business days.
    • Status stays at status: 待评估 (Triage); feel free to add context.
    • If we need more details, we'll add needs: 更多信息 and ping you.
  2. AI-Chef commented on Aug 30, 2026

    @AI-Chef

    期待

  3. Lparksi commented on Aug 30, 2026

    @Lparksi

    有相同的需求,希望支持

  4. EtienneLescot commented on Sep 1, 2026

    @EtienneLescot

    支持!我按这个思路实现了一个社区插件 git-worktree(PR:zcode-plugins#4),可以作为原生实现落地前的过渡方案,也可以当作实现参考:

    • /git-worktree:worktree 命令:无参数默认"创建隔离 worktree"(自动命名分支、基于默认分支、同级目录、绝不占用 main),另有 list / open / remove / prune 子命令
    • 内置防护:脏 worktree 未经明确确认不删除、主 worktree 永不移除、孤儿目录只报告不静默删除
    • 附带技能:对话涉及 worktree / 并行隔离时自动触发,也支持 @ 提及挂载到自由表述的请求上
    • 双语文档(EN / 简体中文),已在 Windows 实际使用中验证(v0.1.0 → 0.1.3 迭代)

    实际使用中验证了两个痛点:skill 回退到裸 git 命令确实会产生一串权限确认;原生分支切换器会把 branch is already used by worktree 误报为"git 操作进行中"。如果维护者计划原生实现,很高兴把插件里的经验(错误信息翻译、路径约定、权限收敛)贡献进去。

  5. mengjiu-cao commented on Sep 9, 2026

    @mengjiu-cao

    怎么没反馈的 意见很好啊

  6. cccfeng commented on Sep 28, 2026

    @cccfeng

    有相同的需求,希望支持

  7. bigjeager commented on Oct 4, 2026

    @bigjeager

    有相同需求,支持!现在手工在 主区下面建 .workingtree的subfolder,模型莫名其妙经常会改动主区里的内容,忘记自己在workingtree里干活。

  8. XuChen-AI commented on Oct 10, 2026

    @XuChen-AI

    求官方支持,很好的提议

  9. Acfufu commented on Oct 29, 2026

    @Acfufu

    补充一条 3.16.3 实机静态检查证据(2026-10-29,macOS,桌面 3.16.3 / CLI 3.16.3-40),支持本 issue 诉求——底层已预留了一半,只差实现层:

    1. runtime schema 已预留 isolation: "worktree",但运行时直接拒绝:workflow agent 配置里该选项会抛 "workflow agent isolation 'worktree' is not implemented yet.";
    2. 平台工具名注册表里已出现 EnterWorktree / ExitWorktree(零实现);
    3. 感知层已完备:手工 git worktree add 后打开目录,项目配置/skills/commands 均能正确解析(findWorktreeRoot),桌面可识别 linked worktree 与 .claude/worktrees/ 约定。

    即「打开已有 worktree」今天就能用,缺的正是本 issue 提议的创建/切换/管理层(/worktree create/switch + 单次授权)。希望能提上排期。

    相关:#132、zcode-plugins#4

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions