用途:在多个项目间安全、一致地创建与管理 Git worktree,避免基于过期的本地 main 或本地 HEAD 拉出任务分支,并让每个任务检出都有明确归宿(保留、阻塞、移除或未知)。
主要能力:识别产出方(shell GWT、仓库原生包装器或应用自有会话/沙箱),解析仓库身份、规范属主检出与 Git 公共目录及已注册工作树;创建前先检查既有工作树,仅在身份、分支与归属匹配时复用;使用经安装包装器认可的健康属主;用 gwt root 解析配置的受管根并置于其下;校验远端新鲜度与依赖兼容性(源固定版本、锁文件、工作区依赖图、补丁、平台、链接器布局与解析路径)。
使用方式:先用 gwt help 做发现、gwt root 找受管根;按需使用 gwt new <branch> <start-point> --finish-managed,或将 start-point 留空;在 Codex 外需先设稳定的 GWT_OWNER_ID;普通场景在仓库策略允许时用 gwt new <branch> <start-point>;完成用 gwt finish --pr <full URL>(必要时 --release),叠加场景用 gwt finish-pin、finish-unpin、--target、--wait-for;清除用 gwt rm <literal-path> --finalized(未登记任务用普通 gwt rm,可用 --discard-ignored <relative-root>)。
适用场景:需要新任务分支与新工作树、并发管理多个工作树、希望避免从陈旧基点分支,以及需要显式回收结果的协作开发流程。
限制:不安全、浅克隆或 promisor 源不能作为创建许可,不得用原始 Git、复制仓库或临时克隆绕过;创建被拒时不得换路创建,只能在同一属主内修复后重检;不得收编其他会话的检出;删除需当前属主、无活跃使用者或锁,且源与恢复内容可用;未知或未完成的移除不得自动重试或标为已保留;未提供的收费、价格与具体平台支持信息暂未提供。