针对新项目，更新Readme

src/Drv/pages/menu/def.h

@@ -87,8 +87,8 @@ typedef struct
  *   菜单项/菜单框的布局计算结果，供 View 层绘制与反显定位使用。
  *
  * 字段说明:
- *   wPos   - 当前项在本层中的行号（从 0 开始）
+ *   wPos   - 当前项在本层中的 0 基行号
- *   wNum   - 当前层可见项数量
+ *   wNum   - 当前节点拥有的直接子节点总数
  *   wSPosX - 绘制区域左上角 X
  *   wSPosY - 绘制区域左上角 Y
  *   wEPosX - 绘制区域右下角 X
@@ -96,8 +96,8 @@ typedef struct
  * ------------------------------------------------------------------------- */
 typedef struct
 {
-    uint16_t wPos;      /* 当前项在本层中的行号（从 0 开始） */
+    uint16_t wPos;      /* 当前项在本层中的 0 基行号 */
-    uint16_t wNum;
+    uint16_t wNum;      /* 当前节点拥有的直接子节点总数 */
     uint16_t wSPosX;
     uint16_t wSPosY;
     uint16_t wEPosX;

tests/test_p1_menu.c

@@ -78,7 +78,7 @@ int main(void)
     /* ---------------------------------------------------------------------
      * Case 3:
      *   测试 MenuModel_IndexMenuItems / MenuModel_GetMenuMaxDisplayLen
-     *   - 使用真实菜单模型验证序号初始化、子节点数量统计与子菜单宽度统计
+     *   - 使用真实菜单模型验证 0 基序号初始化、子节点数量统计与子菜单宽度统计
      * --------------------------------------------------------------------- */
     first[0] = &menuModel.menuItems[0];
     index[0] = &menuModel.menuItems[0];
@@ -134,7 +134,7 @@ int main(void)
     /* ---------------------------------------------------------------------
      * Case 5.1:
      *   强化测试 MenuModel_IndexMenuItems
-     *   - 覆盖多顶层、多兄弟、跨层回退后的 wPos / wNum 统计
+     *   - 覆盖多顶层、多兄弟、跨层回退后的 0 基 wPos / wNum 统计
      * --------------------------------------------------------------------- */
     memset(customItems2, 0, sizeof(customItems2));
     MenuModel_BuildTree(customItems2, customModelTab2, 7);