chore(gate): 门禁钩子改走 gate_python 启动器,worktree 统一插件模型

门禁解释器解耦
  44 条 language: system 钩子此前把解释器写成仓库检出的绝对路径,换机、
  换克隆目录都要重写。改为 entry 只写 scripts/gate_python.py + 脚本名,
  由启动器按候选链解析:$DTU_GATE_PYTHON > <仓库>/.venv >
  <仓库>/.gate/python > PATH。启动器用 execve 替换自身,并把选中的
  解释器经 DTU_GATE_PYTHON 传给子进程,保证脚本内再调 Python 时一致。
  实测 pre-commit 4.6.2 不展开 ${VAR};language: script 的 shebang 只做
  纯 PATH 改写,会把决定权交给 PATH 首个 python,故不采用。
  ci_local.py 预检识别启动器并报出解析结果。

并行工作树统一
  task-worktree 新增 bench-gate(强制台架验收)与 merge(编排式合并),
  删除 new/abort,done 标 DEPRECATED;台架通过记录改存
  .agents/worktrees/.bench-pass-log。keil_build.py 的 plugin_tree_owner
  识别 .agents/worktrees/<name> 并返回 pw:<name>。
  check_doc_links / gen_refgraph / check_layer_deps 的扫描排除面补上
  .agents;并行任务工作树方案重写为单一模型(7 节),取消工作树数量上限,
  删历史实测记录节,两处 §7.3 悬空引用改为按语义引用。

文档与约定
  本地工具路径环境变量方案 §5 重写为四节:谁跑在哪个 Python 上、写新钩子、
  预检对号入座、动环境五步。文档规范的变更记录例外名单由 5 篇减为 4 篇
  (本篇实际没有该节)。AGENTS.md 补委派验收口径三条。

