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:
@@ -96,7 +96,7 @@ Agent 手工 `lock acquire build` 后忘了 `release`,锁要挂到 TTL 才被
|
||||
|
||||
| 开关 | 作用 |
|
||||
|---|---|
|
||||
| `--lock-task <ID>` | 持有者名。默认 `$DTU_TASK_ID` → 从 cwd 反推:`_wt/<ID>-<slug>/` → `<ID>`(`@task` 那批);`.dsh-worktrees/worktree/<name>/` → `pw:<name>`(DSH worktree **插件**建的树,`plugin_tree_owner()`)→ 都没有才落 `build-cli` |
|
||||
| `--lock-task <ID>` | 持有者名。默认 `$DTU_TASK_ID` → 从 cwd 反推:`_wt/<ID>-<slug>/` → `<ID>`(`@task` 那批);`.agents/worktrees/<name>/` 或旧 `.dsh-worktrees/worktree/<name>/` → `pw:<name>`(DSH worktree **插件**建的树,`plugin_tree_owner()`)→ 都没有才落 `build-cli` |
|
||||
| `--lock-wait <N>` | 锁被占时等待 N 秒(默认 0 = 立即失败,退出码 4) |
|
||||
| `--no-lock` | 完全不加锁(危险:并发 `-b` 互相干扰) |
|
||||
| `DTU_LOCK_HELD=build` | 环境变量:**调用方已持锁**时设它,本脚本跳过自持自释(`task-worktree done` 的门禁即如此用) |
|
||||
@@ -108,7 +108,7 @@ Agent 手工 `lock acquire build` 后忘了 `release`,锁要挂到 TTL 才被
|
||||
并告警**(保持本 skill 可独立搬运)。
|
||||
- ⚠ 从 `_wt/<ID>-<slug>/` 反推持有者名,意味着"手工 `lock acquire build --task <ID>`
|
||||
后再跑 `/keil-build`"仍**幂等**(同名即视为自己持有),不会自我死锁。
|
||||
- **退出码 4 的持有者名带 `pw:`(如 `pw:refactor-logging`)= 插件在 `.dsh-worktrees/worktree/<name>/` 里跑的构建占着 UV4,不是某个 `@task` 任务 ID**:
|
||||
- **退出码 4 的持有者名带 `pw:`(如 `pw:refactor-logging`)= 插件在 `.agents/worktrees/<name>/`(或旧 `.dsh-worktrees/worktree/<name>/`)里跑的构建占着 UV4,不是某个 `@task` 任务 ID**:
|
||||
插件树**没有台账**,别拿它去 `lock release <ID>`(释放不掉别人的锁)、更别去杀 UV4 进程。正解 =
|
||||
等那次构建自己 `finally` 释放(自持自释;崩溃则按自报 TTL 兜底),或本次加 `--lock-wait <N>` 排队;
|
||||
想知道是哪棵树的谁:`"$PY" "$TW" plugin list`(缺联接再 `plugin adopt <name>`)→ 细节归
|
||||
|
||||
@@ -274,20 +274,24 @@ def find_lock_tool():
|
||||
|
||||
|
||||
def plugin_tree_owner(cwd: Path):
|
||||
"""DSH worktree 插件的树(仓库内 .dsh-worktrees/worktree/<name>)→ 持有者名 pw:<name>。
|
||||
"""现役/旧版 DSH 插件树 → 同一个持有者名 pw:<name>(多段名压平成 -)。
|
||||
|
||||
2026-10-29 与 task-worktree skill 的 `plugin` 子命令对齐:插件建的树不在 _wt/ 约定里,
|
||||
以前在这里跑构建,持有者名一律落成 "build-cli"——`lock status` 看不出是谁在占 UV4,
|
||||
多个插件树 / 主树并发时就只剩猜。名字里的多段斜杠压平成 -,与
|
||||
task_worktree.py 的 plugin_lock_owner() 完全一致(同一个可 grep 的标识)。
|
||||
现役 @deepseek-ai/dsh-experimental-tool-worktree 默认把树放在
|
||||
.agents/worktrees/<name>/;旧版路径是 .dsh-worktrees/worktree/<name>/。
|
||||
只认这两个完整目录形态,避免把偶然同名目录或路径之外的普通目录算成插件树。
|
||||
与 task_worktree.py 的 plugin_lock_owner() 保持同一个可 grep 的标识。
|
||||
"""
|
||||
parts = cwd.parts
|
||||
if ".dsh-worktrees" not in parts:
|
||||
return None
|
||||
tail = parts[parts.index(".dsh-worktrees") + 1:]
|
||||
if tail and tail[0] == "worktree":
|
||||
tail = tail[1:]
|
||||
return "pw:" + "-".join(tail) if tail else "pw:?"
|
||||
parts = cwd.resolve().parts
|
||||
for marker, namespace in ((".agents", "worktrees"),
|
||||
(".dsh-worktrees", "worktree")):
|
||||
if marker not in parts:
|
||||
continue
|
||||
idx = parts.index(marker)
|
||||
if len(parts) <= idx + 2 or parts[idx + 1] != namespace:
|
||||
return None
|
||||
tail = parts[idx + 2:]
|
||||
return "pw:" + "-".join(tail) if tail else "pw:?"
|
||||
return None
|
||||
|
||||
|
||||
def default_lock_task():
|
||||
|
||||
@@ -38,30 +38,39 @@ PY=".venv/Scripts/python.exe"; TW=".dsh/skills/task-worktree/scripts/task_worktr
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---|---|
|
||||
| `new <ID> <slug>` | 建分支 `task/<ID>-<slug>` + 工作树 + 共享联接 + 台账,打印新空间路径 |
|
||||
| `bench-gate <branch>` | 检查指定分支是否有 bench-pass 记录(存储于 `.agents/worktrees/.bench-pass-log`) |
|
||||
| `merge <branch>` | 在主树执行编排式合并:bench-gate → 预演 → 合并(`--skip-bench` 跳过台架检查) |
|
||||
| `list` | 分支 / 落后领先 / 脏文件数 / 台架状态 + 两把锁归属。**只遍历台账** → 非登记树看不见(E 节) |
|
||||
| `status <ID>` | 未提交清单、相对基线漂移、台架记录、已建联接 |
|
||||
| `sync <ID>` | 在任务树里 `rebase` 追平主干,把冲突留在任务分支上 |
|
||||
| `lock acquire|release|status <build\|bench>` | 独占资源锁(→ 铁律 3、B 节) |
|
||||
| `plugin list|adopt|unadopt [插件树名]` | 插件桥:看清单 / 补共享联接 / 摘联接(**不删树**)→ F 节 |
|
||||
| `done <ID>` | 预演 → 合入主干 → 并集残留审计 → 重生成产物 → 门禁 → 清场 |
|
||||
| `abort <ID>` | 工作树 + 分支一起删,**永久丢弃** |
|
||||
| `done <ID>` | **[DEPRECATED]** 已废弃,请用 `merge`。预演 → 合入主干 → 审计 → 重生成 → 门禁 → 清场 |
|
||||
| `precheck` | 树内自查(**只读**):BOM 漂移 / CR / U+FFFD + docs 逐档门禁 + `--msgfile --ban` 消息检查;顺手补 `ci-artifacts/`(G 节机械项) |
|
||||
| `postmerge` | 主树合并后补绿:体积凭证**自动诊断**(新鲜跳过;红→先短链 `--update`,只读复检真漂了才升全链)+ `check_doc_links --all` + 列待提交文件,**不代提交** |
|
||||
|
||||
- **退出码** `0` 成功 / `1` 操作失败 / `2` 前置或环境错误 / `3` 用法——**只有不接管道才读得到**(→ 读输出)。
|
||||
- `new`:`--base`(默认 `master`)· `--needs-bench`(无台架 PASS 则 `done` 拒合)· `--lean`(跳 LFS smudge,只省磁盘不省时间)· `--no-bootstrap`(不建联接)· `--force`(**只跳过并发上限检查**,不解决谁让位 → A)
|
||||
- `done`:`--dry-run` · `--skip-build` · `--skip-gates` · `--force`。⚠ `--dry-run` **只保护预演段、不保护清场段**(实测:对已合入的分支它照样摘联接、删分支、清台账;且它的前置也要抢 `build` 锁)→ 用完复验 `git worktree list`,细节 → 陷阱清单。
|
||||
- `lock`:`--task`(acquire 必填)· `--wait <秒>` · `--ttl <小时>`(默认 `build`=1h / `bench`=6h,超期视为陈旧、下次 acquire 自动接管)· `--note` · `--bench-pass` · `--force`。⚠ `--note` 只在 **acquire** 写进 payload,**release 时被忽略** → 验收证据写主干提交说明或文档。
|
||||
- `bench-gate`:无参数选项。检查 `.agents/worktrees/.bench-pass-log` 中是否有该分支的记录。
|
||||
- `merge`:`--skip-bench`(跳过 bench-gate 检查)。合并后不自动删除任务分支和目录。
|
||||
- `done` **[DEPRECATED]**:`--dry-run` · `--skip-build` · `--skip-gates` · `--force`。⚠ 已废弃,请用 `merge`。
|
||||
- `lock`:`--task`(acquire 必填)· `--wait <秒>` · `--ttl <小时>`(默认 `build`=1h / `bench`=6h,超期视为陈旧、下次 acquire 自动接管)· `--note` · `--bench-pass` · `--force`。⚠ `--note` 只在 **acquire** 写进 payload,**release 时被忽略** → 验收证据写主干提交说明或文档。`--bench-pass` 现在同时写入 `.agents/worktrees/.bench-pass-log`。
|
||||
- 环境变量:`DTU_WT_ROOT`(默认仓库同级 `_wt/`)· `DTU_TASK_BASE`(默认基线)· `DTU_INTEGRATION_WORKTREE`(集成点,用于隔离演练)。
|
||||
|
||||
## 典型流程
|
||||
|
||||
```bash
|
||||
"$PY" "$TW" new N21 dhara-isfree --needs-bench # 把新会话工作目录切到打印出来的 _wt/N21-dhara-isfree/
|
||||
"$PY" "$TW" lock acquire bench --task N21 # 烧录 / /serial-boot-test / 板级套件
|
||||
"$PY" "$TW" lock release bench --task N21 --bench-pass
|
||||
"$PY" "$TW" done N21 # 回主工作树(铁律 1);先 --dry-run 读全量
|
||||
# 新模型:使用 DSH 插件 create_worktree 建树,然后用 bench-gate + merge 收口
|
||||
# (create_worktree 由 DSH 插件提供,不在本脚本内)
|
||||
|
||||
# 台架验证后记录 bench-pass(lock release --bench-pass 自动写入 .bench-pass-log)
|
||||
"$PY" "$TW" lock acquire bench --task pw:my-task
|
||||
"$PY" "$TW" lock release bench --task pw:my-task --bench-pass
|
||||
|
||||
# 合并前检查台架验收
|
||||
"$PY" "$TW" bench-gate task/my-task # 有记录返回 0,无记录返回 1
|
||||
|
||||
# 在主树执行合并(自动检查 bench-gate,--skip-bench 可跳过)
|
||||
"$PY" "$TW" merge task/my-task # 必须在主工作树执行
|
||||
```
|
||||
|
||||
## 读输出:管道与截断(两起误判的共同根因)
|
||||
@@ -130,14 +139,14 @@ git commit -F <UTF-8 无 BOM 的正文文件> # 提交属 Ask first(AGENTS.md
|
||||
|
||||
三条不可跳过:① 逐文件内容**三桶归类**(与主线工作区/HEAD 比对;「很久没动」不是判据)② 动手前跑**只读 reparse 预扫**,拿到 `REPARSE: none` 才许 `git worktree remove`(铁律 5)③ 唯一未合并残留先备份再 `--force`,拆完复验 + 清悬挂台账。**绝不跑 `done`/`abort`**(铁律 9)。全文(第 1~6 步 + 两份探针脚本)→ [reference/reclaim-unregistered.md](reference/reclaim-unregistered.md)。
|
||||
|
||||
### F. 与 DSH worktree 插件(`/worktree`、`worktree_create`)共存
|
||||
### F. 与现役 DSH worktree 插件(`create_worktree`)共存
|
||||
|
||||
| 联接 | 级别 | 依据 | 缺了会怎样 | 逃生门 |
|
||||
|---|---|---|---|---|
|
||||
| `simulator/SDL2` | **硬需求** | `simulator/CMakeLists.txt:12` 的 `set(SDL2_DIR …)` **非 `CACHE`**,include / `lib/x64` / `SDL2.dll` 全从它派生 | `build_sim.bat` 当场失败 | **无** |
|
||||
| `.venv` | 软需求 | `scripts/ci_local.py` 有 `DTU_PRECOMMIT_PYTHON` + 五级解释器候选 | **静默**落机器级解释器(缺 fontTools → `generated-fresh` 假红) | 环境变量 |
|
||||
|
||||
- `plugin adopt` 两条都补只是因为便宜,不代表两条都硬。插件树占锁记 `pw:<name>`、**回收仍归 /worktree**(本 skill 不删插件树,插件也不删 `_wt/`)。「有插件为何还自持生命周期」=先读插件包(`npm root -g`)再 grep 三个概念名报命中数,插件侧零命中就是理由——取证姿势与答案边界 → [reference/dsh-plugin-bridge.md](reference/dsh-plugin-bridge.md) F-2。
|
||||
- `plugin adopt` 两条都补只是因为便宜,不代表两条都硬。插件树占锁记 `pw:<name>`。现役插件只负责 create/restore,**保留目录与分支,不自动回收**;本 skill 不代删。确需回收先 `plugin unadopt <name>` 摘联接,再按 **E 节非登记树安全回收规程**处理。「有插件为何还自持生命周期」=先读插件包再 grep 三个概念名报命中数,插件侧零命中就是理由——取证姿势与答案边界 → [reference/dsh-plugin-bridge.md](reference/dsh-plugin-bridge.md) F-2。
|
||||
|
||||
### G. 任务树内跑门禁:落点、`--all` 假红、消息禁词
|
||||
|
||||
@@ -157,7 +166,7 @@ git commit -F <UTF-8 无 BOM 的正文文件> # 提交属 Ask first(AGENTS.md
|
||||
4. **单写者文档**:`docs/任务规划/`(整个文件夹)、`AGENTS.md` 任务表块、`MDK-ARM/*.uvprojx`、`.pre-commit-config.yaml`、内存快照 —— 任务期**不在任务树里改**,留到 `done` 统一处理;用户显式豁免时(在任务树写、由 done 合回)要在交付报告里点名这条例外。
|
||||
5. **清场必须先摘联接**:脚本先 `os.rmdir` 掉 `.venv` / `simulator/SDL2` 联接再 `git worktree remove`。手工拆树前必跑 **E 第 3 步**预扫拿到 `REPARSE: none`——否则 git 可能递归进联接把主树 `.venv` 一起删掉。
|
||||
6. **活跃任务硬上限 8 = 脚本常量 `MAX_CONCURRENT`(`task_worktree.py:30`)——唯一事实源**:报错文案与 `new` 的插件树提示都插值它,AGENTS.md / 方案文档 / frontmatter / A 节的数字全是引用同步。改这个数字 → 全形态扫描走 `stale-doc-count-sweep` skill + 隔离小仓验证上限真生效;每棵磁盘代价按实测口径重述、别照抄旧数(细节 → 验证清单末条)。满了 exit 2 → A;悬挂台账 → E 第 6 步。
|
||||
7. **工作树放仓库同级 `_wt/`,绝不在仓库内部**(否则污染 `git status`、`--all-files` 与全库搜索)。唯一例外 = 插件写死的仓内 `.dsh-worktrees/`(改不了,已用预置 .gitignore + 三个全库扫描排除兜住 → F 节)。
|
||||
7. **工作树放仓库同级 `_wt/`,绝不在仓库内部**(否则污染 `git status`、`--all-files` 与全库搜索)。唯一例外 = 插件写死的仓内 `.agents/worktrees/`(现役)与 `.dsh-worktrees/`(旧版);现役目录池自写 `.gitignore`,旧路径由根 `.gitignore` 预置,两处均已纳入三个全库扫描排除面(→ F 节)。
|
||||
8. **`done` 是合并点**:属主没提交完就别跑;合并提交进了主干就只用「主树补提交」收尾,**不用 `reset --hard`** 反悔 → C 节。
|
||||
9. **非登记 / detached 的树绝不跑 `done` / `abort`**:两者都以台账为前置(无台账 exit 2),带残留台账时 `abort --force` 会绕过内容保全把别人在飞的改动连树一起删 → E 节。
|
||||
|
||||
@@ -170,4 +179,4 @@ git commit -F <UTF-8 无 BOM 的正文文件> # 提交属 Ask first(AGENTS.md
|
||||
|
||||
- 构建 = `keil-build`· 烧录/回读 = `stlink-flash` · 串口闭环 = `serial-boot-test`(真实 hex 路径以 `.serialtest/config.json` 的 hex 键为准——实测 `MDK-ARM/Objects/STM32F407-Demo.hex` 不存在,拷错 = 烧旧镜像)
|
||||
- 新 `.c` 双端注册 = `new-source-file` · RAM/.map 台账 = `mem-budget` · UI 回归 = `ui-verify` · 计数同步 = `stale-doc-count-sweep` · 卡死的技能台账行 = `mnemon-skill-ledger-stuck-repair`
|
||||
- DSH worktree 插件(`/worktree` / `worktree_create`,仓内 `.dsh-worktrees/`)与本 skill 的分工、桥接命令、锁归属 → F 节 · 完整机制与目录分配 → `docs/环境与部署/并行任务工作树方案.md`
|
||||
- 现役 DSH worktree 插件(`create_worktree`,仓内 `.agents/worktrees/`,兼容旧 `.dsh-worktrees/`)与本 skill 的分工、桥接命令、锁归属、非登记树安全回收 → F 节 · 完整机制与目录分配 → `docs/环境与部署/并行任务工作树方案.md`
|
||||
|
||||
@@ -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="禁词,可重复")
|
||||
|
||||
Reference in New Issue
Block a user