台架执行《实机测试实施指南》步骤 3~7 并闭环

步骤 3/4（IWDG V2/V4/V5 + 堆低水位 S11）：
- V2 任务饿死 stall 后 ≤2.5s IWDG 复位；V4 关中断死循环 ~4.9s 稳定复位；
  V5 30min 120×FTP 全 PASS、零 IWDG 复位。堆告警全程未触发（min_ever=4728B）。
- task_watchdog.c：stall 证据写盘会经 nand_ftl_wd_feed 喂狗 → 增 s_stall_evidenced
  每次 stall 仅取一次证据，避免"取证据"本身阻止复位。
- default_task.c：堆低水位告警（HEAP_LOW_WATER_B=3072）。

步骤 5（GD5F 错误通道 S9）：gd5f2gq5ue.c/.h + nand_ftl.c 错误码统一为 int32_t 并
全量检查返回值；套件回归 16/16 PASSED。
- test/run_all_suites.py：--forbidden 改为按套件覆盖（GD5F 用 "HardFault;assert"）——
  TC-GD5F-704 故意触发 [ERR] 回落轮询，统一默认值会误判 FAIL。

步骤 6（网络稳定性）：7.1 正常路径 ✅（V5 证据）；7.2 N-2 丢弃可观测性代码已具备、
49s 静默在 V5 未复现（降级低风险观察项）；7.3 N-3 待 PC peer。

步骤 7（工程卫生）：
- S5：新增 test-cppcheck 钩子（仅 warning，排除模拟器桩）。
- S4：新增 scripts/check_test_traceability.py（默认仅告警）。
- 待核实项 TEST_SUITE_SELECTED 实机核实 = 死代码（无使用点）；RTC 套件实际正常执行，
  真缺口 = 缺套件级汇总行 → sd2506_test_task.c 补 === RTC Tests: N/M PASSED === 并
  修正 Phase 级汇总累计问题；test_config.h 补齐 RTC 并注释"当前无引用"。

验证：产品 @build 0/0；pre-commit --all-files 17/17 Passed；
run_all_suites.py --suites RTC → PASS。
文档：实机测试实施指南 / SD2506_Test_Guide / 待处理内容 / 测试与架构改进建议 同步。

test/board/net_latency_test.c

