fix(ui/wave): 回放页枚举扫描失败不再钉「无段」缓存并补 FR 码留痕

真机回放页恒显「无录波段」而 FTP 六段全在盘上（登记簿同名条目，
见 #38 §5）。本提交按执行手册 §3 步骤 1 落两件事：

- ui_task_wave_scan：f_opendir/f_readdir 失败本轮返 -1（「本轮无完整
  事实」语义），不再无条件钉 s_wave_scanned——原实现把卷忙/FR_DENIED
  一类失败钉成「0 段」假空态，直到下一次 manual_req 才重试；失败不
  钉表后下一次进页/按键自然重试，与 soe_store 读者同纪律。
- FR_NO_PATH（从未录过波）仍归「0 段」并钉表，设计原口径不动。
- 失败分支补带 FR 码的留痕（opendir/readdir 各一条 DBG_ERROR），
  「FR_OK 但零条目」加一条 DBG_INFO——根因判读表见执行手册 §3，
  板级远程开一次回放页即可定性，不必猜。
- DBG_TAG 定义 + dbg_log.h 包含上收到包含区（原在 s_wave_ops 之后的
  文件中部；同标签同宏，不构成行为改动，本文件既有留痕照常）。
- 体积/RAM 同码凭证随 /keil-build（0 错误 0 警告）同批刷新：
  Code +8 B，RAM 不变；台账受管区水位按门禁要求随本次 .map 同步
  （台账此前落后 master 既有 flash 漂移 +320 B，--write 一并拉齐）。

Refs #38

App/task/ui_task.c

@@ -32,6 +32,13 @@
  *                          /clear_state 直通）并在 ui_menu_init 之前注入；记录
  *                          reader 的 2 条 if 链改成 7 条映射表 s_log_map，并加
  *                          编译期守卫把 UI_W_REC_LOG_* == syslog_id_t 枚举序钉死
+ *   v1.6  2026-11-02  DTU 项目组  修复「回放页段表枚举恒空」第一幕（登记簿同名
+ *                          条目 + docs/测试说明/专项验证/故障录波板级到场轮执行手册.md §3）：
+ *                          ui_task_wave_scan 失败不再无条件钉 s_wave_scanned——
+ *                          opendir/readdir 失败本轮返 -1（卷忙语义），下一次进页/
+ *                          按键自然重试；失败分支与「FR_OK 零条目」补带 FR 码留痕
+ *                          （DBG_TAG [UIWAVE]）供板级远程定性根因。FR_NO_PATH
+ *                          （从未录过波）归 0 段并钉表的设计原口径不动。
  */
 #include "ui_task.h"
 
@@ -73,6 +80,14 @@
 #include "task_prof.h"        /* P2 常开探针：循环周期 / 工作耗时 / 推流往返 */
 #include "sb_link.h"         /* 屏板链路：帧 B 组帧 / 按键出队 / 统计与离线判定（批 2） */
 