验证:pre_commit run --all-files 48 钩子全 Passed;ci_local.py
--preflight-only 报 44 条经启动器 -> 仓库 .venv;keil-build 0 errors
0 warnings;check_doc_links --sections-strict 全通过。
This commit is contained in:
2026-11-15 19:39:56 +08:00
parent 9f68b7bc03
commit 96a3d15efc
17 changed files with 826 additions and 720 deletions
+227 -137
View File
@@ -82,13 +82,14 @@ BASE_BRANCH = os.environ.get("DTU_TASK_BASE", "master")
STATE_DIR = WT_ROOT / ".state"
LOCKS_DIR = STATE_DIR / "locks"
# DSH 的 worktree 插件(包名 dsh-task-worktree;模型工具 worktree_create、人类命令
# /worktree)把任务树建在**仓库内**这个命名空间下,与本 skill 的仓外 _wt/ 刻意分开。
# .gitignore 里预置同名规则,正是为了让插件的 ensureIgnored() 见到就跳过、
# 不在会话中途往这份受控文件里追加一行。
# DSH worktree 插件实际使用两个位置(历史演进):
# 旧版 dsh-task-worktree → .dsh-worktrees/worktree/
# 新版内置 create_worktree → .agents/worktrees/
# bench-pass 记录文件(JSON lines,每行 {branch, timestamp, operator})
# 放在 .agents/worktrees/ 下,因为 git notes 在 Windows worktree 间共享有坑
BENCH_PASS_LOG = REPO_ROOT / ".agents" / "worktrees" / ".bench-pass-log"
# 现役 DSH worktree 插件 = @deepseek-ai/dsh-experimental-tool-worktree 0.2.2-rc.1,
# 模型工具 create_worktree 默认在仓库内 .agents/worktrees/<name>/ 建同名分支并切换会话 cwd。
# 旧版 dsh-task-worktree 使用 .dsh-worktrees/worktree/<name>/;两处都与本 skill 的
# 仓外 _wt/ 刻意分开。现役插件只负责 create/restore,不合并、不删树、不管锁或共享联接。
# plugin_trees() 同时扫描两处,list 统一展示。
PLUGIN_ROOT_LEGACY = REPO_ROOT / ".dsh-worktrees"
PLUGIN_NAMESPACE_LEGACY = "worktree"
@@ -336,6 +337,49 @@ def lock_release(name: str, task=None, force: bool = False):
return True, "已释放锁 {}(原持有者 {})".format(name, info.get("task"))
# --------------------------------------------------------------------- bench-pass 记录
def read_bench_pass_log() -> list:
"""读取 bench-pass 日志文件,返回记录列表(每行一个 JSON 对象)"""
if not BENCH_PASS_LOG.is_file():
return []
records = []
try:
for line in BENCH_PASS_LOG.read_text(encoding="utf-8").splitlines():
line = line.strip()
if line:
try:
records.append(json.loads(line))
except json.JSONDecodeError:
continue
except OSError:
pass
return records
def find_bench_pass(branch: str) -> dict:
"""查找指定分支的最近一次 bench-pass 记录,无记录返回 None"""
records = read_bench_pass_log()
# 从后往前找,返回最近的匹配
for rec in reversed(records):
if rec.get("branch") == branch:
return rec
return None
def write_bench_pass(branch: str, operator: str = None) -> None:
"""写入一条 bench-pass 记录"""
BENCH_PASS_LOG.parent.mkdir(parents=True, exist_ok=True)
record = {
"branch": branch,
"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
"operator": operator or os.environ.get("USERNAME", os.environ.get("USER", "?")),
}
with open(BENCH_PASS_LOG, "a", encoding="utf-8") as f:
f.write(json.dumps(record, ensure_ascii=False) + "\n")
# --------------------------------------------------------------------- 目录联接
@@ -411,8 +455,9 @@ def bootstrap(wt: Path):
# --------------------------------------------------------------------- DSH 插件工作树
#
# 插件建的树(.dsh-worktrees/worktree/<name>)缺三样东西,下面的命令逐条补。
# 回收**不在这里**:插件树由「/worktree remove|prune」收,done/abort 也不该拿去处理它。
# 新旧插件建的树缺三样东西,下面的命令逐条补。
# 回收**不在这里**:done/abort 不该处理插件树。现役插件只 create/restore、保留目录与分支;
# 要回收时先 unadopt 摘联接,再按本 skill 的 E 节非登记树安全规程处理。
# 1. 共享联接——没有 .venv 与 simulator 的 SDL2 SDK,插件树里「.venv\Scripts\python.exe」
# 直接找不到解释器:/keil-build、ci_local.py、所有 scripts/check_*.py 全部起跑失败;
# 2. 可见性——插件树不在台账里,「list」看不见它,8 个活跃名额也只数登记任务;
@@ -420,36 +465,65 @@ def bootstrap(wt: Path):
# 插件树里算成 pw:<name>),bench 锁仍要人占,占锁名得和「lock status」对得上。
def _plugin_name_parts(name: str):
"""把现役/旧版插件树名归一成同一组路径段;不静默吞掉 .. 等逃逸段。"""
raw = (name or "").strip().replace("\\", "/").strip("/")
if raw.startswith(".agents/worktrees/"):
raw = raw[len(".agents/worktrees/"):]
elif raw.startswith(".dsh-worktrees/"):
raw = raw[len(".dsh-worktrees/"):]
segs = [s for s in raw.split("/") if s]
if segs and segs[0] == PLUGIN_NAMESPACE_LEGACY:
segs = segs[1:]
return segs
def plugin_lock_owner(name: str) -> str:
"""插件树在锁 payload 里的持有者名:pw:<name>(多段名压平成 -)。
必须与 keil_build.py 的 default_lock_task() 对同一种树算出的名字一致——这样构建
自持自释留下的归属,和手工「lock acquire bench --task pw:x」才是同一个可 grep 的标识。
新旧路径写法与裸名都归一到同一个 owner,避免 lock status 出现两个持有者名。
"""
# 与 plugin_dir_for 同样容忍「worktree/」前缀,否则同一棵树会出现两个持有者名
# (pw:refactor-logging vs pw:worktree-refactor-logging),lock status 就散了。
segs = [s for s in name.replace(os.sep, "/").strip("/").split("/") if s]
if segs and segs[0] == PLUGIN_NAMESPACE:
segs = segs[1:]
return "{}:{}".format(PLUGIN_LOCK_PREFIX, "-".join(segs) or "?")
return "{}:{}".format(PLUGIN_LOCK_PREFIX, "-".join(_plugin_name_parts(name)) or "?")
def plugin_dir_for(name: str) -> Path:
"""插件 worktree 名 → 树目录;**只允许落在 .dsh-worktrees/worktree/ 里面**。
"""插件 worktree 名 → 树目录;现役 .agents/worktrees/ 与旧路径均可,禁止逃逸。
adopt/unadopt 会在解析出的目录上建/摘目录联接;不加这道闸,等于允许把主工作树或
任意 _wt 目录当插件树动手(联接会遮蔽真实内容,事后很难看出来)。
任意 _wt 目录当插件树动手(联接会遮蔽真实内容,事后很难看出来)。同名树两处都有时
拒绝猜测,要求传带根路径的全名。
"""
raw = (name or "").strip().replace(os.sep, "/").strip("/")
raw = (name or "").strip().replace("\\", "/").strip("/")
if not raw:
raise EnvError("缺插件 worktree 名(先跑「plugin list」看现有树)")
if raw == PLUGIN_NAMESPACE or raw.startswith(PLUGIN_NAMESPACE + "/"):
raw = raw[len(PLUGIN_NAMESPACE):].strip("/")
p = (PLUGIN_SUBDIR / raw).resolve()
base = PLUGIN_SUBDIR.resolve()
if p == base or base not in p.parents:
raise EnvError("拒绝 {}:只接受 {} 里面的树".format(p, PLUGIN_SUBDIR))
return p
if raw in (".agents", ".agents/worktrees", ".dsh-worktrees", ".dsh-worktrees/worktree"):
raise EnvError("拒绝 {}:必须指定插件树名,不能只给根目录".format(raw))
segs = _plugin_name_parts(raw)
if not segs or any(s in (".", "..") for s in segs):
raise EnvError("拒绝 {}:插件树名不能为空,也不能含 . 或 ..".format(name))
explicit = raw.startswith(".agents/worktrees/") or raw.startswith(".dsh-worktrees/")
bases = [PLUGIN_ROOT_AGENTS] if raw.startswith(".agents/worktrees/") else []
if raw.startswith(".dsh-worktrees/"):
bases = [PLUGIN_SUBDIR_LEGACY]
if not explicit:
bases = [PLUGIN_ROOT_AGENTS, PLUGIN_SUBDIR_LEGACY]
matches = []
for base in bases:
p = (base.joinpath(*segs)).resolve()
resolved_base = base.resolve()
if p == resolved_base or resolved_base not in p.parents:
raise EnvError("拒绝 {}:只接受插件命名空间里面的树".format(p))
if p.is_dir():
matches.append(p)
if len(matches) > 1:
raise EnvError("插件树名 {} 在新旧两处都存在;请传 .agents/worktrees/{} 或 "
".dsh-worktrees/worktree/{} 消歧".format(name, raw, raw))
# 未创建/已删除的树也要能给出确定的候选路径,让上层报「目录不存在」而非 NameError。
return matches[0] if matches else (bases[0].joinpath(*segs)).resolve()
def junction_states(wt: Path):
@@ -486,7 +560,7 @@ def plugin_trees():
位置:
- .dsh-worktrees/worktree/ (旧版 dsh-task-worktree 插件)
- .agents/worktrees/ (新版内置 create_worktree 工具)
- .agents/worktrees/ (现役 dsh-experimental-tool-worktree 的 create_worktree 工具)
manifest.json 是插件私有格式(MANIFEST_VERSION 1,字段随版本变),而 git 的注册表
同时覆盖「插件正常建的树」和「manifest 丢了 / 树被手工删」的残留——桥接命令要看的
@@ -540,8 +614,9 @@ def print_plugin_trees() -> int:
if not trees:
return 0
print()
print("DSH 插件工作树({} 下;**不在本 skill 台账** → 不占 {} 个名额、done/abort "
"管不到,回收走 /worktree remove|prune):".format(PLUGIN_SUBDIR, MAX_CONCURRENT))
print("DSH 插件工作树(.agents/worktrees/ 与旧 .dsh-worktrees/worktree/;**不在本 skill "
"台账** → 不占 {} 个名额、done/abort 管不到;现役插件保留目录与分支,回收先 "
"unadopt 再走 E 节安全规程):".format(MAX_CONCURRENT))
print("{:<26} {:<34} {:>4} {:>16}".format("名称", "分支", "脏", "联接"))
for t in trees:
print("{:<26} {:<34} {:>4} {:>16}".format(
@@ -590,15 +665,16 @@ def adopt_junctions(wt: Path):
def cmd_plugin(a) -> int:
if a.action == "list":
if print_plugin_trees() == 0:
print("({} 下没有插件工作树)".format(PLUGIN_SUBDIR))
print(" 建法:新会话输入框选「Worktree模式」/ 让模型调 worktree_create / "
"/worktree create <name>")
print("(.agents/worktrees/ 与旧 .dsh-worktrees/worktree/ 下没有插件工作树)")
print(" 建法:让模型调现役插件的 create_worktree;默认建 .agents/worktrees/<name>/ "
"及同名分支,并切换会话 cwd")
print(" 建完回来「plugin adopt <name>」补共享联接,才能在里面跑 /keil-build 与门禁。")
return EXIT_OK
wt = plugin_dir_for(a.name)
if not wt.is_dir():
raise EnvError("目录不存在:{}(先用插件建树:/worktree create 或 worktree_create)".format(wt))
raise EnvError("目录不存在:{}(先用现役插件的 create_worktree 建树;旧树也可放在 "
".dsh-worktrees/worktree/<name>/)".format(wt))
if a.action == "adopt":
if git("rev-parse", "--git-dir", cwd=wt, check=False).returncode != 0:
@@ -619,7 +695,8 @@ def cmd_plugin(a) -> int:
print("build 锁由 keil_build.py 自持自释,持有者名就是 {}".format(owner))
print("上台架前:$TW lock acquire bench --task {} --note <说明>".format(owner))
print("下台架后:$TW lock release bench --task {}".format(owner))
print("回收仍归插件:/worktree remove {}(本 skill 不删插件树)".format(a.name))
print("现役插件只 create/restore,不自动回收,会保留目录与分支;本 skill 不代删。")
print("确需回收:先 plugin unadopt {} 摘联接,再按 E 节非登记树安全规程处理。".format(a.name))
return EXIT_OK
removed = [rel for rel, _spec in JUNCTION_SPECS if remove_junction(wt / rel)]
@@ -628,6 +705,96 @@ def cmd_plugin(a) -> int:
return EXIT_OK
# --------------------------------------------------------------------- bench-gate / merge(新统一模型)
def cmd_bench_gate(a) -> int:
"""检查指定分支是否有 bench-pass 记录"""
branch = a.branch
rec = find_bench_pass(branch)
if rec is None:
print("分支 {} 无 bench-pass 记录,请先跑台架验证".format(branch), file=sys.stderr)
return EXIT_FAIL
print("[ok] 分支 {} 有 bench-pass 记录".format(branch))
print(" 最近通过时间:{}".format(rec.get("timestamp", "?")))
print(" 操作人:{}".format(rec.get("operator", "?")))
return EXIT_OK
def cmd_merge(a) -> int:
"""在主树执行编排式合并"""
branch = a.branch
main = main_worktree()
# 检查当前是否在主树
if Path.cwd().resolve() != main.resolve():
raise EnvError("merge 必须在主工作树执行:{}".format(main))
# 检查主树是否干净
if git_out("status", "--porcelain", cwd=main, check=False):
raise Fail("主工作树不干净——合并会把未提交改动卷进来")
cur = git_out("rev-parse", "--abbrev-ref", "HEAD", cwd=main)
base = BASE_BRANCH
if cur != base:
raise Fail("主工作树当前在 {},不是集成分支 {};先切过去再 merge".format(cur, base))
# 检查分支是否存在
if git("rev-parse", "--verify", "--quiet", "refs/heads/" + branch, check=False).returncode != 0:
raise EnvError("分支不存在:{}".format(branch))
# Step 1: bench-gate 检查(除非 --skip-bench)
if not a.skip_bench:
rec = find_bench_pass(branch)
if rec is None:
print("分支 {} 无 bench-pass 记录,请先跑台架验证".format(branch), file=sys.stderr)
print("(加 --skip-bench 可跳过此检查)", file=sys.stderr)
return EXIT_FAIL
print("[ok] bench-gate 通过({})".format(rec.get("timestamp", "?")))
# Step 2: 预演合并(--no-commit)
print("=== 合并预演(git merge --no-ff --no-commit)===")
r = git("merge", "--no-ff", "--no-commit", branch, cwd=main, check=False)
if r.returncode != 0:
# 中止合并
git("merge", "--abort", cwd=main, check=False)
out = (r.stdout + r.stderr).strip()
print(out)
raise Fail("合并有冲突:请回到任务分支解决冲突后重试\n"
" cd <任务工作树> && git merge {} && ... && git commit".format(base))
# Step 3: 检查是否有实际改动(可能已经合入过了)
staged = git_out("diff", "--cached", "--name-only", cwd=main, check=False)
if not staged.strip():
# 没有改动,说明分支已合入或无差异
git("merge", "--abort", cwd=main, check=False)
print("[i] 分支 {} 已合入或与 {} 无差异,无需合并".format(branch, base))
return EXIT_OK
# Step 4: 完成合并提交
print("=== 完成合并提交 ===")
title = "merge: {} 合入 {}".format(branch, base)
if len(title) > 100:
title = title[:97] + "..."
msg_lines = [title, "", "经 task-worktree merge 命令合入。"]
fd, msgpath = tempfile.mkstemp(prefix="taskwt-merge-", suffix=".txt")
os.close(fd)
Path(msgpath).write_text("\n".join(msg_lines) + "\n", encoding="utf-8", newline="\n")
try:
r = git("commit", "--no-edit", "-F", str(msgpath), cwd=main, check=False)
if r.returncode != 0:
raise Fail("合并提交失败:\n{}".format((r.stdout + r.stderr).strip()))
finally:
Path(msgpath).unlink(missing_ok=True)
sha = git_out("rev-parse", "--short", "HEAD", cwd=main)
print("[ok] 合并完成({})".format(sha))
print()
print("合并完成,请在主树跑全量门禁")
print("提示:任务分支和目录未自动删除,清场请走 plugin unadopt + 手动回收")
return EXIT_OK
# --------------------------------------------------------------------- 子进程脚本
@@ -811,59 +978,6 @@ def teardown_worktree(st: dict, force: bool = False, base: str = None) -> None:
# --------------------------------------------------------------------- 子命令
def cmd_new(a) -> int:
if not ID_RE.match(a.task_id):
raise EnvError("任务 ID 非法:{}(字母数字开头,可用 . _ -)".format(a.task_id))
if not SLUG_RE.match(a.slug):
raise EnvError("slug 非法:{}(小写字母数字与连字符)".format(a.slug))
branch = "{}{}-{}".format(BRANCH_PREFIX, a.task_id, a.slug)
wt = WT_ROOT / "{}-{}".format(a.task_id, a.slug)
if state_file(a.task_id).is_file():
raise EnvError("任务 {} 已存在({})".format(a.task_id, state_file(a.task_id)))
if os.path.lexists(str(wt)):
raise EnvError("目录已存在:{}".format(wt))
if git("rev-parse", "--verify", "--quiet", "refs/heads/" + branch, check=False).returncode == 0:
raise EnvError("分支已存在:{}".format(branch))
if git("rev-parse", "--verify", "--quiet", a.base, check=False).returncode != 0:
raise EnvError("基线分支不存在:{}".format(a.base))
active = [s for s in all_states() if Path(s["path"]).is_dir()]
if len(active) >= MAX_CONCURRENT and not a.force:
raise EnvError("已有 {} 个活跃任务(上限 {});先 done/abort,或加 --force".format(
len(active), MAX_CONCURRENT))
n_plugin = len(plugin_trees())
if n_plugin:
print("[i] 另有 {} 个 DSH 插件工作树(.dsh-worktrees/,不计入上限 {});"
"磁盘与 UV4 / 台架仍是共享资源——「plugin list」看清单".format(n_plugin, MAX_CONCURRENT))
WT_ROOT.mkdir(parents=True, exist_ok=True)
print("[1/3] 建工作树(分支 {},基线 {}{})…".format(
branch, a.base, ",跳过 LFS smudge" if a.lean else ""))
git("worktree", "add", "-b", branch, str(wt), a.base,
env={"GIT_LFS_SKIP_SMUDGE": "1"} if a.lean else None)
print("[2/3] 建立共享联接…")
junctions = [] if a.no_bootstrap else bootstrap(wt)
st = {
"id": a.task_id, "slug": a.slug, "branch": branch, "path": str(wt),
"base": a.base, "created_at": time.strftime("%Y-%m-%d %H:%M:%S"),
"junctions": junctions, "needs_bench": bool(a.needs_bench),
"bench_pass": False, "note": a.note or "", "lean": bool(a.lean),
}
save_state(st)
print("[3/3] 台账已写入 {}".format(state_file(a.task_id)))
print()
print("下一步:把新会话的工作目录切到")
print(" " + str(wt))
print("在该目录里干活、跑 /keil-build 与 ci_local.py(并行安全);")
print("要动台架先 `lock acquire bench --task {}`,完事 `lock release bench --task {} --bench-pass`。".format(
a.task_id, a.task_id))
print("回收用 `done {}`(**必须在主工作树执行**)。".format(a.task_id))
return EXIT_OK
def cmd_list(a) -> int:
states = all_states()
if not states:
@@ -974,19 +1088,19 @@ def cmd_lock(a) -> int:
if a.bench_pass:
if not a.task:
raise EnvError("--bench-pass 需要 --task <ID>")
# 非登记持有者(lead 的验收窗、插件树 pw:*)没有台账。以前这里先 load_state
# 就抛「任务 X 不存在(缺台账)」,**根本走不到释放**:锁还挂着,而 done 的前置
# 会因活锁判失败——一个名字没登记,就挡住所有任务的收口。现在降级为显式告警 +
# 照常释放:PASS 没进台账是事实,但不该拿「锁放不掉」当代价。
# 写入统一的 bench-pass-log(新模型)
# 尝试从台账获取分支名,否则用 task ID 作为分支标识
branch_name = a.task
if state_file(a.task).is_file():
st = load_state(a.task)
st["bench_pass"] = True
save_state(st)
print("[ok] 已为任务 {} 记录台架 PASS".format(a.task))
else:
print("[warn] 任务 {} 无台账({})→ **跳过 PASS 记录,仅释放锁**;要把 PASS 留在"
"台账里就得用已「new」出来的任务 ID 占锁,或把验收结论写进主干提交说明/文档"
.format(a.task, state_file(a.task)))
try:
st = load_state(a.task)
st["bench_pass"] = True
save_state(st)
branch_name = st.get("branch", a.task)
except Exception:
pass
write_bench_pass(branch_name)
print("[ok] 已记录台架 PASS(分支 {})到 {}".format(branch_name, BENCH_PASS_LOG))
ok, msg = lock_release(a.name, a.task, force=a.force)
print(msg)
return EXIT_OK if ok else EXIT_FAIL
@@ -1014,6 +1128,8 @@ def release_stale_locks() -> None:
def cmd_done(a) -> int:
print("[DEPRECATED] done 已废弃,请用 merge 命令", file=sys.stderr)
print()
st = load_state(a.task_id)
wt = Path(st["path"])
branch = st["branch"]
@@ -1280,25 +1396,6 @@ def cmd_postmerge(a) -> int:
return EXIT_OK if ok else EXIT_FAIL
def cmd_abort(a) -> int:
st = load_state(a.task_id)
wt = Path(st["path"])
if wt.is_dir():
dirty = git_out("status", "--porcelain", cwd=wt, check=False).splitlines()
ahead = int(git_out("rev-list", "--count",
"{}..{}".format(st["base"], st["branch"]), cwd=wt,
check=False) or "0")
if (dirty or ahead) and not a.force:
print("任务 {} 有 {} 项未提交改动、{} 个未合并提交,abort 会**永久丢弃**:".format(
st["id"], len(dirty), ahead))
for line in dirty[:20]:
print(" " + line)
raise Fail("确认丢弃请加 --force")
teardown_worktree(st, force=True)
print("\n已放弃任务 {}(工作树与分支均已删除)".format(st["id"]))
return EXIT_OK
# --------------------------------------------------------------------- 入口
@@ -1308,18 +1405,16 @@ def build_parser():
description="多任务并行开发的空间管理(git worktree 生命周期)")
sub = ap.add_subparsers(dest="cmd")
p = sub.add_parser("new", help="新建任务空间")
p.add_argument("task_id")
p.add_argument("slug")
p.add_argument("--base", default=BASE_BRANCH, help="基线分支(默认 %(default)s)")
p.add_argument("--lean", action="store_true",
help="跳过 Git LFS smudge(省约 38MB,参考图变成指针文件)")
p.add_argument("--no-bootstrap", action="store_true", help="不建共享联接")
p.add_argument("--needs-bench", action="store_true",
help="需台架验证;无 PASS 记录则 done 拒绝合并")
p.add_argument("--note", default="")
p.add_argument("--force", action="store_true", help="忽略并发上限")
p.set_defaults(func=cmd_new)
# bench-gate:检查分支是否有 bench-pass 记录
p = sub.add_parser("bench-gate", help="检查指定分支是否有 bench-pass 记录")
p.add_argument("branch", help="要检查的分支名")
p.set_defaults(func=cmd_bench_gate)
# merge:在主树执行编排式合并
p = sub.add_parser("merge", help="在主树执行编排式合并(bench-gate → 预演 → 合并)")
p.add_argument("branch", help="要合并的分支名")
p.add_argument("--skip-bench", action="store_true", help="跳过 bench-gate 检查")
p.set_defaults(func=cmd_merge)
p = sub.add_parser("list", help="列出所有任务空间")
p.set_defaults(func=cmd_list)
@@ -1346,13 +1441,13 @@ def build_parser():
help="release bench 时顺带为该任务记录台架 PASS")
p.set_defaults(func=cmd_lock)
p = sub.add_parser("plugin", help="DSH worktree 插件的树(.dsh-worktrees/):list / adopt / unadopt")
p = sub.add_parser("plugin", help="DSH 插件树(.agents/worktrees/,兼容旧路径):list / adopt / unadopt")
p.add_argument("action", choices=["list", "adopt", "unadopt"])
p.add_argument("name", nargs="?", default="",
help="插件 worktree 名(可带 worktree/ 前缀或多段斜杠)")
help="插件树名;可用裸名,或带 .agents/worktrees/ 与旧 .dsh-worktrees/worktree/ 前缀消歧")
p.set_defaults(func=cmd_plugin)
p = sub.add_parser("done", help="回收:预演 → 合入主干 → 审计 → 重生成 → 门禁 → 清场")
p = sub.add_parser("done", help="[DEPRECATED] 已废弃,请用 merge 命令")
p.add_argument("task_id")
p.add_argument("--base", default=None)
p.add_argument("--dry-run", action="store_true", help="只预演,不做任何改动")
@@ -1361,11 +1456,6 @@ def build_parser():
p.add_argument("--force", action="store_true", help="清场时强制移除工作树")
p.set_defaults(func=cmd_done)
p = sub.add_parser("abort", help="放弃任务(不合并)")
p.add_argument("task_id")
p.add_argument("--force", action="store_true")
p.set_defaults(func=cmd_abort)
p = sub.add_parser("precheck", help="树内自查(只读):字节体检 + docs 逐档门禁 + 可选消息检查")
p.add_argument("--msgfile", default=None, help="附带检查提交信息文件(BOM/CRLF/行长/禁词)")
p.add_argument("--ban", action="append", default=[], help="禁词,可重复")