@@ -233,8 +233,6 @@ uint8_t lat_probe_armed(void)
 
 void lat_probe_arm(const char *seg, uint32_t max_n, uint32_t spike_th_us)
 {
-    uint32_t i;
-
     if (max_n > (uint32_t)LAT_MAX_SAMPLES) {
         max_n = (uint32_t)LAT_MAX_SAMPLES;
     }
@@ -245,13 +243,19 @@ void lat_probe_arm(const char *seg, uint32_t max_n, uint32_t spike_th_us)
     s_probe_mx = 0U;
     s_probe_spike_th = spike_th_us;
     s_probe_armed = 0U;   /* 最后置位：arm 完成前 netTask 不写入 */
-    for (i = 0U; i < sizeof(s_probe_seg) - 1U; i++) {
-        s_probe_seg[i] = seg[i];
-        if (s_probe_seg[i] == '\0') {
-            break;
+    /* 有界拷贝：先取源串实际长度（全部调用点均为字符串字面量），再夹到目标容量
+     * 以内。原实现"按目标容量逐字节读源 + 遇 '\0' break"虽对字面量安全，但
+     * cppcheck 无法证明源串提前终止 → 报 arrayIndexOutOfBounds（S5，2026-10-03）；
+     * 改为 strlen+memcpy 后既有界又可证。 */
+    {
+        size_t n = strlen(seg);
+
+        if (n > sizeof(s_probe_seg) - 1U) {
+            n = sizeof(s_probe_seg) - 1U;
         }
+        memcpy(s_probe_seg, seg, n);
+        s_probe_seg[n] = '\0';
     }
-    s_probe_seg[i] = '\0';
     s_probe_armed = 1U;
 }
 

test/board/sd2506_test_task.c

@@ -223,14 +223,31 @@ void sd2506_test_run(void)
     }
 #endif
 
-    memset(&g_sd2506_test_stats, 0, sizeof(g_sd2506_test_stats));
+    /* 套件级累计：每个 Phase 进入前自清零，阶段结束后把本阶段结果累加进来。
+     * 目的有二：
+     *   1) 各 Phase 的 `=== Phase N ... ===` 汇总行只反映"本阶段"的断言数，
+     *      不再出现"Phase 2 显示的是含 Phase 1 的累计值"这种易误读输出；
+     *   2) 末尾输出套件级 `=== RTC Tests: N/M PASSED (failed=0) ===` 汇总行——
+     *      它是 run_all_suites.py --require-suite-summary 的判定标记
+     *      （见 test_common.h / docs/测试说明/测试开发标准流程.md §3.2）。 */
+    uint16_t suite_total  = 0U;
+    uint16_t suite_passed = 0U;
+    uint16_t suite_failed = 0U;
 
 #ifdef ENABLE_RTC_BASIC_TESTS
+    memset(&g_sd2506_test_stats, 0, sizeof(g_sd2506_test_stats));
     sd2506_phase_basic();
+    suite_total  += g_sd2506_test_stats.total;
+    suite_passed += g_sd2506_test_stats.passed;
+    suite_failed += g_sd2506_test_stats.failed;
 #endif
 
 #ifdef ENABLE_RTC_API_TESTS
+    memset(&g_sd2506_test_stats, 0, sizeof(g_sd2506_test_stats));
     sd2506_phase_api();
+    suite_total  += g_sd2506_test_stats.total;
+    suite_passed += g_sd2506_test_stats.passed;
+    suite_failed += g_sd2506_test_stats.failed;
 #endif
 
 #ifdef ENABLE_DESTRUCTIVE_TESTS
@@ -241,6 +258,13 @@ void sd2506_test_run(void)
     }
 #endif
 
