worktree-mgr

@JohnXu22786 · Git
检测有风险提示无安装脚本

为 DSH 提供按任务隔离的 git worktree 全生命周期管理,覆盖创建、同步与自动清理

v0.1.0版本
GitHub 源码安装安装方式
2026-08-17最近更新
2Star
dsh plugin --profile web add github:JohnXu22786/worktree-mgr查看仓库

插件介绍

根据仓库资料整理 · commit 63a457e

主要功能

  • 任务名自动派生分支与工作区路径,无需手动指定 git 分支
  • 分支名安全校验:slug 归一化、双重 ref 合法性检查,避免冲突和非法引用
  • 合并前校验主仓库与任务分支一致性,防止改动合并到错误分支
  • 同步(merge)与收尾(finish)分离,finish 自动提交、合并、删除工作区和分支并清理记录
  • 支持批量清理多个任务(wtm_purge),单个失败不影响其余任务
  • 并发安全的 ledger 写入(带心跳互斥锁)及创建失败自动回滚

适合什么时候用

  • 模型或多人需要并行处理多个任务,且希望各自隔离在独立 git worktree 中互不干扰
  • 希望任务分支的创建、合并、清理全流程自动化,避免手动执行 git 命令出错

安装后会多出什么

命令wtm beginwtm mergewtm finishwtm statuswtm purgewtm help
Agent 工具wtm_beginwtm_mergewtm_finishwtm_statuswtm_purge

使用前需要

  • 需要 Node.js >= 21 运行环境
  • 需要本地已安装 git,且在 git 仓库内使用
  • 仓库级配置可选,通过 <repo-root>/.wtm.json 自定义分支前缀、提交信息模板等

在 GitHub 阅读完整 README

权限与能力

安装后它能碰到什么
不覆盖任何 dsh-base 宿主行:不接管沙箱、审批、凭据等能力。
宿主能力
环境变量文件系统宿主子进程
能力是范围不是结论:很多能力是功能所需。

基本信息

仓库JohnXu22786/worktree-mgr安装方式GitHub 源码安装(需 allowBuilds)安装提示源码安装会在你的机器上执行 prepare 构建,需要 allowBuilds 授权;建议用 github:JohnXu22786/worktree-mgr#63a457e 锁定本次检测的 commit。收录日期2026-08-16固定 commit63a457e23eb3 · 2026-08-17
dsh plugin --profile web add github:JohnXu22786/worktree-mgr