阶段 D 收口：P3 卫生六项 + S-2 boot_log 存档流程 + 登记簿销项

阶段 D（验证与卫生）离线可完成项收口；台架依赖项 D2/D5/D6 保留登记。 - D4 P3 卫生六项： - P3-1 cfg_file.c s_encode：STR 型 len==0 回绕（p_key->len - 1u）直接拒绝 - P3-2 cfg_file_store_mcu.c：原子写临时名由 p_path 同目录推导（s_build_tmp_path） - P3-4 rs485.c：模块描述订正为实际实现（HAL_Delay(1)，非 DWT µs） - P3-6 ch395f_get_socket_status：补 p_status NULL 检查 - P3-8 build.md：退出码契约订正为 0/1/2 三档 - P3-11 adc_task/rs485_task：注明"预留桩（未启用）" - D3 S-2：新增 docs/测试说明/boot_log_data/（快照存档目录 + 流程），并在测试开发标准流程.md §7.3 登记沉淀约定 - 登记簿销项：删 P3-1/2/4/6/8/11、S-2；阶段 D 表移除 D3/D4； §1 计数更新（P3 6→0、登记簿 10→9）；§3 章节重排（登记簿→§3.2、专项→§3.3）；清理 App/cfg/README.md 等对已销编号的引用 - 同步刷新内存快照：Flash 266,632 B / ROM 合计 267,372 B 验证：@build 0 错 0 警；cfg_file 主机单测 149/149； pre-commit --all-files 17/17 通过。
2026-10-05 10:15:53 +08:00
parent de1b50efe9
commit ad0fd53389
12 changed files with 129 additions and 48 deletions
@@ -11,9 +11,9 @@ Run the Keil MDK-ARM build by executing the build script with the bash tool. The

 Then read the tail of `MDK-ARM/build_log.txt` and report the result.

-Exit code interpretation (per AGENTS.md):
+Exit code interpretation (per AGENTS.md / `MDK-ARM/build.bat`):
 - 0 = success (0 errors, 0 warnings) — PASS
- 1 = warnings only — FAIL, must fix
- 2+ = compile errors — FAIL, must fix
+- 1 = build failure (compile errors, or warnings-only, or no build log produced) — FAIL, must fix
+- 2 = environment error (`DTU_KEIL_UV4` unset or invalid path) — fix the tool path, then rerun

 If the build fails, read `MDK-ARM/build_log.txt`, fix the reported errors/warnings, and rerun `@build` until it returns 0.
@@ -9,7 +9,7 @@
 |---|---|
 | `cfg_file.c/h` | **配置引擎核心**：解析 / 查询 / 保存 / 2s 周期 `cfg_file_poll` |
 | `cfg_file_store.h` | **存储后端抽象接口**（MCU=FreeRTOS 堆 / 模拟器=宿主堆，共享核心零分配符号） |
-| `cfg_file_store_mcu.c` | **MCU 端后端实现**：`/config.ini`（`/config.TMP` + `f_rename` 原子写） |
+| `cfg_file_store_mcu.c` | **MCU 端后端实现**：`/config.ini`（临时名由目标路径同目录推导 + `f_rename` 原子写） |

 ## 设计要点

@@ -25,4 +25,3 @@

 - `docs/子系统设计/配置文件设计说明.md` — 完整设计（分层/解析/持久化/迁移）
 - `docs/子系统设计/网络配置说明.md` — 网络段