+    /* 套件级汇总行：名称固定 "RTC Tests"，与 run_all_suites.py 的
+     * --require-suite-summary 约定一致。复用公共报告宏，保证格式统一。 */
+    g_sd2506_test_stats.total  = suite_total;
+    g_sd2506_test_stats.passed = suite_passed;
+    g_sd2506_test_stats.failed = suite_failed;
+    SD2506_TEST_REPORT("RTC Tests");
+
     DBG_INFO("SD2506 test suite done");
     for (;;) {
         osDelay(1000);

test/board/test_config.h

@@ -46,7 +46,14 @@ extern "C" {
 #error "测试套件互斥：一次构建只能启用一个 TEST_SUITE_*"
 #endif
 
-#if defined(TEST_SUITE_CH395F) || defined(TEST_SUITE_STORAGE) || defined(TEST_SUITE_GD5F)
+/* 派生标记：当前**仅作语义标记，全仓无任何代码引用**（2026-10-03 实机核实：
+ * grep 全仓仅本文件有定义，无使用点）。testTask 的创建与调度见 Src/freertos.c
+ * （无条件创建 testTask）+ test/board/test_config.c 的 start_test_task()，后者**直接
+ * 按 TEST_SUITE_RTC 等宏分支**，与本标记无关——故"RTC 构建下 testTask 不被创建"
+ * 的旧疑点不成立（实测 RTC 套件正常执行）。
+ * 4 个套件（含 RTC）在此补齐：若将来真引入"测试构建下 defaultTask 空闲"等分支而复用
+ * 本标记，可避免重演"漏 RTC"的隐患。详见 docs/测试说明/实机测试实施指南.md §8.3。 */
+#if defined(TEST_SUITE_CH395F) || defined(TEST_SUITE_STORAGE) || defined(TEST_SUITE_GD5F) || defined(TEST_SUITE_RTC)
 #define TEST_SUITE_SELECTED
 #endif
 

test/run_all_suites.py

@@ -57,18 +57,21 @@ BUILD_BAT = REPO_ROOT / "MDK-ARM" / "build.bat"
 DOWNLOAD_BAT = REPO_ROOT / "MDK-ARM" / "download.bat"
 RUN_BOOT = REPO_ROOT / "test" / "host" / "run_boot_test.py"
 
-# 套件 -> (宏名, verify_log 需要的汇总行名称, 该套件的 Required 标记)
-# 汇总行名称与套件 `XXX_TEST_REPORT("...")` 里的字符串一致（见各模块 Test_Guide）
+# 套件 -> (宏名, verify_log 需要的汇总行名称, 该套件的 Required 标记, --forbidden 覆盖)
+# 汇总行名称与套件 `XXX_TEST_REPORT("...")` 里的字符串一致（见各模块 Test_Guide）。
+# forbidden 覆盖：套件含"预期 [ERR]"的守卫负路径时须覆盖（空 = 用默认 `HardFault;assert;[ERR]`）。
+#   GD5F：TC-GD5F-704 故意用非 DMA 可达缓冲触发 `[ERR][NAND] RX DMA buffer not DMA-reachable`
+#         回落轮询（用例 PASS）——按 verify_log.py 的说明去掉 [ERR]，保留 HardFault/assert。
 SUITES = {
-    "CH395F":  ("TEST_SUITE_CH395F", None,            ""),
-    "STORAGE": ("TEST_SUITE_STORAGE", "Storage Tests", "=== Storage Tests:"),
-    "GD5F":    ("TEST_SUITE_GD5F",    "GD5F2GQ5UE Tests", "=== GD5F2GQ5UE Tests:"),
-    "RTC":     ("TEST_SUITE_RTC",     "RTC Tests",     "=== RTC Tests:"),
+    "CH395F":  ("TEST_SUITE_CH395F", None,            "", ""),
+    "STORAGE": ("TEST_SUITE_STORAGE", "Storage Tests", "=== Storage Tests:", ""),
+    "GD5F":    ("TEST_SUITE_GD5F",    "GD5F2GQ5UE Tests", "=== GD5F2GQ5UE Tests:", "HardFault;assert"),
+    "RTC":     ("TEST_SUITE_RTC",     "RTC Tests",     "=== RTC Tests:", ""),
 }
 
 # 套件名 -> 汇总行里的名称可能因模块而异，故上面的 summary 值仅为默认；实际以
 # `--required` 给出的前缀做 Required 匹配，`--require-suite-summary` 做严格解析。
-_ALL_MACROS = [m for m, _, _ in SUITES.values()]
+_ALL_MACROS = [m for m, _, _, _ in SUITES.values()]
 
 
 def _rewrite_config(enable_macro):
@@ -172,7 +175,7 @@ def main(argv=None):
         baseline = CONFIG.read_bytes()
 
         for suite in picked:
-            macro, summary_name, required = SUITES[suite]
+            macro, summary_name, required, forbid = SUITES[suite]
             print("")
             print("################ {} ################".format(suite))
             _rewrite_config(macro)
@@ -209,8 +212,9 @@ def main(argv=None):
                 cmd += ["--required", required]
             if summary_name:
                 cmd += ["--require-suite-summary", summary_name]
-            # 套件构建预期可能出现 [ERR]（守卫负路径），放宽 Forbidden 至硬错误
-            cmd += ["--forbidden", "HardFault;assert;[ERR]"]
+            # 套件构建预期可能出现 [ERR]（守卫负路径）——由套件自身的 forbid 覆盖决定
+            # （空 = 默认 HardFault;assert;[ERR]；GD5F = HardFault;assert，见 SUITES 注释）
+            cmd += ["--forbidden", forbid or "HardFault;assert;[ERR]"]
             rc, out = _run(cmd, timeout=args.flash_timeout + 120)
             print("\n".join(out.strip().splitlines()[-8:]))
             results[suite] = "PASS" if rc == 0 else "FAIL"