+/* 枚举留痕（v1.6，第一幕埋点）：dbg_log.h 原在文件后段（s_wave_ops 之后）才
+ * 被包含，随本波把 DBG_TAG 定义 + 包含一并上收到包含区（原后段两处删除，
+ * 同标签同宏，不构成行为改动）；本波只在原先静默返回的黑洞处补锚点，
+ * 不新增重复日志（DBG_* 每条调用点约 90B Flash + 行缓冲栈）。
+ * 留痕行以「ui wave scan」正文前缀区分来源。 */
+#define DBG_TAG "[UI_TASK]"
+#include "dbg_log.h"
+
 /*
  * 函数功能：待机屏底部时钟提供回调（平台差异：MCU = sys_clock_get_str）
  * 入口参数：buf - 时间串输出缓冲  char *
@@ -421,27 +436,46 @@ static uint8_t  s_wave_buf[256u];           /* 读窗：数据区流式 256B/次
 /*
  * 函数功能：重扫 /wave 目录，把现存段号收集成升序表
  * 入口参数：无
- * 返回值：0 - 扫描完成（条数见 s_wave_cnt）；-1 - 卷忙本轮跳过  int
+ * 返回值：0 - 扫描完成（条数见 s_wave_cnt）；-1 - 本轮无完整事实（卷忙，或
+ *         f_opendir/f_readdir 失败），不钉表，下一次取数自然重试  int
  * 限定条件：uiTask；一次 f_opendir + 有界 f_readdir，全程锁内
- * 函数说明：目录不存在（从未录过波）与目录空都归「0 段」，不是错误；
+ * 函数说明：目录不存在（FR_NO_PATH，从未录过波）与目录空都归「0 段」并钉表，
+ *           不是错误（设计原口径）；其余 f_opendir/f_readdir 失败一律不钉表
+ *           （v1.6：原实现失败也无条件置 s_wave_scanned=1，卷忙 / FR_DENIED
+ *           一类失败被钉成「0 段」假空态直到下一次 manual_req，登记簿
+ *           「回放页段表枚举恒空」处置方向 = 失败不钉表、下键重试，与
+ *           soe_store 读者同纪律）。失败留痕带 FR 码，板级判读表（FR_DENIED
+ *           → 锁纪律；FR_NOT_READY → 挂载；FR_OK 但零条目 → readdir 与卷状态
+ *           交互）见 docs/测试说明/专项验证/故障录波板级到场轮执行手册.md §3。
  *           名字不合形态的文件（E_NAME）静默跳过——那是别的道写进来的
  *           东西，回放页不替它背书也不报警
  */
 static int ui_task_wave_scan(void) {
     static DIR dir;              /* static：同 FIL 理由，压栈深 */
     FILINFO finfo;
+    FRESULT fr;
+    FRESULT rr = FR_OK;
     uint8_t idx;
     uint8_t i;
+    uint8_t full;                /* 1 = 本轮拿到完整事实，允许钉表 */
 
     if (vol_lock_wait(0u) == 0u) {
         return -1;
     }
     s_wave_cnt = 0u;
-    if (f_opendir(&dir, WAVE_ST_DIR) == FR_OK) {
+    full = 0u;
+    fr = f_opendir(&dir, WAVE_ST_DIR);
+    if (fr == FR_OK) {
+        full = 1u;
         for (;;) {
-            if (f_readdir(&dir, &finfo) != FR_OK || finfo.fname[0] == '\0') {
+            rr = f_readdir(&dir, &finfo);
+            if (rr != FR_OK) {
+                full = 0u;       /* 半截表不钉：本轮作废重来 */
                 break;
             }
+            if (finfo.fname[0] == '\0') {
+                break;           /* 目录正常走完 */
+            }
             if (finfo.fattrib & AM_DIR) {
                 continue;
             }
@@ -451,9 +485,25 @@ static int ui_task_wave_scan(void) {
                 }
             }
         }
-        f_closedir(&dir);
+        (void)f_closedir(&dir);
+        if (full == 0u) {
+            DBG_ERROR("ui wave scan readdir fail fr=%d got=%u", (int)rr,
+                      (unsigned)s_wave_cnt);
+        }
+    } else if (fr == FR_NO_PATH) {
+        full = 1u;               /* 从未录过波 = 0 段，完整事实 */
+    } else {
+        DBG_ERROR("ui wave scan opendir fail fr=%d", (int)fr);
     }
     vol_lock_release();
+    if (full == 0u) {
+        s_wave_cnt = 0u;         /* 半截计数不外泄：本轮按「无段」显示 */
+        return -1;
+    }
+    if (s_wave_cnt == 0u) {
+        /* 判读表第三条（FR_OK 但零条目）：钉盘级证据，供板级远程定性 */
+        DBG_INFO("ui wave scan done: dir ok, 0 seg entries");
+    }
     /* 插入排序：条数上限 100，不引 qsort 的 stdlib 依赖 */
     for (i = 1u; i < s_wave_cnt; i++) {
         uint8_t j;
@@ -839,9 +889,6 @@ static void ui_task_sink_beat(void) {
     task_wd_beat(TASK_WD_UI);
 }
 
-#define DBG_TAG "[UI_TASK]"
-#include "dbg_log.h"
-
 /*
  * 函数功能：等待网络就绪事件
  * 入口参数：无