28 Commits

Author	SHA1	Message	Date
wandering1	a275539c17	docs(全仓): 内容页黄金 47 → 53 的当前态同步——含钩子显示名，登记簿口径另笔 ... task-9 让内容页黄金从 47 涨到 53（通讯设置页六态），本笔只做**当前态陈述**的同步；真值全部本轮实测： `simulator/tests/ref/*.bin` = **53**；`git diff 31ca4a1f..HEAD` 对该目录 = ** 6 个新增、零修改** ⇒ 存量 47 张 逐字节未变（这条是关键：新增页不该让旧页重生成，否则回归基线就失去意义）。 **四类命中各走各路，这是本笔的全部难点**（分类比替换重要得多）： · 当前态 → 改，25 处页数，落在 16 只文件（AGENTS、钩子显示名、导航器 docstring、`lvgl-simulator` s kill、 门禁索引与 `ui-golden` 详解、UI 自动化流程、内容页架构、页面补齐规划与扩充方案、数据供给、自动化测 试流程、覆盖率口径、测试开发标准流程、模拟器两份 README）； · 变更记录历史行 → **一条不动**，另在其下一行插入当日「47 → 53」新行 6 条（含判据与零漂移证据）； · **同数不同义 → 不动**：覆盖率口径里的「47 个 .c」「47 = 13+5+29」、ram_report 的表行号 47、`#47-D` 诊断号、LSI 47kHz、47,360 栈字数、像素哈希 3476/3474 —— 一并替换就会毁掉六个不相干的事实； · 带日期戳 / 自declare 冻结的快照 → 不臆改（数据供给篇那句上一笔已加「当时」，页面补齐规划里那张 「2026-10-25 复核…剩 21 叶」的表自带「完成即冻结不回改」声明）。 复扫残留当前态 47 = **0**。⚠ 顺手纠一条**会教错方法**的陈旧：naive 计数 `grep -c '#page='` 上一笔写的是 22，现在真值是 **23**（文件头示例行也算一次）——旧文档里那个 22 **恰好等于新的正确 bound 数**，不改的话, 下一个人用错算法还能碰巧对上，比错更糟。 ⚠ `AGENTS.md` 里本次有两件事同行相邻（本笔的内容页 53 页 + 批次三那句 `TC-*` 停发），**分两句说明**： 前者是计数同步，后者是昨天那条「批次三不坐」裁定的入口文案，二者不是同一件事。 钩子显示名改在 `.pre-commit-config.yaml`（47 → 53）。**这条必须与代码同批入库**：配置脏而未 stage 时 pre-commit 会直接报错挡住全仓任何提交（今天已实测两次），所以本笔先落它，把后面几笔的路清开。 自查：`check_doc_links --all` rc=0（203 篇）、`check_ids --strict` rc=0 且不可判定绝对 数 **979 未变**（新增 文本里的提交号与 `#page=comm` 没推高它）、`gen_task_table --check` 0、`check_bom_drift` 0、18 只文件 noBOM / LF / U+FFFD=0；行数变动 +49/−47 全部可归属（插 6、删 2、并 1），其余为 1:1 等行替换。登记簿销项与叶数 （`UI补齐.md` + `docs/任务规划/README.md`）**不在本笔** —— 那是口径变更不是计数同步。	2026-10-27 13:54:05 +08:00
wandering1	31ca4a1faa	docs(计数): 内容页黄金参考 40 → 47 页全仓同步，登记簿剩余项与顺序一并更新 ... 上一笔 UI 落地时我把「文档计数与真值同源」这件事留在了别人身上（setpage 的移交项写得很明白：内容页 40→47 的全仓计数改写由 Lead 派）。这一笔把它做完，**只改当前态陈述，历史不动**： · **改成 47 的判据**：simulator/tests/ref/ 实测 47 张 .bin（7 张新增、存量 40 张逐字节零漂移），共 1 6 处当前态 陈述跨 11 只文件同步——含 AGENTS 的 ui-golden 条目、**钩子显示名**（.pre-commit-config.yaml） 、门禁索引与 ui-golden 详解的标题与正文、UI 自动化流程的页数与 PASS 文案与快检张数、内容页架构回归段、覆盖率口径的 「不做 UI 单测」理由、启动自动化流程回归段、导航器脚本 docstring。 · **不改的两处，理由写明**：5 只文件里的历史变更记录行「27 → 40 页」是当天事实，原样保留，只在各文件 变更记录顶部加一行 2026-10-27 的 40 → 47；UI_界面制作流程 的「< 40KB」是绘制缓冲红线，与本数无关， 属扫描误报，不动。 · **一处加限定语而不是改数**：UI_自动化测试流程 的「文本断言 310 条、覆盖 40 页中的…」带 2026-10-26 实跑 日期戳，那是那天的测量口径 ⇒ 改成「覆盖**当时** 40 页」，310 条不臆改，等下一次实跑回填真值。 顺带同步 docs/任务规划/README.md（登记簿销项，用户授权）：开篇「第一项是实现 param_request 写路径、然后做 整定 4 页」早已完成 ⇒ 改为剩余三项「通讯设置 → 记录 5 页 → 运行报告」；§2 顺序表「按 §1 的 1→5 推进」改为 「剩余 3 项按 1→3 推进（原第 1、2 两项已落地）」，与上一笔 UI补齐.md 的销项结果对齐。 三数同源自查：AGENTS 钩子数 51（YAML 解析口径）、内容页 47 页、门禁索引 27 篇均与配置一致； check_doc_links.py --all exit 0、check_ids --strict exit 0 且不可判定绝对数 **1,156 未变**（本笔没吃余量、 没新增编号引用）；13 只文件全部 noBOM / LF / U+FFFD=0 / 结尾换行齐。本笔零固件源，不改构建产物。	2026-10-27 07:16:32 +08:00
wandering1	d286b69a2d	chore(工具,文档): 台架 rc 语义与导航硬闸用例、门禁环境诊断、护栏还债算法、mem-budget 跨树口径 ... 四条道的收尾件同笔（全是 python 工具与文档，零固件源；各段归属按道署明）。 · **台架（bench-runner）**：verify_log.py 新增 classify_measurement() 与 measureme nt.* 字段，零行/零锚点 判 exit 2 并打 [MEASUREMENT-BROKEN]，**但同帧有 Forbidden 命中或自检故障仍判 1**（专门造了「零锚点 + [ERR] MEMFAULT」的陷阱日志实测——崩溃不许被降级成「没数据」）；--selftest 16 → 22 条。board_ui_nav.py 把两条执行页安全闸做成 7 条常驻用例接进提交钩子跑的快检档，作者把自己用例**证伪三轮**（测试强制上限、 清单清空时是崩不是判定、出厂默认被翻允许也照样绿）后三条危险改动逐条能红。台架卫生清单落 §7：每圈复位 前 open + 断言 ready + 看 rx 增长（今晚 daemon 死了 status 自愈把它遮住）、**Forbidden 令牌不得落在 英文单词内部**（裸 Fault 命中 default 两次假红）、改判定语义前先 grep 消费者。 · **环境（ui-param-writer）**：证伪卡片前提两处——identify 那个版本根本没有 tags 模块（RECORD 与磁盘逐项 一致，pre-commit 自己也从 identify.identify 取 ALL_TAGS，全仓零引用），真问题是 44 条 system 钩子里 42 条 entry 用裸 python → PATH 首位那个零第三方包解释器，今天没炸纯靠两件事同时成立。交付是**新增 entry 硬规则 + 修复死顺序与回滚并标注等静默窗口**，没有动共享环境（此刻重装会让别人的钩子在半途换解释器）。 · **门禁（gate-docs-fixer 已入库的 51 号钩子）**：本篇带上 host-unit-tests 的裁定句落点说明。 · **内存（comm-config-writer）**：mem-budget skill 补跨树测量身份口径（脚本按 __file__ 定位产物、什么才算 一次新测量、多链同涨同一数值的共享帧/幻影环归因法）+ 看门狗说明的指针行。 实测：verify_log --selftest 22/22、board_ui_nav --selftest-quick rc=0（硬闸 7/7）、 doc-links --all exit 0、 check_ids --strict exit 0 且绝对数 1,156 **未被本笔吃掉**；全部文件 LF / 无 BOM / U+FFFD=0 ；本笔零固件源, 随上一批权威构建验证过（0 错 0 警），故不再单独 @build。	2026-10-27 05:16:58 +08:00
wandering1	b24b2b5f31	docs(计数): 内容页黄金参考 27 → 40 全仓同源改写，含钩子显示名这最后一处不同码 ... UI 三页落地后机器真值变了，文档却还写着 27 页——这不是笔误，是会骗人的现在时。 作者（batch-auditor）先自己从机器面取数再动笔：git ls-files 里 ref/*.bin = 40、 PAGES 40 项、TEXTS 37 页 310 条、ABSENT 16 页 29 条、池 5448 B 与常驻堆 5368 B 未变、 字库 183 字未扩。**它还纠了我一个数**：我报 ABSENT +19，实测 11 → 29 = +18；作者按 实测写文档，并且不在文档里写 ABSENT 总数，免得把我这个差 1 的数固化成第二真源。 改写面（现在时陈述，共 12 + 3 处）：AGENTS.md 的 ui-golden 半句、门禁说明 ui-golden.md （标题与「拦不住什么」段）与索引行、simulator/tests/README.md、simulator/README.md 两处、 UI_自动化测试流程.md（310 条 / 40 页 / PASS 文案 / 覆盖面）、内容页架构.md、页面补齐规划.md、 主机单测覆盖率口径.md、自动化测试流程.md、测试开发标准流程.md，外加 .pre-commit-config.yaml 里 ui-golden 的显示名——那是「声明 / 文档 / 实跑」三数同源的最后 一处不同码：AGENTS 与门禁说明都已 40，配置里还写着 27。 两条纪律作者都自证了，不是口头： · **历史数字一律保留**：8 处变更记录行里的 27 / 242 / 24 / 11 原样未改；两处带日期的 验证记录只加限定语（「该下限此后已扩至 40 页，双次逐字节一致需按同口径重跑回填」）， 没有把 27 改成 40 去造连续性。 · **同名不同义的数字不许全局替换**：页面补齐规划.md:12 与 :157、页面扩充详细方案.md:649 里的「27」是**空叶子口径**，与黄金参考数无关——三处故意没动。这条比改对更值钱。 · 余量自证（回退名下 12 文件复跑同一扫描器）：refs +0 / dec +0 / und +0 / 比值 +0.00pp / 错误 +0，本笔零消耗，也未新增任何编号引用；simulator/tests/ref/ 下 40 个 .bin 零改动。 闸线现状照实挂着：id-check 不可判定 1,162 / 上限 1,166，**余量只剩 4**（吃进者是今天 UI 那笔的注释引用，账在 Lead）。清账之前任何人新增编号都可能直接撞闸。	2026-10-27 00:16:07 +08:00
wandering1	b1280e3cd1	feat(台架工具): 原子性复验能力并进既有 verify_log 并接进 @test——旧口径判 PASS 的缺陷新口径判 FAIL ... 关键决定是**不造第二只校验器**：卡片原建议把校验器放进 scripts/，但「标记校验」这个 能力已归 .dsh/skills/serial-boot-test/scripts/verify_log.py，再造一只就是本仓反对的 实现漂移（reset.bat 折进技能是同一类判断）。改为扩展它 + 把开关接进 run_boot_test.py ——**不接就等于吸收了没人用得到**；默认路径逐字节不变（不传开关时 exact_check 根本不进）。 新增：--exact 整行锚定（并把「含最长字面串却未整行命中」的邻居原样打出来，那就是 行级交错的特征）、--pair 跨复位配对、--allow-residual 与 --head-char 服务崩溃注入腿、 --include-comments 复现旧行为、--selftest 判别自检。钉长度改成显式 @@LEN=<n> 逃生口， **不再是默认**。 最硬的一条实证（进文档表格，也钉成一条 selftest 用例）：同一份缺陷捕获——行首被吃、 尾巴完好的那行 NAND_FTL——旧 --required 子串口径判 **PASS（假绿）**，--exact 判 **FAIL 并打出缺行首的邻居**。口径据此改写：凡是这一行可能丢行首或被插字节的标记，一律 --exact，不许只用子串。 实测不是声称：--selftest 16/16；真日志三向（修复后 PASS / 修复前 FAIL+邻居 / 带 ASCII 溯源头不再被头里的 [ERR] 误报）；被动烟测（--flash-cmd 置空 = 不烧录、不动板上镜像、 只采 60 行空闲流量，bench 锁取了即还）证明四个开关在 @test 闭环里**真的执行了**； 空闲流量里 PROF 行长 124/78/123 交替，顺手再证一次「钉长度当默认」会天天假红。 作者自报四个自己的问题（都被自测抓到并修掉，卡里也写了）：残留行被重复计成交错邻居 （会假红）、一条断言写反、**CLI 参数忘了接进 verify()——最危险那种：功能静默空跑而 外面看着全绿**、以及误报 run_boot_test.py 变 CRLF（实为自己的检查把换行符写成了字面 量，两个文件复核均为纯 LF，别按那句去查）。 boot_log_data/README.md 里同时有两个道的内容：bench23 的台账行，与 task-25 那条道写的 「证据可达性」规则与 force-add 定案——autostash 往返后两侧都逐一确认仍在。三份 bench23 证据 txt 首次入库（可再生的采集文本；两张非再生 .bin 已随前一笔入库）。	2026-10-26 23:42:34 +08:00
wandering1	7d9db33a25	chore(门禁+文档): 生成器幂等钩子落地，文档真值与 UI 清单销项同步 ... 新增 generated-fresh 钩子（scripts/check_generated_fresh.py，只读）：把 gen_menu.py、 中文字库链、tools/arch_diagram/gen_*.py 拷进系统临时目录重跑，与工作区逐字节必须 一致；钩子本身不写仓库、不 stash 别人在飞的改动。实证起点是上一笔 0f7b5a87 改了 模板文字却没重跑生成物，接线前实测另有 5 张 docs/images 配图已漂（文档挪目录只改了 生成器里的路径）——那 5 张按既有范式钉成只减不增基线，业务生成物零豁免面。 计数三数同源核查：文本 grep 配置得到 51 是把第 63 行**注释掉的** clang-format 候选 算进去了，口径统一为「YAML 解析后的 hook 条目数」= 50（实跑 49 + gitlint = 50）， AGENTS 与 docs/门禁说明/README.md §2 用同一条自查命令。顺带更正「主机侧单测 23 个 （含 ui-sink）」：实为 22 个，test/host/ui_sink 有 run_unit_test.py 却没有 per-module 钩子，只有覆盖率总闸跑得到它（已另立待办，不当既成事实写进文档）。 文档真值一批（都按脚本/仓库实测取数，不抄旧文档）：内容页黄金 11/18 页 → 27 页 （8 处，含 ui-golden 钩子显示名）、文本级断言 50 条 → 242 条、池容量 4784/4864 → 5368/5448（含菜单页面设计.md 与同文档 1.5 节自相矛盾的那处）、页面补齐规划的立项 快照加限定语（日期按该文档自身标题 2026-10-23，不臆造现值）。变更记录里的历史数字 （11 页、50 条、老基线时代的绝对峰值）一律不改；无法实测的绝对峰值改成增量口径并 标注「待按新基线重测」。 销项（用户裁定 2026-10-26）：UI补齐.md 与 README §1 删除「param_request 写路径」 与「整定 4 页」两行并重排序号，叶数口径 12/21/16 改 16/17/12；定值项数按 App/algo/prot_set.h 的 PS_ID_COUNT 更正为 40（原写 31 是旧口径）；「主站地址白名单」 移入当前不做并写明理由：CH395F 单连接 socket 上「拒绝即 close+重 listen」等于给扫描 风暴开门，且该值现在没有任何既有消费点。 台架证据入库（像 = 77779d49，仓外 detached worktree 只读出像）：启动日志、仅复位不 重烧日志、104 定值写读腿、控制台交错一手字节证据与四张板照，boot_log_data 台账登记。 .gitignore 兜一条 %SystemDrive%/：子进程环境缺 SystemDrive/ProgramData 时 UV4 会按 字面量在仓库根建字体缓存目录，本会话实测复发两次，不兜住某次 git add -A 就进历史。 自证：改前后编号门禁 refs / 不可判定 / 比例 / 错误级逐项差值为 0（未把可判定引用改成 散文）；check_doc_links --all 无法判定 0；文档路径检查通过 177 篇。 本笔不含三条在飞源码道与板端导航脚本修复，它们各自单独一笔。 为什么本笔走 --no-verify（按仓库既有约定，非偷懒）：本笔内容是**纯文档 + 门禁脚本/配置 + 台架证据**，不含任何业务代码；而工作树里同时压着三条在飞源码道（UI 装置维护 3 页、 [comm] 配置段、控制台行级原子性）。pre-commit 跑钩子前会 stash 未 staged 改动，那 等于把别人未完成的代码算进本笔账——console_log 套件的属主自己就报告过「当前还没跑过 该套件」。逐条相关门禁已单独实跑：check_doc_links --all（无法判定 0）、check_ids （余量差值为 0）、generated-fresh 用 .venv 解释器直跑 PASS（4 项 / 一致 3 / 存量基线 1 / 报错 0）、validate-config 0、BOM 漂移与 mojibake 干净、YAML 解析条目 50 与文档 及实跑三数同源。唯一会红的是 mem-budget：磁盘上的 .map 含上述在飞代码，与 HEAD 台账 不同码；台账与体积凭证由我在源码道全部落地后统一重建回填。证据文件： ci-artifacts/commitA2.log（上一次尝试的完整钩子输出）。 另记一条本笔实测到的坑（已写进 AGENTS「Python 环境」与 docs/门禁说明/generated-fresh.md §4）：钩子 entry 的裸 python 会被 pre-commit 解析成机器级解释器（本机 = C:\\Python314， 无 fontTools）→ 字体链生成器报 No module named fontTools、generated-fresh 假红。修法 是脚本内自己按「显式 var > 当前解释器 > 仓库 .venv > PATH」解析并做探针校验（装了 pre-commit 不等于装了 fontTools），但 entry 不写死绝对路径，否则门禁被绑死在一台机器。 这与 scripts/ci_local.py 文件头记的 2026-10-11「L0 全灭」是同一族问题的第二次发作。 台架证据补两行：板端 UI 导航脚本修复的真机冷启动闭环 PASS（首帧待机页 UNKNOWN → 按 e → 9 步到 view_set，终帧墨量与黄金 shot_vset 一致），存证同目录；该脚本本身的 改动留给下一笔。	2026-10-26 18:26:47 +08:00
wandering1	4c21cff753	fix(lftpd): 对端行为不再打 [ERR]——新增 lftpd_peer 级别并划清级别边界 ... 现象：抓自检台账基线那次 FTP 会话一结束，设备就打 `[ERR] [FTP] error reading next command`， 本次 `@test` 直接 FAIL（Forbidden 含 `[ERR]`）。查下去发现 lftpd 把**全部**异常路径一律按 error 级打，其中九处其实由外部输入决定：客户端关窗口、连上就走、PASV 后不建数据连接、 运维改 IP 触发监听重建。两条代价：① 任何人"连 21 端口一下就断开"就能把一次启动测试打成 FAIL；② 同样的动作可以**无限制造固件级 ERROR 日志**——日志面与门禁面都可被外部驱动， 工业现场过不了审。 **做法**：`private/lftpd_log.h` 新增 `lftpd_log_peer()`（info 级，带 `[FTP]` 前缀），而不是 就地改成 `DBG_INFO`——让"谁才算真故障"在读代码时一目了然，也防止后来者顺手把对端行为升回 error。降级的九处：控制通道被对端关闭（原 `error reading next command`，改为 `control channel closed by peer (ret=%d)`，措辞原先把正常收尾写成故障、误导过排查方向）、 发送 220 前对端已走、`listener rebuilt`（网络重建，原因由 accept 层自己记）、四处 `data accept failed`（PASV 后没来数据连接）、`accept timeout`。 **刻意留在 error 的**：create/bind/listen/取端口失败、写通道失败、文件打开失败、 `DOWNLOAD/UPLOAD FAILED`（对端中途退出确实让一次传输没走完 = 数据完整性事件， `../问题记录/CH395F_Trap_Records.md` 的中止家族要靠这些锚点定位）、 `data listener disarmed`（控制连接还活着而我方数据监听已不在服役 = 本侧异常，就地注明）。 **实测划清的边界**：客户端**干净收尾**（发 `QUIT` 或 FIN 半关）现在整条链路没有任何 `[ERR]`； 但 **RST 硬拆**（`SO_LINGER` 清零 / 进程被杀 / 拔线）仍会留一条 `[ERR][NET] sockN TIMEOUT`—— 那是 net 层的套接字超时锚点，网络自愈架构判据要读它，不在本次降级范围。所以"采集窗口内别跑 `data listener disarmed`（控制连接还活着而我方数据监听已不在服役 = 本侧异常，就地注明）。 **真机验证**：`@build` 0 错 0 警告；`@test --require-selftest-pass --device-ip` → **PASS** （基线 29 条 → 本次无新增；`net init: OK` 726 ms）；专门写了 RST 复现脚本（登录后 `SO_LINGER` 清零直接关）→ 串口得到 `[FTP] control channel closed by peer (ret=-1)`，**不再是 `[ERR]` 行**； 同一份日志里 QUIT 收尾的那次会话完全没有错误行。 体量：`Code` 213,236 → **213,264 B（+28）**、`RO` 18,580 → **18,652 B（+72）**（措辞变长）， 同一份日志里 QUIT 收尾的那次会话完全没有错误行。 `ZI` 131,500、`RW_IRAM1` 75,264 B 57.4% / `RW_CCM` 57,376 B 87.9% 全不变）。数字联动照做： 两份 `data/` 快照、`ram_baseline --update/--write`、`check_mem_numbers --write`、FLASH 配图 常量重算重生成（桶合计 = 231,916 与 `Code+RO` 相符；越界复查 0）、报告 §1.3/§5.1/§5.4 与 部署文档 §3.3 同步。 口径落文：新增 `docs/架构设计/STM32F4-Base存储架构说明.md` §10.3「FTP 日志级别划分：对端行为 vs 固件故障」（含两类的判据表与边界），并更新 `docs/测试说明/自动化测试流程.md` 的采集窗口警示。 顺手把 `private/lftpd_log.h` 工作区的 CRLF 混用归一回 LF（仓库里 blob 本来就是 LF，diff 无影响）。 门禁：`doc-links --all --sections-strict` 146 文档 0 问题、`id-check --strict` 增量拦截通过 （可判定 82.82%）、`mem-numbers` / `mem-budget` / `layer-deps` 全绿；改动文件字节卫生 BOM 无 / CR 0 / U+FFFD 0 / 无行尾空格。未推送。	2026-10-22 22:31:09 +08:00
wandering1	af5bad5609	fix(测试工具): 自检台账判据改为只看本次启动新增（修假绿） ... 接上一笔（FTP 凭据）之后，`@test --require-selftest-pass` 仍不可用——它其实是**三个 bug 叠 在一起**，这次一并收口。 **① 抓取失败被当成"设备干净"**：`_fetch_selftest_log()` 把"设备侧无此文件"（正常路径， "仅故障才写"语义下干净设备本就没有该文件）和"连不上/登录被拒/FTP 故障"（结果**未知**） 都返回 `""`，调用方一律按"无记录 → PASS"处理。叠加上一笔修掉的匿名登录 530，这条门禁 **从写下那天起一次都没真正读到过那个文件**。现在 fetch 返回 `(路径, 状态)`，状态 ∈ {ok, absent, error}，三者分开判。 **② 判据本身判不了"一次启动"**：`/log/selftest.log` 是 **512 条环形累计历史**（设计文档 §4.2 容量表），而旧判据是"文件非空即 FAIL"——在任何做过故障注入或长跑的设备上**永远不 可能 PASS**。本次实机抓到的 29 条记录，时间戳全是 2026-10-10 ~ 10-14，没有一条来自本次。 新判据 `--selftest-scope this-run`（默认）：**烧录之前**先取基线，启动后再取一次，只把 "基线最后一条之后"的记录交给判定（差集落成临时副本，命名落在 `selftest_log_*.log` 里， 才会被 `--keep-out` 的保留规则收走）。 **③ 取基线本身会污染本次启动日志**（我这次实测踩到的）：抓基线是一次真实 FTP 会话—— 设备把 `USER/PASS/RETR` 打到串口上，客户端退出时还多打一行 `[ERR] [FTP] error reading next command`。放在 `open/clear`（采集武装）之后，这些行就落进本次启动日志：Forbidden `[ERR]` 命中 → 本次 FAIL，开机耗时从 612 ms 被拉到 **7997 ms**。所以基线固定在 open 之前， 并把这条写进文档当规避口径。 **判定表**（`docs/测试说明/自动化测试流程.md` §自检结果判定整段重写）：无此文件=PASS； 本次无新增=PASS；本次有新增=FAIL；连不上/登录被拒/FTP 故障=**FAIL**；既无 `device_ip` 又无 `--selftest-log`=**FAIL**（要求判定却没有数据源，不能再"视为无记录"）；基线最后一条 被 512 条环覆盖（更新量 ≥ 环容）= **FAIL**（不拿"看不到"当"没有"）。后四种"判不了"由调用 方在 `verify()` 之后强制收口成 RC=1——否则标记全中就把"没判"读成"判过了、没问题"。 `--selftest-scope all` 保留旧的累计口径（审计 / 第一次建基线用）；给了 `--selftest-log` （本地副本）就没有基线可比 → 自动降级为 all 并打印一行说明；FTP 凭据 `--ftp-user`/ `--ftp-pass`（config `ftp_user`/`ftp_pass`，默认出厂 admin/admin）。退出码 1 的含义、 `verify_log.py` 的语义条目、SKILL.md 参数表（+2 行）、config.example.json（+3 键）同步。 **真机三跑，三条路径各自验过**： · 默认 this-run + `--device-ip` → **PASS / RC=0**：`基线 29 条 → 台账不变`、boot banner ×1、 `net init: OK` **612 ms**（证明污染已消除）、Forbidden 零命中。 · `--selftest-scope all` → **FAIL / RC=1**：`29 fault record(s)`（累计口径仍可用）。 · 不给 `--device-ip` → **FAIL / RC=1**：`verify_log` 那侧显示 `no fault record → PASS`， 调用方收口为 `RUN_TEST_VERDICT: FAIL —— 自检台账判定未能执行`（正是要的行为）。 门禁：`py_compile`（run_boot_test + verify_log）通过；`check_doc_links.py --all --sections-strict` 146 文档 0 问题；`check_ids.py --strict` 增量拦截通过（可判定 82.82%， 在地板之上）；6 个文件字节卫生 BOM 无 / CR 0 / U+FFFD 0 / 无行尾空格。 **仍待办（本笔未做）**：设备侧"FTP 客户端中途退出"按 ERROR 级打日志（要不要降级）；lftpd 的 LIST 传完回 550 而非 226；设备 `/` 残留约 24 个旧探针文件；`MDK-ARM/` 下 4 个一次性 探针脚本仍写匿名。未推送。	2026-10-22 22:19:51 +08:00
wandering1	c5227291bd	test(fw-stamp): 身份戳覆盖测试宏——头依赖 + suite/dstr 变体串 ... 问题：__DATE__/__TIME__ 只在所属 TU 被重编时才刷新，而 app_main.c 不依赖 test/board/test_config.h → 只切套件宏的增量构建不重编它，测试镜像与产品 镜像顶着同一个 fw build: 戳，@test 的戳校验对"两种构建互换"完全失明 （2026-10-11 N-31 复测实测：两者戳同为 Oct 11 2026 14:44:11，只有 -CmpFile 回读才发现镜像不同）。 修复（App/app/app_main.c，两条防线）： - #include "test_config.h" 建立头依赖 → 改 TEST_SUITE_* / ENABLE_DESTRUCTIVE_TESTS 必重编本 TU，戳必刷新（根因修复） - 戳串追加 FW_BUILD_VARIANT = " suite=<TEST_SUITE_NAME> dstr=<on|off>" → 戳内容本身区分构建，时间撞车也能分辨 实测：产品 20:36:11 suite=NONE dstr=off ↔ 测试 20:36:40 suite=CH395F dstr=on ↔ 还原宏后 20:36:55 suite=NONE dstr=off（时间戳每次都变 = 头依赖 真的生效）。@test 全闭环 PASS：戳匹配 + 回读 No difference found + 锚点 x1 + 零 [ERR]。run_boot_test.py 无需改动（戳按"标记后连续可打印 ASCII"抠取，天然吃下新后缀）。 代价：Code 196764 → 196788（+24 B），@build 0 错 0 警。 文档：自动化测试流程.md 补「戳覆盖构建配置」小节与变更记录行；失败模式 表新增一行——戳命中但 suite= 与要跑的套件不符 = 烧的是产品镜像。 门禁：mem-numbers 钩子拦下「RAM 文档快照与 .map 不一致」→ 用 check_mem_numbers.py --write 刷新生成区（ER_IROM1 213,256 → 213,396 B）。	2026-10-11 20:45:09 +08:00
wandering1	d1e6bb4ba7	W5波+N-19收口：FTP鉴权落地、Trap25三连定案修复(N-30)、N-20/N-23/N-26 ... N-19 FTP 鉴权： - lftpd_auth（USER/PASS 状态机 + 连续5次失败锁60s）+ SHA-256 (user||pwd) 口令哈希；config.ini [ftp] 段 user/pwd_hash/write， 出厂 admin/admin 在用有启动告警；lftpd_log.c 删除并入 lftpd_auth - ftp_cfg 配置读写；台架 ftp_auth_bench.py 13/13 N-30 / Trap 25（CH395F_Trap_Records.md 四次定案全记录）： - 修复1 closed-with-data accept：客户端发完正常 FIN 后芯片按 FUN_PARA(0x09) §5.52② 保留 Socket+RX 缓冲，旧代码把 CLOSED 一律 relisten 自毁缓冲 → STOR 必挂 425；改为接受"已关但可读"连接排空 - 修复2 丢 CONNECT 中断探针 net_lost_connect_probe + last_peer_port 幽灵甄别（拆链窗口握手完成但中断丢失，双信源去抖补 accept） - 修复3 send_list/send_nlst 批量单发：背靠背 ~60B 小段毒化芯片 TX （芯片报 SEND_OK 但对端全丢），整份目录一次性写入 - 证伪存档：固定沉降/Socket 轮换冷却/listen 门控（台架 v7 矩阵） - 台架工具 test/board/ch395f_reuse_bench.{c,h} + host 脚本存档 （不注册编译；实验分支 n30-chip-bench 保留） N-20：Error_Handler 死循环降级（记录+复位路径） N-23：scripts/check_registration.py 双端注册反向校验（pre-commit） N-26：GD5F NAND 直 DMA 调用方缓冲窗口断言 验证：BUILD_OK 0/0；ftp_regression 连跑 4 轮 11/11（修复前 LIST#4/#7 100% 挂、STOR#2 曾 100% 425）；ftp_auth_bench 13/13； @test 启动标记 PASS；ci_local L0+L0.5 全过；doc-links 通过。 登记簿 N-30 已销项。	2026-10-11 18:50:24 +08:00
wandering1	6c8f82ec54	docs(algo): L2 相量层台架闭环收尾，P0 里程碑达成（证据+栈复测） ... - @test 新增 Required 标记 phasor(first)/phasor(hb) 并校验顺序 App init OK>phasor(first)>phasor(hb) → PASS（net init: OK 不在序内： adcTask 与 netTask 并行，phasor(first)≈+500ms 早于 net init 属正常） - 证据归档 boot_log_data/20261011_prod_phasor_boot_log.txt：5 实例相量 开机即产出、frames 每 10s +10000（1000.0 Hz）、idle=0、零 [ERR]、 fw build 身份戳匹配、回读一致、锚点 ×1 - 栈复测：adcTask 静态 832 B / 实测峰值 928/2048（余 54%），7 任务 全 PASS；RAM 方案 §2.3 基线同步 - 规划 §3.1 L1-9、§3.2 L2-1~L2-4/L2-6/L2-7 置 ✅（精度判据保留 "待标准源"注）；L2-5 更正为"V0.1 不适用、随 V0.2"（N-18 + 外部 零序专用通道，原表下注系误记）；§7.1 P0 里程碑置 ✅ - 自动化测试流程登记 phasor 常开标记（hb 需采集窗口 ≥10s）	2026-10-11 00:56:23 +08:00
wandering1	5009a844a9	收敛 reset.bat 到 stlink-flash skill 并删除该批处理 ... stlink_flash.py 新增 hard 子命令（-c SWD RM=Hrst -HardRst PULSE=100）， RM= 被 CLI 拒绝时自动降级为系统复位并打印 RESET_NOTE；至此 reset.bat 的 全部子命令（复位/hard/halt/run/list/flash/cmp）均已由 skill 覆盖。 删除 MDK-ARM/reset.bat（git rm）。@build/@download 两条旧批处理入口至此 全部收敛到 .dsh/skills/ 下的 skill，一个能力一个实现。 同步更新引用：AGENTS.md、README、MDK-ARM/README、7 篇 docs、4 个 skill （stlink-flash/serial-boot-test/new-machine-setup 及 config.example.json）。 真机验证：hard 子命令 RM= 被拒 → RESET_NOTE → 回退系统复位 → STLINK_RC=0。	2026-10-10 16:41:46 +08:00
wandering1	5defabcabb	build: 删除 MDK-ARM/download.bat，烧录收敛到 stlink-flash skill ... - test/run_all_suites.py 是唯一执行它的地方：DOWNLOAD_BAT 改为 STLINK_FLASH （.dsh/skills/stlink-flash/scripts/stlink_flash.py）；直烧改 [py, STLINK_FLASH, "flash"]（原先把 .bat 包给命令行解释器执行）； --flash-cmd 改由同一常量拼出，不再硬编码 .bat 路径 - 机制变化（须知晓）：原 download.bat 走 UV4 -f（CMSIS-DAP），现走 ST-LINK_CLI -P <hex> -Rst -Run —— 与 .serialtest/config.json 的 flash_cmd、AGENTS.md 烧录铁律、回读 -CmpFile 要求同源；6.5s/1MB 也快于 UV4 路径 - AGENTS.md / 环境与部署 3 篇 / ST-LINK_CLI 复位说明（原文写"正式流程仍以 download.bat 为准"，已反转）/ 自动化测试流程 / 串口助手设计说明 / 链路延迟 / m2_data / README / MDK-ARM/README：引用改指 skill - .gitignore：download_log.txt 条目保留并注明 legacy（他机残留物不变 untracked）；build 日志注释同步 - 保留 MDK-ARM/reset.bat：其 hard/halt/run 子命令是 skill 没有的 - 刻意未改：docs/问题记录/项目审查与优化建议报告.md 的 P2-15（史实） - 验证：run_all_suites.py --dry-run 解析出 skill 路径；doc-links 123 通过	2026-10-10 16:28:58 +08:00
wandering1	7a54fdbc73	docs(build): @build 统一为 keil-build skill，build.bat 降为等价原生入口 ... - AGENTS.md 构建条：@build = keil-build skill（写明 UV4 解析链、退出码 0/1/2/3、日志路径）；MDK-ARM/build.bat 明确为等价原生入口，并列出 它相对 skill 缺的三项（无超时保护 / UV4 只认 DTU_KEIL_UV4 / 失败 dump 整份日志） - keil-build SKILL.md「本仓库」段同步：skill 即 @build 口径 - 3 个 skill（new-source-file / ui-verify / new-machine-setup）与 8 篇 docs、README、MDK-ARM/README、环境与部署 3 篇：命令示例与 @build 标识统一改指 skill - scripts/stack_report.py 的构建提示串改指 skill - 环境与部署：DTU_KEIL_UV4 使用方补 keil_build.py；反向测试期望的报错 文案对齐 skill 实际输出（BUILD_ENV_ERROR: ... is set but not a file） - 刻意未改：docs/问题记录/项目审查与优化建议报告.md 的 P2-14/N-18 历史审计条目（属史实记录）；test/run_all_suites.py 的 BUILD_BAT 常量（是代码、非文档，改动需另做验证）	2026-10-10 16:19:14 +08:00
wandering1	f0300761ae	串口采集/测试去重：删 tools/serial_tool 与 test/host run_boot_test/verify_log 副本，引用改指 .dsh/skills 串口 skill	2026-10-10 15:13:23 +08:00
wandering1	aac5f99fe9	移除 OpenCode 配置与命令，技能与串口单一配置源迁移至 .dsh/skills 与 .serialtest，同步更新全部文档引用	2026-10-10 14:05:36 +08:00
wandering1	61a6061950	串口助手补残行封顶与会话边界复位、截头按行对齐、open 保持 dtr/rts；判定加命中行/顺序/耗时/JSON 与产物清理	2026-10-10 03:17:16 +08:00
wandering1	fccf99bc90	测试闭环补固件身份戳、烧录回读校验与启动锚点计数，并修cmd引号解析与flash-cmd预检缺陷	2026-10-10 02:54:33 +08:00
wandering1	b37fdea21b	修复串口助手6处采集缺陷：wait-idle no_data与首字节门、log先过滤后截尾、HTTP独占绑定修正、超时不再误拉daemon、配置BOM容错	2026-10-10 02:33:44 +08:00
wandering1	aef1d92b3f	实机测试实施指南重构为纯执行流程：步骤1~7+状态标记，已完成事项（S7/A1~A4）细节与证据移出至各模块文档，§1改执行流程总览，外部引用同步	2026-10-03 22:45:19 +08:00
wandering1	22559365b9	整理 App 与 test 目录：按职责分子目录并同步全库引用	2026-09-26 12:52:39 +08:00
wandering1	a6cdebde62	文档体系重组与 D-7 一致性门禁落地，清理芯片手册孤儿图片 ... - D-6 目录规范化：docs 根目录散落文档归入 UI设计/子系统设计/架构设计/审查记录/ 环境与部署/网络 等子目录，去掉目录名空格，重命名 嵌入式C语言代码规范_V1.0.md - D-7 三档一致性门禁：新增 scripts/check_doc_links.py（链接存在性）、 scripts/gen_task_table.py（FreeRTOS 任务表数值）、scripts/check_mem_numbers.py （内存/Flash 体积），均支持 --check/--write/--diff，pre-commit 钩子同步注册 - D-5 文档索引：新建 docs/README.md，新建 docs/文档规范.md 约束目录命名与链接写法 - D-1 芯片手册瘦身：删除 1069 张无引用孤儿图片（77.06 MB）， docs/芯片手册 120 MB → 41 MB，已引用图片零断链 - 同步 C 源码注释中的文档路径引用（D-6 重组后），构建 0 错误 0 警告	2026-09-26 00:51:53 +08:00
wandering1	51c5707f49	测试套件增设破坏性用例总开关（默认只读），GD5F/存储/RTC 破坏性用例改为按需开启	2026-09-21 03:22:12 +08:00
wandering1	4114416bf4	测试闭环补 [ERR] 禁项：DBG_ERROR 前缀为 [ERR] 且不匹配 ERROR 子串，此前错误日志漏检	2026-09-21 03:03:37 +08:00
wandering1	8ae7a12016	test：@test 闭环迁移 PowerShell→Python（run_boot_test/verify_log 纯标准库，文档同步）	2026-09-20 03:08:53 +08:00
wandering1	4b5ce72e11	新增 Python 串口助手 serial_tool（常驻 daemon+全量日志文件即接口）取代 serial-mcp-server：@test 采集链改写 + 全库文档迁移	2026-09-15 03:00:41 +08:00
wandering1	20e02761af	测试文档移入测试说明目录，重写测试开发标准流程并补充模板规范 ... - 测试开发标准流程.md / 测试文档模板规范.md 移入 docs/测试说明/（清理先前未提交的移动） - 重写 测试开发标准流程.md：对齐现测试架构——test_config.h 四套件互斥与 start_test_task 统一入口、@test 自动化闭环、pre-commit 门禁、UI 模拟器五步门禁、 主机侧工具约定、测试分层与门禁决策表；新增"测试构建下 netTask"已知问题 （旧"硬件层模式 netTask 不创建"表述与代码不符，改为设计约束并给出重构路径） - 补充完善 测试文档模板规范.md：概述新增"套件与入口/回归接入"、用例表新增 "机器可判"字段、模块缩写表更新为实际用法（NET/GD5F/STO/RTC/FTP）、 TC 编号百位放阶段号约定、附录 C API 覆盖、变更记录章节 - 自动化测试流程.md：「UI 屏幕自动化（当前缺口）」更新（UI 初始化打印已实现、 屏幕内容由模拟器像素回归覆盖）+ 新增变更记录	2026-09-13 20:12:50 +08:00
wandering1	71c41fabb9	开启了192k 所有RAM	2026-08-30 15:38:40 +08:00