fix(cfg): 热重载读侧三点一致性校验——掐断打回出厂与保存吞段（#73） #82

Merged

wandering1 merged 3 commits from fix-config-reload-03ecc431fc5e into master 2026-11-05 18:26:59 +08:00

Conversation 6 Commits 3 Files Changed 9

+371 -17

3 Commits

Author	SHA1	Message	Date
super_agent_bot	b66fcc4d87	docs(cfg): HELD 日志行“两数相等”语义注记（内容判据命中）（#73） ... 台架实录中出现 `poll: view 1064B != stat 1064B, HELD`：两数相等是 设计使然——同尺寸旧映射块命中内容判据（s_view_bad），并非空读/ 短读。首读该日志易误判为格式串错误，在 §5.3 守卫条目补一句语义 注记。纯文档改动，不影响代码指纹与体积门禁。	2026-11-05 17:27:34 +08:00
super_agent_bot	1a2ca0467d	fix(cfg): 视图守卫补内容判据——同尺寸全 0 旧映射块也能拦（#73） ... 台架（PR #82 head d9303e05，常授权烧写验证）在三点校验版守卫上继续复现 出打回形态：卷层给出的旧映射块与目标文件恰好同长（1064B）且整块全 0， 读长 == st.size 与读前后复 stat 全部通过，解析零错误、RAM 照样打回默认 （15:21 决定性轮：盘文件 RETR 校验七段完好，重载窗口内 s_sntp 三字节段 全 0）。纯令牌层校验对"内容坏"是盲的，必须补内容判据。 处置（引擎侧，与三点校验同族）： - 新增 s_view_bad：重载/保存读到的视图若为空读、或 [0,len) 内任意偏移 含 NUL 字节即判坏——INI UTF-8 文本约定下任何偏移都不得含 0x00；解析 器按行切分遇 NUL 即断行，零块之后的内容本就不可达（静默截断同源故障）， 拒之不误伤任何可解析文档。不要求首字节 ';'（手写文档可直接段名起始）。 - poll：坏内容 = 与长度/令牌不符同处置——拒绝应用，RAM 与基线不动，2s 重试自愈，首次 ERROR + 自检留痕，每 30 趟一条 WARN（限速）。 - save：坏内容同族拒存返回 -1，原文件一字节不动，调用方 dirty 保留重试。 - 边界如实保留：内容合法但陈旧的整卷视图（长度/令牌/内容三者皆一致滞后） 引擎层无法检出，属卷层（dhara/FTL）课题，重启必然收敛；"改过配置后 重启一次"在卷层根治前仍是最稳口径。 测试： - TC-CONFIG-061（poll 同尺寸全 0 块 HELD + 视图刷新自愈 + 零回调）、 TC-CONFIG-062（save 遇全 0 块拒存、文件字节/写次数不动、追平后重试 成功）；桩新增 vfs_mark_stale_zeros() 注入同长全 0 旧视图。 - cfg_file 套件 259/259；iec104 179/179、run_par 67/67、adc_cal 117/117、 sntp 98/98、cfg_file_store_mcu 34/34 复跑全绿。 - /keil-build 0 错 0 警：Code 254,784 -> 254,820 B（+36 B）；台账与同码 凭证已同步。台架实录见 PR #82 评论：NUL 注入块实机 HELD（16:55:46） + WARN 节拍 30/60 趟命中（16:56:42/16:57:41）+ 视图转新鲜后重载自动 追平；残余打回事件均为"内容合法但陈旧"整卷视图（15:19:30/16:34:59/ 16:58:38），属已声明守卫边界，盘文件全程未吞段，重启收敛实机确认 （17:04 RAM 回文件值）。 文档： - 《配置文件设计说明》§4-(3)/§5.3 守卫描述补内容判据与 15:21 实证形态、 风险表行更新、变更记录 v1.17 行同步； - 《配置文件单元测试说明》TC-CONFIG-061/062 行 + 当前结果 259/259 + 扩展指南补 vfs_mark_stale_zeros()。	2026-11-05 17:08:25 +08:00
super_agent_bot	d9303e05a4	fix(cfg): 热重载读侧三点一致性校验——掐断打回出厂与保存吞段（#73） ... 真机 #73：运行中改配置触发热重载，卷层（dhara）偶发返回旧/短 视图时，引擎把该视图当成文件全文：逐段按缺省解析后整盘打回 出厂默认且不自愈；此后任何一次保存又按缩小的视图做手术式 重写，文件越写越小（台架 1066B→986B，[sntp] 段整体丢失）， 即真机对时静默 10.5 小时的元凶。 处置（引擎侧根因无关防御；卷层回滚归 #79/#81 已合并的 FTL 修复域）： - poll：读完加三点校验（读长==stat.size、读前后 re-stat 的 size/mtime 一致），判为旧/短视图则 RAM 不动、基线不刷新、 每 2 拍自动重试自愈；首次拒绝留 1 条 DBG_ERROR+syslog， 之后每 30 拍一条 WARN 提示重启收敛。 - save：同型三点校验，视图与 stat 不符返回 -1 且文件不动， 调用方保留 dirty 下拍重试，吞段链在第一次保存即被掐断。 - 边界：「一致但陈旧」的整卷回滚引擎层无法区分，靠重启 收敛，已写入设计说明风险表与文档口径。 测试：新增 TC-CONFIG-058/059/060（旧视图保持 RAM、保存短 视图拒写、读中改写拒绝+日志限速）。cfg_file 239/239； iec104 179、run_par 67、adc_cal 117、sntp 98、 cfg_file_store_mcu 34、net_cfg 48、ftp_cfg 16、prot_set 90、 prot_dim 38 全绿；/keil-build 0 Error 0 Warning。 文档：配置文件设计说明 §(3)/§5.3/风险表/变更记录 v1.17； 单元测试说明 058–060 行；网络配置说明与产品需求 FR-CFG-3 同步口径；台账随新鲜 .map 由 ram_baseline --update 回填。	2026-11-05 12:35:46 +08:00