测试套件增设破坏性用例总开关（默认只读），GD5F/存储/RTC 破坏性用例改为按需开启

test/test_config.h

@@ -28,6 +28,16 @@ extern "C" {
 //#define TEST_SUITE_GD5F
 //#define TEST_SUITE_RTC
 
+/* === 破坏性测试总开关（默认关闭）===
+ * 破坏性用例会改变设备的**持久状态**，跑一次即有代价（2026-09-21 实测：GD5F 整轮
+ * 破坏性用例跑一次即消耗一个 NAND 块，容量 95248 → 95200，且 TC-STO-04 恢复不回来）：
+ *   - 向 BBT 持久化坏块标记 / 注入坏块（永久减少可用容量）
+ *   - 写、擦 NAND 块（覆盖卷数据）；格式化卷（nand_ftl_format / f_mkfs）
+ *   - FatFS 建文件、写文件、性能压测
+ * 默认关闭：套件只跑**只读与参数校验**类用例，可随时在在用设备上执行。
+ * 仅在**产品首次上电/产线首启**或明确需要时打开；打开跑完建议做一次恢复。 */
+//#define ENABLE_DESTRUCTIVE_TESTS
+
 #if defined(TEST_SUITE_CH395F) + defined(TEST_SUITE_STORAGE) + defined(TEST_SUITE_GD5F) + defined(TEST_SUITE_RTC) > 1
 #error "测试套件互斥：一次构建只能启用一个 TEST_SUITE_*"
 #endif
@@ -47,18 +57,26 @@ extern "C" {
 #endif
 
 #ifdef TEST_SUITE_GD5F
-/* 选中 GD5F 套件时，自动开启 gd5f 测试总开关与全部阶段 */
+/* 选中 GD5F 套件时，自动开启 gd5f 测试总开关；
+ * 只读阶段无条件启用，破坏性阶段（写/擦/格式化/BBT 落盘）受 ENABLE_DESTRUCTIVE_TESTS 门控 */
 #define ENABLE_GD5F_TESTS
-#define ENABLE_GD5F_PHASE1_TESTS
-#define ENABLE_GD5F_PHASE2_TESTS
-#define ENABLE_GD5F_PHASE3_TESTS
-#define ENABLE_GD5F_PHASE4_TESTS
-#define ENABLE_GD5F_PHASE5_TESTS
-#define ENABLE_GD5F_PHASE6_TESTS
-#define ENABLE_GD5F_PHASE7_TESTS
-#define ENABLE_GD5F_PHASE8_TESTS
-#define ENABLE_GD5F_PHASE9_TESTS
-#define ENABLE_GD5F_PHASE10_TESTS
+
+/* --- 只读阶段：随时可跑，不改设备状态 --- */
+#define ENABLE_GD5F_PHASE1_TESTS     /* init / read_id / reset */
+#define ENABLE_GD5F_PHASE2_TESTS     /* BBT 读取与 RAM 内标记（206/207 落盘另受门控） */
+#define ENABLE_GD5F_PHASE7_TESTS     /* DMA 边界与守卫（701~703/705 写擦受门控；704 只读，日常回归亦跑） */
+#define ENABLE_GD5F_PHASE10_TESTS    /* 越界与 size=0 参数校验（1003/1004 写入另受门控） */
+
+#ifdef ENABLE_DESTRUCTIVE_TESTS
+/* --- 破坏性阶段：写/擦页与块、格式化、FatFS 写入 --- */
+#define ENABLE_GD5F_PHASE3_TESTS     /* 页/跨页/多页读写 */
+#define ENABLE_GD5F_PHASE4_TESTS     /* 块擦除 */
+#define ENABLE_GD5F_PHASE5_TESTS     /* ECC 写读 */
+#define ENABLE_GD5F_PHASE6_TESTS     /* SPI 原语（块擦除 + 编程） */
+#define ENABLE_GD5F_PHASE8_TESTS     /* FTL init + nand_ftl_format（格式化清卷） */
+#define ENABLE_GD5F_PHASE9_TESTS     /* FatFS 挂载 + 写文件 */
+#endif
+
 #include "gd5f_test.h"
 #define TEST_SUITE_NAME "GD5F"
 #endif