wandering1
16be01915d
chore(docs): 补齐文件末尾换行（end-of-file-fixer 实测 18 篇）
...
CI / 静态门禁 (pre-commit) (push) Failing after 46s
CI / 主机侧单测 (MSVC) (push) Failing after 43s
提交后台跑 scripts/ci_local.py 时 end-of-file-fixer 报 Failed 并就地修复：
17 篇补文件末尾换行、1 篇去掉行尾空行。
内容零变化：git diff --ignore-all-space 只有 1 处空行删除；18 篇均在
上一笔流水清理里被改过，恢复补丁时把上一轮的 EOF 修复冲掉了，这一
笔补回。
2026-10-28 22:12:59 +08:00
wandering1
511fd30cc6
docs: 清理全仓变更记录流水（43 篇整节删 / 23 篇留一行 / 5 篇保留）
...
用户裁定：文档只写现状，历史流水一律删掉，过程查 git log。
- 43 篇「变更记录 / 修订记录」整节删除：继电保护规划 12.6 KB、产品
需求 11.8 KB、项目部署环境 5.5 KB、BSD Socket 指南 5.3 KB、架构
总览 5.0 KB、实机测试实施指南 3.8 KB 等
- 23 篇别处仍有指向：只留节名 + 一行「本文件不再记流水账，过程查
git log」，节号与锚点不位移（doc-links 不因此断链）
- 5 篇整表保留（被当唯一证据 / 活台账引用）：看门狗设计说明、配置
文件设计说明、RAM预算台账、内容页架构、本地工具路径环境变量方案
- 规范同步：文档规范 §5.1 改新裁定；测试文档模板规范删示例节与
登记句；测试开发标准流程 / UI 两篇 / 实机测试实施指南 / 四篇单测
说明 / 并行任务工作树方案 / 编号规范 的「登记变更记录」改「写进
正文」
- 技能同步：stale-doc-count-sweep / ui-verify / id-family 三个 SKILL
正文不再要求追加流水行（顺带消掉 SKILL.md:121「产品需求 §12」
失效引用）
- 修 5 处悬空指针：采样有效性校验目录锚点、BSD 指南「文末变更
记录」、docs/README 过期描述、网络自愈架构两处指向面
72 篇文档净减 600 余行；check_doc_links --all --sections-strict 可判
定比例 61% → 78%、失效引用 0；静态门禁 passed=50 failed=0；gitlint
10 条历史提交信息 0 failed。
未提交他人在飞改动：.dsh/skills/keil-build/*（%SystemDrive% 守卫）。
2026-10-28 22:00:34 +08:00
wandering1
f50e74c63b
docs+log: 撤销"PA10 未接线"结论，ORE 机理改为"RX 使能却不读 DR"
...
用户反馈：PA10 这个端口是接线的，当年那个分析应该是错的。
核查确认：console_log.c（文件头与 con_uart_reinit() 注释）和
控制台单写者日志设计说明.md 12 节里的"PA10 悬空 / 未接线"是 2026-10-02 的
归因推断，不是实测，且与用户确认的接线状态相反。
ORE 的充分条件本来就不依赖引脚悬空：RX 使能了却从不读 DR，
线上任意一个字节或一个噪声沿使 RXNE 置位后无人读，下一个事件即锁存 ORE
（常伴 NE/FE/PE）；而 ORE 只能靠"先读 SR 再读 DR"清除，所以永不自愈。
引脚悬空只影响发生率，不是必要条件。
当年那场风暴的真因仍待定：接线正常时更常见的是对端波特率不匹配
（适配器不是 115200）或适配器 TX 在 USB 掉线时浮空。下次复现先量
适配器 TX 的空闲电平与波特率，不要再默认"引脚悬空"。
改动：
- console_log.c：函数注释改按正确机理表述；修改记录加 2026-10-28 一条
说明归因更正。纯注释，Code 236456 B 与上版一致，@build 0/0。
- 控制台单写者日志设计说明.md 12 节：机理段后加更正块，写明观察与缓解
措施仍成立、只有归因需要改写。
- 产品需求文档：4.2 表 USART1 行改为"PA10 双向均已接线"；5.16.2 的
"PA10 没接线"警示块整段重写为"旧结论已撤销 + 真正机理 + 两条硬要求"
（屏板链路必须消费 DR 并在错误回调清 ORE；新日志口仍设 UART_MODE_TX）；
9.13 前置阻塞由"两条物理前置"改为"一条物理前置 + 一条实现纪律"；
12 节加 v1.9。
- 屏板链路规划：0 章第 2 行标为已撤销、执行顺序去掉"接 PA10"；
批 0 由 4 项减为 3 项；批 1 第 3 项判据补"拔插 TX 线制造噪声后能自动
恢复"；风险表把"PA10 没接"换成"一次噪声后链路永久静默"。
- 任务规划 README 独立轨道行同步为两条前置。
体积凭证随索引刷新（scripts/size_attestation.json），数字未变。
2026-10-28 10:41:32 +08:00
wandering1
b1494eb10c
feat(固件): 标定值语义 setter + 卷锁 fail-open 自检留痕 + 控制台编号写法整理
...
三批同笔的理由：它们是同一份权威构建（Linker run 04:5x，Code=233,900 / RW=1,536）里的内容，中间态从未
单独编译过，拆开提任何一段都没有对应的构建凭证。按道分述如下。
**① 算法层（ui-maint）：写值与置脏成对，不留可单独调用的置脏口**。新增 run_par_cal_k_set() /
run_par_cal_b_set()，被拒时副本不动也不置脏（= 不承诺持久化）；104 的 run_par_104_write() k/b 两支
同批改调 setter，函数内自己碰 s_dirty 的两处删净——**消除两份置脏逻辑才是本段的目的**。刻意**没有**新增
公开 run_par_mark_dirty()：作者的理由我采纳并原文保留——「一旦存在就一定有人只调它」，与今天删掉的零消费
者接口是同一失效机理。另新增合法域唯一出口 run_par_db_range()、粗守上限 RUN_PAR_K_MAX_UV、毫→工程换算
单点 s_milli_to_eng()，并改正了头文件里「除以 1000 唯一在此」那条在加 db_range 后会变假陈述的说法。
**顺带满足 task-43 第①项**：adc_cal 落盘口的缺口由本段 setter 解决（写值必置脏），task-43 剩余项 = 可诊断
性与文档。
**② 日志层（log-maint）：卷锁 fail-open 的 defaultTask 侧边沿留痕**。syslog_drain() 尾部紧跟既有
s_quiet_
drop 差值块之后读 vol_lock_get_stats()，水位新增才算一个 episode、每上电一条，投 SYSLOG_SELFTEST，文本
vollock failopen=%lu。三条硬约束都落了且**有牙**：失败调用点零改动（wdev.log 自己也要这把非递归卷锁）；
不打错级、**不打 [ERR]**（断言里 g_sys_err_count == 0 就是机器判据，把「改成 DBG_ERROR」注入后四条用例
全红）；锁层只自增、唯一写者消费。作者一度按我的要求准备造 obs_first_ms/obs_last_ms 字段，我撤了那条
要求——记录自带 ts 就是被观测时刻，**再造一个时间戳字段等于造第二个「看起来像发生时刻」的东西**。
成本 .bss +48 B、**零栈增量**（缓冲全静态），已由本笔权威构建的 after 表证实：9 条链全 PASS，
iec104Task 1,464 / margin 1,096、defaultTask 3,040 与提交态逐项一致。
**③ 控制台与中断（log-maint，纯注释/文档）**：b623a406 之后的编号写法整理，把裸形态号改为可校验形式，
零代码行为改动。
实测：@build 0 错误 0 警告；run_par 67/67、sys_log_mcu 141/141、console_log 套件零回归
覆盖率只增不减
（sys_log_mcu.c 410/413 = 99.3%、函数 22/22）；cppcheck / coding-standard /
doc-links / bom / mojibake /
nested-comment 全 0；编号五项式错误差值 0、不可判定绝对数 **1,156**（上限 1,166 未动，本笔没吃余量）。
台账随本笔回填：ram_baseline --write 与 mem-numbers --write 同批（RW_IRAM1 80,920 B 61.7%
/
RW_CCM 57,376 B 87.9% / ER_IROM1 260,004 B 24.8%）。
2026-10-27 05:10:11 +08:00
wandering1
b623a406ad
fix(栈·存储·UI 收尾): 断掉临界区↔断言幻影环回到 1,464，标定门控单点化，卷锁五态可观测
...
这四笔在主树里已经互相纠缠（同一次 @build 编译、同一份 .htm 度量），拆成四笔就不
存在任何一个被真编过的中间态，所以合一笔入库；下面按模块分段陈述，作者与出证归属
逐段写明。
—— 一、崩溃证据路径的整行独占收尾（log-maint-writer，task-26）——
上午那笔 1d4b6a17
2026-10-26 23:31:05 +08:00
wandering1
1d4b6a17ce
fix(控制台): 未注册期裸发加"整行独占"，让路整行入环不丢，修掉 O1 第二实例
...
台架一手证据（boot_log_data/20261026_prod_console_interleave_evidence.txt）：两次
「仅复位不重烧」启动里，[PROT] 未标定 INFO 行内分别多出 3 个和 1 个字节，而紧邻其后
的 [NAND_FTL] 行正好缺自己行首同样数量的字节（"[20" 与 "["）——串口 framing 错不会
让行变长，字节按原序出现在邻居里 ⇒ 两个写者并发逐字节写 USART1->DR。写者对：
protectTask 的未标定闭锁边沿 × defaultTask 的 storage_bring_up()，两者都落在
dbg_console_writer_attach() 之前（attach 排在存储 bring-up 之后），该窗口
s_con_writer_up == 0 ⇒ 任何任务的整行都走零互斥裸发。这是控制台单写者设计说明在册
O1 的**第二个实例**；2026-10-12 那次只补了"自愿门控"，而自愿门控挡不住业务边沿留痕
（业务无法预知某条边沿落在哪个窗口），所以这次被同一窗口第二次咬到。
修法是**非阻塞整行独占**：con_tx_try_claim/release 只在几条指令的临界区里
test-and-set，绝不把 7.8 ms 的逐字节发送包进关中断区、绝不等待；IPSR 上下文与调度
器未启动两种情况显式放行（崩溃遗言必须能出去；早期本就单执行流，一条不丢）；同任务
按深度嵌套。抢不到独占的那条行**原文入环**延后发——前缀与时间戳在 DBG_* 调用点就
格式化进调用方缓冲，本模块与 drain 都不补前缀、不重打时间戳，所以延后发出的行与当场
直发逐字节相同；[ERR] 只在「抢不到独占且环也放不下」时才红，按 3 次启动命中 2 次的
频率，让路若计 [ERR] 就会把静默缺陷换成常红门禁。顺带堵掉第二处洞：drain 每轮先取
凭证，拿不到就让位且 tail 不推进（旧写法 attach 可以撞上别人已发出的半行）。
新导出 dbg_console_tx_begin()/tx_end() 供 task-26 收口故障钩子的多段裸发。
否决过的两条路写进文档 §4.4.1：提前 attach 会把等串口塞进 mount/mkfs 时序敏感段
或让生产者在整个 bring-up 里堵在满环上；整段进环会让「无看门狗窗口」死机时一个字都
不出（2026-10-02 那几轮正是靠 bring-up 期流式日志取证的）。
判据：test/host/console_log 127 → 152 全绿（M 族 TC-CONLOG-170..179 共 +25，既有
127 条零删除）。唯一换钉法的是 TC-CONLOG-015——旧断言钉的正是缺陷机理本身（裸发 0
次临界区 = 零互斥），现改钉「恰 2 次几条指令的临界区 + 每个上线字节都在临界区之外 +
零等待」；硬红线由假 USART 在每个上线字节处记录临界区深度水位恒 0 来机器守住。四处
注入反证各自转红 11 / 5 / 1 / 3 条并逐字节还原复跑；覆盖率 console_log.c 199/200 行
→ 256/257 行、16/16 → 21/21 函数。邻域复跑：task_prof 27/27、sys_log_mcu 137/137、
iec104_serv 37/37。CONLOG 游标抬到 179。
台架复验判据（**本笔尚未上机**，下一轮请台架跑）：连续 3~5 次「仅复位不重烧」启动
日志 [ERR] 零命中，且 [PROT] 未标定与 [NAND_FTL] Initializing 两行都完整。
成本：.bss +5 B、Flash 估 +100~150 B，零新增 DBG_* / 零新增缓冲 / 零堆 / 零内核对象。
文档：控制台单写者日志设计说明.md 升 v1.6（O1 改「已处置」含两实例与字节账、新增
§4.4.1、§3.4 并发区间、§4.4 取消「不加锁」口径、§7 失效表、§11 变更记录、API 表）。
2026-10-26 19:34:29 +08:00
wandering1
0f7b5a87fb
chore(编号): 存量编号全量转语义短语，门禁识别面与语料同批重打
...
登记簿、文档与代码注释里的存量字母加数字编号（N-x / S-x / T-x / E-x / A-x / 卡号）
一律改写为语义短语，净删 2,028 处引用；删除基线与待确认、并行分道方案、排期详述、
采集保护收尾 4 篇（内容已并入 docs/任务规划/README 与登记簿）。
门禁机器与三张账同批重打：check_ids.py 新增变更记录行豁免与第二根护栏
undecidable_total_ceiling；check_test_traceability.py 只加 stdout/stderr UTF-8
reconfigure（TC_RE 未动）；check_cubemx_survival.py 的 --write 固定 newline=LF；
id_registry / id_aliases（+19 条 retired-to-phrase）/ id_known_backlog 重打。
test/ 56 个文件同步 TC 标签语义化，其中 18 个 TU 改了 CHECK / printf 里的标签文字，
是本批唯一改变构建产物的文件集合。
为什么合成一笔、不拆四笔（实测撞闸，非偏好）：pre-commit 跑钩子前会 stash 未 staged
部分，拆开后中间提交必然是「新规则 + 旧语料」——实跑可判定 85.15% < 基线 86.00%、
不可判定 1,453 > 上限 1,166，编号门禁直接拦下。编号识别面与它描述的语料只能同码移动。
实跑基线（工作区全量）：754 文件 / 8,230 处编号字面量 / 可判定 7,079 = 86.01%
（基线 86.0%，容差 0.1pp）/ 不可判定绝对数 1,151（上限 1,166）/ 校验 1-6 错误级 0 /
告警 = 悬空 2（App/algo/freq.c 的 S2，属 §4.4 同号不同义）+ 孤儿 50。
基线从 84.0 抬到 86.0 的理由见 docs/门禁说明/id-check.md §7.6：本批真删了 2,028 处
引用，可判定面随真实内容上升，不是把分母做小。同批新增排除 docs/硬件平台/ 语料，使
识别面少 264 处——芯片手册位号与网表料号不属编号空间（registry 有 excluded_paths_note）。
⚠ 余量只剩 0.11pp（约 10 处）与绝对数 15 处：把「可判定的引用」改成散文会立刻撞第二
根护栏。另遗留一项：id_aliases 里 retired 的 N / S / T / A 别名没有 scope（U1~U5 有），
今后有人新写一个 A-4，校验 3 不会响，只能靠人，建议下批补 scope。
固件不变证据：115 个 .c/.h 剥注释并归一字符串后与 HEAD 逐字节全等，残留代码差异 0；
App / Src / Drivers 的字符串字面量零改动。@build 0 错误 0 警告；40/40 主机套件、2,889
断言全通过；覆盖率 line 89.2% / func 92.6%；pre-commit 48 钩子 --all-files 全绿；
check_doc_links --all 通过（176 文档，章节引用无法判定 0）；逐字节卫生核过：14 个带
BOM 文件与 HEAD 一致、0 个 CR、0 个 U+FFFD，字符串字面量纯 ASCII。
.cubemx_survival_baseline.json 的 watchdog-module 哈希 56bf27 变 2bb051 属合法：
Src/freertos.c 的 USER CODE 区内只有注释文字随编号改写，代码未变。
同批带上体积同码凭证与 RAM 台账行（@build 之后盖戳）：RW_IRAM1 79,008 B / 60.3%，
RW_CCM 57,376 B / 87.9%，阈值 92%。
2026-10-26 12:28:14 +08:00
wandering1
c89c8effd4
docs(日志): N-2 × S8 合并评估收口——S8 判已达成、IT/DMA 维持否决、N-2 收敛 V5 复跑
...
道F 批 2 / task-18（评估任务：结论即交付，零代码改动，未顺手重构）。
【结论（全文 = docs/子系统设计/控制台单写者日志设计说明.md 文末附录 A.1-A.4）】
A.1 S8（非阻塞日志；需求出处 = 链路延迟测试说明 §9.2/§10.2）在**生产者侧已由
单写者形态达成**：实测日志税 4402µs/行（L10）→ 亚微秒~µs 级整行入环；
溢出 = 有界 200ms + dropped 账 + [ERR]；冲刷 = 有界裸发。S8 判**已实现**。
A.2 TX 中断/DMA（原案后半）维持 D4 否决；复议条件绑定 S-3（TX-only 根治 ORE
僵尸，批 2.5 独占轮）：根治后 tx_timeout 实测增量 > 0 才复议——S-3 之前
动 TX 路径 = 给即将被移除的场景写两遍代码。
A.3 与 N-2 合并判定 = 同源不同题：判据②（丢弃可观测）已具备（v1.5 三本账 +
syslog 丢弃账）；判据① 运行期窗内静默随 N-17（merge 969fc5c）待复跑核验，
附录并给出「无源 vs 真停滞」机判口径（账目增量 / [ERR] dropped 行对照）。
销项条件 = V5 复跑（e02_probe + FTP ≥30min）运行期 stall 与非开机 MISS 双零；
销项动作与登记簿行清理归 lead，本提交未碰 docs/任务规划/**。
A.4 遗留面全部既有（O1/O2/O3/O4/S-3 归属不变），无新增。
【最小实现】判定为**无需**（三结论：已实现/否决/观察窗内）。唯一候选（O2 的
STALL 证据行接 tx_timeout）涉 App/util 与台架证据行解析端，超本卡写域，维持
O2 后续项登记。
【改动】纯文档 3 个：控制台单写者日志设计说明.md（附录 + §11 时间线 + 修订
记录 v1.6）；链路延迟测试说明.md §10.2 第 9 条划状态 + 第 14 条现状互链；
实机测试实施指南.md §7.2 结论段互链 N-17 修复与销项条件。
【越界申报】docs/子系统设计 + docs/测试说明 3 篇——评估类任务的结论落文档
即交付物本身，同 n22 批准②的先例类别；未碰单写者/登记表以外他人文件。
【门禁】check_doc_links --all：本单 3 篇引用全绿（首轮照出附录 3 处跨行/裸形
小节引用已改紧邻完整路径写法；仓内余 32 条 = simulator/SDL2 第三方路径空格
既有噪音，与主干一致、非本单引入）；id-check exit 0。零代码 → 无需 @build；
soe_store/道E 窗口零交集（本卡零代码）。
2026-10-25 11:01:00 +08:00
wandering1
ef688485ad
docs(log): 对齐姊妹文档版本头部与修订记录行序
...
CI / L0 静态门禁 (pre-commit) (push) Failing after 4m6s
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 25s
用户裁定：运行/自检记录那篇**不建表也不 bump**（修订史留在 git），只修姊妹文档
控制台单写者日志设计说明.md 上由我造成的两处形制瑕疵：
1. 头部「**版本**：v1.1（已实施）」与文末修订记录已写到 v1.5 不一致（正文 §13-O2
也早在引用 v1.5）。头部改为 v1.5 并注明「修订史见文末修订记录」；日期行同步写明
当前版本日期与初版日期，避免「v1.5 却标着 09-25」这种二次误读。
2. 修订记录表内 v1.5 行排在了 v1.4 行之前（我上一批次插行时没核对行序），已交换回
升序：v1.0 / v1.1 / v1.2 / v1.3 / v1.4 / v1.5。
两行内容本身一字未动，只换位；文档 356 行不变，diff 为 3 增 3 删。
验证（只读等价自查，未跑 pre-commit——理由见下）：
- scripts/check_doc_links.py --sections-strict → 退出码 0（另有 --all 跑通 178 篇路径；
变更记录小节内 706 处历史指称按规范跳过）
- scripts/check_ids.py --strict → 退出码 0（存量 635 处 backlog 为 warn-only，非本次引入）
- 字节卫生：该文档带 UTF-8 BOM，改写走 Python 逐行而非 Edit，BOM 原样保留；无 CR、
U+FFFD 计数 0、单个结尾换行
为何 --no-verify：主工作树此刻存在**另一路会话的未提交改动**（docs/任务规划/ 四个登记
簿文件 + 主机单测覆盖率口径.md 的「16/28 套→33 套、25 s→67 s」数字纠偏，标注
2026-10-25 实测）。pre-commit 运行会 stash 这些未暂存改动，与并发写入者互相打架；
故本次只提交本文件路径，不代他人提交、也不替他人冒 stash 风险。
2026-10-25 01:13:27 +08:00
wandering1
5a806d8a26
fix(log,net): 处置主机单测照出的 10 条现状，撤销 1 条误报
...
用户裁定「全部修」。第 1 轮修复跨三名队友、写范围互斥、零越界；
11 条登记现状 → 10 条已处置 + 1 条撤销（非阻塞 recv 「看不见 EOF」是误报：
net_recv_locked:1885 的非阻塞分支已把 CLOSED||session_dead 判成 EOF(0)，
动手前读码才发现，误报比漏报更贵）。
存储与日志（App/log/sys_log_mcu.c、soe_store.c、cfg_file_store_mcu.c、sys_log.h）
A 卷忙整批丢日志：批量路径补 rc==-2 分支整批回投（不计故障/不打日志/
保序）；此前一批最多 8 条既不落盘也不回投，而文档写着「条目不丢」
B rc==-1 文案与行为相反：改 write fail, requeue + 正常→故障节流
C 删永不可达的截断支；容量契约写死 sys_log.h（不足一律 -1、不写调用方字节）
D 自愈触发集违规（比原报告更严重）：新增代码侧唯一入口 s_is_selfheal_code，
触发集收敛为 {DISK_ERR,INT_ERR,NO_FILESYSTEM,DENIED}，移出名字/参数类码——
旧集合在 8.3 同名同因下每轮删一次自己的历史日志且永不自愈，正是存储架构
§10.1 第 10 条严禁的归集；soe_store 侧同源取更保守子集（打开失败绝不 unlink）
E 注释里的 FR_NO_SYSTEM 不存在，改 FR_NOT_READY / FR_NO_FILESYSTEM
F syslog_post 满态留痕节流（A 修好后「队列常驻满」成必然场景，不修等于用
新刷屏换掉静默丢）；丢弃语义一字未改
NET（net_socket.c/.h、net_types.h、net_socket_sim.c、lftpd.c）
IP 字节序统一到 POSIX 网络序：改 net_inet_addr（&s_addr[0]==第一段）+ 出向
IP 数组按内存字节顺位拆装（进与出同时换族→芯片侧数组净效果不变，550h 钉住）
+ 模拟器逐字同步；ntoa 函数体未动，只改对它注释里取了废弃族值的例子——
那正是两套约定长期共存不被发现的原因。lftpd 两处算术核对确认无需改
UDP 绕过 netTask：两入口加执行任务上下文守卫，新码 NET_ERR_NOT_IN_NETTASK
(-12，重试永远无意义)；结论口径=危险面已结构性关掉、串行化改造仍未做。
附带关掉第二条更隐蔽的路：非 netTask 自旋 recvfrom 期间控制块被 close 并
把同一 sockfd 分给新会话→旧自旋者消费新会话数据报
控制台（console_log.c/.h）：冷却改独立 s_con_cooling 标志（旧写法在 tick==0 那
拍冷却等于没记）；con_append 的判空位+推进 head+整行拷贝收进同一临界区（旧
为区外 check-then-act，环 >95% 满时可静默覆盖且既不打 [ERR] 也不计 dropped）；
Instance==NULL 与僵尸通道分诊（未初始化绝不 reinit）；三本账分离 + 新读口
dbg_console_tx_timeout()；[ERR] 行改为发成功才销账
测试：net_socket 452、console_log 127、sys_log_mcu 104、soe_store 27、
cfg_file_store_mcu 34；回归 net_listener 34 / net_events 34 / net_pending 43 /
net_select 22 / lftpd 35 / lftpd_inet 28 / lftpd_io 33 / iec104_serv 28 /
nand_port 149 / vol_lock 33 / soe 32 / cfg_file 151 全绿。原「按现状钉住」的
用例全部翻正向；console_log 用「逐条退回旧实现」做变异自证，失败集合单调增长
6→11→18→22（把一条本来空转的断言逼了出来）。
游标抬升：TC-NETSOCK-545→560、TC-SYSLOG-100→107、TC-CONLOG-135→167。
文档：控制台设计说明 §4.1 口径与 §13-O2 销项 + v1.5；运行与自检记录 §4.4/§4.5
四条；存储架构 §10.1 第 10 条推论（指向 s_is_selfheal_code）；TRAP-NET-21 后续
条目；BSD 指南新增 §9.0 s_addr 唯一约定；覆盖率口径 §9「第 1 轮修复处置」表 +
后续项 5 条 + 台架复验 7 条 + 新坑 8 条 + 变更记录。
后续项（本轮刻意不做，理由见 §9）：UDP 改走 netMsgQueue（需 per-task 结果槽，
net_msg_t 按值拷贝、禁止加回传字段，且要真机回归）；sim_syslog.c 同源不可达
支（本轮编译验证不到，不交没编译过的改动）；syslog_post 丢弃计数；
dbg_console_tx_timeout() 读端接线（STALL 行是被解析的证据行，加字段要连解析端
与台架判据一起改）；104 来源地址日志（现网无输出点）。
gate: @build 0 errors 0 warnings（Code=213720 RO=18860 RW=1204 ZI=131500）。
pre-commit run --all-files -> 39 hooks, 36 Passed; failed = mem-numbers +
mem-budget（受管快照与本树首次构建产物的漂移，非本批增量）+ id-check（已修，
现 0 台账外新账，可判定 84.63% > 基线 82.6%）。实测水位 RW_IRAM1 57.4%、
RW_CCM 87.9%，均低于 92% 红线；RAM/Flash 本批增量为数个 static 变量。
test-coverage / cppcheck / coding-standard / bsp-err / layer-deps / doc-links
全 Passed；全量覆盖率 33/33 套件、line 89.3%、func 92.3%、逐文件下降 0。
按仓内分支约定 --no-verify 提交，台账 --write 回填留待主工作树合并后。
2026-10-24 19:43:56 +08:00
wandering1
dafcf8098b
test(b6): 台架 @test 闭环复测收口 + 启动行门控修复 + PC 104 主站
...
B6 台架 @test 闭环复测（B4/B5 验收窗口）完成，DoD 全判据过。
门控修复（首跑 FAIL 实锤的 B5 遗留竞态）：
- 现象：protect task start 锚点行字节级交错损坏
（st[art: cycle=220ms elm=70，两次开机同形复现）
- 根因：启动行在控制台写者注册前打印走无锁裸发，与
defaultTask 启动日志交错——违反 2026-10-10 门控纪律
（控制台单写者日志设计说明.md §3.4，adcTask 同款先例）
- 修复：启动锚点行改 dbg_console_writer_ready() 首拍补打
台架与工具：
- .serialtest/config.json：Required 增 protect task start /
i104 listening on 2404 / [STACK] protect|iec104|heap
- test/host/iec104_master.py：纯标准库 104 主站客户端
（STARTDT→总召四组+actterm→C_SE 两段写触发 YX15/16 变位
COT=3→恢复复归→YK11 两段正答→C_RD 读回），往返 18/18
PASS（d3107f3 与 B7+fix 两版固件）
- 复测 @test PASS：锚点完好 +577ms、9/9 Required、零 [ERR]、
回读一致；protect free_min 1220（59%）、iec104 2136（83%）、
新 56KB 堆 min_ever=10000（N-33 抬栈背书就绪）
证据与文档回填：
- boot_log_data 四份快照（含缺陷复现 MISS 件）+ README 登记
- 保护规划 §7 B6 行（B5 台架遗留闭环）；控制台单写者 §3.4
纪律示例 + §11 变更记录；IEC104 §7/§8 主站工具就绪；
W1 卡 B6 ✅ + N-33 背书 + B7 台架腿注；登记簿 N-33
- 内存台账：+16 B 构建后 ram_baseline/check_mem_numbers 回填
验证：@build 0 错 0 警（Code=205516）；ci_local 全绿
（L0 30 钩子 + L0.5 13 套件 826 断言）。
2026-10-12 16:31:33 +08:00
wandering1
d3107f374f
docs: 待处理内容.md 解耦为 docs/任务规划/ 文件夹（README 排序权威 + 6 个职责单一文件）
...
- rename_ref.py 搬迁：git mv + 全库引用改写 33 文件 82 处
- README.md 保留 §0 编号空间 / §1 未闭环一览 / §2 推进顺序权威 / §3 维护约定
- 拆出 6 文件：W1-采集保护收尾（任务卡五字段）、排期详述、暂缓-RS485、
登记簿、测试与架构专项、基线与待确认
- 外部引用重定位 ~50 处：裸「登记簿 §X」、§5.1→基线与待确认 §2.1、
§2.4→暂缓-RS485、§6→基线与待确认 §3、脚本注释 T-x/N-x→登记簿
- 新增并行写纪律：任务分支不改本文件夹，状态列由 Lead 主工作树更新
- 验证：doc-links 141 文档全绿；mem-numbers 一致；refgraph 重生成；
@build 0 错误 0 警告；新文件无 BOM / LF / 零乱码
2026-10-12 13:42:47 +08:00
wandering1
eddbedeee8
docs(AGENTS): 入口重构——补宏观概况与边界块，瘦身51KB→25.8KB，子域知识入skills
...
CI / L0 静态门禁 (pre-commit) (push) Has been cancelled
CI / L0.5 主机侧单测 (MSVC) (push) Has been cancelled
- AGENTS.md 51,067→25,828 B（−50%）：审计→迁移→删除，逐节 diff 零信息损失
- 按调研（agents.md 官方/aihero/airflow）补「项目概况」：一句话定位、
数据主线、顶层目录地图、分层边界；平台约束 17 条分 5 组
- 新增「边界（Ask first / Never）」：git commit/push 须明确指示首次入库
- 串口助手、LVGL 模拟器两节移入 serial-assistant / 新建 lvgl-simulator skill
（开关语义按 main.c 实锤）；LVGL 两条实证坑移入 ui-verify skill
- 9 条入口独有细节迁移至对应设计文档（存储/看门狗/启动顺序/文档规范/
pre-commit 使用说明/keil-build skill）；@test 细节指向自动化测试流程
- 新增 docs/AGENTS编写指南.md：六原则/模板/反模式/维护纪律 + 本仓案例
- 修正 3 处对 AGENTS 串口节的过时引用；docs/README.md 登记新文档
2026-10-11 10:44:50 +08:00
wandering1
da66c500ea
fix(console): gate adcTask logs on console-writer readiness
...
B1 on-board closed loop surfaced a byte-level console interleave: before
the console writer (defaultTask) registers, con_append() routes to
dbg_console_write_raw() -> con_tx_bounded(), which is register-level
polling with no mutual exclusion. adcTask logged every 1 ms, so its
first-frame line collided with defaultTask's [NAND_FTL] init line and
the required marker spanned two interleaved lines -> false FAIL.
- console_log: add dbg_console_writer_ready() (returns s_con_writer_up)
- adc_task: gate first-frame and 10 s stats logs on writer readiness;
defer the first-frame report until the writer is up
- docs: close B1/P1-1 in the registry; flip stale "remaining @test"
notes; correct the console doc's obsolete "drop-only, no interleave"
claim (that held for HAL gState, not register-level raw send)
Bench (run_boot_test.py): VERDICT PASS, readback OK. adcTask
frames/seq +10000 per 10 s = 1000 Hz, idle=0, frst_err=0; stack
496/2048 (75%). @build 0/0.
2026-10-10 14:53:36 +08:00
wandering1
0779d3a075
栈整改不抬栈：删旧档迁移、FIL静态化、日志行缓冲按模块收紧、钩子脱离HAL，defaultTask链5312→2776B
2026-10-10 10:17:00 +08:00
wandering1
b96d649e62
文档销项：登记ORE僵尸根治与卷锁待办，补存储架构resume锚点说明
CI / L0 静态门禁 (pre-commit) (push) Successful in 57s
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 25s
2026-10-02 20:54:05 +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