chore(全仓): @build/@test 旧文档别名清退为技能调用名

现状口径:/keil-build 与 /serial-boot-test 是 DSH 会话的技能调用名,
不是 shell 命令;「名 + 命令行参数」的命令形态改为可执行体
run_boot_test.py 的真实调用。

- AGENTS.md:别名说明重写为「技能调用名不是 shell 命令」,两条目改
  「编译(/keil-build)」「串口回归(/serial-boot-test)」
- keil-build / serial-boot-test 两 skill 调用名与示例同步;task-worktree
  方案文档去掉 @build/@test 惯例从句;@task 保留(不在点名范围)
- 123 文件现状陈述全改;台架捕获、变更记录/时间线、rename 映射输入
  等 41 行历史证据保留旧名
- gen_memory_svg.py 6 处措辞随改,3 张 SVG 产物同批重跑
- 顺手补并行方案同行漏网计数 51→52 钩子

验证:提交期快钩子对 123 文件实跑全 Passed;check_doc_links --all
rc=0(3038 处、无法判定 0);check_mermaid --all rc=0;YAML 解析 52
钩子不变;skill-size rc=0;py_compile 全过;字节卫生零漂移。
This commit is contained in:
2026-10-30 13:03:12 +08:00
parent dc964090ea
commit 4a4ad6bc5f
123 changed files with 455 additions and 455 deletions
@@ -19,7 +19,7 @@
status 全状态(单条 JSON)
log --tail N --grep P 读日志(先过滤后截尾;-i 忽略大小写 / --regex 正则)
clear 清空日志(原子截断 + 代际递增)
wait-idle 等 RX 静默(@test 用;--settle-ms / --max-ms / --first-timeout-ms)
wait-idle 等 RX 静默(/serial-boot-test 用;--settle-ms / --max-ms / --first-timeout-ms)
start / stop / restart daemon 生命周期(其余命令会自动拉起 daemon)
selftest 无头自检(行拆分/解码回退/截头算法,无需硬件)
@@ -615,10 +615,10 @@ class Daemon:
def wait_idle(self, settle_s, max_s, first_timeout_s=None):
"""等 RX 静默,返回 reason ∈ {idle, no_data, timeout}。
2026-10-09 修三处(旧实现会让 @test 在"板子全程没输出"时误判收尾):
2026-10-09 修三处(旧实现会让 /serial-boot-test 在"板子全程没输出"时误判收尾):
1. no_data 判据:旧实现比的是"进入函数时 daemon 累计 rx_bytes 是否为 0"。
daemon 常驻(本机实测 rx_bytes=1.2MB)→ 永远 >0 → 板子一个字节都不发
也返回 idle:true,@test 的 no_data 拦截形同虚设。现按**本次增量**判。
也返回 idle:true,/serial-boot-test 的 no_data 拦截形同虚设。现按**本次增量**判。
2. 首字节门:旧实现从进入即开始计静默时间,板子第一行比 settle_ms 来得
晚就提前收尾("开机日志缺尾巴"的另一半成因)。现首字节到达前不启动
settle 计时,改由 first_timeout_s 兜底(默认 = max_s)。
@@ -1353,7 +1353,7 @@ def build_parser():
sub.add_parser("clear", parents=[common], help="清空日志(代际 +1)")
p = sub.add_parser("wait-idle", parents=[common], help="等 RX 静默(@test 用)")
p = sub.add_parser("wait-idle", parents=[common], help="等 RX 静默(/serial-boot-test 用)")
p.add_argument("--settle-ms", type=int, default=8000,
help="静默判据毫秒(默认 8000:boot 有 3~4s 自然静默间隙)")
p.add_argument("--max-ms", type=int, default=30000, help="最长等待毫秒(默认 30000)")