- `docs/待处理内容.md` P3-2 — 临时文件名硬编码问题
@@ -266,7 +266,14 @@ static int s_encode(const cfg_key_def_t *p_key, const uint8_t *p_src, char *p_ds
                         (unsigned)p_src[3], (unsigned)p_src[4], (unsigned)p_src[5]);
            break;
        case CFG_VAL_STR: {
-            size_t slen = strlen((const char *)p_src);
+            size_t slen;
+
+            /* P3-1：len==0 时 `p_key->len - 1u` 回绕为 SIZE_MAX → memcpy 巨长越界。
+             * STR 字段至少 1 字节（含结尾 NUL），len==0 非法，直接拒绝 */
+            if (p_key->len == 0u) {
+                return -1;
+            }
+            slen = strlen((const char *)p_src);
            if (slen >= p_key->len) {
                slen = p_key->len - 1u;
            }
@@ -1,7 +1,7 @@
 /*
 * 模块名称：cfg_file_store (MCU 后端)
 * 模块功能：cfg_file 存储后端——NAND 上 FatFS 文件 /config.ini（卷根，8.3 合规）；
- *          原子写 = 临时文件 /config.TMP + f_rename；mtime 变更令牌 =
+ *          原子写 = 临时文件 config.TMP（与目标同目录）+ f_rename；mtime 变更令牌 =
 *          (fdate << 16) | fmtime；旧版遗留文件 /cfg/netcfg.bin 供迁移读取
 * 适用平台：STM32F407ZGTx
 * 作者：王建锋
@@ -18,6 +18,9 @@
 *                              dhara journal 竞争实证）；busy 返回 -1 由调用方
 *                              按既有失败语义处理（poll 保留 RAM/保存待重试），
 *                              本任务 = 看门狗喂狗点，绝不阻塞等锁
+ *     v1.4  2026-10-05  王建锋  原子写临时文件由 p_path 推导（P3-2）：与目标同目录的
+ *                              固定 8.3 名 config.TMP，不再硬编码卷根；目标恒为
+ *                              "/config.ini" 时推导结果与旧值逐字节一致
 */

 /* 头文件包含区 */
@@ -74,8 +77,40 @@ int cfg_store_read(const char *p_path, uint8_t *p_buf, size_t cap, size_t *p_nre
    return 0;
 }

+/* 临时文件名（8.3 合规）与路径缓冲上限 */
+#define CFG_STORE_TMP_NAME       "config.TMP"
+#define CFG_STORE_TMP_PATH_MAX   24u
+
 /*
- * 函数功能：原子写文件（先写 /config.TMP，成功后 unlink 既有目标 + f_rename 替换）
+ * 函数功能：由目标路径推导同目录的临时文件路径（P3-2）
+ * 入口参数：p_path - 目标文件路径  const char *
+ *           p_out  - 输出缓冲  char *
+ *           cap    - 缓冲容量  size_t
+ * 返回值：0 - 成功；-1 - 参数非法/缓冲不足  int
+ * 函数说明：取 p_path 的目录前缀（含末尾 '/'；无 '/' 则用当前目录），拼固定 8.3 名
+ *          config.TMP。目标 "/config.ini" → "/config.TMP"（与旧硬编码值一致）
+ */
+static int s_build_tmp_path(const char *p_path, char *p_out, size_t cap) {
+    const char *p_slash;
+    size_t dirlen;
+
+    if (p_path == NULL || p_out == NULL) {
+        return -1;
+    }
+    p_slash = strrchr(p_path, '/');
+    dirlen = (p_slash != NULL) ? ((size_t)(p_slash - p_path) + 1u) : 0u;
+    if (dirlen + sizeof(CFG_STORE_TMP_NAME) > cap) {
+        return -1;
+    }
+    if (dirlen != 0u) {
+        (void)memcpy(p_out, p_path, dirlen);
+    }
+    (void)memcpy(p_out + dirlen, CFG_STORE_TMP_NAME, sizeof(CFG_STORE_TMP_NAME));
+    return 0;
+}
+
+/*
+ * 函数功能：原子写文件（先写与目标同目录的 config.TMP，成功后 unlink 既有目标 + f_rename 替换）
 * 入口参数：p_path - 目标文件路径  const char *
 *           p_buf  - 待写数据（不可为 NULL）  const uint8_t *
 *           len    - 数据长度  size_t
@@ -86,14 +121,19 @@ int cfg_store_write_atomic(const char *p_path, const uint8_t *p_buf, size_t len)
    FIL f;
    FRESULT fr;
    UINT bw = 0u;
+    char tmp_path[CFG_STORE_TMP_PATH_MAX];

    if (p_buf == NULL) {
        return -1;
    }
+    /* P3-2：临时文件由 p_path 推导（同目录 + 固定 8.3 名），不再硬编码卷根 */
+    if (s_build_tmp_path(p_path, tmp_path, sizeof(tmp_path)) != 0) {
+        return -1;
+    }
    if (vol_lock_wait(0u) == 0u) {
        return -1;   /* 卷被占用：本轮跳过（保存请求由 2s 轮询重试） */
    }
-    fr = f_open(&f, s_path_tmp, FA_WRITE | FA_CREATE_ALWAYS);
+    fr = f_open(&f, tmp_path, FA_WRITE | FA_CREATE_ALWAYS);
    if (fr != FR_OK) {
        vol_lock_release();
        return -1;
@@ -101,7 +141,7 @@ int cfg_store_write_atomic(const char *p_path, const uint8_t *p_buf, size_t len)
    fr = f_write(&f, (const void *)p_buf, (UINT)len, &bw);
    (void)f_close(&f);
    if (fr != FR_OK || bw != (UINT)len) {
-        (void)f_unlink(s_path_tmp);
+        (void)f_unlink(tmp_path);
        vol_lock_release();
        return -1;
    }
@@ -113,9 +153,9 @@ int cfg_store_write_atomic(const char *p_path, const uint8_t *p_buf, size_t len)
     * 开机 load 按"首启"重建工厂模板——与函数失败语义一致，丢失边界 =
     * 本次进行中的保存内容（目标原值本就是待覆盖的旧代数据） */
    (void)f_unlink(p_path);    /* 目标不存在返回 FR_NO_FILE，无害 */
-    fr = f_rename(s_path_tmp, p_path);
+    fr = f_rename(tmp_path, p_path);
    if (fr != FR_OK) {
-        (void)f_unlink(s_path_tmp);
+        (void)f_unlink(tmp_path);
        vol_lock_release();
        return -1;
    }
@@ -1,11 +1,15 @@
 /*
 * 模块名称：ADC Sampling Task
 * 模块功能：TPAFE5160 8 通道同步采样，数据缓存与通知
+ * 状态说明：**预留桩（未启用）**——采集链路尚未实现，产品定义未定
+ *          （见 docs/待处理内容.md 阶段 B0/B1）。当前 init/func 为空实现，
+ *          不触发 CONVST、不消费数据。
 * 适用平台：STM32F407ZGTx + TPAFE5160
 * 作者：王建锋
 * 创建日期：2026-07-19
 * 修改记录：
 *   v1.0  2026-07-19  王建锋  创建初始版本
+ *   v1.1  2026-10-05  王建锋  P3-11：注明"预留桩（未启用）"，避免误认为已实现
 */

 #include "adc_task.h"
@@ -1,11 +1,15 @@
 /*
 * 模块名称：RS485 Communication Task
 * 模块功能：RS-485 轮询收发、协议帧解析与响应
+ * 状态说明：**预留桩（未启用）**——采集/协议链路尚未实现，产品定义未定
+ *          （见 docs/待处理内容.md 阶段 B0/B2）。当前 init/func 为空实现，
+ *          不收发、不解析。
 * 适用平台：STM32F407ZGTx
 * 作者：王建锋
 * 创建日期：2026-07-19
 * 修改记录：
 *   v1.0  2026-07-19  王建锋  创建初始版本
+ *   v1.1  2026-10-05  王建锋  P3-11：注明"预留桩（未启用）"，避免误认为已实现
 */

 #include "rs485_task.h"
@@ -1331,12 +1331,16 @@ uint8_t ch395f_get_sock_int_status(uint8_t sock) {
 * 入口参数：sock - Socket索引  uint8_t  0 - 7
 *           p_status - 2字节输出缓冲区指针  uint8_t*
 *                     [0] = Socket状态, [1] = TCP状态
- * 限定条件：芯片已初始化
+ * 限定条件：1. p_status 不可为 NULL
+ *           2. 芯片已初始化
 * 函数说明：Socket状态: 00H=CLOSED, 05H=OPEN
 *           TCP状态: 00H=CLOSED, 01H=LISTEN, 02H=SYN_SENT,
 *                    03H=SYN_RCVD, 04H=ESTABLISHED
 */
 void ch395f_get_socket_status(uint8_t sock, uint8_t *p_status) {
+    if (p_status == NULL) {
+        return;
+    }
    ch395f_spi_begin();
    ch395f_write_cmd(CH395F_CMD_GET_SOCKET_STATUS_SN);
    ch395f_write_data(sock);
@@ -1,15 +1,17 @@
 /*
 * 模块名称：RS-485 半双工通信驱动
 * 模块功能：RS-485 半双工通信驱动实现，封装任意 UART 外设实现 485 方向控制，
- *          提供阻塞发送、中断接收（IDLE 空闲帧检测）。使用 DWT CYCCNT 提供
- *          微秒级延时，确保 RS485 收发器 DE 使能稳定。
+ *          提供阻塞发送、中断接收（IDLE 空闲帧检测）。DE 建立延时用 HAL_Delay(1)
+ *          （HAL 时基 1ms，远大于收发器 50us 的 DE 建立时间），确保 DE 使能稳定。
 * 适用平台：STM32F4 系列
 * 作者：王建锋
 * 创建日期：2026-07-18
 * 修改记录：
 *     2026-07-18  王建锋  创建初始版本
- *     2026-07-20  王建锋  修复 DE 时序：添加 DWT 微秒延时替代 for 循环
+ *     2026-07-20  王建锋  修复 DE 时序：添加 DE 建立延时替代 for 循环
 *     2026-07-20  王建锋  清理中文注释乱码，对齐代码规范
+ *     2026-10-05  王建锋  P3-4：模块描述订正为实际实现 HAL_Delay(1)
+ *                         （原描述称 DWT CYCCNT 微秒延时，与代码不符）
 */

 #include "rs485.h"
@@ -36,10 +36,10 @@
 <!-- MEM_SNAPSHOT:BEGIN generated by scripts/check_mem_numbers.py -->
 | 区域 | 用量 | 容量 | 占比 |
 |---|---|---|---|
-| ER_IROM1 | 266,548 B (260.30 KB) | 1,048,576 B (1024 KB) | 25.4% |
+| ER_IROM1 | 266,632 B (260.38 KB) | 1,048,576 B (1024 KB) | 25.4% |
 | RW_IRAM1 | 84,960 B (82.97 KB) | 131,072 B (128 KB) | 64.8% |
 | RW_CCM | 49,184 B (48.03 KB) | 65,280 B (64 KB) | 75.3% |
-| **Flash (ROM 合计)** | **267,288 B (261.0 KB)** | 1,048,576 B (1024 KB) | **25.5%** |
+| **Flash (ROM 合计)** | **267,372 B (261.1 KB)** | 1,048,576 B (1024 KB) | **25.5%** |
 <!-- MEM_SNAPSHOT:END -->

 各区的容量与常量来源：
@@ -38,8 +38,7 @@
 | 级别 | 数量 | 关键项 |
 |---|---|---|
 | **P1** | 1 (+1 收尾) | **P1-1 ADC 采样路径产品构建中死亡**；P1-10 测试固件构建实测闭环（主体已闭环，见 §3.1） |
-| **P3** | 6 | 卫生项：P3-1/2/4/6/8/11，可随其他修改顺手处理 |
-| 登记簿 | 10 | 网络：N-2（49s 日志静默，**低风险观察项**）、N-3（L5 基线重验）、N-4（pending 二期）、N-16（A2/A4 专项负向验证）、N-17（探针窗口心跳缺口）；存储/日志：**S-1（defaultTask 栈余量 10%，需尽快处理）**、S-2（boot_log 存档）、S-3（USART1 TX-only 根治）、S-4（dhara 重试自旋）、S-5（可选全序列卷锁） |
+| 登记簿 | 9 | 网络：N-2（49s 日志静默，**低风险观察项**）、N-3（L5 基线重验）、N-4（pending 二期）、N-16（A2/A4 专项负向验证）、N-17（探针窗口心跳缺口）；存储/日志：**S-1（defaultTask 栈余量 10%，需尽快处理）**、S-3（USART1 TX-only 根治）、S-4（dhara 重试自旋）、S-5（可选全序列卷锁） |
 | 测试/基础设施 | 5 | T-7（CI runner 未就绪）+ 测试架构专项 **S12**（断言宏）、**S1-c**（可选单测）、**A-4**（采集链路测试约束）、**A-5 残余**（CI 体积门禁盲区） |

 > **网络侧另有 E-xx 未闭环项**（E-12/15/16/23/24/25/26/27/28/30/47/48/49/50/58/59/61，共 17 项）
@@ -92,8 +91,6 @@
 | 序 | 任务 | 说明 |
 |---|---|---|
 | **D2** | N-3 L5 基线重锁 | 下次 Phase 13 窗口顺带做（低风险：阈值余量 >8×；**需 PC peer**） |
-| **D3** | S-2 boot_log 快照存档流程 | 固化 `%TEMP%\opencode\boot_log_*.txt` 进 `docs/测试说明/` 存档目录 |
-| **D4** | P3 卫生项 | P3-1/2/4/6/8/11（含 E-13 `test_parse_ip` 门控析取）顺手清理 |
 | **D5** | **N-16 专项负向台架窗口** | A2/A4 负向场景：PHY 拔线（需断 DTU 侧/关受管交换机端口）、A2 芯片级 `net_init` 失败（SPI 故障注入）、A4 短写压测 |
 | **D6** | **N-17 探针窗口心跳缺口** | 定位 `time_sync` 监听重建为何阻塞 NET/FTP/UI（~1s 缺口，余量仅 ~0.7s）；评估缩短重建重试或让掉线路径不阻塞其它任务 |

@@ -106,7 +103,7 @@
 【阶段 C 结构】  C1 pending 二期 ─ C3 日志管线(N-2/S-3) ─ C4 栈(S-1)
                                  ─ C5 收口 ─ C6 USART1 TX-only
        ↓
-【阶段 D 常态】  D2 N-3 / D3 boot_log / D4 P3 / D5 N-16 负向 / D6 N-17 探针窗口
+【阶段 D 常态】  D2 N-3 / D5 N-16 负向 / D6 N-17 探针窗口
 ```

 ---
@@ -129,18 +126,7 @@
 - **剩余**：① CH395F 套件（`TEST_SUITE_CH395F`，HW 全阶段 / NET 层 7 配置）实际构建确认链接通过——PHASE5 三静态缓冲 3×4093B 仍在，理论余量足够但未实测；② `@test` 闭环；③ **不建议**扩 scatter 到 192KB（破坏既有克隆芯片兼容决策）。
 - **置信度**：high（基线数据来自 2026-09-21 map；测试固件构建未复验）。

-### 3.2 P3（未闭环 6 项）
-
-| # | 位置 | 问题 |
-|---|---|---|
-| P3-1 | `App/cfg/cfg_file.c` `s_encode` | STR 型 `len==0` 时 slen 计算回绕（`if (slen >= p_key->len) slen = p_key->len - 1u;`） |
-| P3-2 | `App/cfg/cfg_file_store_mcu.c` | 临时文件名硬编码 `/config.TMP`，忽略 `p_path` 参数 |
-| P3-4 | `Drivers/BSP/RS485/rs485.c` | 文件头宣称 DWT µs 延时，实际用 `HAL_Delay(1)`（文档不一致） |
-| P3-6 | `Drivers/BSP/CH395F/ch395f.c` `ch395f_get_socket_status` | `p_status` 无 NULL 检查 |
-| P3-8 | `.opencode/command/build.md` | 退出码契约写 "2+ = 编译错误"，`build.bat` 实际只有 0/1 两档（与 AGENTS.md 一致的是后者） |
-| P3-11 | `App/task/adc_task.c` / `rs485_task.c` | 空桩无注释说明原因（建议注明"预留，未启用"） |
-
-### 3.3 登记簿（N-x / S-x / T-x）
+### 3.2 登记簿（N-x / S-x / T-x）

 **网络（CH395F / net 层）**

@@ -157,7 +143,6 @@
 | # | 事项 | 发现 | 证据与现状 | 出处 |
 |---|---|---|---|---|
 | S-1 | defaultTask 静态最坏链余量贴线：`storage_bring_up → … → dhara GC → SPI` 链 | 2026-09-22；2026-10-04 重采升级 | **2026-10-04 重采（升级为需尽快处理）**：产品构建（`suite=NONE`）V5 30 min 真实负载实测 **3664B/4096（余量 432B = 10%）**，**已远低于 30% 判据**。处置：栈 4096→4608（CCM 堆余量可覆盖 +512B）或 GC 链缓冲局部削减；建议**提前到阶段 B 之前**处理 | 本文件 §2.2 C4 / §6 |
-| S-2 | N-2 消化后，台架 20MB 串口日志截头会丢早期 [STACK] 水位行——跨构建的"前后"栈水位对照建议固化 boot_log 快照（`%TEMP%\opencode\boot_log_*.txt`）进 `docs/测试说明/` 存档目录 | 2026-09-22 | 流程项，无代码改动 | 本文件 N-2 佐证 |
 | S-3 | **USART1 TX-only 结构根治（灭 ORE 僵尸机制）**——ORE 锁存在外设软复位后毫秒级重锁（PA10 悬空 + RX 使能），是 2026-10-02 台架"背靠背 drain 拉长主循环 → 喂狗节奏饥饿 → IWDG 误复位"的**机制根源**。现仅有缓解（单次 drain 250ms 预算 + 发送故障后 300ms 冷却），**未根治** | 2026-10-02（台架 gen-288） | **待办**：改 `.ioc` 令 USART1 为 TX-only → CubeMX 重生成 → 跑 `scripts/check_cubemx_survival.py`。结构性改动，需单开一轮并复跑台架闭环 | `子系统设计/控制台单写者日志设计说明.md` §12（含 O4） |
 | S-4 | **dhara 重试自旋残留**——`try_recover()` 的 `DHARA_MAX_RETRIES`(8) 自旋在坏块密集时仍可能长时间占用 defaultTask（喂狗点） | 2026-10-02 | 低优先：现有 `vol_lock` + 喂狗节奏缓解；若台架再出"存储侧喂狗饥饿"再排期 | `Lib/dhara/map.c` |
 | S-5 | **可选全序列卷锁**——现卷锁仅覆盖 `syslog` / `cfg` / `lftpd` 三条路径（`vol_lock_wait(0)` try 语义），其它潜在访问点（如 UI 读日志）未纳入 | 2026-10-02 | 待评估：先确认是否真有第二写者；无则关闭本项 | `App/fs/vol_lock.{c,h}` |
@@ -168,7 +153,7 @@
 |---|---|---|---|---|---|
 | T-7 | **CI runner 未就绪（部署前置）** | 中 | `.gitea/workflows/ci.yml` 已落地，但 CI 仅在 runner 就绪后才真正生效：① Gitea 实例 `[actions] ENABLED = true`；② 注册 Windows runner（labels 含 `windows`），装 Python 3.x / cppcheck / pre-commit / MSVC | runner 未就绪前，**提交前仍须在本地跑 `scripts/ci_local.py` 或 `pre-commit run --all-files` 自查**（L0 唯一保障，不能因"已配 CI"而放宽） | `.gitea/workflows/ci.yml`；`测试说明/测试开发标准流程.md` §9 |

-### 3.4 测试与架构改进专项（S1x / A-x）
+### 3.3 测试与架构改进专项（S1x / A-x）

 > **编号约定**：**S1~S14 / T-1~T-5 / A-1~A-7** 是 2026-10-02 版复审的**条目编号**——编号**不随条目删除而回收**；
 > 其他文档若引用这些编号，其证据见对应模块文档与 `git log`。已完成事项的证据沉淀：
@@ -180,12 +165,12 @@

 | 编号 | 事项 | 状态 | 详述 |
 |---|---|---|---|
-| **S12** | 模块级轻量断言宏 | ⬜ 待做（第 4 波按需） | 3.4.1 |
-| **S1-c** | `sys_log` / `time_sync` 主机侧单测 | ⬜ 可选（价值递减） | 3.4.2 |
-| **A-4** | ADC / RS485 采集链路的**测试可验证性约束** | ⏸ 待 B1/B2 落地时执行 | 3.4.3 |
-| **A-5 残余** | CI 体积门禁盲区（`mem-numbers` 在 CI 被跳过） | ⬜ 未消除 | 3.4.4 |
+| **S12** | 模块级轻量断言宏 | ⬜ 待做（第 4 波按需） | 3.3.1 |
+| **S1-c** | `sys_log` / `time_sync` 主机侧单测 | ⬜ 可选（价值递减） | 3.3.2 |
+| **A-4** | ADC / RS485 采集链路的**测试可验证性约束** | ⏸ 待 B1/B2 落地时执行 | 3.3.3 |
+| **A-5 残余** | CI 体积门禁盲区（`mem-numbers` 在 CI 被跳过） | ⬜ 未消除 | 3.3.4 |

-#### 3.4.1 S12：模块级轻量断言宏 ⬜
+#### 3.3.1 S12：模块级轻量断言宏 ⬜

 **动机**：`configASSERT` 只覆盖 FreeRTOS 内部；自研代码的"不该发生"靠散落的 `if`。

@@ -211,7 +196,7 @@

 **完成判据**：宏存在 + 生产构建 `@build` 0/0 且 `.map` 无新增符号；试点处有实际使用。

-#### 3.4.2 S1-c（可选）：`sys_log` / `time_sync` 主机侧单测 ⬜
+#### 3.3.2 S1-c（可选）：`sys_log` / `time_sync` 主机侧单测 ⬜

 **范围**：`App/log/sys_log_mcu.c`（定长 64B 记录编解码；落盘部分需桩）、
 `App/sync/time_sync.c`（协议帧编解码；与网络耦合，需先判定可解耦面）。
@@ -222,7 +207,7 @@

 **完成判据**：`test/host/<模块>/run_unit_test.py` 退出码 0 + 挂 pre-commit 钩子。

-#### 3.4.3 A-4：ADC / RS485 采集链路的测试可验证性约束 ⏸
+#### 3.3.3 A-4：ADC / RS485 采集链路的测试可验证性约束 ⏸

 **背景**：`adc_task.c` / `rs485_task.c` 仍是空桩，`App/protocol/` 只有 README 与 `.gitkeep`。
 本项不是"缺陷"，而是**对上游 B1 / B2 的设计约束**——应在动手前明确，否则后续无法补测。
@@ -238,7 +223,7 @@

 **完成判据**：B1 / B2 设计文档体现上述三条；协议解析函数有对应 L0.5 单测。

-#### 3.4.4 A-5 残余：CI 体积门禁盲区 ⬜
+#### 3.3.4 A-5 残余：CI 体积门禁盲区 ⬜

 **现状**：`mem-numbers` 钩子**在 CI 上被跳过**（CI 无 `.map`）→ **CI 不守体积门禁**。
 S14 已在 workflow 显式提示"体积门禁未执行"（`::notice::`）并在 `CI配置指南.md` 声明，
@@ -258,7 +243,7 @@ S14 已在 workflow 显式提示"体积门禁未执行"（`::notice::`）并在
 ## 4. 待确认（需手册/硬件/产品定义，暂不直接改码）

 1. TPAFE5160 是否有自动扫描模式（决定 P1-1 定 P0 还是 P1）。
-2. `APP_ADC_ENABLE` / `APP_RS485_ENABLE` 是否应在产品构建真实门控模块（关联 P1-1、P3-11；当前宏已如实标注为"未接线占位"，此处确认的是**是否接入真实门控**）。
+2. `APP_ADC_ENABLE` / `APP_RS485_ENABLE` 是否应在产品构建真实门控模块（关联 P1-1；当前宏已如实标注为"未接线占位"，此处确认的是**是否接入真实门控**）。
 3. RS-485 PD0 DE 的半双工方向语义需硬件实测确认（本次仅静态审查）。

 ---
@@ -324,7 +309,7 @@ S14 已在 workflow 显式提示"体积门禁未执行"（`::notice::`）并在

 | 项 | 当前值（2026-10-04） | 出处 |
 |---|---|---|
-| 产品构建 Flash (ER_IROM1) | 265,940 B / 1024 KB（25.4%）；ROM 合计 **266,676 B** | `.map` 受管快照 |
+| 产品构建 Flash (ER_IROM1) | 266,632 B / 1024 KB（25.4%）；ROM 合计 **267,372 B** | `.map` 受管快照 |
 | 产品构建 RW_IRAM1 | **84,960 / 131,072 B（64.8%）** | `.map` 受管快照（`RAM使用分析与优化方案.md` §2.1） |
 | 产品构建 RW_CCM | 49,184 / 65,280 B（75.3%） | 同上 |
 | 实测堆 | free=8,664 / **min_ever=4,728 B** | V5 串口 `[STACK] heap` |
@@ -357,6 +342,6 @@ S14 已在 workflow 显式提示"体积门禁未执行"（`::notice::`）并在
 - 已闭环条目的**结论与证据沉淀进模块文档**，本文件不再重复。
 - 编号一律**沿用且不回收**（P-x / N-x / S-x / T-x / S1x / A-x）；`错误码传播审计.md` 的 E-xx 独立维护。
 - 阶段 B 完成后重写 §1（届时 ADC/RS485 应从未闭环消失）。
- 新增发现按既有惯例分流：能立即修的进 §2（阶段 A/C5）；需排期的进 §3 对应编号空间；跨版本观察的进 §3.3（登记簿）。
+- 新增发现按既有惯例分流：能立即修的进 §2（阶段 C5）；需排期的进 §3 对应编号空间；跨版本观察的进 §3.2（登记簿）。
 - 上游引用关系：`问题记录/项目审查与优化建议报告.md`（体系层评审）、`问题记录/错误码传播审计.md`（E-xx）、
  `测试说明/实机测试实施指南.md`（执行流程）——三者均不在本文件合并范围。
@@ -0,0 +1,35 @@
+# 启动日志（boot_log）存档
+
+本目录保存 `@test`（`test/host/run_boot_test.py`）产出的**开机串口日志快照**，
+用于**跨构建的栈 / 堆水位对照**（解析其中的 `[STACK]` 行）。
+
+## 1. 为什么需要存档
+
+- `@test` 默认把 boot_log 写到临时目录 `%TEMP%\opencode\boot_log_<时间戳>.txt`——**会被系统清理**；
+- 台架长跑的 20MB 串口日志**截头会丢掉早期 `[STACK]` 水位行**（开机首次约 5s 后才报告）；
+- 两者叠加导致**无法事后回溯**"改代码前后"的栈水位变化。
+
+因此凡涉及**栈 / 堆预算**的改动或**基线重采**，必须把该轮的 boot_log 快照固化到本目录。
+
+## 2. 约定
+
+| 项 | 规则 |
+|---|---|
+| 来源 | `& '.venv\Scripts\python.exe' test/host/run_boot_test.py`（默认 `--out-dir %TEMP%\opencode`，产出 `boot_log_<stamp>.txt` + `selftest_log_<stamp>.log`） |
+| 命名 | `<日期>_<构建标识>_boot_log.txt`，例：`20261005_prod_none_boot_log.txt` |
+| 构建标识 | 建议含：产品 / 测试套件（`prod_none` / `suite_ch395f` …）+ 负载（`idle` / `v5_30min` / `ftp_stress`） |
+| 随文件登记 | 在下方 §3 清单登记日期、构建、负载、关键 `[STACK]` 水位（如 defaultTask 峰值） |
+| 入库门槛 | **只存有对照价值的快照**——常规 `@test` 通过日志不必入库 |
+
+## 3. 清单
+
+| 日期 | 构建 / 负载 | 关键 `[STACK]` 水位 | 文件 |
+|---|---|---|---|
+| — | — | — | （待台架窗口补齐） |
+
+## 4. 关联
+
+- 沉淀约定：`../测试开发标准流程.md` §7.3
+- 栈水位探针与基线：`../../内存管理/RAM使用分析与优化方案.md` §0.2 / §0.6
+- 当前诊断基线：`../../待处理内容.md` §6
+- 本流程立项：原 `../../待处理内容.md` S-2（2026-09-22 提出；2026-10-05 固化为本节流程后销项）
@@ -476,6 +476,7 @@ flowchart TD
 | 代码变更影响判定标准 | 立即同步更新模块 Test_Guide，并登记该文档变更记录 |
 | 有意改视觉 | 刷黄金参考 + 重生成目检 PNG + `UI_自动化测试流程.md` 变更记录登记 |
 | 新增测试工具 / 新标记 | `自动化测试流程.md` 命令清单登记（§4.2） |
+| 栈 / 堆预算相关改动或基线重采 | 把 `@test` 的 boot_log 快照（`%TEMP%\opencode\boot_log_*.txt`）存入 `docs/测试说明/boot_log_data/` 并在其 §3 清单登记（防临时目录被清理 / 长跑日志截头丢 `[STACK]` 行） |

 > 文档与代码一体两面：**代码改了文档没同步 = 未完成**。