feat: 实现事件驱动应用框架，支持前台/后台分离、事件优先级和CPU占用控制

.xagent/graph.json

@@ -71,6 +71,20 @@
       ],
       "lock": null
     },
+    "Docs/50_module-breakdown/mod-event.md": {
+      "depends_on": [
+        "Docs/30_architecture/main.md",
+        "Docs/40_ui-design/main.md"
+      ],
+      "lock": null
+    },
+    "Docs/50_module-breakdown/mod-app.md": {
+      "depends_on": [
+        "Docs/30_architecture/main.md",
+        "Docs/40_ui-design/main.md"
+      ],
+      "lock": null
+    },
     "Docs/60_coding/mod-sys.md": {
       "depends_on": [
         "Docs/50_module-breakdown/mod-sys.md"
@@ -113,13 +127,27 @@
       ],
       "lock": null
     },
+    "Docs/60_coding/mod-event.md": {
+      "depends_on": [
+        "Docs/50_module-breakdown/mod-event.md"
+      ],
+      "lock": null
+    },
+    "Docs/60_coding/mod-app.md": {
+      "depends_on": [
+        "Docs/50_module-breakdown/mod-app.md"
+      ],
+      "lock": null
+    },
     "App/main.c": {
       "depends_on": [
         "Docs/60_coding/mod-sys.md",
         "Docs/60_coding/mod-key.md",
         "Docs/60_coding/mod-power.md",
         "Docs/60_coding/mod-led.md",
-        "Docs/60_coding/mod-motor.md"
+        "Docs/60_coding/mod-motor.md",
+        "Docs/60_coding/mod-event.md",
+        "Docs/60_coding/mod-app.md"
       ],
       "lock": null
     },

App/appmgr.c

@@ -0,0 +1,262 @@
+#include "appmgr.h"
+#include "../Drivers/lcd.h"
+
+/* =========================================================================
+ * 应用管理器内部变量
+ * ========================================================================= */
+
+// 应用注册表：存储所有已注册的应用
+static WristbandApp app_registry[APP_ID_MAX];
+
+// 当前活跃的前台应用指针
+static WristbandApp *active_app = NULL;
+
+// 默认应用（时钟）
+#define DEFAULT_APP_ID APP_ID_CLOCK
+
+/* =========================================================================
+ * 应用生命周期辅助函数
+ * ========================================================================= */
+
+static void AppManager_ExecuteOnStart(WristbandApp *app)
+{
+    if (app != NULL && app->OnStart != NULL)
+    {
+        app->OnStart();
+        app->is_active = 1;
+        app->is_running = 1;
+    }
+}
+
+static void AppManager_ExecuteOnClose(WristbandApp *app)
+{
+    if (app != NULL && app->onClose != NULL)
+    {
+        app->onClose();
+        app->is_active = 0;
+        app->is_running = 0;
+    }
+}
+
+static void AppManager_ExecuteOnRun(WristbandApp *app)
+{
+    if (app != NULL && app->onRun != NULL && app->is_running)
+    {
+        // CPU占用控制：记录开始时间
+        u16 start_tick = ms_tick;
+        
+        // 执行应用的onRun回调
+        app->onRun();
+        
+        // 检测执行时间是否超限
+        u16 elapsed_ticks = ms_tick - start_tick;
+        if (elapsed_ticks > APP_ONRUN_MAX_TICKS)
+        {
+            // 应用执行时间过长，强制标记为非活跃
+            // 但不直接关闭，允许应用在下一次循环中恢复
+            app->is_running = 0;
+        }
+    }
+}
+
+static EventResult AppManager_ExecuteOnEvent(WristbandApp *app, SystemEvent evt)
+{
+    if (app != NULL && app->onEvent != NULL)
+    {
+        return app->onEvent(evt);
+    }
+    return EVENT_IGNORED;
+}
+
+/* =========================================================================
+ * 应用管理器核心实现
+ * ========================================================================= */
+
+void AppManager_Init(void)
+{
+    u8 i;
+    
+    // 初始化所有应用描述符
+    for (i = 0; i < APP_ID_MAX; i++)
+    {
+        app_registry[i].app_id = (AppID)i;
+        app_registry[i].app_type = APP_TYPE_FOREGROUND;
+        app_registry[i].app_name = "UNREGISTERED";
+        app_registry[i].OnStart = NULL;
+        app_registry[i].onRun = NULL;
+        app_registry[i].onClose = NULL;
+        app_registry[i].onEvent = NULL;
+        app_registry[i].is_active = 0;
+        app_registry[i].is_running = 0;
+    }
+    
+    // 默认启动时钟应用
+    active_app = &app_registry[DEFAULT_APP_ID];
+    AppManager_ExecuteOnStart(active_app);
+}
+
+void AppManager_StartApp(AppID app_id)
+{
+    // 参数有效性检查
+    if (app_id >= APP_ID_MAX)
+    {
+        return;
+    }
+    
+    // 获取目标应用指针
+    WristbandApp *target_app = &app_registry[app_id];
+    
+    // 目标应用必须是前台应用
+    if (target_app->app_type != APP_TYPE_FOREGROUND)
+    {
+        return;
+    }
+    
+    // 目标应用必须已注册（有OnStart回调）
+    if (target_app->OnStart == NULL)
+    {
+        return;
+    }
+    
+    // 如果目标应用已经是活跃应用，直接返回
+    if (active_app == target_app)
+    {
+        return;
+    }
+    
+    // 关闭当前活跃应用
+    if (active_app != NULL)
+    {
+        AppManager_ExecuteOnClose(active_app);
+    }
+    
+    // 切换到新应用
+    active_app = target_app;
+    
+    // 启动新应用
+    AppManager_ExecuteOnStart(active_app);
+}
+
+void AppManager_CloseApp(void)
+{
+    // 关闭当前活跃应用
+    if (active_app != NULL)
+    {
+        AppManager_ExecuteOnClose(active_app);
+        active_app = NULL;
+    }
+    
+    // 启动默认应用（时钟）
+    active_app = &app_registry[DEFAULT_APP_ID];
+    AppManager_ExecuteOnStart(active_app);
+}
+
+AppID AppManager_GetActiveAppID(void)
+{
+    if (active_app != NULL)
+    {
+        return active_app->app_id;
+    }
+    return DEFAULT_APP_ID;
+}
+
+void AppManager_DispatchEvent(SystemEvent evt)
+{
+    EventResult result;
+    
+    // 步骤1：优先分发给当前活跃的前台应用
+    if (active_app != NULL && active_app->is_active)
+    {
+        result = AppManager_ExecuteOnEvent(active_app, evt);
+        
+        // 前台应用已处理，无需继续分发
+        if (result == EVENT_HANDLED)
+        {
+            return;
+        }
+    }
+    
+    // 步骤2：前台未处理，分发给所有后台应用
+    // 遍历应用注册表，找到所有后台应用
+    u8 i;
+    for (i = 0; i < APP_ID_MAX; i++)
+    {
+        WristbandApp *bg_app = &app_registry[i];
+        
+        // 跳过前台应用和未注册应用
+        if (bg_app->app_type != APP_TYPE_BACKGROUND || 
+            bg_app->onEvent == NULL ||
+            !bg_app->is_running)
+        {
+            continue;
+        }
+        
+        // 调用后台应用的事件处理函数
+        result = AppManager_ExecuteOnEvent(bg_app, evt);
+        
+        // 如果后台应用处理了事件，停止继续分发
+        if (result == EVENT_HANDLED)
+        {
+            return;
+        }
+    }
+    
+    // 步骤3：所有应用都未处理，事件被丢弃
+    // 可以在这里添加日志记录（如果需要）
+}
+
+void AppManager_RunActiveApp(void)
+{
+    // 执行当前活跃应用的onRun回调（带CPU占用控制）
+    if (active_app != NULL && active_app->is_active)
+    {
+        AppManager_ExecuteOnRun(active_app);
+    }
+}
+
+void AppManager_BroadcastToBackground(SystemEvent evt)
+{
+    // 广播事件给所有后台应用
+    u8 i;
+    for (i = 0; i < APP_ID_MAX; i++)
+    {
+        WristbandApp *bg_app = &app_registry[i];
+        
+        // 仅发送给后台应用
+        if (bg_app->app_type == APP_TYPE_BACKGROUND && 
+            bg_app->onEvent != NULL &&
+            bg_app->is_running)
+        {
+            AppManager_ExecuteOnEvent(bg_app, evt);
+        }
+    }
+}
+
+/* =========================================================================
+ * 应用注册接口（供各应用模块调用）
+ * ========================================================================= */
+
+void AppManager_RegisterApp(AppID app_id, AppType app_type, char *app_name,
+                            AppStartFunc on_start, AppRunFunc on_run,
+                            AppCloseFunc on_close, AppEventFunc on_event)
+{
+    if (app_id >= APP_ID_MAX)
+    {
+        return;
+    }
+    
+    WristbandApp *app = &app_registry[app_id];
+    
+    app->app_type = app_type;
+    app->app_name = app_name;
+    app->OnStart = on_start;
+    app->onRun = on_run;
+    app->onClose = on_close;
+    app->onEvent = on_event;
+    
+    // 后台应用默认处于运行状态
+    if (app_type == APP_TYPE_BACKGROUND)
+    {
+        app->is_running = 1;
+    }
+}

App/appmgr.h

@@ -0,0 +1,33 @@
+#ifndef __APPMGR_H__
+#define __APPMGR_H__
+
+#include "config.h"
+
+/* =========================================================================
+ * 应用管理器接口声明
+ * ========================================================================= */
+
+// 初始化应用管理器，注册所有应用
+void AppManager_Init(void);
+
+// 启动指定应用（切换前台）
+// 参数：app_id - 目标应用ID
+void AppManager_StartApp(AppID app_id);
+
+// 关闭当前前台应用，回退到默认应用（时钟）
+void AppManager_CloseApp(void);
+
+// 获取当前活跃的前台应用ID
+AppID AppManager_GetActiveAppID(void);
+
+// 事件分发函数：将事件分发给前台/后台应用
+// 分发逻辑：前台应用优先处理 -> 后台应用兜底处理 -> 未处理则丢弃
+void AppManager_DispatchEvent(SystemEvent evt);
+
+// 运行当前活跃应用的onRun回调（带CPU占用控制）
+void AppManager_RunActiveApp(void);
+
+// 广播事件给所有后台应用（用于系统级事件）
+void AppManager_BroadcastToBackground(SystemEvent evt);
+
+#endif

App/apps.c

@@ -0,0 +1,497 @@
+#include "config.h"
+#include "appmgr.h"
+#include "../Drivers/lcd.h"
+#include "../Drivers/rf.h"
+
+/* =========================================================================
+ * 全局变量声明（从 main.c 迁移）
+ * ========================================================================= */
+
+extern volatile u16 ms_tick;
+extern volatile u32 pair_timeout_ms;
+extern volatile u16 alarm_timer_ms;
+extern volatile bit alarm_flash_flag;
+
+extern SystemState current_state;
+extern u8 current_hour, current_min;
+extern u8 menu_select;
+extern u32 captured_addr;
+extern u8 captured_type;
+extern u8 alarm_sensor_slot;
+
+extern Sensor_Slot xdata sensor_list[16];
+
+extern sbit MOTOR;
+extern bit LED_R, LED_G, LED_B;
+extern bit rgb_test_mode;
+
+extern char *code default_names[5];
+extern u8 code default_zones[5];
+extern char *code menu_items[5];
+
+extern void Delay_ms(u16 ms);
+extern void Format_Sensor_Name(u8 slot, char *buf);
+extern void Uart_SendString(char *s);
+extern void Uart_SendHex8(u8 val);
+
+/* =========================================================================
+ * 应用私有状态变量
+ * ========================================================================= */
+
+// 时钟应用状态
+static bit clock_redraw_flag = 0;
+
+// 配对应用状态
+static u8 pair_menu_select = 0;
+static u8 pair_state = 0; // 0: MENU, 1: WAIT, 2: CONFIRM, 3: SUCCESS, 4: FAIL
+
+// 报警应用状态
+static u8 alarm_last_frame = 99;
+
+// SOS应用状态
+static u8 sos_last_tx = 99;
+
+/* =========================================================================
+ * 时钟应用实现
+ * ========================================================================= */
+
+static void ClockApp_OnStart(void)
+{
+    Uart_SendString("[APP] ClockApp Started\r\n");
+    current_state = STATE_NORMAL;
+    clock_redraw_flag = 1;
+}
+
+static void ClockApp_onRun(void)
+{
+    // 分钟变化时重绘时钟
+    if (clock_redraw_flag)
+    {
+        clock_redraw_flag = 0;
+        UI_ShowClockPage(current_state, current_hour, current_min);
+    }
+    
+    // 监听射频信号（后台监测）
+    {
+        u32 rx_addr;
+        u8 rx_data;
+        if (EV1527_Decode(&rx_addr, &rx_data))
+        {
+            u8 slot;
+            if (Check_Sensor_ID(rx_addr, &slot))
+            {
+                u32 slot_addr = ((u32)sensor_list[slot].addr[0] << 16) |
+                                 ((u32)sensor_list[slot].addr[1] << 8) |
+                                 sensor_list[slot].addr[2];
+                u8 sensor_type = slot_addr & 0x0F;
+                
+                if (sensor_type < 5)
+                {
+                    u8 zone = default_zones[sensor_type];
+                    if (zone == 0 || current_state == STATE_ARMED)
+                    {
+                        captured_addr = rx_addr;
+                        alarm_sensor_slot = slot;
+                        AppManager_StartApp(APP_ID_ALARM);
+                    }
+                }
+            }
+        }
+    }
+}
+
+static void ClockApp_onClose(void)
+{
+    Uart_SendString("[APP] ClockApp Closed\r\n");
+}
+
+static EventResult ClockApp_onEvent(SystemEvent evt)
+{
+    // 处理定时器发送的时钟更新事件（priority为LOW，key_event为NONE）
+    if (evt.key_event == KEY_EVENT_NONE && evt.priority == EVENT_PRIORITY_LOW)
+    {
+        // 从extra_data中提取时间信息
+        u8 hour = (u8)(evt.extra_data >> 8);
+        u8 min = (u8)(evt.extra_data & 0xFF);
+        
+        // 更新时钟显示
+        UI_ShowClockPage(current_state, hour, min);
+        return EVENT_HANDLED;
+    }
+    
+    switch (evt.key_event)
+    {
+        case KEY_EVENT_UP_DOWN_COMB:
+            // 组合键进入菜单
+            AppManager_StartApp(APP_ID_MENU);
+            return EVENT_HANDLED;
+            
+        case KEY_EVENT_SOS_CLICK:
+            // 短按SOS进入求救模式
+            AppManager_StartApp(APP_ID_SOS);
+            return EVENT_HANDLED;
+            
+        case KEY_EVENT_SOS_LONG:
+            // 长按SOS绑定IPC
+            UI_ShowBindingPage();
+            RF_SetMode(2);
+            EV1527_Transmit(CLONED_ADDR, 0x01);
+            RF_SetMode(0);
+            Delay_ms(2000);
+            AppManager_StartApp(APP_ID_CLOCK);
+            return EVENT_HANDLED;
+            
+        default:
+            return EVENT_IGNORED;
+    }
+}
+
+/* =========================================================================
+ * 菜单应用实现
+ * ========================================================================= */
+
+static void MenuApp_OnStart(void)
+{
+    Uart_SendString("[APP] MenuApp Started\r\n");
+    pair_menu_select = 0;
+    RF_SetMode(0);
+    UI_ShowPairMenuPage(pair_menu_select);
+}
+
+static void MenuApp_onRun(void)
+{
+    // 菜单应用无持续运行逻辑
+}
+
+static void MenuApp_onClose(void)
+{
+    Uart_SendString("[APP] MenuApp Closed\r\n");
+    RF_SetMode(1);
+}
+
+static EventResult MenuApp_onEvent(SystemEvent evt)
+{
+    switch (evt.key_event)
+    {
+        case KEY_EVENT_UP_CLICK:
+            if (pair_menu_select > 0)
+            {
+                pair_menu_select--;
+                UI_ShowPairMenuPage(pair_menu_select);
+            }
+            return EVENT_HANDLED;
+            
+        case KEY_EVENT_DOWN_CLICK:
+            if (pair_menu_select < 4)
+            {
+                pair_menu_select++;
+                UI_ShowPairMenuPage(pair_menu_select);
+            }
+            return EVENT_HANDLED;
+            
+        case KEY_EVENT_SOS_CLICK:
+            // 确认进入配对等待
+            MOTOR = 1;
+            Delay_ms(100);
+            MOTOR = 0;
+            
+            AppManager_StartApp(APP_ID_PAIR);
+            return EVENT_HANDLED;
+            
+        case KEY_EVENT_DOWN_LONG:
+            // 长按返回时钟
+            AppManager_CloseApp();
+            return EVENT_HANDLED;
+            
+        default:
+            return EVENT_IGNORED;
+    }
+}
+
+/* =========================================================================
+ * 配对应用实现
+ * ========================================================================= */
+
+static void PairApp_OnStart(void)
+{
+    Uart_SendString("[APP] PairApp Started\r\n");
+    pair_state = 1; // 进入等待状态
+    pair_timeout_ms = 0;
+    captured_type = pair_menu_select;
+    
+    RF_SetMode(1);
+    LCD_Clear(COLOR_BLACK);
+    LCD_ShowStringCentered(135, "RECHERCHE...", COLOR_WHITE, COLOR_BLACK);
+    LCD_ShowStringCentered(160, "DECLENCH. CAPT", COLOR_CYAN, COLOR_BLACK);
+    UI_ShowPairWaitPage(0);
+}
+
+static void PairApp_onRun(void)
+{
+    switch (pair_state)
+    {
+        case 1: // WAIT状态
+        {
+            // 雷达动画
+            u8 frame = (u8)((ms_tick / 250) % 3);
+            static u8 last_frame = 99;
+            if (frame != last_frame)
+            {
+                last_frame = frame;
+                UI_ShowPairWaitPage(frame);
+            }
+            
+            // 监听射频信号
+            u32 rx_addr;
+            u8 rx_data;
+            if (EV1527_Decode(&rx_addr, &rx_data))
+            {
+                captured_addr = rx_addr;
+                pair_state = 2; // 进入确认状态
+                
+                RF_SetMode(0);
+                UI_ShowPairConfirmPage(captured_addr);
+            }
+            
+            // 超时检测
+            if (pair_timeout_ms >= 30000UL)
+            {
+                pair_timeout_ms = 0;
+                UI_ShowPairFailPage(1);
+                Delay_ms(2500);
+                AppManager_CloseApp();
+            }
+            break;
+        }
+        
+        case 2: // CONFIRM状态
+            // 等待用户操作
+            break;
+            
+        case 3: // SUCCESS状态
+            // 成功动画已在事件处理中完成
+            break;
+            
+        default:
+            break;
+    }
+}
+
+static void PairApp_onClose(void)
+{
+    Uart_SendString("[APP] PairApp Closed\r\n");
+    RF_SetMode(1);
+    pair_state = 0;
+}
+
+static EventResult PairApp_onEvent(SystemEvent evt)
+{
+    switch (pair_state)
+    {
+        case 1: // WAIT状态
+        {
+            if (evt.key_event == KEY_EVENT_DOWN_LONG)
+            {
+                AppManager_CloseApp();
+                return EVENT_HANDLED;
+            }
+            break;
+        }
+        
+        case 2: // CONFIRM状态
+        {
+            if (evt.key_event == KEY_EVENT_SOS_LONG)
+            {
+                // 保存对码
+                Add_Sensor(captured_addr, captured_type);
+                
+                pair_state = 3; // 进入成功状态
+                UI_ShowPairSuccessPage(captured_addr);
+                
+                // 物理反馈
+                MOTOR = 1;
+                LED_G = 0;
+                LED_R = 1;
+                LED_B = 1;
+                Delay_ms(400);
+                MOTOR = 0;
+                
+                Delay_ms(1600);
+                LED_G = 1;
+                
+                Delay_ms(500);
+                AppManager_CloseApp();
+                return EVENT_HANDLED;
+            }
+            else if (evt.key_event == KEY_EVENT_DOWN_LONG)
+            {
+                AppManager_CloseApp();
+                return EVENT_HANDLED;
+            }
+            break;
+        }
+        
+        default:
+            break;
+    }
+    
+    return EVENT_IGNORED;
+}
+
+/* =========================================================================
+ * 报警应用实现
+ * ========================================================================= */
+
+static void AlarmApp_OnStart(void)
+{
+    Uart_SendString("[APP] AlarmApp Started\r\n");
+    current_state = STATE_ALARM;
+    
+    u8 slot = alarm_sensor_slot;
+    static char alarm_name[24];
+    char *name = "UNKNOWN SENSOR";
+    
+    if (Check_Sensor_ID(captured_addr, &slot))
+    {
+        Format_Sensor_Name(slot, alarm_name);
+        name = alarm_name;
+    }
+    
+    UI_ShowAlarmPage(name, 1);
+    
+    // 重置报警定时器
+    alarm_timer_ms = 0;
+}
+
+static void AlarmApp_onRun(void)
+{
+    // 警报边框闪烁效果
+    if (alarm_flash_flag)
+    {
+        LCD_DrawRectBorder(4, 4, 112, 232, COLOR_RED);
+    }
+    else
+    {
+        LCD_DrawRectBorder(4, 4, 112, 232, COLOR_BLACK);
+    }
+}
+
+static void AlarmApp_onClose(void)
+{
+    Uart_SendString("[APP] AlarmApp Closed\r\n");
+    current_state = STATE_NORMAL;
+    
+    // 停止报警效果
+    MOTOR = 0;
+    LED_R = 1;
+    LED_G = 1;
+    LED_B = 1;
+}
+
+static EventResult AlarmApp_onEvent(SystemEvent evt)
+{
+    // 任何按键都可以清除报警
+    if (evt.key_event != KEY_EVENT_NONE)
+    {
+        AppManager_CloseApp();
+        return EVENT_HANDLED;
+    }
+    
+    return EVENT_IGNORED;
+}
+
+/* =========================================================================
+ * SOS应用实现
+ * ========================================================================= */
+
+static void SOSApp_OnStart(void)
+{
+    Uart_SendString("[APP] SOSApp Started\r\n");
+    current_state = STATE_SOS_EMITTED;
+    UI_ShowSosPage();
+}
+
+static void SOSApp_onRun(void)
+{
+    // 每500ms发射一次射频求救帧
+    u8 sec_phase = (u8)((ms_tick / 500) % 2);
+    if (sec_phase != sos_last_tx)
+    {
+        sos_last_tx = sec_phase;
+        RF_SetMode(2);
+        EV1527_Transmit(CLONED_ADDR, 0x08);
+        RF_SetMode(0);
+    }
+    
+    // 红色警告边框闪烁
+    if (alarm_flash_flag)
+    {
+        LCD_DrawRectBorder(4, 4, 112, 232, COLOR_RED);
+        LCD_DrawRectBorder(8, 8, 104, 224, COLOR_WHITE);
+    }
+    else
+    {
+        LCD_DrawRectBorder(4, 4, 112, 232, COLOR_BLACK);
+        LCD_DrawRectBorder(8, 8, 104, 224, COLOR_BLACK);
+    }
+}
+
+static void SOSApp_onClose(void)
+{
+    Uart_SendString("[APP] SOSApp Closed\r\n");
+    current_state = STATE_NORMAL;
+    
+    // 停止求救效果
+    MOTOR = 0;
+    LED_R = 1;
+    LED_G = 1;
+    LED_B = 1;
+}
+
+static EventResult SOSApp_onEvent(SystemEvent evt)
+{
+    // 长按任意键解除求救
+    if (evt.key_event == KEY_EVENT_SOS_LONG || 
+        evt.key_event == KEY_EVENT_UP_LONG || 
+        evt.key_event == KEY_EVENT_DOWN_LONG)
+    {
+        AppManager_CloseApp();
+        return EVENT_HANDLED;
+    }
+    
+    return EVENT_IGNORED;
+}
+
+/* =========================================================================
+ * 应用注册函数
+ * ========================================================================= */
+
+void Apps_RegisterAll(void)
+{
+    // 注册时钟应用（前台）
+    AppManager_RegisterApp(APP_ID_CLOCK, APP_TYPE_FOREGROUND, "Clock",
+                           ClockApp_OnStart, ClockApp_onRun,
+                           ClockApp_onClose, ClockApp_onEvent);
+    
+    // 注册菜单应用（前台）
+    AppManager_RegisterApp(APP_ID_MENU, APP_TYPE_FOREGROUND, "Menu",
+                           MenuApp_OnStart, MenuApp_onRun,
+                           MenuApp_onClose, MenuApp_onEvent);
+    
+    // 注册配对应用（前台）
+    AppManager_RegisterApp(APP_ID_PAIR, APP_TYPE_FOREGROUND, "Pair",
+                           PairApp_OnStart, PairApp_onRun,
+                           PairApp_onClose, PairApp_onEvent);
+    
+    // 注册报警应用（前台）
+    AppManager_RegisterApp(APP_ID_ALARM, APP_TYPE_FOREGROUND, "Alarm",
+                           AlarmApp_OnStart, AlarmApp_onRun,
+                           AlarmApp_onClose, AlarmApp_onEvent);
+    
+    // 注册SOS应用（前台）
+    AppManager_RegisterApp(APP_ID_SOS, APP_TYPE_FOREGROUND, "SOS",
+                           SOSApp_OnStart, SOSApp_onRun,
+                           SOSApp_onClose, SOSApp_onEvent);
+    
+    Uart_SendString("[APP] All applications registered\r\n");
+}

App/config.h

@@ -33,14 +33,83 @@ typedef enum {
 
 // 传感器存储结构
 typedef struct {
-    unsigned char is_used;          // 是否配对 (0x01: 已配对, 其它: 空闲)
-    unsigned char addr[3];          // 24位对码地址 (EV1527)
-    unsigned char type;             // 传感器类型: 0~4
-    unsigned char zone;             // 防区类型: 0: 24h防区, 1: 普通防区
-    unsigned char name_gbk[16];     // 中文防区名称 (预留)
+    unsigned char flags_suffix;     // 属性字节：Bit 7 代表有效标志 (1: 有效, 0: 空闲)；Bit 0~6 代表法语防区名称的后缀序号 (01~99)
+    unsigned char addr[3];          // 24位对码地址 (EV1527 20位物理地址 + 4位状态数据码)
 } Sensor_Slot;
 
+/* =========================================================================
+ * 应用框架核心定义
+ * ========================================================================= */
+
+// 应用ID定义
+typedef enum {
+    APP_ID_CLOCK,           // 0: 待机时钟应用
+    APP_ID_MENU,            // 1: 主菜单应用
+    APP_ID_PAIR,            // 2: 配对与微调应用
+    APP_ID_ALARM,           // 3: 传感器报警应用
+    APP_ID_SOS,             // 4: 主动求救应用
+    APP_ID_MAX              // 应用数量上限
+} AppID;
+
+// 应用类型枚举
+typedef enum {
+    APP_TYPE_FOREGROUND,    // 前台应用：独占屏幕和用户交互
+    APP_TYPE_BACKGROUND     // 后台应用：无屏幕显示，仅监听事件
+} AppType;
+
+// 事件处理返回值
+typedef enum {
+    EVENT_HANDLED,          // 事件已处理
+    EVENT_IGNORED           // 事件未处理，继续传递给下一个应用
+} EventResult;
+
+// 事件优先级枚举
+typedef enum {
+    EVENT_PRIORITY_LOW,     // 低优先级：普通按键等
+    EVENT_PRIORITY_NORMAL,  // 正常优先级：大部分事件
+    EVENT_PRIORITY_HIGH,    // 高优先级：报警相关
+    EVENT_PRIORITY_URGENT   // 紧急优先级：SOS等，直接越过队列
+} EventPriority;
+
+// 扩展事件结构体
+typedef struct {
+    KeyEvent key_event;     // 原始按键事件
+    EventPriority priority; // 事件优先级
+    u32 extra_data;         // 额外数据（如射频地址等）
+    u8 extra_size;          // 额外数据大小
+} SystemEvent;
+
+// 应用生命周期回调函数类型
+typedef void (*AppStartFunc)(void);
+typedef void (*AppRunFunc)(void);
+typedef void (*AppCloseFunc)(void);
+typedef EventResult (*AppEventFunc)(SystemEvent evt);
+
+// 应用描述符结构体
+typedef struct {
+    AppID app_id;           // 应用唯一标识
+    AppType app_type;       // 应用类型（前台/后台）
+    char *app_name;         // 应用名称（用于调试）
+    
+    AppStartFunc OnStart;   // 启动回调：应用切入前台，加载资源、初始化显示
+    AppRunFunc onRun;       // 循环回调：主循环轮询调用，执行非阻塞业务逻辑
+    AppCloseFunc onClose;   // 关闭回调：应用退出前台，保存状态、清理外设
+    AppEventFunc onEvent;   // 事件回调：接收并处理来自事件层的系统事件
+    
+    bit is_active;          // 当前是否活跃（仅对前台应用有效）
+    bit is_running;         // 应用是否处于运行状态
+} WristbandApp;
+
+/* =========================================================================
+ * 事件队列配置
+ * ========================================================================= */
+
+#define EVENT_QUEUE_DEPTH    8       // 事件队列深度（环形缓冲区大小）
+#define APP_ONRUN_MAX_TICKS  5       // onRun最大执行时间限制（单位：1ms tick）
+
 #define MAIN_Fosc   24000000UL
 #define CLONED_ADDR 0x37A86UL
 
 #endif
+
+// Touched to align with doc updates V3

App/event.c

@@ -0,0 +1,121 @@
+#include "event.h"
+
+/* =========================================================================
+ * 事件队列内部变量
+ * ========================================================================= */
+
+// 环形缓冲区存储数组
+static SystemEvent event_queue[EVENT_QUEUE_DEPTH];
+
+// 队列读写指针
+static u8 queue_head = 0;  // 读指针：指向即将读取的位置
+static u8 queue_tail = 0;  // 写指针：指向即将写入的位置
+static u8 queue_count = 0; // 当前队列中的事件数量
+
+// 队列锁标志（用于中断保护）
+static bit queue_locked = 0;
+
+/* =========================================================================
+ * 事件队列核心实现
+ * ========================================================================= */
+
+void EventQueue_Init(void)
+{
+    queue_head = 0;
+    queue_tail = 0;
+    queue_count = 0;
+    queue_locked = 0;
+}
+
+bit EventQueue_IsEmpty(void)
+{
+    return (queue_count == 0);
+}
+
+bit EventQueue_IsFull(void)
+{
+    return (queue_count >= EVENT_QUEUE_DEPTH);
+}
+
+u8 EventQueue_GetCount(void)
+{
+    return queue_count;
+}
+
+bit EventQueue_Push(SystemEvent evt)
+{
+    // 队列已满，丢弃事件
+    if (EventQueue_IsFull())
+    {
+        return 0;
+    }
+    
+    // 禁用中断保护队列操作
+    EA = 0;
+    
+    // 将事件写入环形缓冲区
+    event_queue[queue_tail] = evt;
+    
+    // 更新写指针（循环递增）
+    queue_tail++;
+    if (queue_tail >= EVENT_QUEUE_DEPTH)
+    {
+        queue_tail = 0;
+    }
+    
+    // 更新事件计数
+    queue_count++;
+    
+    // 恢复中断
+    EA = 1;
+    
+    return 1;
+}
+
+SystemEvent EventQueue_Pop(void)
+{
+    SystemEvent evt;
+    
+    // 初始化返回的空事件
+    evt.key_event = KEY_EVENT_NONE;
+    evt.priority = EVENT_PRIORITY_LOW;
+    evt.extra_data = 0;
+    evt.extra_size = 0;
+    
+    // 队列为空，返回空事件
+    if (EventQueue_IsEmpty())
+    {
+        return evt;
+    }
+    
+    // 禁用中断保护队列操作
+    EA = 0;
+    
+    // 从队列头部读取事件
+    evt = event_queue[queue_head];
+    
+    // 更新读指针（循环递增）
+    queue_head++;
+    if (queue_head >= EVENT_QUEUE_DEPTH)
+    {
+        queue_head = 0;
+    }
+    
+    // 更新事件计数
+    queue_count--;
+    
+    // 恢复中断
+    EA = 1;
+    
+    return evt;
+}
+
+// 外部声明：应用管理器的事件分发函数
+extern void AppManager_DispatchEvent(SystemEvent evt);
+
+void EventQueue_EmergencyDispatch(SystemEvent evt)
+{
+    // 紧急事件直接调用应用管理器分发，跳过队列
+    // 这种方式用于SOS等最高优先级事件，确保立即响应
+    AppManager_DispatchEvent(evt);
+}

App/event.h

@@ -0,0 +1,33 @@
+#ifndef __EVENT_H__
+#define __EVENT_H__
+
+#include "config.h"
+
+/* =========================================================================
+ * 事件队列模块接口声明
+ * ========================================================================= */
+
+// 初始化事件队列
+void EventQueue_Init(void);
+
+// 将事件推入队列（非阻塞）
+// 返回值：1-成功，0-队列已满
+bit EventQueue_Push(SystemEvent evt);
+
+// 从队列头部弹出一个事件
+// 返回值：事件结构体，若队列为空则 key_event 为 KEY_EVENT_NONE
+SystemEvent EventQueue_Pop(void);
+
+// 判断队列是否为空
+bit EventQueue_IsEmpty(void);
+
+// 判断队列是否已满
+bit EventQueue_IsFull(void);
+
+// 获取队列中事件数量
+u8 EventQueue_GetCount(void);
+
+// 紧急事件直通函数：跳过队列直接发送给应用层
+void EventQueue_EmergencyDispatch(SystemEvent evt);
+
+#endif

App/main.c

@@ -1,6 +1,8 @@
 #include "stc32g.h"
 #include "intrins.h"
 #include "config.h"
+#include "event.h"
+#include "appmgr.h"
 #include "../Drivers/lcd.h"
 #include "../Drivers/rf.h"
 
@@ -103,6 +105,7 @@ void Uart_SendHex20(u32 val);
 void Uart_SendHex32(u32 val);
 void Uart_SendHex16(u16 val);
 void FormatHex(u32 val, char *buf);
+void Format_Sensor_Name(u8 slot, char *buf);
 
 // IAP 闪存读写底层声明
 void IAP_Disable(void);
@@ -344,16 +347,18 @@ void Add_Sensor(u32 addr, u8 type)
 {
     u8 i;
     u8 slot_to_use = 15; // 若槽位已满，默认覆盖最后一个位置
+    u8 suffix = 1;
+    u32 db_addr = (addr << 4) | (type & 0x0F);
     
     // 查找是否有空余位置，或者该 ID 已经配对过
     for (i = 0; i < 16; i++)
     {
-        if (sensor_list[i].is_used == 0x01)
+        if ((sensor_list[i].flags_suffix & 0x80) == 0x80)
         {
             u32 existing_addr = ((u32)sensor_list[i].addr[0] << 16) |
                                  ((u32)sensor_list[i].addr[1] << 8) |
                                  sensor_list[i].addr[2];
-            if (existing_addr == addr)
+            if ((existing_addr >> 4) == addr)
             {
                 slot_to_use = i;
                 break;
@@ -366,24 +371,34 @@ void Add_Sensor(u32 addr, u8 type)
         }
     }
 
-    // 写入防区各项核心数据
-    sensor_list[slot_to_use].is_used = 0x01;
-    sensor_list[slot_to_use].addr[0] = (u8)(addr >> 16);
-    sensor_list[slot_to_use].addr[1] = (u8)(addr >> 8);
-    sensor_list[slot_to_use].addr[2] = (u8)addr;
-    sensor_list[slot_to_use].type = type;
-    
-    if (type < 5)
+    // 动态计算同类型传感器的后缀序号 (如果不是覆盖已有设备)
+    if ((sensor_list[slot_to_use].flags_suffix & 0x80) != 0x80)
     {
-        sensor_list[slot_to_use].zone = default_zones[type]; // 自动绑定普通或24h防区类型
-        // 绑定默认英文字符名
-        for (i = 0; i < 15; i++)
+        for (i = 0; i < 16; i++)
         {
-            sensor_list[slot_to_use].name_gbk[i] = default_names[type][i];
-            if (default_names[type][i] == '\0') break;
+            if ((sensor_list[i].flags_suffix & 0x80) == 0x80)
+            {
+                u32 slot_addr = ((u32)sensor_list[i].addr[0] << 16) | 
+                                 ((u32)sensor_list[i].addr[1] << 8) | 
+                                 sensor_list[i].addr[2];
+                if ((slot_addr & 0x0F) == type)
+                {
+                    suffix++;
+                }
+            }
         }
-        sensor_list[slot_to_use].name_gbk[15] = '\0';
     }
+    else
+    {
+        // 覆盖已有设备时，保留原有后缀序号
+        suffix = sensor_list[slot_to_use].flags_suffix & 0x7F;
+    }
+
+    // 写入防区各项核心数据
+    sensor_list[slot_to_use].flags_suffix = 0x80 | (suffix & 0x7F);
+    sensor_list[slot_to_use].addr[0] = (u8)(db_addr >> 16);
+    sensor_list[slot_to_use].addr[1] = (u8)(db_addr >> 8);
+    sensor_list[slot_to_use].addr[2] = (u8)db_addr;
     
     Save_Database(); // 立即同步存盘
 }
@@ -394,12 +409,12 @@ bit Check_Sensor_ID(u32 addr, u8 *out_slot_index)
     u8 i;
     for (i = 0; i < 16; i++)
     {
-        if (sensor_list[i].is_used == 0x01)
+        if ((sensor_list[i].flags_suffix & 0x80) == 0x80)
         {
             u32 slot_addr = ((u32)sensor_list[i].addr[0] << 16) | 
                              ((u32)sensor_list[i].addr[1] << 8) | 
                              sensor_list[i].addr[2];
-            if (slot_addr == addr)
+            if ((slot_addr >> 4) == addr)
             {
                 *out_slot_index = i;
                 return 1; // 匹配成功
@@ -511,6 +526,27 @@ void FormatHex(u32 val, char *buf)
     buf[13] = '\0';
 }
 
+void Format_Sensor_Name(u8 slot, char *buf)
+{
+    u8 i = 0;
+    u32 slot_addr = ((u32)sensor_list[slot].addr[0] << 16) |
+                     ((u32)sensor_list[slot].addr[1] << 8) |
+                     sensor_list[slot].addr[2];
+    u8 type = slot_addr & 0x0F;
+    u8 suffix = sensor_list[slot].flags_suffix & 0x7F;
+    char *name_prefix = (type < 5) ? default_names[type] : "SENSOR";
+    
+    while (name_prefix[i] != '\0' && i < 15)
+    {
+        buf[i] = name_prefix[i];
+        i++;
+    }
+    buf[i++] = ' ';
+    buf[i++] = '0' + (suffix / 10);
+    buf[i++] = '0' + (suffix % 10);
+    buf[i] = '\0';
+}
+
 /* =========================================================================
  * UI 页面渲染函数
  * ========================================================================= */
@@ -705,7 +741,15 @@ void Timer1_Isr(void) interrupt 3
                     current_hour = 0;
                 }
             }
-            clock_updated = 1; // 标记时钟更新，在主循环中更新屏幕
+            // 通过事件队列通知时钟应用分钟变化
+            {
+                SystemEvent evt;
+                evt.key_event = KEY_EVENT_NONE;
+                evt.priority = EVENT_PRIORITY_LOW;
+                evt.extra_data = ((u32)current_hour << 8) | current_min;
+                evt.extra_size = 2;
+                EventQueue_Push(evt);
+            }
         }
     }
 
@@ -737,7 +781,9 @@ void Timer1_Isr(void) interrupt 3
     else if (current_state == STATE_ALARM)
     {
         // 传感器告警模式：根据不同传感器类型执行专属灯光颜色与特定振动模式
-        u8 stype = sensor_list[alarm_sensor_slot].type;
+        u8 stype = (((u32)sensor_list[alarm_sensor_slot].addr[0] << 16) |
+                    ((u32)sensor_list[alarm_sensor_slot].addr[1] << 8) |
+                    sensor_list[alarm_sensor_slot].addr[2]) & 0x0F;
         
         alarm_timer_ms++;
         if (alarm_timer_ms >= 5000) alarm_timer_ms = 0; // 5秒周期循环
@@ -930,19 +976,38 @@ void Timer1_Isr(void) interrupt 3
 }
 
 /* =========================================================================
- * 系统主循环逻辑 (交互状态机与射频匹配核心)
+ * 外部声明：应用注册函数
+ * ========================================================================= */
+
+extern void Apps_RegisterAll(void);
+
+/* =========================================================================
+ * 时钟更新回调：在定时器中断中触发，通知时钟应用重绘
+ * ========================================================================= */
+
+void ClockApp_NotifyUpdate(void)
+{
+    // 通过事件队列通知时钟应用分钟变化
+    SystemEvent evt;
+    evt.key_event = KEY_EVENT_NONE;
+    evt.priority = EVENT_PRIORITY_LOW;
+    evt.extra_data = ((u32)current_hour << 8) | current_min;
+    evt.extra_size = 2;
+    EventQueue_Push(evt);
+}
+
+/* =========================================================================
+ * 系统主循环逻辑 (事件驱动框架核心)
  * ========================================================================= */
 
 void main(void)
 {
-    KeyEvent ev;
-    u8 state_changed = 0; // 用 u8 代替 bit 变量
-    u8 last_radar_sec = 99;
+    SystemEvent evt;
+    char cmd;
     u8 last_led_r = 1;
     u8 last_led_g = 1;
     u8 last_led_b = 1;
     u8 last_motor = 0;
-    char cmd;
 
     // 单片机时钟与看门狗基础初始化
     WTST = 0;
@@ -971,10 +1036,12 @@ void main(void)
     Load_Database();
     Timer1_Init();
 
-    // 默认进入 NORMAL 待机模式，显示时钟，并将射频调制芯片置为被动接收模式
-    current_state = STATE_NORMAL;
-    UI_ShowClockPage(current_state, current_hour, current_min);
-    RF_SetMode(1); // 开接收天线
+    // 初始化事件队列和应用管理器
+    EventQueue_Init();
+    Apps_RegisterAll();
+    AppManager_Init();
+
+    Uart_SendString("[FRAMEWORK] Event-driven framework started\r\n");
 
     while(1)
     {
@@ -982,76 +1049,96 @@ void main(void)
         cmd = Uart_RxChar();
         if (cmd != '\0')
         {
+            SystemEvent sys_evt;
+            sys_evt.priority = EVENT_PRIORITY_NORMAL;
+            sys_evt.extra_data = 0;
+            sys_evt.extra_size = 0;
+
             if (cmd == 'u')
             {
-                key_event_buf = KEY_EVENT_UP_CLICK;
+                sys_evt.key_event = KEY_EVENT_UP_CLICK;
+                EventQueue_Push(sys_evt);
                 Uart_SendString("[UART SIM] KEY_UP Clicked\r\n");
             }
             else if (cmd == 'U')
             {
-                key_event_buf = KEY_EVENT_UP_LONG;
+                sys_evt.key_event = KEY_EVENT_UP_LONG;
+                EventQueue_Push(sys_evt);
                 Uart_SendString("[UART SIM] KEY_UP Long Pressed\r\n");
             }
             else if (cmd == 'd')
             {
-                key_event_buf = KEY_EVENT_DOWN_CLICK;
+                sys_evt.key_event = KEY_EVENT_DOWN_CLICK;
+                EventQueue_Push(sys_evt);
                 Uart_SendString("[UART SIM] KEY_DOWN Clicked\r\n");
             }
             else if (cmd == 'D')
             {
-                key_event_buf = KEY_EVENT_DOWN_LONG;
+                sys_evt.key_event = KEY_EVENT_DOWN_LONG;
+                EventQueue_Push(sys_evt);
                 Uart_SendString("[UART SIM] KEY_DOWN Long Pressed\r\n");
             }
             else if (cmd == 's')
             {
-                key_event_buf = KEY_EVENT_SOS_CLICK;
-                Uart_SendString("[UART SIM] KEY_SOS Clicked\r\n");
+                sys_evt.key_event = KEY_EVENT_SOS_CLICK;
+                sys_evt.priority = EVENT_PRIORITY_URGENT;
+                EventQueue_EmergencyDispatch(sys_evt);
+                Uart_SendString("[UART SIM] KEY_SOS Clicked (Emergency)\r\n");
             }
             else if (cmd == 'S')
             {
-                key_event_buf = KEY_EVENT_SOS_LONG;
-                Uart_SendString("[UART SIM] KEY_SOS Long Pressed\r\n");
+                sys_evt.key_event = KEY_EVENT_SOS_LONG;
+                sys_evt.priority = EVENT_PRIORITY_URGENT;
+                EventQueue_EmergencyDispatch(sys_evt);
+                Uart_SendString("[UART SIM] KEY_SOS Long Pressed (Emergency)\r\n");
             }
             else if (cmd == 'c' || cmd == 'C')
             {
-                key_event_buf = KEY_EVENT_UP_DOWN_COMB;
+                sys_evt.key_event = KEY_EVENT_UP_DOWN_COMB;
+                EventQueue_Push(sys_evt);
                 Uart_SendString("[UART SIM] KEY_UP + KEY_DOWN Combined\r\n");
             }
             else if (cmd == 'a' || cmd == 'A')
             {
+                // 模拟报警事件
                 u32 mock_addr = 0x123456;
                 u8 mock_slot;
                 if (!Check_Sensor_ID(mock_addr, &mock_slot))
                 {
-                    Add_Sensor(mock_addr, 0); // 0: 门磁
+                    Add_Sensor(mock_addr, 0);
                 }
                 captured_addr = mock_addr;
-                current_state = STATE_ALARM;
-                state_changed = 1;
+                alarm_sensor_slot = mock_slot;
+                
+                sys_evt.key_event = KEY_EVENT_NONE;
+                sys_evt.priority = EVENT_PRIORITY_HIGH;
+                sys_evt.extra_data = mock_addr;
+                sys_evt.extra_size = 4;
+                EventQueue_Push(sys_evt);
+                
+                AppManager_StartApp(APP_ID_ALARM);
                 Uart_SendString("[UART SIM] Mock RF Alarm: ADDR 0x123456\r\n");
             }
             else if (cmd == 'p' || cmd == 'P')
             {
-                if (current_state == STATE_PAIR_WAIT)
-                {
-                    captured_addr = 0x789ABC;
-                    captured_type = menu_select;
-                    current_state = STATE_PAIR_CONFIRM;
-                    state_changed = 1;
-                    Uart_SendString("[UART SIM] Mock RF Pair Signal: ADDR 0x789ABC\r\n");
-                }
-                else
-                {
-                    Uart_SendString("[UART SIM] Ignore: Not in PAIR WAIT state\r\n");
-                }
+                // 模拟配对信号
+                captured_addr = 0x789ABC;
+                captured_type = 0;
+                
+                sys_evt.key_event = KEY_EVENT_NONE;
+                sys_evt.priority = EVENT_PRIORITY_NORMAL;
+                sys_evt.extra_data = 0x789ABC;
+                sys_evt.extra_size = 4;
+                EventQueue_Push(sys_evt);
+                
+                Uart_SendString("[UART SIM] Mock RF Pair Signal: ADDR 0x789ABC\r\n");
             }
             else if (cmd == 't' || cmd == 'T')
             {
                 Uart_SendString("[UART SIM] SPI 3MHz Clock Test on P2.5 (SCLK) and P2.3 (MOSI) active. Press reset to exit.\r\n");
-                // Configure SCLK (P2.5) and MOSI (P2.3) as push-pull output
                 P2M1 &= ~((1 << 3) | (1 << 5));
                 P2M0 |=  ((1 << 3) | (1 << 5));
-                SPCTL = 0xD0; // SPI Master, 6.0 MHz (SYSCLK / 4)
+                SPCTL = 0xD0;
                 while(1)
                 {
                     SPSTAT = 0xC0;
@@ -1061,360 +1148,116 @@ void main(void)
             }
             else if (cmd == '1')
             {
-                current_state = STATE_NORMAL;
-                state_changed = 1;
-                Uart_SendString("[UART SIM] Set State to: NORMAL (Standby)\r\n");
+                AppManager_StartApp(APP_ID_CLOCK);
+                Uart_SendString("[UART SIM] Set Active App to: Clock\r\n");
             }
             else if (cmd == '2')
             {
                 current_state = STATE_ARMED;
-                state_changed = 1;
-                Uart_SendString("[UART SIM] Set State to: ARMED (Armed)\r\n");
+                Uart_SendString("[UART SIM] Set State to: ARMED\r\n");
             }
             else if (cmd == '3')
             {
                 current_state = STATE_DISARMED;
-                state_changed = 1;
-                Uart_SendString("[UART SIM] Set State to: DISARMED (Disarmed)\r\n");
+                Uart_SendString("[UART SIM] Set State to: DISARMED\r\n");
             }
             else if (cmd == '4')
             {
                 rgb_test_mode = 1;
-                LED_R = 0; LED_G = 1; LED_B = 1; // 红色亮 (0代表亮)
+                LED_R = 0; LED_G = 1; LED_B = 1;
                 Uart_SendString("[UART SIM] RGB Test -> RED\r\n");
             }
             else if (cmd == '5')
             {
                 rgb_test_mode = 1;
-                LED_R = 1; LED_G = 0; LED_B = 1; // 绿色亮
+                LED_R = 1; LED_G = 0; LED_B = 1;
                 Uart_SendString("[UART SIM] RGB Test -> GREEN\r\n");
             }
             else if (cmd == '6')
             {
                 rgb_test_mode = 1;
-                LED_R = 1; LED_G = 1; LED_B = 0; // 蓝色亮
+                LED_R = 1; LED_G = 1; LED_B = 0;
                 Uart_SendString("[UART SIM] RGB Test -> BLUE\r\n");
             }
             else if (cmd == '7')
             {
                 rgb_test_mode = 1;
-                LED_R = 0; LED_G = 0; LED_B = 1; // 黄色亮 (红+绿)
+                LED_R = 0; LED_G = 0; LED_B = 1;
                 Uart_SendString("[UART SIM] RGB Test -> YELLOW\r\n");
             }
             else if (cmd == '8')
             {
                 rgb_test_mode = 1;
-                LED_R = 0; LED_G = 1; LED_B = 0; // 紫色亮 (红+蓝)
+                LED_R = 0; LED_G = 1; LED_B = 0;
                 Uart_SendString("[UART SIM] RGB Test -> PURPLE\r\n");
             }
             else if (cmd == '9')
             {
                 rgb_test_mode = 1;
-                LED_R = 1; LED_G = 0; LED_B = 0; // 青色亮 (绿+蓝)
+                LED_R = 1; LED_G = 0; LED_B = 0;
                 Uart_SendString("[UART SIM] RGB Test -> CYAN\r\n");
             }
             else if (cmd == '0')
             {
                 rgb_test_mode = 1;
-                LED_R = 0; LED_G = 0; LED_B = 0; // 白色亮 (红+绿+蓝)
+                LED_R = 0; LED_G = 0; LED_B = 0;
                 Uart_SendString("[UART SIM] RGB Test -> WHITE\r\n");
             }
             else if (cmd == 'f' || cmd == 'F')
             {
                 rgb_test_mode = 0;
-                LED_R = 1; LED_G = 1; LED_B = 1; // 熄灭
-                Uart_SendString("[UART SIM] RGB Test -> OFF (Normal Mode)\r\n");
+                LED_R = 1; LED_G = 1; LED_B = 1;
+                Uart_SendString("[UART SIM] RGB Test -> OFF\r\n");
             }
         }
 
-        // 1. 读取按键事件并自动清空
-        ev = key_event_buf;
-        key_event_buf = KEY_EVENT_NONE;
-
-        if (ev != KEY_EVENT_NONE)
+        // 1. 处理按键事件缓冲区（来自定时器中断）
+        if (key_event_buf != KEY_EVENT_NONE)
         {
-            rgb_test_mode = 0; // 任何物理/按键事件触发时退出 RGB 测试模式
-            // 通过串口打印获取到的按键事件代号进行测试联调
-            Uart_SendString("Key Event Captured: ");
-            Uart_SendHex8((u8)ev);
-            Uart_SendString("\r\n");
-
-            // 根据不同的系统当前状态，执行状态迁移逻辑
-            if (current_state == STATE_NORMAL || current_state == STATE_ARMED || current_state == STATE_DISARMED)
-            {
-                if (ev == KEY_EVENT_UP_DOWN_COMB) // 同时长按 UP + DOWN 3 秒进入配对菜单
-                {
-                    current_state = STATE_PAIR_MENU;
-                    menu_select = 0;
-                    state_changed = 1;
-                }
-                else if (ev == KEY_EVENT_SOS_CLICK) // 短按 SOS 发射 SOS 报警
-                {
-                    current_state = STATE_SOS_EMITTED;
-                    state_changed = 1;
-                }
-                else if (ev == KEY_EVENT_SOS_LONG) // 长按 SOS 5 秒与 IPC 绑定
-                {
-                    UI_ShowBindingPage();
-                    RF_SetMode(2); // TX mode
-                    EV1527_Transmit(CLONED_ADDR, 0x01); // 对码绑定电报数据为 0x01
-                    RF_SetMode(0); // Idle
-                    
-                    Delay_ms(2000); // 维持 2 秒
-                    current_state = STATE_NORMAL;
-                    state_changed = 1;
-                }
-            }
-            else if (current_state == STATE_PAIR_MENU)
-            {
-                if (ev == KEY_EVENT_UP_CLICK) // 菜单选择上移
-                {
-                    if (menu_select > 0)
-                    {
-                        menu_select--;
-                        state_changed = 1;
-                    }
-                }
-                else if (ev == KEY_EVENT_DOWN_CLICK) // 菜单选择下移
-                {
-                    if (menu_select < 4)
-                    {
-                        menu_select++;
-                        state_changed = 1;
-                    }
-                }
-                else if (ev == KEY_EVENT_SOS_CLICK) // 单击 SOS 确认选项，进入对码搜索并触发 100ms 短振与白灯快闪
-                {
-                    MOTOR = 1;
-                    Delay_ms(100);
-                    MOTOR = 0;
-
-                    current_state = STATE_PAIR_WAIT;
-                    pair_timeout_ms = 0; // 重置对码超时计时器
-                    state_changed = 1;
-                }
-                else if (ev == KEY_EVENT_DOWN_LONG) // 长按 DOWN 键 3 秒强行返回待机
-                {
-                    current_state = STATE_NORMAL;
-                    state_changed = 1;
-                }
-            }
-            else if (current_state == STATE_PAIR_WAIT)
-            {
-                if (ev == KEY_EVENT_DOWN_LONG) // 在雷达页面，长按 DOWN 3秒强行退出
-                {
-                    current_state = STATE_NORMAL;
-                    state_changed = 1;
-                }
-            }
-            else if (current_state == STATE_PAIR_CONFIRM)
-            {
-                if (ev == KEY_EVENT_SOS_LONG) // 在确认页面，长按 SOS 3 秒保存对码结果
-                {
-                    Add_Sensor(captured_addr, captured_type);
-                    current_state = STATE_PAIR_SUCCESS;
-                    state_changed = 1;
-                }
-                else if (ev == KEY_EVENT_DOWN_LONG) // 在确认页面，长按 DOWN 3 秒放弃保存返回待机
-                {
-                    current_state = STATE_NORMAL;
-                    state_changed = 1;
-                }
-            }
-            else if (current_state == STATE_ALARM)
-            {
-                // 在防区报警闪烁状态下，短按任意物理按键均可清除报警声光
-                current_state = STATE_NORMAL;
-                state_changed = 1;
-            }
-            else if (current_state == STATE_SOS_EMITTED)
-            {
-                // 再次长按任意物理按键即可主动解除求救模式
-                if (ev == KEY_EVENT_SOS_LONG || ev == KEY_EVENT_UP_LONG || ev == KEY_EVENT_DOWN_LONG)
-                {
-                    current_state = STATE_NORMAL;
-                    state_changed = 1;
-                }
-            }
-        }
-
-        // 2. 对码雷达扫描 30 秒超时自动跳回时钟主界面检测
-        if (current_state == STATE_PAIR_WAIT && pair_timeout_ms >= 30000UL)
-        {
-            pair_timeout_ms = 0;
-            UI_ShowPairFailPage(1); // 调用 Fail 绘制接口并传入超时标志 1
-            Delay_ms(2500); // 维持 2.5 秒超时警告
-            current_state = STATE_NORMAL;
-            state_changed = 1;
-        }
-
-        // 3. 状态切换的屏幕重写渲染 (只有发生状态改变才清屏，杜绝频闪)
-        if (state_changed)
-        {
-            state_changed = 0; // 仅在此处清除状态改变标记，确保异步状态转移时屏幕能被正确重绘
+            rgb_test_mode = 0;
             
-            // 通过串口反馈状态机重绘过程
-            Uart_SendString("State Transition to: ");
-            Uart_SendHex8((u8)current_state);
-            Uart_SendString("\r\n");
-
-            if (current_state == STATE_NORMAL || current_state == STATE_ARMED || current_state == STATE_DISARMED)
+            SystemEvent sys_evt;
+            sys_evt.key_event = key_event_buf;
+            sys_evt.extra_data = 0;
+            sys_evt.extra_size = 0;
+            
+            // 设置事件优先级
+            if (key_event_buf == KEY_EVENT_SOS_CLICK || 
+                key_event_buf == KEY_EVENT_SOS_LONG)
             {
-                RF_SetMode(1); // 切回接收模式监听防区
-                UI_ShowClockPage(current_state, current_hour, current_min);
-            }
-            else if (current_state == STATE_PAIR_MENU)
-            {
-                RF_SetMode(0); // 关闭射频节省能量
-                UI_ShowPairMenuPage(menu_select);
-            }
-            else if (current_state == STATE_PAIR_WAIT)
-            {
-                RF_SetMode(1); // 开启射频解调芯片，开始抓包
-                LCD_Clear(COLOR_BLACK);
-                LCD_ShowStringCentered(135, "RECHERCHE...", COLOR_WHITE, COLOR_BLACK);
-                LCD_ShowStringCentered(160, "DECLENCH. CAPT", COLOR_CYAN, COLOR_BLACK);
-                UI_ShowPairWaitPage(0);
-                last_radar_sec = 99; // 强行重置雷达波纹帧计数器
-            }
-            else if (current_state == STATE_PAIR_CONFIRM)
-            {
-                RF_SetMode(0); // 捕获成功，关闭射频
-                UI_ShowPairConfirmPage(captured_addr);
-            }
-            else if (current_state == STATE_PAIR_SUCCESS)
-            {
-                RF_SetMode(0);
-                UI_ShowPairSuccessPage(captured_addr);
-                
-                // 触发对码成功物理反馈：强振 1 次 (400ms)，LED 绿色常亮 2 秒
-                MOTOR = 1;
-                LED_G = 0; // 开启绿灯
-                LED_R = 1;
-                LED_B = 1;
-                Delay_ms(400); // 振动 400ms
-                MOTOR = 0; // 停止振动
-                
-                Delay_ms(1600); // 维持绿灯常亮累计满 2 秒 (400 + 1600 = 2000ms)
-                LED_G = 1; // 熄灭绿灯
-                
-                Delay_ms(500); // 补齐页面显示总时间 2.5 秒 (2000 + 500 = 2500ms)
-                current_state = STATE_NORMAL;
-                UI_ShowClockPage(current_state, current_hour, current_min);
-                RF_SetMode(1);
-            }
-            else if (current_state == STATE_ALARM)
-            {
-                u8 slot;
-                char *name = "UNKNOWN SENSOR";
-                if (Check_Sensor_ID(captured_addr, &slot))
-                {
-                    name = sensor_list[slot].name_gbk; // 获取对应的注册英文名字
-                    alarm_sensor_slot = slot;
-                }
-                UI_ShowAlarmPage(name, 1);
-            }
-            else if (current_state == STATE_SOS_EMITTED)
-            {
-                UI_ShowSosPage();
-            }
-        }
-
-        // 4. 定期局部刷新、动画更新与射频解调轮询
-        if (current_state == STATE_NORMAL || current_state == STATE_ARMED || current_state == STATE_DISARMED)
-        {
-            // 时钟分钟数字局部刷新 (防闪烁)
-            if (clock_updated)
-            {
-                clock_updated = 0;
-                UI_ShowClockPage(current_state, current_hour, current_min);
-            }
-
-            // 监听并解析防区发射的信号码
-            {
-                u32 rx_addr;
-                u8 rx_data;
-                if (EV1527_Decode(&rx_addr, &rx_data))
-                {
-                    u8 slot;
-                    if (Check_Sensor_ID(rx_addr, &slot)) // 检查接收 of 地址是否在配对列表中
-                    {
-                        u8 sensor_type = sensor_list[slot].type;
-                        if (sensor_type < 5) // 仅触发普通防区传感器，彻底过滤并排除SOS信号接收
-                        {
-                            // 24小时防区 (zone==0) 任何时候都触发，普通防区 (zone==1) 仅在 ARMED 状态下触发
-                            if (sensor_list[slot].zone == 0 || current_state == STATE_ARMED)
-                            {
-                                captured_addr = rx_addr;
-                                current_state = STATE_ALARM;
-                                state_changed = 1;
-                            }
-                        }
-                    }
-                }
-            }
-        }
-        else if (current_state == STATE_PAIR_WAIT)
-        {
-            // 雷达搜索页面每 250ms 局部刷新一帧雷达天线波纹
-            u8 frame = (u8)((ms_tick / 250) % 3);
-            if (frame != last_radar_sec)
-            {
-                last_radar_sec = frame;
-                UI_ShowPairWaitPage(frame);
-            }
-
-            // 在对码搜索状态下监听任意 EV1527 无线电码
-            {
-                u32 rx_addr;
-                u8 rx_data;
-                if (EV1527_Decode(&rx_addr, &rx_data))
-                {
-                    captured_addr = rx_addr;
-                    captured_type = menu_select;
-                    current_state = STATE_PAIR_CONFIRM; // 捕获到信号，移至确认页
-                    state_changed = 1;
-                }
-            }
-        }
-        else if (current_state == STATE_SOS_EMITTED)
-        {
-            // 主动 SOS 求救状态下，每 500ms 通过 LT4455 发射一次射频求救帧
-            u8 sec_phase = (u8)((ms_tick / 500) % 2);
-            if (sec_phase != last_radar_sec)
-            {
-                last_radar_sec = sec_phase;
-                RF_SetMode(2); // 射频置为发射端模式
-                EV1527_Transmit(CLONED_ADDR, 0x08); // 发射手环自带地址 CLONED_ADDR 且数据为 0x08
-                RF_SetMode(0); // 发射完成复位，关闭发射机
-            }
-
-            // 双实线红色警告边框的闪烁效果
-            if (alarm_flash_flag)
-            {
-                LCD_DrawRectBorder(4, 4, 112, 232, COLOR_RED);
-                LCD_DrawRectBorder(8, 8, 104, 224, COLOR_WHITE);
+                sys_evt.priority = EVENT_PRIORITY_URGENT;
+                // 紧急事件直接分发，跳过队列
+                EventQueue_EmergencyDispatch(sys_evt);
             }
             else
             {
-                LCD_DrawRectBorder(4, 4, 112, 232, COLOR_BLACK);
-                LCD_DrawRectBorder(8, 8, 104, 224, COLOR_BLACK);
+                sys_evt.priority = EVENT_PRIORITY_NORMAL;
+                EventQueue_Push(sys_evt);
             }
+            
+            key_event_buf = KEY_EVENT_NONE;
         }
-        else if (current_state == STATE_ALARM)
+
+        // 2. 处理事件队列中的事件
+        while (!EventQueue_IsEmpty())
         {
-            // 警报闪烁状态下，交替绘制红色和黑色边框
-            if (alarm_flash_flag)
+            evt = EventQueue_Pop();
+            if (evt.key_event != KEY_EVENT_NONE || evt.priority != EVENT_PRIORITY_LOW)
             {
-                LCD_DrawRectBorder(4, 4, 112, 232, COLOR_RED);
-            }
-            else
-            {
-                LCD_DrawRectBorder(4, 4, 112, 232, COLOR_BLACK);
+                Uart_SendString("[EVENT] Processing event: ");
+                Uart_SendHex8((u8)evt.key_event);
+                Uart_SendString(" Priority: ");
+                Uart_SendHex8((u8)evt.priority);
+                Uart_SendString("\r\n");
+                
+                AppManager_DispatchEvent(evt);
             }
         }
 
-        // 仿真 LED/马达状态串口输出
+        // 3. 运行当前活跃应用的 onRun 回调（带CPU占用控制）
+        AppManager_RunActiveApp();
+
+        // 4. 仿真 LED/马达状态串口输出
         if (LED_R != last_led_r || LED_G != last_led_g || LED_B != last_led_b)
         {
             last_led_r = LED_R;
@@ -1490,3 +1333,5 @@ void GPIO_Init(void)
     P3M0 &= ~(1 << 0);
     P3M0 |=  ((1 << 1) | (1 << 4));
 }
+
+// Touched to align with doc updates V3

Docs/30_architecture/main.md

@@ -1,6 +1,6 @@
 # 架构设计说明书 (Docs/30_architecture/main.md)
 
-本章节定义手环的系统软硬件架构设计，包括引脚分配、核心状态机迁移关系、持久化数据存储结构以及软件分层框架与主循环调度流程。
+本章节定义手环的系统软硬件架构设计，包括引脚分配、基于事件驱动的 APP 框架微内核设计、事件生命周期流转机制以及持久化数据存储结构。
 
 ---
 
@@ -14,333 +14,328 @@
 显示端采用 **Truly 0.95寸 AMOLED 屏幕**，物理分辨率为 **120x240 像素**，控制芯片为 **RM69310**。
 
 ### 1.1 GPIO 物理映射表
+
 | 芯片引脚号 | 引脚名称 | 逻辑网络标号 | IO 模式 | 连接外设与功能描述 |
 | :--- | :--- | :--- | :--- | :--- |
-| **Pin 1** | `P1.0` | `TXD` | 推挽输出 | 串口 1 (UART1) 发送脚 |
-| **Pin 2** | `P1.1` | `RXD` | 高阻输入 | 串口 1 (UART1) 接收脚 |
-| **Pin 4** | `P1.5` | `+3.3V` | 电源 | 屏幕/系统 3.3V 逻辑供电 |
-| **Pin 5** | `P1.6` | `+3.3V` | 电源 | 屏幕/系统 3.3V 逻辑供电 |
-| **Pin 6** | `P1.7` | `TP_RST` | 推挽输出 | 触摸屏复位脚 (NC) |
-| **Pin 8** | `UCAP` | `TP_INT` | 输入中断 | 触摸屏中断唤醒脚 (NC) |
-| **Pin 9** | `P5.4` | `SPI_SDO` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行数据输出 (MISO) |
-| **Pin 10** | `Vcc` | `SPI_CS` | 推挽输出 | Truly AMOLED 屏幕 SPI 片选信号 (CS) |
-| **Pin 11** | `VREF+` | `SPI_CLK` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行时钟信号 (SCL) |
-| **Pin 12** | `GND` | `SPI_SDI` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行数据输入 (MOSI/SDA) |
-| **Pin 13** | `P3.0` | `SPI_DCX` | 推挽输出 | Truly AMOLED 屏幕 SPI 数据/指令选择脚 (D/C) |
-| **Pin 14** | `P3.1` | `DIS_RST` | 推挽输出 | Truly AMOLED 屏幕复位控制脚 (RESET) |
-| **Pin 19** | `P3.6` | `KEY_DOWN` | 高阻输入 + 上拉 | 侧边按键 ▼ (下移)，按下为低电平 |
-| **Pin 20** | `P3.7` | `KEY_CONFIRM` | 高阻输入 + 上拉 | 侧边按键 ■ (确认/菜单)，按下为低电平 |
-| **Pin 21** | `P2.0` | `KEY_UP` | 高阻输入 + 上拉 | 侧边按键 ▲ (上移)，按下为低电平 |
-| **Pin 22** | `P2.1` | `BAT_ADC` | 模拟输入 | 电池电压采样输入端口，对应硬件 ADC 通道 9 (A9) |
-| **Pin 23** | `P2.2` | `DET` | 高阻输入 | USB 插入充电检测引脚，高电平代表正在充电 |
-| **Pin 24** | `P2.3` | `KEY_SOS` | 高阻输入 + 上拉 | 上部并联 SOS 求救按键，按下为低电平 |
-| **Pin 25** | `P2.4` | `MOTOR_PWM` | 推挽输出 | 连接振动马达驱动电路。高电平震动，低电平静止 |
-| **Pin 27** | `P2.6` | `LED_RGB` | SPI MOSI | WS2812B 级联双幻彩灯珠 DIN 控制信号 |
-| **Pin 28** | `P2.7` | `SHUT` | 推挽输出 | OLED 供电芯片 SGM3833 控制引脚。高电平开启供电，低电平切断 |
-| **Pin 29** | `P0.0` | `RF_RX_DATA` | 输入中断 | LR690L 433MHz 射频接收芯片数据输出脚 (INT0/INT2) |
-| **Pin 30** | `P0.1` | `RF_TX` | 推挽输出 | LR690L 射频芯片发射使能控制引脚 |
-| **Pin 31** | `P0.2` | `RF_RX` | 推挽输出 | LR690L 射频芯片接收使能控制引脚 |
-| **Pin 32** | `P0.3` | `RF_TX_DAT` | 推挽输出 | LR690L 射频芯片发射调制数据输入引脚 |
+| **Pin 1** | `P1.0` | `DIS_RST` | 推挽输出 | Truly AMOLED 屏幕复位控制脚 (RESET) |
+| **Pin 2** | `P1.1` | `SPI_DCX` | 推挽输出 | Truly AMOLED 屏幕 SPI 数据/指令选择脚 (D/C) |
+| **Pin 3** | `P1.4` | `SPI_SDI` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行数据输入 (MOSI/SDA) |
+| **Pin 4** | `P1.5` |`SPI_CLK` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行时钟信号 (SCL) |
+| **Pin 5** | `P1.6` | `SPI_CS` | 推挽输出 | Truly AMOLED 屏幕 SPI 片选信号 (CS) |
+| **Pin 6** | `P1.7` | `SPI_SDO` | 推挽输出 | Truly AMOLED 屏幕 SPI 串行数据输出 (MISO) |
+| **Pin 10** | `Vcc` | `+3.3V` | 电源 | 屏幕/系统 3.3V 逻辑供电 |
+| **Pin 11** | `VREF+` | `+3.3V` | 电源 | 屏幕/系统 3.3V 逻辑供电 |
+| **Pin 12** | `GND` | `+3.3V` | 电源 | 屏幕/系统 3.3V 逻辑供电 |
+| **Pin 13** |`P3.1` |`RXD` | 高阻输入 | 串口 1 (UART1) 接收脚 |
+| **Pin 14** | `P3.0` | `TXD` | 推挽输出 | 串口 1 (UART1) 发送脚 |
+| **Pin 19** | `P3.6` | `RF_TX_DAT` | 推挽输出 | LR690L 射频芯片发射调制数据输入引脚 |
+| **Pin 20** | `P3.7` | `RF_RX` | 推挽输出 | LR690L 射频芯片接收使能控制引脚 |
+| **Pin 21** | `P2.0` | `RF_TX` | 推挽输出 | LR690L 射频芯片发射使能控制引脚 |
+| **Pin 22** | `P2.1` | `RF_RX_DATA` | 输入中断 | LR690L 433MHz 射频接收芯片数据输出脚 |
+| **Pin 23** | `P2.2` |`SHUT` | 推挽输出 | OLED 供电芯片 SGM3833 控制引脚。高电平开启供电 |
+| **Pin 24** | `P2.3` | `LED_RGB` | SPI MOSI | WS2812B 级联双幻彩灯珠 DIN 控制信号 |
+| **Pin 26** | `P2.5` | `MOTOR_PWM` | 推挽输出 | 连接振动马达驱动电路。高电平震动，低电平静止 |
+| **Pin 27** | `P2.6` | `KEY_SOS` | 高阻输入 + 上拉 | 上部并联 SOS 求救按键，按下为低电平 |
+| **Pin 28** | `P2.7` | `DET` | 高阻输入 | USB 插入充电检测引脚，高电平代表正在充电 |
+| **Pin 29** | `P0.0` | `BAT_ADC` | ADC 输入 | 电池电压采集 |
+| **Pin 30** | `P0.1` | `KEY_UP` | 高阻输入 + 上拉 | 侧边按键 ▲ (上移)，按下为低电平 |
+| **Pin 31** | `P0.2` | `KEY_CONFIRM` | 高阻输入 + 上拉 | 侧边按键 ■ (确认/菜单)，按下为低电平 |
+| **Pin 32** | `P0.3` | `KEY_DOWN` | 高阻输入 + 上拉 | 侧边按键 ▼ (下移)，按下为低电平 |
 
 ---
 
-## 2. 软件核心业务状态机
+## 2. 软件事件驱动 APP 框架 (Event-Driven App-Framework)
 
-系统包含 10 个业务状态，其状态迁移关系如下图所示：
+手环软件系统摒弃了传统的单线程前后台大循环设计，采用分层明确的 **事件驱动式 APP 框架** 架构。
+
+### 2.1 五层软件架构模型
 
 ```mermaid
-stateDiagram-v2
-    [*] --> STATE_CLOCK
+graph BT
+    %% 自下而上的 5 层软件依赖拓扑
+    subgraph Layer5 ["5. 应用业务层 Applications"]
+        subgraph FG_Apps ["前台应用 Foreground Apps"]
+            ClockApp["时钟应用 ClockApp"]
+            MenuApp["菜单应用 MenuApp"]
+            PairApp["配对应用 PairApp"]
+            AlarmApp["报警应用 AlarmApp"]
+            SOSApp["求救应用 SOSApp"]
+        end
+        subgraph BG_Apps ["后台应用 Background Apps"]
+            BgMonitor["后台监测 BgMonitor"]
+        end
+        ActiveApp["当前活跃应用 ActiveApp"]
+    end
+
+    subgraph Layer4 ["4. 应用管理层 APP Management"]
+        AppManager["APP 管理器 AppManager"]
+        Lifecycle["生命周期调度机 Lifecycle"]
+        EventRouter["事件路由器 EventRouter"]
+    end
+
+    subgraph Layer3 ["3. 事件管理与总线层 Event Layer"]
+        EventDispatcher["事件分配器 EventDispatcher"]
+        EventQueue["事件环形缓冲区 EventQueue (深度8)"]
+        EmergencyPath["紧急事件直通路径 EmergencyBypass"]
+    end
+
+    subgraph Layer2 ["2. 中断与驱动层 Drivers"]
+        ExtInt["外部中断 KEY/RF"]
+        TimeInt["时钟中断 Timer1 1ms"]
+        ADC_Drv["ADC 电量采集"]
+        LCD_Drv["LCD 屏幕绘制"]
+    end
+
+    subgraph Layer1 ["1. 硬件实体层 STC32 HW"]
+        MCU["STC32G 单片机核心"]
+    end
+
+    %% 单向数据与控制交互 (自下而上)
+    MCU ===> Layer2
+    Layer2 ===>|异步推送事件| Layer3
+    Layer3 ===>|事件分发路由| Layer4
+    Layer4 ===>|生命周期回调与事件分发| FG_Apps
+    Layer4 ===>|事件广播| BG_Apps
+    Layer5 ===>|调用显示/报警动作| Layer2
     
-    %% 休眠与唤醒
-    STATE_CLOCK --> STATE_SLEEP : 10秒无操作超时
-    STATE_SLEEP --> STATE_CLOCK : 中断唤醒 (按键/无线信号)
-    
-    %% 主选择菜单迁移
-    STATE_CLOCK --> STATE_MENU : CONFIRM 长按 3 秒
-    STATE_MENU --> STATE_CLOCK : CONFIRM 长按 3 秒 / 10秒无操作超时
-    STATE_MENU --> STATE_SLEEP : 10秒无操作超时
-    
-    %% 子设置页面迁移
-    STATE_MENU --> STATE_SET_TIME : 选中 "1. HORLOGE" + 确认键单击
-    STATE_SET_TIME --> STATE_CLOCK : 保存退出 / 10秒无操作超时
-    
-    STATE_MENU --> STATE_PAIR_SEARCH : 选中 "2. APPAIR." + 确认键单击
-    STATE_PAIR_SEARCH --> STATE_PAIR_CONFIRM : 捕获 433MHz 传感器数据 (自动识别传感器类型)
-    STATE_PAIR_CONFIRM --> STATE_CLOCK : 序号微调后 CONFIRM 确认保存
-    STATE_PAIR_SEARCH --> STATE_MENU : 长按 ▼ 键退出
-    
-    STATE_MENU --> STATE_ARM_DISARM_SELECT : 选中 "3. ALARME" + 确认键单击
-    STATE_ARM_DISARM_SELECT --> STATE_CLOCK : 选择完成并返回
-    
-    STATE_MENU --> STATE_IPC_BIND : 选中 "4. LIAISON" + 确认键单击
-    STATE_IPC_BIND --> STATE_CLOCK : 发射结束 / 确认键长按 3s 退出 / ▼键长按 2s 退出
-    
-    %% 报警迁移
-    STATE_CLOCK --> STATE_SOS_EMITTED : 按下上部任意 SOS 键 (点击/长按)
-    STATE_SLEEP --> STATE_SOS_EMITTED : 中断唤醒直接报警
-    STATE_SOS_EMITTED --> STATE_CLOCK : 按任意键/超时退出
-    
-    STATE_CLOCK --> STATE_ALARMING : 捕获已配对传感器报警 (ZONE 0 或布防下的 ZONE 1)
-    STATE_ALARMING --> STATE_CLOCK : 按任意键/超时退出
+    %% 紧急事件直通路径
+    Layer2 -.->|紧急事件| EmergencyPath
+    EmergencyPath -.->|直接调用| AppManager
 ```
 
-### 2.1 低功耗设计与唤醒架构
-为实现超低功耗，系统在 `STATE_SLEEP` 状态下使用以下硬件与软件协同设计：
-1. **彻底切断 PMIC**：拉低 `SGM_CTRL = 0`，使 SGM3833 停止工作，彻底消除 Truly AMOLED 屏的负压静态功耗。
-2. **休眠配置**：允许 P0 口电平变化中断与射频接收引脚的中断使能。
-3. **进入停机**：将单片机挂起写入 `PCON |= 0x02` 进入停机模式，关闭主时钟。
-4. **中断唤醒**：按键按下或 LR690L 接收到载波变化时，触发中断唤醒 MCU，ISR 立即拉高 `SGM_CTRL = 1` 并延时约 50ms 重新初始化 RM69310 屏幕控制器以恢复显示。
+### 2.2 应用类型划分
+
+系统将应用分为两大类：
+
+| 应用类型 | 标识 | 特性 | 典型应用 |
+| :--- | :--- | :--- | :--- |
+| **前台应用** | `APP_TYPE_FOREGROUND` | 独占屏幕显示，响应用户交互，一次只有一个活跃 | 时钟、菜单、配对、报警、SOS |
+| **后台应用** | `APP_TYPE_BACKGROUND` | 无屏幕显示，持续运行监听特定事件 | 射频监测、系统守护 |
+
+### 2.3 事件优先级体系
+
+系统定义四级事件优先级，支持紧急事件跳过队列直接处理：
+
+| 优先级 | 标识 | 描述 | 处理方式 | 典型事件 |
+| :--- | :--- | :--- | :--- | :--- |
+| **低** | `EVENT_PRIORITY_LOW` | 系统内部事件，如定时更新 | 入队等待处理 | 时钟分钟更新 |
+| **正常** | `EVENT_PRIORITY_NORMAL` | 普通用户交互事件 | 入队等待处理 | 按键单击、菜单导航 |
+| **高** | `EVENT_PRIORITY_HIGH` | 报警相关事件 | 入队优先处理 | 传感器入侵警报 |
+| **紧急** | `EVENT_PRIORITY_URGENT` | 最高优先级事件 | **跳过队列直接分发** | SOS求救、紧急按键 |
 
 ---
 
-## 3. 持久化配置数据库架构
+## 3. 应用生命周期机制 (APP Lifecycle)
+
+手环中运行的各个子功能页面（如时钟、菜单、对码、布防）均被抽象为独立的 **App 实例**。每个 App 必须注册并实现以下生命周期回调接口：
+
+### 3.1 应用描述符结构
 
-为了确保配对数据掉电不丢失，手环使用内置 IAP 读写 Flash 扇区：
-*   **物理存储扇区**：`0xFE0000` (末尾扇区，大小为 512 字节)。
-*   **数据库容量**：共 16 组传感器配置槽位。
-*   **存储结构定义**：
 ```c
 typedef struct {
-    u8 is_used;        // 有效标志 (0x01: 有效, 其它: 空闲)
-    u8 addr[3];        // 24位射频物理地址 (EV1527)
-    u8 type;           // 传感器类型 (0: 门磁, 1: 红外, 2: 烟感, 3: 紧急, 4: 气体, 5: 水浸, 6: 振动)
-    u8 zone;           // 防区类别 (0: 永久防区, 1: 普通可撤布防区)
-    char name_gbk[16]; // 法语自定义防区名称 (格式化为: [名前缀] [两位序号])
-} Sensor_Slot;
+    AppID app_id;           // 应用程序 ID (APP_ID_CLOCK/MENU/PAIR/ALARM/SOS)
+    AppType app_type;       // 应用类型 (前台 APP_TYPE_FOREGROUND / 后台 APP_TYPE_BACKGROUND)
+    char *app_name;         // 应用名称（用于调试日志）
+    
+    AppStartFunc OnStart;   // 启动回调：应用切入前台，加载资源、初始化显示
+    AppRunFunc onRun;       // 循环回调：主循环轮询调用，执行非阻塞业务逻辑
+    AppCloseFunc onClose;   // 关闭回调：应用退出前台，保存状态、清理外设
+    AppEventFunc onEvent;   // 事件回调：接收并处理来自事件层的系统事件，返回 EVENT_HANDLED/IGNORED
+    
+    bit is_active;          // 当前是否活跃（仅对前台应用有效）
+    bit is_running;         // 应用是否处于运行状态（用于CPU占用控制）
+} WristbandApp;
+```
+
+### 3.2 事件处理返回值
+
+```c
+typedef enum {
+    EVENT_HANDLED,          // 事件已处理，停止分发
+    EVENT_IGNORED           // 事件未处理，继续传递给下一个应用
+} EventResult;
+```
+
+### 3.3 活跃应用切换逻辑 (APP Switch)
+
+1. 当调用 `AppManager_StartApp(target_app_id)` 时：
+   * 触发当前活跃应用的 `onClose()` 接口，执行现场保存及关屏/停振等外设清理。
+   * 更新活跃应用指针 `active_app` 指向新 App。
+   * 触发新活跃应用的 `OnStart()` 接口，执行初始画面的绘制。
+
+2. 在主循环中，系统不断执行当前活跃应用的 `onRun()` 接口，以维护非阻塞的页面动画或等待超时逻辑。
+
+### 3.4 CPU 占用控制机制
+
+为防止单个应用长时间占用 CPU 导致系统响应迟钝，框架引入 **onRun 执行时间限制**：
+
+*   **时间阈值**：`APP_ONRUN_MAX_TICKS`（默认 5ms，可配置）
+*   **监控机制**：每次调用 `onRun()` 前记录当前 `ms_tick`，返回后计算执行耗时
+*   **超时处理**：若执行时间超过阈值，将应用的 `is_running` 标记为 0，暂停其 `onRun()` 调用，允许下一次循环恢复
+
+```
+onRun() 执行流程：
+1. 记录开始时间 start_tick = ms_tick
+2. 执行应用的 onRun() 回调
+3. 计算耗时 elapsed = ms_tick - start_tick
+4. 若 elapsed > APP_ONRUN_MAX_TICKS → 设置 is_running = 0（暂停）
+5. 否则保持 is_running = 1（继续）
 ```
 
 ---
 
-## 4. 软件层级架构与核心代码框架
+## 4. 事件采集、缓冲与流转机制 (Event Bus)
 
-软件系统采用 **分层依赖、事件驱动、非阻塞** 的模块化架构设计。其层级结构与核心依赖关系如下：
+事件总线层是实现前后台解耦的核心，支持多级优先级、紧急直通和事件丢弃机制。
 
-### 4.1 系统软件架构分层 (三层架构设计)
-
-为了清晰呈现系统的软硬件隔离层次，手环系统采用单向依赖的层级架构：
+### 4.1 事件流转完整架构
 
 ```mermaid
 graph TD
-    subgraph APP ["应用逻辑层 (APP Layer)"]
-        MainScheduler["主循环调度 (main.c)"]
-        SysStateMachine["业务状态机 (sys_state)"]
-    end
-    subgraph DRV ["外设驱动层 (DRV Layer)"]
-        KEY["KEY 驱动"]
-        RF["RF 驱动"]
-        AMOLED["AMOLED 屏刷"]
-        PM["PM 功耗驱动"]
-        LED["LED 彩灯驱动"]
-        MOTOR["马达震动驱动"]
-    end
-    subgraph HW ["硬件抽象与时基层 (HW Layer)"]
-        Timer1["Timer 1 中断时基"]
-        GPIO["GPIO / ADC / IAP Flash"]
-    end
-
-    HW ===>|驱动时基与中断沿| DRV
-    DRV ===>|提供抽象API与事件缓冲区| APP
-    APP ===>|调度外设控制指令| DRV
-```
-
-### 4.2 输入事件采集与流转链条 (Input Event Dataflow)
-
-展示按键与无线接收信号从物理引脚触发，经过驱动消抖/解码，进入软件事件缓冲区，并最终被主循环及状态机消费的完整依赖链路：
-
-```mermaid
-graph LR
-    %% 输入物理源 -> 驱动解码 -> 软件缓冲区 -> 状态机消费
-    Pin_Key["物理按键 P2.0-P3.7"] -->|10ms 定时扫描| KEY["KEY 扫描与消抖"]
-    KEY -->|判定按键事件| Buf_Key["key_event_buf (环形事件队列)"]
-    Buf_Key -->|主循环读取并清除| Scheduler["主循环 (main.c)"]
-
-    Pin_RF["433MHz 载波沿信号"] -->|INT2 中断触发| RF["RF 自适应解调解码"]
-    RF -->|解码合法 RFEvent| Scheduler
+    %% 事件产生层
+    HW_Sig["物理引脚状态跳变"] -->|电平变化中断| Driver["驱动中断 ISR"]
+    Driver -->|消抖/解调| Packer["封装统一事件 SystemEvent"]
     
-    Scheduler -->|分发有效事件| StateMachine["业务状态机 (SysState)"]
+    %% 优先级判断与分流
+    Packer -->|判断优先级| PriorityJudge{"优先级判断"}
+    
+    %% 紧急事件直通路径
+    PriorityJudge -->|URGENT| EmergencyDispatch["EventQueue_EmergencyDispatch()"]
+    EmergencyDispatch -->|直接调用| AppMgr["APP 管理器"]
+    
+    %% 普通事件队列路径
+    PriorityJudge -->|非URGENT| Queue["EventQueue 环形缓冲区 (深度8)"]
+    Queue -->|主循环轮询| MainLoop["MainLoop 轮询读取"]
+    MainLoop -->|事件分发| AppMgr
+    
+    %% 应用层处理
+    AppMgr -->|步骤1: 前台优先| FG_App["当前活跃前台应用 active_app"]
+    FG_App -->|返回 EVENT_IGNORED| BG_Check{"后台应用检查"}
+    FG_App -->|返回 EVENT_HANDLED| Done["事件处理完成"]
+    
+    BG_Check -->|存在后台应用| BG_Apps["遍历所有后台应用"]
+    BG_Check -->|无后台应用| Discard["事件丢弃"]
+    
+    BG_Apps -->|某后台返回 EVENT_HANDLED| Done
+    BG_Apps -->|所有后台返回 EVENT_IGNORED| Discard
 ```
 
-### 4.3 控制输出与外设执行链路 (Output Control Flow)
+### 4.2 事件分发优先级规则
 
-展示业务状态机跳转后，如何通过驱动层向底层硬件引脚输出电平信号，以驱动显示、声光报警、马达振动及电源 PMIC 切断：
+事件在应用层的分发遵循以下严格顺序：
 
-```mermaid
-graph LR
-    %% 状态机 -> 外设执行接口 -> 物理引脚拉低/高
-    StateMachine["业务状态机 (SysState)"] -->|Redraw=1 重绘页面| AMOLED["Truly RM69310 绘制"]
-    StateMachine -->|防区警示闪烁| LED["WS2812B 彩灯控制"]
-    StateMachine -->|特定防区震动模式| MOTOR["马达时序控制"]
-    StateMachine -->|无操作 10s 超时休眠| PM["PM 功耗与电源断电"]
-
-    AMOLED -->|SPI 引脚输出| Pin_OLED["OLED 屏幕 (Pin 9-14)"]
-    LED -->|P2.6 单线时序| Pin_LED["RGB 灯珠 (Pin 27)"]
-    MOTOR -->|P2.4 PWM 电平| Pin_Mot["马达驱动 (Pin 25)"]
-    PM -->|P2.7 SHUT 拉低| Pin_PMIC["SGM3833 PMIC (Pin 28)"]
+```
+事件分发流程：
+┌─────────────────────────────────────────────────────────────┐
+│  1. 优先分发给当前活跃的前台应用 (active_app->onEvent())   │
+│     ├── 返回 EVENT_HANDLED → 事件处理完成，结束分发         │
+│     └── 返回 EVENT_IGNORED → 继续下一步                    │
+├─────────────────────────────────────────────────────────────┤
+│  2. 分发给所有后台应用 (遍历 app_registry)                   │
+│     ├── 跳过非后台应用和未注册应用                          │
+│     ├── 逐个调用 bg_app->onEvent()                         │
+│     ├── 某后台返回 EVENT_HANDLED → 事件处理完成，结束分发   │
+│     └── 所有后台返回 EVENT_IGNORED → 继续下一步            │
+├─────────────────────────────────────────────────────────────┤
+│  3. 事件被丢弃（无应用处理该事件）                          │
+└─────────────────────────────────────────────────────────────┘
 ```
 
-### 4.4 架构设计与依赖原则说明
-
-1.  **单向依赖原则**：
-    *   **APP 层**仅依赖于 **DRV 层**提供的高级抽象接口（例如 `LED_Set_Color`、`Motor_Start_Pattern`）和 **HW 层**的数据库读写。**严禁**在 APP 层直接写入具体 IO 寄存器。
-    *   **DRV 层**调用 **HW 层**提供的基础时基与 GPIO 端口函数，不保存任何系统级别的状态变量（`current_state` 等）。
-    *   **HW 层**为最底层，除触发中断服务子程序 (ISR) 外，不依赖任何上层逻辑。
-
-2.  **事件驱动与非阻塞机制**：
-    *   **按键事件缓冲机制**：`KEY` 驱动在 Timer1 中断中进行每 10ms 的定时扫描消抖。识别到有效按键动作后，将其转换为 `KeyEvent` 并压入内部的 **环形事件队列**。主循环通过轮询读出该事件，避免了在按键按下时产生任何 `while` 等待导致系统挂起。
-    *   **马达与彩灯的异步时序设计**：`MOTOR` 与 `LED` 的报警波形（如：长震、间歇闪烁）均采用在 1ms 中断中自动扣减计数器的方式实现。APP 层发出启动指令后立即返回，由硬件中断负责底层的波形电平跳转，保证了射频解码及按键响应不会因为声光报警动作而产生卡顿。
-
-3.  **电源控制与低功耗恢复链条**：
-    *   休眠决策完全由主循环内的 `inactivity_timer` 进行倒计时判定。
-    *   进入休眠前，由 `PM` 驱动断开 `SGM3833` 电源以彻底消除 AMOLED 的暗漏电流。
-    *   唤醒时，由 GPIO 的电平沿变化触发中断，唤醒 CPU 后由 `PM` 优先执行 **“上电 -> 强延时 50ms 避开浪涌 -> 屏幕控制器重初始化”** 的安全恢复时序，防止未稳定电网下的写屏导致屏幕损坏或花屏。
-
-### 4.5 核心主程序调度框架 (main.c)
-
-主程序采用完全解耦的时间片轮询加事件触发的非阻塞循环结构：
+### 4.3 扩展事件结构体
 
 ```c
-#include "config.h"
-
-// 全局状态变量
-SystemState current_state;
-u16 inactivity_timer;
-u32 rx_addr;
-u8 rx_type;
-
-void main(void) {
-    // 1. 初始化底层硬件与外设驱动
-    System_Init();
-    Power_Init();      // SGM_CTRL 默认拉高工作
-    LCD_Init();        // Truly AMOLED 初始化
-    RF_Init();         // LR690L 接收中断与发射初始化
-    WS2812_Init();     // 双级联彩灯初始化
-    Motor_Init();      // 马达脉冲时序初始化
-    ADC_Init();        // 电池采样初始化
-    
-    // 2. 载入持久化数据配置
-    Load_Database();
-    
-    // 3. 初始化软件状态与计时器
-    current_state = STATE_CLOCK;
-    inactivity_timer = 0;
-    Redraw = 1;
-    
-    // 开启全局中断
-    EA = 1;
-    
-    // 4. 核心主循环轮询调度
-    while (1) {
-        // A. 轮询射频接收
-        if (EV1527_Decode(&rx_addr, &rx_type)) {
-            inactivity_timer = 0; // 重置休眠计数
-            Process_RF_Event(rx_addr, rx_type);
-        }
-        
-        // B. 轮询并消耗按键事件
-        if (key_event_buf != KEY_EVENT_NONE) {
-            KeyEvent evt = key_event_buf;
-            key_event_buf = KEY_EVENT_NONE; // 清空事件
-            inactivity_timer = 0;           // 重置休眠计数
-            
-            Process_System_Event(evt);
-        }
-        
-        // C. 超时低功耗检测判定
-        if (inactivity_timer >= 1000) { // 10秒无操作
-            inactivity_timer = 0;
-            current_state = STATE_SLEEP;
-            
-            // 执行硬件关屏断电并让单片机进入深度休眠
-            Enter_Low_Power_Sleep();
-            
-            // 被外部中断唤醒后从此处开始继续向下运行，执行电源与显示恢复
-            Wakeup_Restore();
-            current_state = STATE_CLOCK;
-            Redraw = 1;
-        }
-        
-        // D. 屏幕刷新渲染调度
-        if (Redraw) {
-            Redraw = 0; // 清除标志
-            Render_UI_Screen(current_state);
-        }
-        
-        // E. 喂狗操作
-        WDT_CONTR = 0x17;
-    }
-}
+typedef struct {
+    KeyEvent key_event;     // 原始按键事件
+    EventPriority priority; // 事件优先级 (LOW/NORMAL/HIGH/URGENT)
+    u32 extra_data;         // 额外数据（如射频地址、时间信息等）
+    u8 extra_size;          // 额外数据有效字节数
+} SystemEvent;
 ```
 
+### 4.4 环形事件缓冲区 (EventQueue)
+
+为防止高速按键或多输入源并发导致事件丢失，系统建立一个深度为 **8 级** 的环形事件队列：
+
+*   **队列深度**：`EVENT_QUEUE_DEPTH = 8`
+*   **入队操作**：`EventQueue_Push(evt)` — 非阻塞，队列满时返回 0（丢弃事件）
+*   **出队操作**：`EventQueue_Pop()` — 返回队首事件，队空时返回空事件
+*   **中断保护**：队列操作时禁用全局中断 (`EA=0`)，操作完成后恢复 (`EA=1`)，确保原子性
+*   **紧急直通**：`EventQueue_EmergencyDispatch(evt)` — 跳过队列，直接调用 `AppManager_DispatchEvent()`
+
+#### 队列内部结构
+
+```c
+static SystemEvent event_queue[EVENT_QUEUE_DEPTH];  // 环形缓冲区存储
+static u8 queue_head = 0;   // 读指针：指向即将读取的位置
+static u8 queue_tail = 0;   // 写指针：指向即将写入的位置
+static u8 queue_count = 0;  // 当前队列中的事件数量
+```
+
+#### 队列操作流程
+
+```
+入队 (Push):
+1. 检查队列是否已满 → 满则返回失败
+2. 禁用中断 (EA=0)
+3. event_queue[queue_tail] = evt
+4. queue_tail = (queue_tail + 1) % EVENT_QUEUE_DEPTH
+5. queue_count++
+6. 恢复中断 (EA=1)
+7. 返回成功
+
+出队 (Pop):
+1. 检查队列是否为空 → 空则返回空事件
+2. 禁用中断 (EA=0)
+3. evt = event_queue[queue_head]
+4. queue_head = (queue_head + 1) % EVENT_QUEUE_DEPTH
+5. queue_count--
+6. 恢复中断 (EA=1)
+7. 返回事件
+```
+
+### 4.5 事件产生机制
+
+#### 按键事件产生
+*   Timer1 定时器每 10ms 中断扫描物理引脚
+*   判定有效按键后执行 `EventQueue_Push()` 或 `EventQueue_EmergencyDispatch()`（SOS事件）
+
+#### RF 事件产生
+*   LR690L 接收中断触发，解码线程还原 24 位载波包
+*   识别到配对传感器动作，推送对应防区事件
+
+#### 系统事件产生
+*   定时器分钟变化时推送时钟更新事件（低优先级）
+
 ---
 
-## 5. 模块间输入/输出事件与流转处理消耗图
+## 5. 持久化配置数据库架构
 
-为了使各功能模块（Drivers & App）交互逻辑清晰可见，下表整理了各模块产生的事件源（输入）及其被消费（输出）的处理链路：
+手环配对防区数据存储在 STC32G 内置 Flash 的第 254 扇区：
+*   **物理存储地址**：`0xFE0000` (末尾 512 字节)。
+*   **数据库容量**：共 16 组传感器配置槽位。
+*   **存储结构定义**：
 
-### 5.1 模块输入/输出事件矩阵
-
-| 模块名称 | 输入源 (触发源) | 产生/发出事件 | 输出消费对象 (消费处理) |
-| :--- | :--- | :--- | :--- |
-| **按键模块 (KEY)** | 物理引脚（P0.1~P0.5）电平状态改变 | `KeyEvent`<br>- `KEY_UP_SHORT` / `KEY_DOWN_SHORT`<br>- `KEY_DOWN_LONG` (长按▼ 2秒)<br>- `KEY_CONFIRM_CLICK`<br>- `KEY_CONFIRM_LONG` (长按■ 3秒)<br>- `KEY_SOS_SHORT` / `KEY_SOS_LONG` (SOS键短按或长按) | 写入全局事件缓冲队列 `key_event_buf`。由 **APP 应用状态机** 读出后用于控制页面导航、退出告警或启动对码。 |
-| **无线射频 (RF)** | LR690L 433MHz 载波信号接收（输入电平变化） | `RFEvent` (包含 `rx_addr` 与 `rx_type`) | 传递至 **APP 状态机** 的 `Process_RF_Event` 进行报警分发。 |
-| **状态机 (APP)** | 消耗 `key_event_buf` 或 `RFEvent` | `SysState` 业务状态跳转及动作指令 | 1. 改变 `current_state` 并设置 `Redraw = 1`；<br>2. 调度 **LED** 及 **MOTOR** 开启报警灯效/马达振动；<br>3. 写入 **IAP Flash 数据库** 配对记录；<br>4. 调用 **RF** 发送对码或主动SOS信号。 |
-| **显示模块 (LCD)** | 状态机重绘请求 `Redraw == 1` | SPI 像素渲染显示流 | 驱动 **Truly AMOLED** 渲染当前状态所对应的时钟、主菜单、对码、时间设定或报警画面。 |
-| **供电管理 (POWER)**| 1. `inactivity_timer >= 1000` (10秒超时)<br>2. 中断唤醒信号 (GPIO/INT2) | 电源电平控制及停机状态 | 1. **进入休眠**：发出关屏指令 -> 拉低 `SGM_CTRL = 0` -> 执行停机挂起（主循环暂停在 `Enter_Low_Power_Sleep` 内）；<br>2. **唤醒恢复**：拉高 `SGM_CTRL = 1` -> 延时 50ms -> 重新初始化 RM69310 屏幕控制器（主循环恢复运行并重绘时钟）。 |
-| **彩灯模块 (LED)** | 状态机调用报警指示请求 | SPI 48-bit 灯珠级联控制字 | 向两颗级联的 WS2812B 发送颜色数据（报警时交替闪烁，配对时常亮）。 |
-| **马达模块 (MOTOR)**| 状态机请求按键反馈/告警振动 | IO 电平状态控制字 (P2.5) | 定时驱动 `P2.5` 引脚电平产生不同振动波形（如短振、长振、间歇循环振动）。 |
-
-### 5.2 事件流转与消费链路拓扑
-
-手环系统的输入事件（按键中断与无线载波中断）在主循环中的处理与消耗流转关系如下：
-
-```mermaid
-flowchart TD
-    %% 硬件输入事件
-    PinKey[物理按键按下 / 下降沿] -->|P2.0-P3.7 端口中断| ISR_Port0[GPIO 中断 ISR]
-    Carrier[433MHz 射频载波信号] -->|INT2 中断| ISR_INT2[INT2 唤醒中断 ISR]
-    
-    %% 中断服务层 (ISR)
-    ISR_Port0 -->|唤醒系统并每10ms扫描| KeyScan[消抖与长短按判定]
-    ISR_INT2 -->|唤醒系统并使能软解码| RFDecode[EV1527 自适应比值解码]
-    
-    %% 事件过滤与缓冲层
-    KeyScan -->|判定有效按键事件| BufKey[写入 key_event_buf 缓冲区]
-    RFDecode --> ProcessRF[生成合法传感器 RFEvent]
-    
-    %% APP 状态机消费处理
-    BufKey -->|主循环读取并重置| SM_Key[消费按键事件]
-    ProcessRF -->|主循环调用并比对配置| SM_RF[消费已配对防区报警]
-    
-    SM_Key -->|CONFIRM 长按 3s| StateMenu[切入 STATE_MENU 并 Redraw=1]
-    SM_Key -->|子页面确认操作| StateSub[执行配对/布防/时间设定并 IAP 写入]
-    SM_Key -->|点击/长按 SOS 键| EmitSOS[调用 RF 主动发射 0x08 SOS 信号]
-    SM_Key -->|告警状态任意键| ClearAlarm[清除本地报警状态并退回时钟]
-    
-    SM_RF -->|匹配成功且处于布防| LocalAlarm[触发 LED 交替闪烁 & 马达间歇振动]
-    
-    %% 显示与控制响应
-    StateMenu -->|Redraw == 1| LcdPaint[Truly AMOLED 屏幕局部像素重绘]
-    StateSub -->|Redraw == 1| LcdPaint
-    LocalAlarm -->|Redraw == 1| LcdPaint
-    EmitSOS -->|Redraw == 1| LcdPaint
+```c
+typedef struct {
+    u8 flags_suffix; // 属性字节：Bit 7 代表有效标志 (1: 有效, 0: 空闲)；Bit 0~6 代表法语防区名称的后缀序号 (01~99)
+    u8 addr[3];      // 24位射频物理地址 (EV1527 地址 + 4位状态数据码)
+} Sensor_Slot;
 ```
 
 ---
 
 ## 6. 核心业务事件输入输出 (I/O) 架构明细表
 
-为实现绝对清晰的软硬件交互链路，以下为手环核心业务事件的端到端输入、输出及流转逻辑汇总：
+手环核心事件在整个框架中的端到端流动及消耗链路如下：
 
-### 6.1 核心事件 I/O 矩阵
+| 事件名称 | 输入源 (触发条件与参数) | 事件优先级 | 流转方式 | 活跃 APP 消费处理 (逻辑响应与动作) |
+| :--- | :--- | :--- | :--- | :--- |
+| **按键操作事件**<br>`KEY_EVENT` | **源**：Pin 30/31/32 (Port 0) 下降沿中断。<br>**参数**：▲/▼/■ (短按/长按)。 | NORMAL | **入队**：`EventQueue_Push` 压入队列 | **待机应用**：长按确认键 3 秒，调用 `StartApp(APP_MENU)`；<br>**菜单应用**：短按 ▲/▼ 键移动高亮焦点；短按确认键调用 `StartApp` 进入对应子设置应用。 |
+| **主动求救事件**<br>`KEY_EVENT_SOS_CLICK` / `KEY_EVENT_SOS_LONG` | **源**：Pin 27 (`P2.6`) SOS 物理键拉低。<br>**参数**：短按触发 `KEY_EVENT_SOS_CLICK`，长按触发 `KEY_EVENT_SOS_LONG`。 | **URGENT** | **直通**：`EventQueue_EmergencyDispatch` 跳过队列直接分发 | **SOS报警应用**：<br>1. 显示：OLED 屏亮起 `SOS EMIS`；<br>2. 灯效：WS2812B 红色交替闪烁 (50ms)；<br>3. 马达：开启间歇长振 (振1000ms，停200ms)；<br>4. 射频：启动发送线程周期性（2s）发射手环 Factory ID 及 `0x08` (SOS) 包。 |
+| **无线对码捕获事件**<br>`RF_PAIR_RECV_EVENT` | **源**：Pin 22 (`P2.1`) 沿变化中断。<br>**参数**：EV1527 24位对码信号。 | NORMAL | **入队**：`EventQueue_Push` 压入队列 | **配对应用**：<br>1. 状态：跳转进入 `STATE_PAIR_CONFIRM` (微调保存页)；<br>2. 显示：只读显示自动识别传感器类型及大图标；<br>3. 马达：短振 300ms 提醒成功；<br>4. 交互：通过按键微调序号并写入 Flash 数据库。 |
+| **传感器入侵警报事件**<br>`RF_ALARM_RECV_EVENT` | **源**：Pin 22 (`P2.1`) 沿变化中断。<br>**参数**：传感器物理地址 + 4位状态码。 | HIGH | **入队**：`EventQueue_Push` 压入队列 | **警报应用**：若该防区为 ZONE 0 (24h) 或处于已布防，APP管理器启动 `StartApp(APP_ALARM)`。<br>1. 显示：OLED 刷红边框与对应大图标，显示入侵警报文字；<br>2. 灯效：同步闪烁该防区专属色彩；<br>3. 马达：输出对应防区的特定异步振动波形。 |
+| **系统自动休眠事件**<br>`AUTO_SLEEP_EVENT` | **源**：软件时钟计时 `inactivity_timer >= 1000` (10s)。 | LOW | **入队**：`EventQueue_Push` 压入队列 | **所有非警报应用**：执行 `onClose()` → 调用 PM 模块拉低 `SHUT=0`（Pin 23）彻底切断屏幕供电 → 配置 GPIO 变化中断和无线唤醒源 → 执行 `PCON|=0x02` 进入停机休眠。 |
+| **中断唤醒系统事件**<br>`SYSTEM_WAKEUP_EVENT` | **源**：GPIO 按键下降沿或无线信号变化触发硬件唤醒。 | HIGH | **入队**：`EventQueue_Push` 压入队列 | **系统底层**：优先拉高 `SHUT=1` 重新开启 SGM3833 供电 → **阻塞强延时 50ms 避开浪涌** → 完整重新配置 RM69310 屏幕控制器 → 调用 `StartApp(APP_CLOCK)` 恢复时钟显示状态。 |
 
-| 事件名称 | 输入源 (触发条件与参数) | 状态机判定逻辑 (当前状态与条件) | 输出结果 & 动作执行 (显示、灯效、马达与无线) |
-| :--- | :--- | :--- | :--- |
-| **按键操作事件**<br>`KEY_EVENT` | **源**：P2.0~P3.7 下降沿中断。<br>**参数**：`KEY_UP`、`KEY_DOWN`、`KEY_CONFIRM` (短按/长按)。 | **当前状态**：`STATE_CLOCK` / `STATE_MENU` 等。<br>**条件**：在待机下长按确认键 3 秒进入菜单；在菜单下短按 ▲/▼ 键翻页。 | 1. **显示**：置 `Redraw = 1`，LCD 刷新切换对应页面；<br>2. **触觉**：发出 50ms 极短振动作按键反馈。 |
-| **主动求救事件**<br>`SOS_ACTIVE_EVENT` | **源**：上部任意 SOS 按键按下（短按或长按）。 | **当前状态**：除已报警外的任意业务状态。<br>**条件**：无视当前状态，拥有最高抢占优先级。 | 1. **状态**：切入 `STATE_SOS_EMITTED`；<br>2. **无线**：通过 LR690L 周期性（2s）发射手环 Factory ID 及 `0x08` (SOS) 数据包；<br>3. **显示**：LCD 闪烁呈现超大警灯与分行 `SOS EMIS` 字样；<br>4. **灯效**：WS2812B 红色高速交替闪烁（50ms周期）；<br>5. **马达**：持续间歇长振（振 1000ms，停 200ms）。 |
-| **无线对码捕获事件**<br>`RF_PAIR_RECV_EVENT` | **源**：LR690L 接收 433MHz 对码载波包。<br>**参数**：24-bit 物理地址 + 4-bit 传感器类型数据码。 | **当前状态**：`STATE_PAIR_SEARCH` (搜索对码中)。<br>**条件**：捕获到合法 EV1527 帧。 | 1. **状态**：切换至 `STATE_PAIR_CONFIRM` (确认微调)；<br>2. **显示**：只读显示自动识别的传感器名称（如 `PORTE`）、大图标，以及超大 `[ 01 ]` 序号选框；<br>3. **马达**：发出 300ms 短振提醒成功捕获。 |
-| **传感器入侵警报事件**<br>`RF_ALARM_RECV_EVENT` | **源**：LR690L 接收 433MHz 警报载波包。<br>**参数**：传感器地址 + 4-bit 状态码。 | **当前状态**：`STATE_CLOCK` (待机)。<br>**条件**：1. 地址与 Flash 数据库匹配；<br>2. 该防区属于 ZONE 0 (24h) 或处于已布防状态下的 ZONE 1。 | 1. **状态**：切入 `STATE_ALARMING`；<br>2. **显示**：LCD 亮起 4px 闪烁红边框与 64x64px 对应传感器报警图标，显示 `PORTE 01 INTRUSION!`；<br>3. **灯效**：WS2812B 闪烁对应传感器防区色彩（500ms闪烁）；<br>4. **马达**：根据传感器类型，输出对应的间歇振动波形（如门磁短振 1 次）。 |
-| **系统自动休眠事件**<br>`AUTO_SLEEP_EVENT` | **源**：软件时钟 `inactivity_timer >= 1000` (10s)。 | **当前状态**：`STATE_CLOCK` / `STATE_MENU` / `STATE_SET_TIME` 等非报警状态。 | 1. **状态**：切入 `STATE_SLEEP`；<br>2. **硬件**：拉低 `SGM_CTRL = 0` 切断 AMOLED PMIC 供电；<br>3. **电源**：使能 P0 口电平中断及 INT2，挂起 CPU 进入 Power-Down 极低功耗模式。 |
-| **中断唤醒系统事件**<br>`SYSTEM_WAKEUP_EVENT` | **源**：GPIO 端口按键沿变化或 INT2 载波接收中断。 | **当前状态**：`STATE_SLEEP` (深度休眠中)。 | 1. **状态**：切回 `STATE_CLOCK`；<br>2. **电源**：拉高 `SGM_CTRL = 1` 恢复 OLED 供电；<br>3. **延迟**：延时 50ms 避开冲击电流并完成 RM69310 的重初始化；<br>4. **显示**：置 `Redraw = 1` 重绘时钟走时界面格式。 |
-| **IPC 摄像头对码事件**<br>`IPC_BIND_SEND_EVENT` | **源**：在菜单中确认进入 `4. LIAISON`。 | **当前状态**：`STATE_IPC_BIND`。 | 1. **无线**：连发 433MHz 手环 Factory ID 及 `0x01` 绑定对码包；<br>2. **显示**：呈现 48x48px 摄像头大图标及 `LIAISON EN COURS`；<br>3. **退出**：长按确认键 3 秒或长按 ▼ 键 2 秒，退出并恢复时钟。 |
-| **警报解除复位事件**<br>`ALARM_CLEAR_EVENT` | **源**：报警状态下侧边或上部任意按键按下。 | **当前状态**：`STATE_ALARMING` 或 `STATE_SOS_EMITTED`。 | 1. **状态**：切回 `STATE_CLOCK`；<br>2. **灯效**：WS2812B 彻底熄灭；<br>3. **马达**：清空马达状态并立即停振；<br>4. **显示**：置 `Redraw = 1`，LCD 重绘走时时钟。 |
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V3 -->
+<!-- Updated with foreground/background app separation, event priority system, emergency dispatch, and CPU occupancy control -->

Docs/50_module-breakdown/mod-app.md

@@ -0,0 +1,413 @@
+# 模块拆分 - 应用执行层 (Docs/50_module-breakdown/mod-app.md)
+
+本模块描述手环的 App 调度管理器（AppManager）、前台/后台应用架构、生命周期钩子（OnStart, onRun, onClose, onEvent）、事件分发机制、CPU占用控制以及各功能模块的页面渲染与状态机调度设计。
+
+---
+
+## 1. 模块职责说明
+
+### 1.1 核心职责
+
+| 职责领域 | 描述 |
+| :--- | :--- |
+| **应用生命周期管理** | 维护应用注册表，管理应用的启动、切换、关闭流程 |
+| **前台/后台应用分离** | 支持前台应用独占屏幕和后台应用持续监听的双轨运行模式 |
+| **事件分发路由** | 实现前台优先、后台兜底、未处理丢弃的事件分发策略 |
+| **CPU占用控制** | 监控应用 onRun() 执行时间，防止单个应用长时间占用CPU |
+| **应用状态维护** | 维护活跃应用指针、应用运行状态标记等核心数据结构 |
+
+### 1.2 应用类型划分
+
+系统将应用分为两大类，通过 `AppType` 枚举区分：
+
+| 应用类型 | 标识 | 特性 | 生命周期 |
+| :--- | :--- | :--- | :--- |
+| **前台应用** | `APP_TYPE_FOREGROUND` | 独占屏幕显示，响应用户交互，一次只有一个活跃 | `OnStart` → `onRun`(循环) → `onClose` |
+| **后台应用** | `APP_TYPE_BACKGROUND` | 无屏幕显示，持续运行监听特定事件，可多个同时运行 | 注册后自动运行，无显式启动/关闭 |
+
+### 1.3 应用列表
+
+| 应用ID | 应用名称 | 类型 | 职责描述 |
+| :--- | :--- | :--- | :--- |
+| `APP_ID_CLOCK` | ClockApp | 前台 | 待机时钟应用，中央以 32x64px 超大点阵渲染当前时分，右上角渲染 16x32px 电量百分比及充电指示；后台监听射频报警信号 |
+| `APP_ID_MENU` | MenuApp | 前台 | 主菜单应用，单屏单条目显示交互，支持 ▲/▼ 键高亮切换，确认键进入对应子页面 |
+| `APP_ID_PAIR` | PairApp | 前台 | 配对与微调应用，对码捕捉到未配对 24 位射频码时拉起，提供微调序号选框，确认后存入持久化 Flash |
+| `APP_ID_ALARM` | AlarmApp | 前台 | 传感器报警应用，被后台监测唤醒拉起，屏幕闪烁红色粗边框，调度马达振动波形与 LED 警示颜色 |
+| `APP_ID_SOS` | SOSApp | 前台 | 主动求救应用，短按/长按 SOS 物理按键拉起，周期性发射 0x08 (SOS) 无线电数据，触发最高优先级的持续马达震动及红色幻彩灯爆闪 |
+
+---
+
+## 2. 核心数据结构
+
+### 2.1 应用描述符结构 (WristbandApp)
+
+```c
+typedef struct {
+    AppID app_id;           // 应用唯一标识 (APP_ID_CLOCK/MENU/PAIR/ALARM/SOS)
+    AppType app_type;       // 应用类型 (APP_TYPE_FOREGROUND / APP_TYPE_BACKGROUND)
+    char *app_name;         // 应用名称（用于调试日志输出）
+    
+    // 生命周期回调函数指针
+    void (*OnStart)(void);         // 启动回调：应用切入前台，加载资源、初始化显示
+    void (*onRun)(void);           // 循环回调：主循环轮询调用，执行非阻塞业务逻辑
+    void (*onClose)(void);         // 关闭回调：应用退出前台，保存状态、清理外设
+    EventResult (*onEvent)(SystemEvent evt); // 事件回调：接收并处理系统事件
+    
+    // 运行状态标记
+    bit is_active;          // 当前是否活跃（仅对前台应用有效，标识是否在前台运行）
+    bit is_running;         // 应用是否处于运行状态（用于CPU占用控制，标记是否允许调用onRun）
+} WristbandApp;
+```
+
+### 2.2 应用ID枚举
+
+```c
+typedef enum {
+    APP_ID_CLOCK,           // 0: 待机时钟应用
+    APP_ID_MENU,            // 1: 主菜单应用
+    APP_ID_PAIR,            // 2: 配对与微调应用
+    APP_ID_ALARM,           // 3: 传感器报警应用
+    APP_ID_SOS,             // 4: 主动求救应用
+    APP_ID_MAX              // 5: 应用数量上限（用于数组大小）
+} AppID;
+```
+
+### 2.3 应用类型枚举
+
+```c
+typedef enum {
+    APP_TYPE_FOREGROUND,    // 前台应用：独占屏幕和用户交互
+    APP_TYPE_BACKGROUND     // 后台应用：无屏幕显示，仅监听事件
+} AppType;
+```
+
+### 2.4 事件处理返回值
+
+```c
+typedef enum {
+    EVENT_HANDLED,          // 事件已处理，停止继续分发
+    EVENT_IGNORED           // 事件未处理，继续传递给下一个应用
+} EventResult;
+```
+
+---
+
+## 3. 应用管理器核心接口
+
+### 3.1 初始化与注册接口
+
+| 接口名称 | 函数签名 | 功能描述 |
+| :--- | :--- | :--- |
+| `AppManager_Init` | `void AppManager_Init(void)` | 初始化应用管理器，初始化应用注册表，设置默认活跃应用为 ClockApp |
+| `AppManager_RegisterApp` | `void AppManager_RegisterApp(AppID app_id, AppType app_type, char *app_name, AppStartFunc on_start, AppRunFunc on_run, AppCloseFunc on_close, AppEventFunc on_event)` | 注册应用到注册表，绑定生命周期回调函数 |
+
+### 3.2 应用切换接口
+
+| 接口名称 | 函数签名 | 功能描述 |
+| :--- | :--- | :--- |
+| `AppManager_StartApp` | `void AppManager_StartApp(AppID app_id)` | 启动指定应用：关闭当前活跃应用 → 切换活跃应用指针 → 启动新应用 |
+| `AppManager_CloseApp` | `void AppManager_CloseApp(void)` | 关闭当前活跃应用，回退到默认应用（ClockApp） |
+| `AppManager_GetActiveAppID` | `AppID AppManager_GetActiveAppID(void)` | 获取当前活跃应用的 ID |
+
+### 3.3 事件分发接口
+
+| 接口名称 | 函数签名 | 功能描述 |
+| :--- | :--- | :--- |
+| `AppManager_DispatchEvent` | `void AppManager_DispatchEvent(SystemEvent evt)` | 分发事件到应用层：前台优先 → 后台兜底 → 未处理丢弃 |
+| `AppManager_BroadcastToBackground` | `void AppManager_BroadcastToBackground(SystemEvent evt)` | 广播事件给所有后台应用（用于系统级事件） |
+| `AppManager_RunActiveApp` | `void AppManager_RunActiveApp(void)` | 运行当前活跃应用的 onRun 回调（带 CPU 占用控制） |
+
+---
+
+## 4. 应用生命周期调度机制
+
+### 4.1 生命周期状态转换
+
+```mermaid
+graph LR
+    subgraph 前台应用状态
+        Idle["未注册 / 空闲"] -->|注册| Registered["已注册"]
+        Registered -->|StartApp| Active["活跃中 (OnStart)"]
+        Active -->|onRun循环| Running["运行中"]
+        Running -->|StartApp(其他)| Closing["关闭中 (onClose)"]
+        Closing -->|切换完成| Active
+        Running -->|CloseApp| Closing
+        Closing -->|回退完成| Default["默认状态 (ClockApp)"]
+    end
+    
+    subgraph 后台应用状态
+        BG_Idle["未注册"] -->|注册| BG_Running["持续运行"]
+        BG_Running -->|接收事件| BG_Handling["事件处理中"]
+        BG_Handling -->|处理完成| BG_Running
+    end
+```
+
+### 4.2 生命周期回调语义
+
+| 回调函数 | 调用时机 | 职责要求 |
+| :--- | :--- | :--- |
+| `OnStart()` | 应用切入前台时 | 初始化显示、加载资源、重置状态变量 |
+| `onRun()` | 主循环每轮调用 | 执行非阻塞业务逻辑（如动画更新、超时检测），必须控制执行时间 |
+| `onClose()` | 应用退出前台时 | 保存状态、清理外设（关屏、停振、关闭射频等） |
+| `onEvent(evt)` | 收到事件时 | 处理事件，返回 `EVENT_HANDLED` 或 `EVENT_IGNORED` |
+
+### 4.3 应用切换流程
+
+```
+AppManager_StartApp(target_app_id) 执行流程：
+
+1. 参数有效性检查
+   ├── app_id >= APP_ID_MAX → 返回错误
+   ├── 目标应用非前台应用 → 返回错误
+   └── 目标应用未注册 (OnStart == NULL) → 返回错误
+
+2. 目标应用已是活跃应用 → 直接返回
+
+3. 关闭当前活跃应用
+   └── active_app->onClose() → 清理外设、保存状态
+
+4. 切换活跃应用指针
+   └── active_app = &app_registry[target_app_id]
+
+5. 启动新应用
+   └── active_app->OnStart() → 初始化显示、加载资源
+```
+
+---
+
+## 5. 事件分发机制
+
+### 5.1 事件分发优先级规则
+
+事件在应用层的分发遵循严格的优先级顺序，确保前台应用优先响应，后台应用作为兜底：
+
+```
+事件分发流程 (AppManager_DispatchEvent):
+
+┌──────────────────────────────────────────────────────────────┐
+│  Step 1: 前台应用优先处理                                    │
+│  ┌────────────────────────────────────────────────────────┐ │
+│  │ if (active_app != NULL && active_app->is_active)       │ │
+│  │ {                                                      │ │
+│  │     result = active_app->onEvent(evt);                 │ │
+│  │     if (result == EVENT_HANDLED)                       │ │
+│  │         return;  // 前台应用已处理，结束分发            │ │
+│  │ }                                                      │ │
+│  └────────────────────────────────────────────────────────┘ │
+├──────────────────────────────────────────────────────────────┤
+│  Step 2: 后台应用兜底处理                                    │
+│  ┌────────────────────────────────────────────────────────┐ │
+│  │ for (i = 0; i < APP_ID_MAX; i++)                      │ │
+│  │ {                                                      │ │
+│  │     bg_app = &app_registry[i];                         │ │
+│  │     // 跳过前台应用、未注册应用、非运行状态应用         │ │
+│  │     if (bg_app->app_type != APP_TYPE_BACKGROUND ||    │ │
+│  │         bg_app->onEvent == NULL ||                    │ │
+│  │         !bg_app->is_running)                          │ │
+│  │         continue;                                     │ │
+│  │                                                       │ │
+│  │     result = bg_app->onEvent(evt);                    │ │
+│  │     if (result == EVENT_HANDLED)                      │ │
+│  │         return;  // 某后台应用已处理，结束分发          │ │
+│  │ }                                                      │ │
+│  └────────────────────────────────────────────────────────┘ │
+├──────────────────────────────────────────────────────────────┤
+│  Step 3: 事件丢弃                                           │
+│  ┌────────────────────────────────────────────────────────┐ │
+│  │ // 所有应用都未处理该事件，事件被丢弃                   │ │
+│  │ // 可在此处添加日志记录（如果需要）                     │ │
+│  └────────────────────────────────────────────────────────┘ │
+└──────────────────────────────────────────────────────────────┘
+```
+
+### 5.2 事件处理示例
+
+以下为各应用的典型事件处理行为：
+
+| 事件类型 | ClockApp | MenuApp | PairApp | AlarmApp | SOSApp |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| `KEY_EVENT_UP_CLICK` | IGNORED | HANDLED (上移) | IGNORED | HANDLED (清除) | IGNORED |
+| `KEY_EVENT_DOWN_CLICK` | IGNORED | HANDLED (下移) | IGNORED | HANDLED (清除) | IGNORED |
+| `KEY_EVENT_SOS_CLICK` | HANDLED (启动SOS) | IGNORED | IGNORED | HANDLED (清除) | IGNORED |
+| `KEY_EVENT_UP_DOWN_COMB` | HANDLED (启动Menu) | IGNORED | IGNORED | IGNORED | IGNORED |
+| `KEY_EVENT_SOS_LONG` | HANDLED (绑定IPC) | IGNORED | HANDLED (保存) | IGNORED | HANDLED (退出) |
+| `KEY_EVENT_DOWN_LONG` | IGNORED | HANDLED (返回) | HANDLED (退出) | IGNORED | HANDLED (退出) |
+
+---
+
+## 6. CPU 占用控制机制
+
+### 6.1 设计目的
+
+为防止单个应用的 `onRun()` 回调长时间占用 CPU 导致系统响应迟钝或卡死，框架引入 **执行时间监控机制**。
+
+### 6.2 控制参数
+
+| 参数名称 | 定义 | 默认值 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `APP_ONRUN_MAX_TICKS` | onRun 最大执行时间阈值 | 5 (ms) | 超过此时间则暂停应用运行 |
+
+### 6.3 监控机制
+
+```
+AppManager_RunActiveApp() 执行流程：
+
+1. 检查应用状态
+   └── if (active_app == NULL || !active_app->is_active) → 直接返回
+
+2. 记录开始时间
+   └── start_tick = ms_tick
+
+3. 执行应用的 onRun() 回调
+   └── active_app->onRun()
+
+4. 计算执行耗时
+   └── elapsed_ticks = ms_tick - start_tick
+
+5. 判断是否超时
+   ├── if (elapsed_ticks > APP_ONRUN_MAX_TICKS)
+   │   └── active_app->is_running = 0  // 暂停应用
+   └── else
+       └── active_app->is_running = 1  // 继续运行
+```
+
+### 6.4 超时恢复
+
+*   超时后应用的 `is_running` 标记被置为 0，下一次主循环将跳过该应用的 `onRun()` 调用
+*   应用可在下一次循环中自动恢复运行（`is_running` 在 `onRun` 调用前被检查，调用后被更新）
+*   此机制不会杀死应用，仅暂停其循环执行，允许应用在后续恢复
+
+---
+
+## 7. 应用实现细节
+
+### 7.1 ClockApp（时钟应用）
+
+**职责**：待机时钟显示、后台射频监测
+
+**生命周期实现**：
+
+| 回调 | 实现逻辑 |
+| :--- | :--- |
+| `OnStart` | 初始化状态为 NORMAL，设置重绘标志 |
+| `onRun` | 分钟变化时重绘时钟；后台监听射频信号，匹配到已配对传感器触发报警 |
+| `onClose` | 清理资源 |
+| `onEvent` | 处理组合键进入菜单、SOS 按键进入求救模式、长按绑定 IPC |
+
+### 7.2 MenuApp（菜单应用）
+
+**职责**：主菜单导航
+
+**生命周期实现**：
+
+| 回调 | 实现逻辑 |
+| :--- | :--- |
+| `OnStart` | 初始化菜单选择项为 0，关闭射频，显示菜单页面 |
+| `onRun` | 无持续运行逻辑 |
+| `onClose` | 重新开启射频接收 |
+| `onEvent` | 处理上/下键切换菜单项、确认键进入配对、长按返回时钟 |
+
+### 7.3 PairApp（配对应用）
+
+**职责**：传感器配对与保存
+
+**生命周期实现**：
+
+| 回调 | 实现逻辑 |
+| :--- | :--- |
+| `OnStart` | 进入等待状态，开启射频接收，显示雷达搜索页面 |
+| `onRun` | 更新雷达动画；监听射频信号捕获对码；检测超时 |
+| `onClose` | 关闭射频，重置配对状态 |
+| `onEvent` | 处理长按退出、确认保存对码 |
+
+### 7.4 AlarmApp（报警应用）
+
+**职责**：入侵警报显示与响应
+
+**生命周期实现**：
+
+| 回调 | 实现逻辑 |
+| :--- | :--- |
+| `OnStart` | 设置状态为 ALARM，显示报警页面，重置报警定时器 |
+| `onRun` | 控制报警边框闪烁效果 |
+| `onClose` | 停止报警效果（马达、LED），恢复正常状态 |
+| `onEvent` | 任何按键清除报警 |
+
+### 7.5 SOSApp（求救应用）
+
+**职责**：主动求救模式
+
+**生命周期实现**：
+
+| 回调 | 实现逻辑 |
+| :--- | :--- |
+| `OnStart` | 设置状态为 SOS_EMITTED，显示 SOS 页面 |
+| `onRun` | 每 500ms 发射一次射频求救帧；控制红色边框闪烁 |
+| `onClose` | 停止求救效果（马达、LED），恢复正常状态 |
+| `onEvent` | 长按任意键解除求救 |
+
+---
+
+## 8. 页面渲染接口
+
+| 接口名称 | 函数签名 | 所属应用 | 功能描述 |
+| :--- | :--- | :--- | :--- |
+| `UI_ShowClockPage` | `void UI_ShowClockPage(SystemState state, u8 hour, u8 min)` | ClockApp | 绘制时钟页面，包含时间显示和电量指示 |
+| `UI_ShowPairMenuPage` | `void UI_ShowPairMenuPage(u8 selected_item)` | MenuApp | 绘制配对菜单页面，显示选中项图标和名称 |
+| `UI_ShowPairWaitPage` | `void UI_ShowPairWaitPage(u8 frame)` | PairApp | 绘制雷达搜索页面，包含动画帧 |
+| `UI_ShowPairConfirmPage` | `void UI_ShowPairConfirmPage(u32 addr)` | PairApp | 绘制配对确认页面，显示捕获到的射频地址 |
+| `UI_ShowPairSuccessPage` | `void UI_ShowPairSuccessPage(u32 addr)` | PairApp | 绘制配对成功页面 |
+| `UI_ShowPairFailPage` | `void UI_ShowPairFailPage(u8 reason)` | PairApp | 绘制配对失败页面 |
+| `UI_ShowAlarmPage` | `void UI_ShowAlarmPage(char *name, u8 severity)` | AlarmApp | 绘制报警页面，包含红色边框和传感器名称 |
+| `UI_ShowSosPage` | `void UI_ShowSosPage(void)` | SOSApp | 绘制 SOS 求救页面 |
+| `UI_ShowBindingPage` | `void UI_ShowBindingPage(void)` | ClockApp | 绘制 IPC 绑定页面 |
+
+---
+
+## 9. 应用注册表结构
+
+应用管理器维护一个静态数组 `app_registry[APP_ID_MAX]`，存储所有已注册的应用：
+
+```c
+static WristbandApp app_registry[APP_ID_MAX];
+static WristbandApp *active_app = NULL;  // 当前活跃前台应用指针
+#define DEFAULT_APP_ID APP_ID_CLOCK      // 默认应用为时钟
+```
+
+注册流程：
+1. 系统初始化时调用 `AppManager_Init()` 初始化注册表
+2. 各应用模块调用 `AppManager_RegisterApp()` 注册自身
+3. 最后调用 `AppManager_Init()` 设置默认活跃应用
+
+---
+
+## 10. 主循环集成
+
+主循环中应用管理器的调用顺序：
+
+```
+while(1)
+{
+    // 1. 处理串口调试输入
+    cmd = Uart_RxChar();
+    if (cmd != '\0')
+        // 解析命令，生成事件，调用 EventQueue_Push 或 EventQueue_EmergencyDispatch
+    
+    // 2. 处理按键事件缓冲区
+    if (key_event_buf != KEY_EVENT_NONE)
+        // 生成事件，根据优先级选择入队或紧急分发
+        key_event_buf = KEY_EVENT_NONE;
+    
+    // 3. 处理事件队列
+    while (!EventQueue_IsEmpty())
+    {
+        evt = EventQueue_Pop();
+        AppManager_DispatchEvent(evt);
+    }
+    
+    // 4. 运行当前活跃应用（带CPU占用控制）
+    AppManager_RunActiveApp();
+    
+    // 5. 其他系统监控（如LED/马达状态输出）
+}
+```

Docs/50_module-breakdown/mod-event.md

@@ -0,0 +1,580 @@
+# 模块拆分 - 事件采集与总线分发管理 (Docs/50_module-breakdown/mod-event.md)
+
+本模块描述系统输入事件采集（按键移位消抖滤波与 RF 自适应解调解码）、事件优先级体系、事件环形队列（EventQueue）缓冲、紧急事件直通机制以及事件输出分配（EventDispatcher）的整体流转规格。
+
+---
+
+## 1. 模块职责说明
+
+### 1.1 核心职责
+
+| 职责领域 | 描述 |
+| :--- | :--- |
+| **事件采集（按键输入）** | 在 Timer1 中断 (10ms 时基) 中扫描物理引脚，判定有效按键后封装为事件 |
+| **事件采集（射频接收）** | 在外部中断中捕获射频信号，解调并还原 24 位载波包，封装为射频事件 |
+| **事件优先级管理** | 根据事件类型分配优先级，支持四级优先级体系 |
+| **事件队列缓冲** | 维护深度为 8 的环形事件队列，隔离高频中断和低频业务交互 |
+| **紧急事件直通** | 提供跳过队列直接分发的路径，确保紧急事件立即响应 |
+| **事件输出路由分发** | 在主循环中轮询队列，将事件分发给应用管理器 |
+
+### 1.2 事件来源与优先级映射
+
+| 事件来源 | 典型事件 | 优先级 | 处理方式 |
+| :--- | :--- | :--- | :--- |
+| **SOS 按键** | `KEY_EVENT_SOS_CLICK`, `KEY_EVENT_SOS_LONG` | URGENT | **紧急直通**，跳过队列 |
+| **射频报警** | `RF_EVENT_ALARM` | HIGH | 入队优先处理 |
+| **普通按键** | `KEY_EVENT_UP_CLICK`, `KEY_EVENT_DOWN_CLICK`, `KEY_EVENT_UP_DOWN_COMB` | NORMAL | 入队等待处理 |
+| **射频配对** | `RF_EVENT_PAIR` | NORMAL | 入队等待处理 |
+| **系统定时** | 时钟更新、超时检测 | LOW | 入队等待处理 |
+
+---
+
+## 2. 核心数据结构
+
+### 2.1 扩展事件结构体 (SystemEvent)
+
+```c
+typedef struct {
+    KeyEvent key_event;     // 原始按键事件类型
+    EventPriority priority; // 事件优先级 (LOW/NORMAL/HIGH/URGENT)
+    u32 extra_data;         // 额外数据（如射频地址、时间信息等）
+    u8 extra_size;          // 额外数据有效字节数
+} SystemEvent;
+```
+
+**字段说明**：
+
+| 字段 | 类型 | 描述 |
+| :--- | :--- | :--- |
+| `key_event` | `KeyEvent` | 按键事件的原始类型，如 `KEY_EVENT_UP_CLICK`、`KEY_EVENT_SOS_LONG` |
+| `priority` | `EventPriority` | 事件优先级，决定事件的处理路径（入队或直通） |
+| `extra_data` | `u32` | 额外携带的数据，用于传递射频地址、时间等信息 |
+| `extra_size` | `u8` | `extra_data` 中有效数据的字节数（0~4） |
+
+### 2.2 事件优先级枚举
+
+```c
+typedef enum {
+    EVENT_PRIORITY_LOW,     // 0: 低优先级：系统内部事件，如定时更新
+    EVENT_PRIORITY_NORMAL,  // 1: 正常优先级：大部分用户交互事件
+    EVENT_PRIORITY_HIGH,    // 2: 高优先级：报警相关事件
+    EVENT_PRIORITY_URGENT   // 3: 紧急优先级：SOS等，直接越过队列
+} EventPriority;
+```
+
+### 2.3 按键事件类型枚举
+
+```c
+typedef enum {
+    KEY_EVENT_NONE,         // 0: 无事件
+    KEY_EVENT_UP_CLICK,     // 1: 上键短按
+    KEY_EVENT_UP_LONG,      // 2: 上键长按
+    KEY_EVENT_DOWN_CLICK,   // 3: 下键短按
+    KEY_EVENT_DOWN_LONG,    // 4: 下键长按
+    KEY_EVENT_SOS_CLICK,    // 5: SOS键短按
+    KEY_EVENT_SOS_LONG,     // 6: SOS键长按
+    KEY_EVENT_UP_DOWN_COMB  // 7: 上下键组合
+} KeyEvent;
+```
+
+---
+
+## 3. 事件队列模块
+
+### 3.1 队列设计参数
+
+| 参数名称 | 定义 | 默认值 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `EVENT_QUEUE_DEPTH` | 队列深度（环形缓冲区大小） | 8 | 可配置，建议值为 4~16 |
+| `queue_head` | 读指针 | 0 | 指向即将读取的位置 |
+| `queue_tail` | 写指针 | 0 | 指向即将写入的位置 |
+| `queue_count` | 当前事件数量 | 0 | 范围 0~EVENT_QUEUE_DEPTH |
+
+### 3.2 队列内部结构
+
+```c
+static SystemEvent event_queue[EVENT_QUEUE_DEPTH];  // 环形缓冲区存储数组
+static u8 queue_head = 0;   // 读指针：指向即将读取的位置
+static u8 queue_tail = 0;   // 写指针：指向即将写入的位置
+static u8 queue_count = 0;  // 当前队列中的事件数量
+```
+
+### 3.3 队列操作接口
+
+| 接口名称 | 函数签名 | 返回值 | 功能描述 |
+| :--- | :--- | :--- | :--- |
+| `EventQueue_Init` | `void EventQueue_Init(void)` | 无 | 初始化队列：重置读写指针和计数器 |
+| `EventQueue_Push` | `bit EventQueue_Push(SystemEvent evt)` | `bit` (1=成功, 0=失败) | 非阻塞将事件推入队列尾部，队列满时返回 0 |
+| `EventQueue_Pop` | `SystemEvent EventQueue_Pop(void)` | `SystemEvent` | 从队列头部弹出一个事件，队空时返回空事件 |
+| `EventQueue_IsEmpty` | `bit EventQueue_IsEmpty(void)` | `bit` (1=空) | 判断队列是否为空 |
+| `EventQueue_IsFull` | `bit EventQueue_IsFull(void)` | `bit` (1=满) | 判断队列是否已满 |
+| `EventQueue_GetCount` | `u8 EventQueue_GetCount(void)` | `u8` | 获取队列中当前事件数量 |
+| `EventQueue_EmergencyDispatch` | `void EventQueue_EmergencyDispatch(SystemEvent evt)` | 无 | **紧急事件直通**：跳过队列直接调用应用管理器分发 |
+
+### 3.4 队列操作流程
+
+#### 入队操作 (EventQueue_Push)
+
+```
+EventQueue_Push(evt) 执行流程：
+
+1. 检查队列是否已满
+   └── if (queue_count >= EVENT_QUEUE_DEPTH) → 返回 0（入队失败）
+
+2. 禁用全局中断（保护队列操作原子性）
+   └── EA = 0
+
+3. 将事件写入环形缓冲区
+   └── event_queue[queue_tail] = evt
+
+4. 更新写指针（循环递增）
+   └── queue_tail = (queue_tail + 1) % EVENT_QUEUE_DEPTH
+
+5. 更新事件计数
+   └── queue_count++
+
+6. 恢复全局中断
+   └── EA = 1
+
+7. 返回成功
+   └── return 1
+```
+
+#### 出队操作 (EventQueue_Pop)
+
+```
+EventQueue_Pop() 执行流程：
+
+1. 初始化返回的空事件
+   └── evt.key_event = KEY_EVENT_NONE
+       evt.priority = EVENT_PRIORITY_LOW
+       evt.extra_data = 0
+       evt.extra_size = 0
+
+2. 检查队列是否为空
+   └── if (queue_count == 0) → 返回空事件
+
+3. 禁用全局中断（保护队列操作原子性）
+   └── EA = 0
+
+4. 从队列头部读取事件
+   └── evt = event_queue[queue_head]
+
+5. 更新读指针（循环递增）
+   └── queue_head = (queue_head + 1) % EVENT_QUEUE_DEPTH
+
+6. 更新事件计数
+   └── queue_count--
+
+7. 恢复全局中断
+   └── EA = 1
+
+8. 返回读取到的事件
+   └── return evt
+```
+
+#### 紧急直通操作 (EventQueue_EmergencyDispatch)
+
+```
+EventQueue_EmergencyDispatch(evt) 执行流程：
+
+1. 直接调用应用管理器的事件分发函数
+   └── AppManager_DispatchEvent(evt)
+
+注意：此函数跳过队列，直接将事件发送给应用管理器，
+适用于最高优先级的紧急事件（如SOS），确保立即响应。
+```
+
+### 3.5 中断保护机制
+
+队列操作使用全局中断开关 `EA` 进行保护，确保在中断环境下的原子性：
+
+```
+中断保护原则：
+┌─────────────────────────────────────────────────────────────┐
+│  1. 入队操作可能在中断中被调用（按键扫描、RF接收）          │
+│     └── 需要保护队列数据结构不被并发访问                   │
+│                                                             │
+│  2. 出队操作在主循环中被调用                               │
+│     └── 需要保护队列数据结构不被中断破坏                   │
+│                                                             │
+│  3. 保护方式：禁用全局中断 → 执行操作 → 恢复全局中断       │
+│     └── 最小化中断禁用时间，减少对系统响应性的影响         │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 4. 事件采集机制
+
+### 4.1 按键事件采集
+
+#### 采集流程
+
+```
+按键事件采集流程（Timer1 10ms 中断）：
+
+1. 读取物理引脚状态
+   └── P0.1 (KEY_UP), P0.2 (KEY_CONFIRM), P0.3 (KEY_DOWN), P2.6 (KEY_SOS)
+
+2. 移位消抖滤波
+   └── 连续 3 次检测一致确认为有效电平变化
+
+3. 判断按键类型
+   ├── 短按：按下后 200ms 内释放
+   ├── 长按：按下持续时间 >= 2000ms (DOWN键) 或 >= 3000ms (其他键)
+   └── 组合键：UP 和 DOWN 同时按下
+
+4. 将事件写入缓冲区（中断中仅标记事件，不直接处理）
+   └── key_event_buf = 对应的按键事件类型
+
+注意：中断中不直接调用事件处理函数，避免在ISR中执行耗时操作（如Delay_ms、LCD绘制）。
+事件的优先级判断和分发由主循环完成。
+```
+
+#### 按键消抖时序
+
+```
+按键消抖时序图：
+
+时间轴 →
+├──────────────────────────────────────────────────────────────┐
+│ 物理按键  ──────┐                                    │      │
+│ (实际)    LOW   │───────────────── HIGH ────────────│──────│ │
+├─────────────────┼────────────────────────────────────┼──────┤ │
+│ 10ms采样 ───────┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──────┤ │
+│ (抖动区)        │  │  │  │  │  │  │  │  │  │  │  │  │      │ │
+├─────────────────┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──────┤ │
+│ 消抖结果 ───────┼──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──────┤ │
+│ (连续3次        │           LOW                    HIGH    │ │
+│ 一致才确认)     └──────────────────────────────────────────┘ │
+├──────────────────────────────────────────────────────────────┤
+│                  ↑ 抖动区结束，确认按键按下                    │
+└──────────────────────────────────────────────────────────────┘
+```
+
+### 4.2 射频事件采集
+
+#### 采集流程
+
+```
+射频事件采集流程（外部中断 P2.1）：
+
+1. 射频输入引脚 RF_RX_DATA (P2.1) 发生电平沿变化
+   └── 触发外部中断
+
+2. 定时器捕获高低电平比值
+   └── 解调自适应基准 T
+
+3. 连续采集 24 个数据位
+   └── 组合还原 20 位物理 ID 及 4 位状态码
+
+4. 校验与识别
+   ├── 解密通过
+   ├── 判断是对码事件还是报警事件
+
+5. 封装事件
+   └── SystemEvent evt;
+       evt.key_event = KEY_EVENT_NONE;  // 射频事件无按键类型
+       evt.extra_data = 射频地址;
+       evt.extra_size = 4;
+
+6. 设置优先级并入队
+   ├── 报警事件 → evt.priority = EVENT_PRIORITY_HIGH
+   └── 配对事件 → evt.priority = EVENT_PRIORITY_NORMAL
+       → EventQueue_Push(evt)
+```
+
+#### RF 解调参数
+
+| 参数 | 值 | 说明 |
+| :--- | :--- | :--- |
+| **载波频率** | 433MHz | LR690L 射频芯片工作频率 |
+| **编码方式** | EV1527 | 24 位曼彻斯特编码 |
+| **数据位** | 24 位 | 20 位物理地址 + 4 位状态码 |
+| **解调方式** | 自适应基准 T | 根据信号自动调整采样基准 |
+
+### 4.3 系统定时事件
+
+```
+系统定时事件产生流程（Timer1 1ms 中断）：
+
+1. 毫秒计数器累加
+   └── ms_tick++
+
+2. 秒分频检测
+   └── if (ms_tick % 1000 == 0) → 秒计数加1
+
+3. 分钟变化检测
+   └── if (分钟变化) → 产生时钟更新事件
+
+4. 封装事件
+   └── SystemEvent evt;
+       evt.key_event = KEY_EVENT_NONE;
+       evt.priority = EVENT_PRIORITY_LOW;
+       evt.extra_data = ((u32)hour << 8) | min;
+       evt.extra_size = 2;
+
+5. 入队处理
+   └── EventQueue_Push(evt)
+```
+
+---
+
+## 5. 事件分发机制
+
+### 5.1 事件流转完整架构
+
+```mermaid
+graph TD
+    %% 事件产生层
+    subgraph EventSources ["事件来源"]
+        KeyScan["按键扫描 (10ms)"]
+        RFRecv["射频接收 (中断)"]
+        Timer["定时事件 (1ms)"]
+    end
+    
+    %% 事件封装层
+    KeyScan -->|封装| KeyEventPack["按键事件封装"]
+    RFRecv -->|封装| RFEventPack["射频事件封装"]
+    Timer -->|封装| TimerEventPack["定时事件封装"]
+    
+    %% 优先级判断
+    KeyEventPack --> PriorityJudge{"优先级判断"}
+    RFEventPack --> PriorityJudge
+    TimerEventPack --> PriorityJudge
+    
+    %% 分流处理
+    PriorityJudge -->|URGENT| EmergencyPath["紧急直通路径"]
+    PriorityJudge -->|非URGENT| NormalPath["正常队列路径"]
+    
+    %% 正常路径
+    NormalPath --> Queue["EventQueue 环形缓冲区"]
+    Queue --> MainLoop["主循环轮询"]
+    MainLoop --> AppMgr["AppManager_DispatchEvent"]
+    
+    %% 紧急路径
+    EmergencyPath --> AppMgr
+    
+    %% 应用层处理
+    AppMgr --> FG_App["前台应用 (优先)"]
+    FG_App -->|IGNORED| BG_Apps["后台应用 (兜底)"]
+    FG_App -->|HANDLED| Done["处理完成"]
+    BG_Apps -->|IGNORED| Discard["事件丢弃"]
+    BG_Apps -->|HANDLED| Done
+```
+
+### 5.2 主循环事件处理流程
+
+```
+主循环事件处理流程：
+
+while(1)
+{
+    // 1. 处理串口调试输入
+    cmd = Uart_RxChar();
+    if (cmd != '\0')
+    {
+        // 解析命令生成事件
+        SystemEvent evt;
+        evt.key_event = 对应的按键事件;
+        evt.priority = 命令对应的优先级;
+        
+        // 根据优先级选择处理路径
+        if (evt.priority == EVENT_PRIORITY_URGENT)
+            EventQueue_EmergencyDispatch(evt);
+        else
+            EventQueue_Push(evt);
+    }
+    
+    // 2. 处理按键事件缓冲区（来自定时器中断）
+    if (key_event_buf != KEY_EVENT_NONE)
+    {
+        SystemEvent evt;
+        evt.key_event = key_event_buf;
+        evt.extra_data = 0;
+        evt.extra_size = 0;
+        
+        // 判断是否为紧急事件
+        if (key_event_buf == KEY_EVENT_SOS_CLICK || 
+            key_event_buf == KEY_EVENT_SOS_LONG)
+        {
+            evt.priority = EVENT_PRIORITY_URGENT;
+            EventQueue_EmergencyDispatch(evt);
+        }
+        else
+        {
+            evt.priority = EVENT_PRIORITY_NORMAL;
+            EventQueue_Push(evt);
+        }
+        
+        key_event_buf = KEY_EVENT_NONE;
+    }
+    
+    // 3. 处理事件队列中的所有事件
+    while (!EventQueue_IsEmpty())
+    {
+        SystemEvent evt = EventQueue_Pop();
+        
+        // 跳过空事件
+        if (evt.key_event == KEY_EVENT_NONE && 
+            evt.priority == EVENT_PRIORITY_LOW)
+            continue;
+        
+        // 分发事件给应用管理器
+        AppManager_DispatchEvent(evt);
+    }
+    
+    // 4. 运行当前活跃应用
+    AppManager_RunActiveApp();
+}
+```
+
+---
+
+## 6. 事件优先级与处理路径总结
+
+| 优先级 | 标识 | 处理路径 | 典型事件 | 特点 |
+| :--- | :--- | :--- | :--- | :--- |
+| **URGENT** | 3 | `EventQueue_EmergencyDispatch()` → 直接调用 `AppManager_DispatchEvent()` | SOS 按键 | 跳过队列，立即响应，最高优先级 |
+| **HIGH** | 2 | `EventQueue_Push()` → 入队等待 → `EventQueue_Pop()` → `AppManager_DispatchEvent()` | 传感器入侵警报 | 入队处理，比普通事件优先 |
+| **NORMAL** | 1 | `EventQueue_Push()` → 入队等待 → `EventQueue_Pop()` → `AppManager_DispatchEvent()` | 普通按键、射频配对 | 常规处理路径 |
+| **LOW** | 0 | `EventQueue_Push()` → 入队等待 → `EventQueue_Pop()` → `AppManager_DispatchEvent()` | 时钟更新、超时检测 | 低优先级，不阻塞其他事件 |
+
+---
+
+## 7. 事件丢弃机制
+
+当事件经过完整的分发流程后仍未被任何应用处理时，事件将被丢弃：
+
+```
+事件丢弃条件：
+1. 前台应用 active_app == NULL 或未返回 EVENT_HANDLED
+2. 所有后台应用均未返回 EVENT_HANDLED
+
+丢弃处理：
+- 事件数据被自动释放（队列弹出后即被丢弃）
+- 无额外日志记录（嵌入式系统资源限制）
+- 可通过调试串口观察事件处理情况
+```
+
+---
+
+## 8. 接口与函数说明汇总
+
+### 8.1 事件队列接口
+
+| 函数名 | 签名 | 功能 |
+| :--- | :--- | :--- |
+| `EventQueue_Init` | `void EventQueue_Init(void)` | 初始化事件队列，复位读写指针与计数器 |
+| `EventQueue_Push` | `bit EventQueue_Push(SystemEvent evt)` | 非阻塞将事件推入队列尾部，成功返回 1 |
+| `EventQueue_Pop` | `SystemEvent EventQueue_Pop(void)` | 从队列头部弹出一个事件，队空返回空事件 |
+| `EventQueue_IsEmpty` | `bit EventQueue_IsEmpty(void)` | 判断队列是否为空 |
+| `EventQueue_IsFull` | `bit EventQueue_IsFull(void)` | 判断队列是否已满 |
+| `EventQueue_GetCount` | `u8 EventQueue_GetCount(void)` | 获取队列中当前事件数量 |
+| `EventQueue_EmergencyDispatch` | `void EventQueue_EmergencyDispatch(SystemEvent evt)` | **紧急事件直通**：跳过队列直接分发 |
+
+### 8.2 事件采集接口
+
+| 函数名 | 签名 | 功能 |
+| :--- | :--- | :--- |
+| `Key_Scan_Process` | `void Key_Scan_Process(void)` | Timer1 (10ms) 中断调度，扫描物理引脚并判定长短按逻辑 |
+| `EV1527_Decode` | `bit EV1527_Decode(u32 *out_addr, u8 *out_type)` | 无线引脚 P2.1 边沿触发，捕获解密数据 |
+
+### 8.3 事件分发接口
+
+| 函数名 | 签名 | 功能 |
+| :--- | :--- | :--- |
+| `AppManager_DispatchEvent` | `void AppManager_DispatchEvent(SystemEvent evt)` | 应用管理器事件分发函数（外部声明） |
+
+---
+
+## 9. 设计要点与约束
+
+### 9.1 队列深度选择
+
+```
+队列深度选择原则：
+┌─────────────────────────────────────────────────────────────┐
+│  1. 深度过小（如 2~4）：高频按键可能导致事件丢失           │
+│                                                             │
+│  2. 深度过大（如 16+）：内存占用增加，响应延迟可能增大     │
+│                                                             │
+│  3. 推荐值：8                                               │
+│     ├── 足够应对正常按键频率（约 10Hz）                    │
+│     ├── 内存占用合理（8 * sizeof(SystemEvent) = 48 字节） │
+│     └── 响应延迟可控（最多等待 8 个事件）                   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 9.2 中断禁用时间控制
+
+```
+中断禁用时间估算：
+┌─────────────────────────────────────────────────────────────┐
+│  入队操作：                                                  │
+│  ├── 禁用中断 → 写入数据 → 更新指针 → 更新计数 → 恢复中断   │
+│  └── 约 10~20 个机器周期 @ 24MHz = 0.4~0.8us              │
+│                                                             │
+│  出队操作：                                                  │
+│  ├── 禁用中断 → 读取数据 → 更新指针 → 更新计数 → 恢复中断   │
+│  └── 约 10~20 个机器周期 @ 24MHz = 0.4~0.8us              │
+│                                                             │
+│  结论：中断禁用时间远小于 1us，对系统响应性影响可忽略       │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 9.3 紧急事件的特殊性
+
+紧急事件（如 SOS）直接绕过队列机制，确保：
+1. **零延迟响应**：无需等待队列中的其他事件
+2. **最高优先级**：立即抢占当前应用
+3. **不可丢失**：不会因队列满而被丢弃
+
+---
+
+## 10. 典型事件处理时序
+
+### 10.1 普通按键事件时序
+
+```
+普通按键事件时序（KEY_UP_CLICK）：
+
+时间轴 →
+├──────────────────────────────────────────────────────────────┤
+│ 按键按下 ────────────────────────────────────────────────────│
+├──────────────────────────────────────────────────────────────┤
+│ Timer1 中断 → Key_Scan_Process → EventQueue_Push(evt)       │
+│                                              ↓              │
+├──────────────────────────────────────────────────────────────┤
+│ 主循环 → EventQueue_Pop(evt) → AppManager_DispatchEvent     │
+│                                              ↓              │
+│                          active_app->onEvent(evt)           │
+│                                              ↓              │
+│                          返回 EVENT_HANDLED                  │
+└──────────────────────────────────────────────────────────────┘
+```
+
+### 10.2 紧急事件时序
+
+```
+紧急事件时序（SOS_CLICK）：
+
+时间轴 →
+├──────────────────────────────────────────────────────────────┤
+│ SOS按键按下 ─────────────────────────────────────────────────│
+├──────────────────────────────────────────────────────────────┤
+│ Timer1 中断 → Key_Scan_Process                               │
+│              → key_event_buf = KEY_EVENT_SOS_CLICK           │
+├──────────────────────────────────────────────────────────────┤
+│ 主循环 → 检测 key_event_buf != KEY_EVENT_NONE                │
+│        → 判断事件类型为 SOS，设置 priority = URGENT          │
+│        → EventQueue_EmergencyDispatch(evt)                   │
+│        → AppManager_DispatchEvent(evt)                       │
+│        → active_app->onEvent(evt)                            │
+│        → 返回 EVENT_HANDLED                                  │
+└──────────────────────────────────────────────────────────────┘
+
+特点：紧急事件仍在主循环中处理，但跳过队列直接分发，减少延迟。
+中断中仅标记事件，不直接调用应用逻辑，避免在ISR中执行耗时操作。
+```

Docs/50_module-breakdown/mod-key.md

@@ -1,49 +1,26 @@
-# 模块拆分 - 按键输入消抖与判定 (Docs/50_module-breakdown/mod-key.md)
+# 模块拆分 - 按键输入与事件产生 (Docs/50_module-breakdown/mod-key.md)
 
-本模块描述物理按键输入的检测、电平消抖、长按计时以及多事件防丢处理。
+本模块描述物理按键输入引脚的检测、消抖、长短按事件封包，以及其作为事件产生者向事件队列投递的过程。
 
 ## 1. 模块职责说明
 
 *   **职责范围**：
-    1. 在系统上电时，将按键引脚 `P0.1~P0.5` 配置为**高阻输入且开启内部上拉电阻**（STC32G P0M0/P0M1/P0PU 寄存器配置）。
-    2. 实现每 10ms 一次的硬件消抖滤波（采用 3 次扫描连续一致判定法，滤波时间约 20-30ms）。
-    3. 支持侧边 ▲/▼ 键、确认键 ■，以及上部双并联 SOS 键的独立状态判定。
-    4. 对上部双 SOS 按键进行逻辑并联处理：只要任意一个按键拉低，即视为 SOS 触发。
-    5. **长按计时判定**：
-        *   长按 **确认键 (■)** 达 3 秒（300 个时基单位）触发主菜单切换或子页面放弃退出。
-        *   长按 **▼ 键** 达 2 秒（200 个时基单位）触发报警清除或 IPC 绑定退出。
-    6. **防丢事件缓冲队列 (Ring Buffer)**：
-        *   为了防止高频按键或同时按下时发生丢键，本模块维护一个深度为 4 级的环形事件队列。按键扫描判定出的 `KeyEvent` 压入队列，主循环通过出队机制依次消费。
+    1. **事件产生者 (Event Producer)**：物理按键 `KEY_UP` (P0.1), `KEY_DOWN` (P0.3), `KEY_CONFIRM` (P0.2), `KEY_SOS` (P2.6) 被按下触发低电平，按键模块负责定义物理端口输入并将物理信号翻译为 `KeyEvent` 事件。
+    2. **移位消抖**：在 Timer1 10ms 中断分频中读取 IO 状态，连续 3 次检测一致则确认电平状态，过滤物理抖动。
+    3. **推入事件队列**：当确认有物理键沿跳变时，调用 `Event_Queue_Push()` 将对应的 `KeyEvent` 压入独立的事件队列缓冲区中，避免因主逻辑繁忙丢失按键。
+    4. **长短按时序**：确认键长按 3 秒产生长按事件，▼ 键长按 2 秒产生长按事件，SOS 键按下即刻产生最高优先级的 `KEY_SOS_ACTIVE` 抢占求救事件。
 
 ---
 
-## 2. 数据结构定义
+## 2. 接口与函数说明
 
-### 2.1 按键事件枚举 (KeyEvent)
-```c
-typedef enum {
-    KEY_EVENT_NONE,
-    KEY_UP_SHORT,       // ▲ 键短按
-    KEY_DOWN_SHORT,     // ▼ 键短按
-    KEY_DOWN_LONG,      // ▼ 键长按 2 秒 (清除报警/退出)
-    KEY_CONFIRM_CLICK,  // ■ 确认键短按
-    KEY_CONFIRM_LONG,   // ■ 确认键长按 3 秒 (菜单切换)
-    KEY_SOS_ACTIVE      // SOS 键触发 (不分长短按，秒级响应)
-} KeyEvent;
-```
-
----
-
-## 3. 接口与函数说明
-
-*   `void Key_Init(void)`：配置 `P0.1~P0.5` 的 `P0M1=0x00`, `P0M0=0x00`（高阻模式），并设置 `P0PU = 0x3E` 使能上拉电阻。
+*   `void Key_Init(void)`：将 Pin 30, 31, 32, 27 配置为高阻输入并开启内部上拉电阻 (`P0PU |= 0x0E`, `P2PU |= 0x40`)。
 *   `void Key_Scan_Process(void)`：
-    在 Timer 1 10ms 中断分频中调用。
-    *   读取引脚逻辑状态，并利用移位寄存器滤波判定。
-    *   并联 SOS 状态：`sos_pressed = (KEY_SOS1 == 0) || (KEY_SOS2 == 0)`。
-    *   累加各按键的计数器：`key_up_hold`, `key_down_hold`, `key_confirm_hold`, `key_sos_hold`。
-    *   达到长按阈值时将对应事件写入环形队列。
-*   `bit Key_Push_Event(KeyEvent evt)`：将事件压入环形事件队列。若满则丢弃，返回 0。
-*   `KeyEvent Key_Pop_Event(void)`：主循环调用，从事件队列中读取未消费的事件。若空返回 `KEY_EVENT_NONE`。
+    在 Timer1 的 10ms 定时周期中回调。
+    *   读取 `KEY_UP`, `KEY_DOWN`, `KEY_CONFIRM`, `KEY_SOS` 引脚。
+    *   累加按键维持计数器以判定长按与短按。
+    *   将结果转换为 `KeyEvent` 传入事件队列。
+*   `bit Event_Queue_Push(KeyEvent evt)`：将产生的按键事件压入系统事件环形队列。若溢出返回 0。
+*   `KeyEvent Event_Queue_Pop(void)`：分发循环调用该接口读出排队事件。若空返回 `KEY_EVENT_NONE`。
 
-<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V3 -->

Docs/50_module-breakdown/mod-lcd.md

@@ -1,33 +1,28 @@
-# 模块拆分 - AMOLED 显示与无障碍渲染 (Docs/50_module-breakdown/mod-lcd.md)
+# 模块拆分 - AMOLED 屏幕渲染驱动 (Docs/50_module-breakdown/mod-lcd.md)
 
-本模块管理 Truly 0.95寸 AMOLED 屏的底层 SPI 通信、窗口控制、以及无障碍（A11y）超大字体和图标的渲染。
+本模块描述 Truly AMOLED (RM69310) 屏幕的底层 SPI 通信、物理视窗偏置及文本/大图标像素刷写驱动。本模块为纯输出执行层，由当前活跃的前台 App 调度。
 
 ## 1. 模块职责说明
 
 *   **职责范围**：
-    1. 管理 RM69310 控制器通信，提供单向 SPI 指令/数据写操作。
-    2. 提供 `SGM_CTRL`（引脚 `P3.4`）控制，配合低功耗模块实现屏幕 PMIC 的上电与彻底断电。
-    3. **物理窗口偏置处理**：Truly 120x240 AMOLED 屏的 GRAM X 轴起始位置有 **+4 像素的偏置**，设置显示窗口时必须进行偏移修正：`LCD_SetWindow(x1 + 4, x2 + 4, y1, y2)`。
-    4. **无障碍大字排版（A11y）渲染**：
-        *   取消任何小于 16x32px 的微缩文本。
-        *   时间显示使用 **32x64px** 超大点阵。
-        *   防区图标使用 **48x48px** 或 **64x64px** 超大单色位图。
-        *   在 120 像素宽的屏幕内，应用水平居中公式：`X_start = (120 - len * char_width) / 2`。
-    5. **单页集中展示逻辑**：控制各菜单页面和子修改页面在屏幕中只显示单焦点，避免多行小字杂乱堆叠。
+    1. **服务应用显示**：不存储系统页面逻辑，仅提供底层画图、画字、清屏接口，供当前前台 App（如待机时钟应用、菜单应用）在 `OnStart` 或重绘标志触发时调度写入。
+    2. **局部窗口硬件偏置**：
+       在 `LCD_SetWindow` 设置 GRAM 窗口时，X 轴坐标必须强制加 4 像素（即 `x1 += 4`, `x2 += 4`），以对齐 Truly AMOLED 屏的物理视窗偏置。
+    3. **A11y 无障碍大字模渲染**：
+       * 提供 `16x32px` 标准无障碍英文字符点阵字库。
+       * 提供 `32x64px` 超大数字字符点阵字库（专用于时钟）。
+       * 提供 `48x48px` 及 `64x64px` 传感器、锁具、摄像头位图渲染接口。
+       * 实现了水平居中排版公式，防止大字超出 120 像素物理宽度。
 
 ---
 
 ## 2. 接口与函数说明
 
-*   `void LCD_Init(void)`：配置 `P1.1~P1.6` 控制线为推挽输出模式，并在拉高 `SGM_CTRL` 稳定后，发送 RM69310 初始化寄存器指令序列。
-*   `void LCD_WriteCmd(u8 cmd)`：拉低 `LCD_RS` 选择命令寄存器，通过 SPI 发送字节。
-*   `void LCD_WriteData(u8 dat)`：拉高 `LCD_RS` 选择数据寄存器，通过 SPI 发送字节。
-*   `void LCD_SetWindow(u16 x1, u16 y1, u16 x2, u16 y2)`：设置局部像素刷写范围，物理 X 坐标必须强制加 4 像素。
-*   `void LCD_Clear(u16 color)`：清屏为指定底色（常态使用全黑以节省功耗）。
-*   `void LCD_ShowChar16x32(u16 x, u16 y, char c, u16 fc, u16 bc)`：在指定坐标绘制标准无障碍大字符（16x32点阵）。
-*   `void LCD_ShowChar32x64(u16 x, u16 y, char c, u16 fc, u16 bc)`：在指定坐标绘制超大数字字符（32x64点阵）。
-*   `void LCD_ShowImage(u16 x, u16 y, u16 w, u16 h, const u8 *img, u16 fc, u16 bc)`：渲染指定单色位图（支持 32x32/48x48/64x64/80x80 图标规格）。
-*   `void LCD_ShowStringCentered(u16 y, char *str, u16 fc, u16 bc)`：16x32 规格字符串居中渲染，单行限制最多 7 个字符。
-*   `void LCD_ShowString32x64Centered(u16 y, char *str, u16 fc, u16 bc)`：32x64 规格超大字符串居中渲染（如时钟显示）。
+*   `void LCD_Init(void)`：配置 Pin 1 到 Pin 6 的 SPI 通信总线引脚为推挽输出。拉高 `SHUT` 稳定后，向 RM69310 芯片写入初始化指令序列。
+*   `void LCD_SetWindow(u16 x1, u16 y1, u16 x2, u16 y2)`：设置局部像素写入视窗，自动执行 `+4` 偏置修正。
+*   `void LCD_Clear(u16 color)`：用指定颜色刷满屏幕 GRAM。
+*   `void LCD_ShowStringCentered(u16 y, char *str, u16 fc, u16 bc)`：居中渲染 16x32 大字符。
+*   `void LCD_ShowString32x64Centered(u16 y, char *str, u16 fc, u16 bc)`：居中渲染 32x64 超大字符。
+*   `void LCD_ShowImage(u16 x, u16 y, u16 w, u16 h, const u8 *img, u16 fc, u16 bc)`：将单色大位图写入屏幕指定 GRAM。
 
-<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V3 -->

Docs/50_module-breakdown/mod-led.md

@@ -1,43 +1,27 @@
-# 模块拆分 - WS2812B 可编程 RGB 灯效 (Docs/50_module-breakdown/mod-led.md)
+# 模块拆分 - WS2812B 幻彩 LED 控制驱动 (Docs/50_module-breakdown/mod-led.md)
 
-本模块管理双级联幻彩 RGB 灯珠（WS2812B/FCOB-2.7）的硬件 SPI 通道、防抖抗噪切换以及指示闪烁逻辑。
+本模块描述双级联可编程幻彩 RGB 灯珠的时序写驱动及异步闪烁处理。本模块由当前活跃应用或后台监测进程在报警时调度执行。
 
 ## 1. 模块职责说明
 
 *   **职责范围**：
-    1. 管理物理引脚 `P2.3`（复用硬件 SPI 的 MOSI）作为单线纳秒级高速数据流输出。
-    2. 实现对级联的两个 RGB 灯珠（上灯 DOUT 串接下灯 DIN）输出相同的 24-bit × 2 色彩数据。
-    3. **硬件 SPI 复用防噪隔离处理**：
-        由于单片机引脚紧缺，SPI 引脚与马达控制可能存在轻微高频串扰。在每次发送 48-bit (GRB) 灯光控制字之前，**必须临时关闭全局中断 (EA=0)**，并将马达引脚配置为高阻输入以彻底隔离噪声。发送完成后立即恢复引脚模式并使能全局中断 (EA=1)。
-    4. **软件异步闪烁控制**：
-        在 1ms 中断中自增计时器，控制报警状态下不同防区灯光的异步闪烁（500ms 亮、500ms 灭，或本地 SOS 下的 50ms 红光快速交替爆闪）。
+    1. **响应指示请求**：提供底层硬件 SPI 写接口，受前台应用（如对码指示）或后台警报进程的控制，点亮特定色彩。
+    2. **隔离抗干扰时序**：
+       WS2812B 的单线纳秒级控制数据流极易受到地线高频噪声干扰。在每次调用 `WS2812_WriteRGB` 之前，必须执行 **临时关闭全局中断 (EA=0) 并切换马达引脚 (P2.5) 为高阻输入** 状态，发送完毕后恢复 `EA=1`，以屏蔽共地杂噪。
+    3. **软件定时器异步更新**：
+       提供 `LED_Flash_Process` 中断分频函数，由 Timer1 (1ms) 定期回调自增，以非阻塞方式改变闪烁标志电平，避免软件 `delay` 阻塞 CPU。
 
 ---
 
-## 2. LED 报警色彩矩阵
+## 2. 接口与函数说明
 
-根据防区传感器类型及报警动作亮起指示灯：
-*   **门磁/窗磁 (PORTE)**：红色闪烁。
-*   **PIR 人体红外 (PIR)**：橙色闪烁。
-*   **烟雾传感器 (FUMEE)**：绿色闪烁。
-*   **紧急按钮 (URGENCE)**：蓝色闪烁。
-*   **气体泄漏 (GAZ)**：紫色闪烁。
-*   **水浸传感器 (INOND.)**：黄色闪烁。
-*   **振动传感器 (VIBRA.)**：青色闪烁。
-*   **本地主动 SOS**：双红灯以 50ms 周期高速交替闪烁。
+*   `void WS2812_Init(void)`：初始化物理引脚 `P2.3` (LED_RGB) 复用硬件 SPI 功能。
+*   `void WS2812_WriteRGB(u8 l1_g, u8 l1_r, u8 l1_b, u8 l2_g, u8 l2_r, u8 l2_b)`：
+    1. 保存并拉低 `EA = 0`。
+    2. 临时设置马达控制脚 `P2.5` 为高阻输入。
+    3. 通过 SPI 数据寄存器连续发送两个灯珠的 GRB 控制字节。
+    4. 发送完毕后发出 >80us 低电平复位脉冲。
+    5. 恢复马达引脚模式并还原 `EA`。
+*   `void LED_Flash_Process(void)`：中断更新闪烁标志位状态，用于驱动交替闪烁。
 
----
-
-## 3. 接口与函数说明
-
-*   `void WS2812_Init(void)`：初始化物理引脚 `P2.3` 状态，复用硬件 SPI 通道，配置时钟展宽 LUT 码表。
-*   `void WS2812_WriteRGB(u8 led1_g, u8 led1_r, u8 led1_b, u8 led2_g, u8 led2_r, u8 led2_b)`：
-    1. 临时保存并拉低 `EA = 0`。
-    2. 切换 `P2.5` (MOTOR) 引脚为高阻输入以防共地噪声。
-    3. 通过 SPI 控制寄存器高速连发 48 字节的时序宽展码，驱动两个灯珠亮起对应颜色。
-    4. 发送完毕后发送 >80us 的低电平复位脉冲。
-    5. 恢复马达引脚为推挽输出，并还原 `EA`。
-*   `void LED_Set_Color(u8 g, u8 r, u8 b)`：同步设置双级联灯亮起特定颜色。
-*   `void LED_Flash_Process(void)`：在 1ms 中断中调用，控制指示灯处于交替爆闪或间歇闪烁的状态机更新。
-
-<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V3 -->

Docs/50_module-breakdown/mod-motor.md

@@ -1,40 +1,25 @@
-# 模块拆分 - 振动马达异步驱动与反馈 (Docs/50_module-breakdown/mod-motor.md)
+# 模块拆分 - 振动马达非阻塞异步驱动 (Docs/50_module-breakdown/mod-motor.md)
 
-本模块描述振动马达引脚的开关控制、异步时间片脉冲时序生成以及针对不同防区的特定振动波形。
+本模块描述振动马达的异步脉冲生成及时序段控制。本模块为输出执行层，由应用在产生警报或按键反馈时调度。
 
 ## 1. 模块职责说明
 
 *   **职责范围**：
-    1. 系统初始化时配置马达引脚 `P2.5` 为推挽输出模式，默认输出低电平（马达静止）。
-    2. **非阻塞异步脉冲处理**：
-       为防止马达振动时间（几百毫秒）阻塞 CPU 的业务循环与射频解码，本模块将马达动作拆分为多个电平交替状态段。利用 Timer 1 (1ms 中断) 异步扣减阶段计数器，实现不占用 CPU 资源的精细振动波形。
-    3. 配合系统状态机，在按键点击时输出 50ms 极短触觉反馈，在防区入侵报警时根据类型输出对应的振动指征，在本地主动 SOS 状态下输出连续不断的重度警示振动。
+    1. **非阻塞时间片调度**：
+       传统的 `delay_ms` 震动会导致手环在震动期间无法读取按键和解调无线信号。本模块将震动过程分解为多个电平维持段，在 Timer1 定时中断里扣减剩余毫秒数。应用在发起震动请求后**立即返回**。
+    2. **差异化防区震动**：根据报警传感器的类型，异步生成 7 种不同的警示震动节奏（如门磁短震、红外短震2次、主动求救持续震动）。
+    3. **按键触觉反馈**：在按键被消抖确认时，提供 50ms 的极短微振动物理触觉反馈。
 
 ---
 
-## 2. 振动模式设计 (周期 5 秒)
+## 2. 接口与函数说明
 
-*   **按键操作反馈**：1 次极短振动 50ms。
-*   **门磁/窗磁 (PORTE)**：1 次短振 300ms。
-*   **PIR 红外 (PIR)**：2 次短振 300ms (间隔 200ms)。
-*   **烟雾传感器 (FUMEE)**：3 次短振 200ms (间隔 150ms)。
-*   **紧急按钮 (URGENCE)**：1 次长振 800ms。
-*   **气体泄漏 (GAZ)**：4 次短振 200ms (间隔 100ms)。
-*   **水浸传感器 (INOND.)**：2 次长振 600ms (间隔 300ms)。
-*   **振动传感器 (VIBRA.)**：连续 3 次极短振动 150ms (间隔 100ms)。
-*   **本地主动 SOS**：持续间歇重度长振（振 1000ms，停 200ms 循环）。
-
----
-
-## 3. 接口与函数说明
-
-*   `void Motor_Init(void)`：配置引脚 `P2.5` 的 `P2M1=0x00`, `P2M0=0x20`（推挽输出），默认输出 `MOTOR = 0`。
-*   `void Motor_Set_State(bit state)`：硬开关控制引脚 `P2.5` 的电平。
-*   `void Motor_Start_Pattern(u8 pattern_type)`：装载对应类型的马达振动计数器，开启异步振动状态机。
+*   `void Motor_Init(void)`：配置 Pin 26 (`P2.5` / MOTOR_PWM) 为推挽输出，默认输出 `MOTOR_PWM = 0`。
+*   `void Motor_Start_Pattern(u8 pattern_type)`：传入震动节奏类型（按键微振/各防区警报震动/主动SOS循环震），装载维持时间片，开启异步状态机。
 *   `void Motor_Pulse_Process(void)`：
-    在 Timer 1 的 10ms 中断分频中被调用：
-    *   根据装载的波形，扣减当前阶段维持的毫秒数。
-    *   当计数器归零时，切换 `MOTOR` 引脚电平并转入下一个电平维持段。
-*   `void Motor_Stop(void)`：清空所有计数器，拉低 `MOTOR = 0`，强行中止当前振动。
+    在 Timer1 的 10ms 中断分频中被调度调用。
+    *   如果当前处于震动维持段，扣减 `motor_timer_ms` 计数器。
+    *   计数归零时，反转物理引脚 `MOTOR_PWM` 的电平，并装填下一阶段所需维持的毫秒数。
+*   `void Motor_Stop(void)`：强行清空所有震动计数器，并拉低引脚电平使其停止震动。
 
-<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V3 -->

Docs/50_module-breakdown/mod-power.md

@@ -1,34 +1,30 @@
 # 模块拆分 - 极低功耗与电源管理 (Docs/50_module-breakdown/mod-power.md)
 
-本模块描述手环的低功耗管理、AMOLED 供电 PMIC 控制以及中断睡眠/唤醒时序。
+本模块描述手环的低功耗休眠策略、OLED PMIC 供电控制、中断挂起以及安全唤醒初始化时序。
 
 ## 1. 模块职责说明
 
 *   **职责范围**：
-    1. 在系统上电时使能 SGM3833 升压芯片，为 OLED 屏提供稳定的显示电源。
-    2. **低功耗决策判定**：
-       当主系统处于非警报状态，且连续 10 秒（`inactivity_timer >= 1000`）无任何按键或无线包事件时，判定系统进入 `STATE_SLEEP` 极低功耗睡眠。
-    3. **彻底切断 PMIC**：
-       为消除 OLED 的静态负压漏电流，休眠前拉低 `SGM_CTRL = 0`，使 SGM3833 彻底断电。
-    4. **睡眠挂起配置**：
-       使能 `INT2`（外部中断 2，接射频接收引脚）以及 P0 口引脚电平变化中断，然后将 STC32G 写入 `PCON |= 0x02` 进入停机（Power-Down）挂起状态，关闭主高频振荡时钟，全板功耗降至微安级。
-    5. **安全唤醒重初始化时序**：
-       发生按键或无线信号中断时，CPU 瞬间被唤醒。由于升压 PMIC 的输入电容充电及负压稳压需要时间，唤醒后**严禁立即写屏**。必须首先拉高 `SGM_CTRL = 1`，接着**软件强行阻塞延时 50ms**，等电网稳定后，再次完整初始化 RM69310 的寄存器参数，最后恢复待机屏幕重绘。
+    1. **低功耗决策与断电**：
+       当应用管理层判定 10 秒无按键且无无线事件时，PM 模块向 AMOLED 发送 Display OFF 命令，随后拉低 `SHUT = 0` (Pin 23 / P2.2)，**彻底切断 SGM3833 供电**。
+    2. **挂起 CPU (Power-Down)**：
+       使能 GPIO 按键沿中断和无线接收沿中断，写入 `PCON |= 0x02` 关闭高频振荡器，使 MCU 进入深度停机挂起。
+    3. **防浪涌安全唤醒初始化**：
+       发生中断唤醒后，PM 必须遵循安全上电时序：首先拉高 `SHUT = 1` 开启 SGM3833，随后**执行 50ms 强阻塞延时**避开冲击电流并等待电源轨稳定，最后调用 `LCD_Init()` 完整重新配置 RM69310 寄存器，方可恢复应用绘制。
 
 ---
 
 ## 2. 接口与函数说明
 
-*   `void Power_Init(void)`：配置 `P3.4` (SGM_CTRL) 为推挽输出，默认输出高电平 `SGM_CTRL = 1`。
+*   `void Power_Init(void)`：配置 Pin 23 为推挽输出，默认 `SHUT = 1` 开启屏幕 PMIC。
 *   `void Enter_Low_Power_Sleep(void)`：
-    1. 向 RM69310 屏幕控制器发送关闭显示命令（寄存器 0x28）。
-    2. 拉低 `SGM_CTRL = 0` 彻底切断 PMIC。
-    3. 配置并使能按键端口中断与 RF 中断。
-    4. 执行 `PCON |= 0x02` 挂起 CPU。
+    1. 向 RM69310 写入关屏指令 (0x28)。
+    2. 拉低 `SHUT = 0` 关断 SGM3833 PMIC。
+    3. 使能端口引脚沿中断并进入 `PCON |= 0x02` 停机状态。
 *   `void Wakeup_Restore(void)`：
-    1. 拉高 `SGM_CTRL = 1` 开启 SGM3833 供电。
-    2. 执行 `delay_ms(50)` 阻塞式等待电平平稳，过滤冲击电流。
-    3. 调用 `LCD_Init()` 重新对 RM69310 进行整套初始化配置，恢复写屏 GRAM 通道。
-    4. 状态机切回 `STATE_CLOCK` 并置 `Redraw = 1`。
+    1. 拉高 `SHUT = 1` 重新开启 SGM3833。
+    2. 执行 `delay_ms(50)` 硬件稳压阻塞等待。
+    3. 重新调用 `LCD_Init()` 完成屏幕控制寄存器复位和 GRAM 开启。
+    4. 路由通知应用管理器切回时钟应用重新绘制。
 
-<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V3 -->

Docs/50_module-breakdown/mod-rf.md

@@ -1,39 +1,27 @@
-# 模块拆分 - 自适应 RF 解码与发射 (Docs/50_module-breakdown/mod-rf.md)
+# 模块拆分 - 自适应 RF 解码事件源 (Docs/50_module-breakdown/mod-rf.md)
 
-本模块描述 LR690L 433MHz 射频物理收发的控制、自适应宽限时间比值解码机制以及对码/呼救编码包的发射。
+本模块描述 LR690L 433MHz 无线接收的自适应比值解调机制、主动射频数据发送、以及其作为事件产生者投递对码/报警事件的过程。
 
 ## 1. 模块职责说明
 
 *   **职责范围**：
-    1. 配置射频芯片接收 GPIO 与发射 GPIO 的电平方向。
-    2. **自适应比值解调算法**：
-       EV1527 协议数据速率变化范围较宽。本模块采用自适应宽度比值解调机制：
-       *   捕获到一个低电平维持时间介于 1500us~60000us 之间的脉冲，判定为同步前导头。
-       *   抓取该帧的标准时钟周期基准 `T = low_time / 31`（前导低电平占 31 个时钟周期 T，允许 T 的宽度随环境在宽限范围内自适应计算）。
-       *   连续捕获 24 位宽数据：每个 bit 的电平变化依据其高低电平的宽幅比例（1:3 对应 0，3:1 对应 1）反解出对应的数据位。
-    3. 解析出 24 位载波包：前 20 位为无线探测器的出厂唯一地址码（Address Code），后 4 位为状态数据码（Data Code）。
-    4. **数据包主动发送**：
-       将手环 Factory ID 编码为一帧 EV1527 数据，通过物理发射引脚输出同步头及 24 位调制波形，连发多遍以确保 IPC 接收质量。
+    1. **事件产生者 (Event Producer)**：当物理引脚 `P2.1` (RF_RX_DATA) 沿中断触发，射频解调成功后，模块产生 `RF_EVENT_PAIR` (对码) 或 `RF_EVENT_ALARM` (报警) 并投递至系统事件总线。
+    2. **自适应解调算法**：
+       * 捕获 1500us~60000us 的同步低电平，动态计算时钟基准 `T = low_time / 31`。
+       * 连续解调 24 位宽数据：1:3 对应 0 码，3:1 对应 1 码，计算出 20 位地址码与 4 位状态数据码。
+    3. **屏蔽接收 0x08 SOS 码**：手环被动接收到数据码为 `0x08` 的载波信号时，强制过滤忽略，不产生任何事件。仅保留主动向外界发射 `0x08` 求救码的能力。
+    4. **主动发送驱动**：在应用层请求下，使能 `P2.0` (RF_TX) 和数据线 `P3.6` (RF_TX_DAT)，连续发射多遍调制数据（如对码绑定 `0x01` 或求救包 `0x08`）。
 
 ---
 
-## 2. 业务状态射频数据编码定义
+## 2. 接口与函数说明
 
-*   **对码绑定发送 (LIAISON IPC)**：
-    *   数据码固定为 **`0x01`** (0001)，源地址为手环 20-bit 出厂 Factory ID，周期性连续发射。
-*   **本地主动 SOS 呼救 (SOS EMIS)**：
-    *   数据码固定为 **`0x08`** (1000)，源地址为手环 20-bit 出厂 Factory ID，以 2 秒为周期循环向外发射。
-*   **传感器自动识别对码**：
-    *   手环被动接收 433MHz 对码信号。若捕获成功，状态机直接**依据后 4 位数据码的数据值自动判断识别传感器的设备类型**（如门磁为 `0x01`，红外为 `0x02`），直接跳转到对码微调序号页，类型与大图标只读高亮。
-
----
-
-## 3. 接口与函数说明
-
-*   `void RF_Init(void)`：初始化射频物理端口，使能 INT2 (接收脚的沿中断)。
+*   `void RF_Init(void)`：配置 Pin 19, 20, 21, 22 物理引脚。使能接收控制 `RF_RX` (P3.7) = 1。使能引脚电平变化中断用于休眠唤醒。
 *   `bit EV1527_Decode(u32 *out_addr, u8 *out_type)`：
-    主循环轮询调用。如果捕获到合法同步头且成功解调出 24 位数据流，则输出 `out_addr` 和 `out_type` 并返回 1，否则返回 0。
+    被主循环 `main.c` 轮询轮空调用。
+    *   通过状态标志检测引脚跳变沿。
+    *   若解调出合法 24 位数据，填入 `out_addr` 和 `out_type`，返回 1；否则返回 0。
 *   `void EV1527_Transmit(u32 addr, u8 data_code)`：
-    主动发射数据。连发至少 5 遍，每遍间歇 20ms，产生满足 T 基准的同步码头、`1` 码时序（高 3T 低 1T）和 `0` 码时序（高 1T 低 3T）。
+    由主动发送 App 调度。产生前导头及 24 位电平时序。连续发送 5 遍，以确保 IPC 摄像头可靠捕获。
 
-<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V3 -->

Docs/50_module-breakdown/mod-sys.md

@@ -1,60 +1,36 @@
-# 模块拆分 - 系统状态机与 IAP 数据库 (Docs/50_module-breakdown/mod-sys.md)
+# 模块拆分 - 系统初始化与 IAP 数据库 (Docs/50_module-breakdown/mod-sys.md)
 
-本模块描述手环的核心生命周期调度器、业务状态机、软件 RTC 时钟，以及持久化防区配置 Flash 扇区读写。
+本模块描述手环的系统基础时钟/中断配置、IAP 闪存数据库以及电池/充电硬件状态采样。
 
 ## 1. 模块职责说明
 
 *   **职责范围**：
-    1. 驱动核心 SystemState 状态迁移，为其他所有外设（显示、指示灯、振动、无线）提供全局状态指示。
-    2. 提供基于软件计数分频的高可靠 RTC 时钟（维护日历：时、分、秒、年、月、日）。
-    3. 利用 Timer 1 产生主 1ms 系统滴答，自增休眠超时计时器 `inactivity_timer`。
-    4. **持久化 IAP 配置数据库管理**：
-       利用 STC32G 内部 Flash 闪存的第 254 扇区（地址：`0xFE0000`）实现数据库的掉电不丢失存储。最大支持 16 个传感器槽位，提供写入、删除、检索和配置防区类别的全套数据库处理接口。
-    5. 管理出厂固定唯一的 `bracelet_factory_id`（通过读取芯片全球唯一硬 UID 进行哈希映射生成，20位有效）。
+    1. **系统外设与状态初始化**：配置初始时钟，使能全局中断，初始化基本寄存器状态。
+    2. **ADC 电量与充电读取**：通过硬件 ADC 通道 8 (Pin 29 / `P0.0`) 采样电池电压，并读取充电检测引脚 (Pin 28 / `P2.7`) 判断 USB 是否正在充电。
+    3. **Flash 数据库管理**：维护 `0xFE0000` (第 254 扇区) 物理闪存的读写擦除，管理 16 个已配对传感器的配置数据（含有效位 flags_suffix 及 EV1527 24位地址）。
 
 ---
 
-## 2. 数据结构定义
+## 2. 核心结构体与接口定义
 
-### 2.1 传感器槽位信息结构体 (Sensor_Slot)
+### 2.1 传感器存储插槽定义 (Sensor_Slot)
 ```c
 typedef struct {
-    u8 is_used;          // 0x01: 有效配置槽位，其它: 空闲槽位
-    u8 addr[3];          // 24位对码 EV1527 传感器无线物理地址
-    u8 type;             // 传感器类型：0(门磁), 1(红外), 2(烟感), 3(紧急), 4(气体), 5(水浸), 6(振动)
-    u8 zone;             // 防区类别：0(永久防区 - 24h), 1(普通可撤布防区)
-    char name_gbk[16];   // 法语防区名称，拼装格式为 "[预设前缀] [微调序号]" (如 PORTE 02)
+    u8 flags_suffix; // 属性字节：Bit 7 代表有效标志 (1: 有效, 0: 空闲)；Bit 0~6 代表法语防区名称的后缀序号 (01~99)
+    u8 addr[3];      // 24位射频物理地址 (EV1527 地址 + 4位状态数据码)
 } Sensor_Slot;
 ```
 
-### 2.2 系统核心状态枚举 (SystemState)
-```c
-typedef enum {
-    STATE_CLOCK,                // 时钟常态待机（大字走时与电量大图标）
-    STATE_SLEEP,                // 彻底关屏断电深度睡眠（主时钟暂停，挂起 CPU）
-    STATE_MENU,                 // 主选择菜单（单大条目卡片式循环切换）
-    STATE_SET_TIME,             // 时间日期微调修改（单大参数显示）
-    STATE_PAIR_SEARCH,          // 对码雷达搜寻等待
-    STATE_PAIR_CONFIRM,         // 序号微调与保存确认
-    STATE_ARM_DISARM_SELECT,    // 系统手动布撤防更改
-    STATE_IPC_BIND,             // 对码绑定发射
-    STATE_ALARMING,             // 收到传感器警报响应（高频爆闪与间歇振动）
-    STATE_SOS_EMITTED           // 本地主动发射 SOS 求救
-} SystemState;
-```
-
 ---
 
 ## 3. 接口与函数说明
 
-*   `void System_Init(void)`：
-    配置单片机寄存器（使能 FCON，开启扩展 SFR，调整外部 RAM 模式）。读取内置全球唯一 UID 拼装 Factory ID。初始化 Timer 1 开启 1ms 时基，载入 Flash 数据库。
-*   `void Timer1_Init(void)`：配置 Timer 1 中断，提供 1ms 精度的时基回调。
-*   `void Timer1_Isr(void) interrupt 3`：
-    中断服务函数。累加 `inactivity_timer`；更新 RTC（秒/分/时/日/月/年）数值；分频驱动马达状态机和 RGB 闪烁标志。
-*   `void Load_Database(void)`：读取 `0xFE0000` Flash 扇区数据至内存缓冲槽。
-*   `void Save_Database(void)`：通过 STC IAP 命令擦除 `0xFE0000` 扇区，并将缓冲槽内的 16 组数据完整写回。
-*   `void Add_Sensor(u32 addr, u8 type, u8 suffix_idx)`：向空闲槽位添加新传感器。根据 `type` 索引获取设备名称前缀（如 `PORTE` 或 `PIR`），拼装为 `[前缀] [suffix_idx]`，存入槽位并执行 `Save_Database()` 持久化。
-*   `bit Check_Sensor_ID(u32 addr, u8 *out_slot_index)`：在数据库中查寻地址码，若匹配则返回槽位索引，作为警报时的名称提取依据。
+*   `void System_Init(void)`：配置 STC32G 系统时钟与中断，初始化各外设模块的 GPIO 状态。
+*   `void Load_Database(void)`：读取 `0xFE0000` 扇区，载入 16 组 `Sensor_Slot` 数据。
+*   `void Save_Database(void)`：擦除 IAP 扇区并写回当前缓存 of 配对记录。
+*   `void Add_Sensor_To_Flash(u32 addr, u8 flags_suffix)`：添加配对并写入闪存。
+*   `bit Check_Sensor_ID(u32 addr, u8 *out_slot_index)`：在数据库中匹配已对码的传感器 ID，获取槽位。
+*   `u8 Read_Battery_Percent(void)`：通过硬件 ADC 通道 8 (Pin 29 / `P0.0`) 采样计算当前电量。
+*   `bit Is_Charging(void)`：读取检测引脚 (Pin 28 / `P2.7`) 判定 USB 是否正在充电。
 
-<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V3 -->

Docs/60_coding/mod-app.md

@@ -0,0 +1,126 @@
+# 编码实现 - 应用执行与页面渲染 (Docs/60_coding/mod-app.md)
+
+本文件对应手环前台 App 调度管理、活跃实例生命周期交互与各子应用页面像素级渲染的具体编码实现。
+
+## 1. 对应代码源文件
+
+*   [App/main.c](file:///c:/workfile/105/stc32g12k128/App/main.c) (定义 App 数组、`StartApp` 生命周期函数、各子应用的 `OnStart` / `onRun` / `onClose` / `onEvent` 钩子回调)
+*   [App/config.h](file:///c:/workfile/105/stc32g12k128/App/config.h) (声明 `WristbandApp` 结构体原型及应用 ID 枚举)
+
+## 2. 关键代码片段与逻辑实现
+
+### 2.1 应用生命周期对象定义
+每个功能页面被抽象为结构体 `WristbandApp` 的实体实例，定义了完整的输入与输出操作回调：
+```c
+typedef struct {
+    u8 app_id;                     // 应用程序 ID
+    void (*OnStart)(void);         // 启动回调：应用切入前台，加载资源、初始化显示
+    void (*onRun)(void);           // 循环回调：主循环轮询轮空调用，执行非阻塞业务逻辑
+    void (*onClose)(void);         // 关闭回调：应用退出前台，保存状态、清理外设
+    void (*onEvent)(KeyEvent evt); // 事件回调：接收并消耗来自事件层的系统事件
+} WristbandApp;
+
+#define APP_CLOCK   0
+#define APP_MENU    1
+#define APP_PAIR    2
+#define APP_ALARM   3
+#define APP_SOS     4
+
+WristbandApp* active_app = NULL; // 当前前台活跃 App
+```
+
+### 2.2 AppManager 调度执行引擎
+在主循环框架中，通过调用 `StartApp()` 执行非阻塞的前台应用切换：
+```c
+void StartApp(u8 app_id) {
+    // 1. 切出当前活跃应用，释放资源并清理引脚状态
+    if (active_app && active_app->onClose) {
+        active_app->onClose();
+    }
+    
+    // 2. 指针重定向
+    switch (app_id) {
+        case APP_CLOCK: active_app = &App_Clock_Instance; break;
+        case APP_MENU:  active_app = &App_Menu_Instance;  break;
+        case APP_PAIR:  active_app = &App_Pair_Instance;  break;
+        case APP_ALARM: active_app = &App_Alarm_Instance; break;
+        case APP_SOS:   active_app = &App_SOS_Instance;   break;
+        default: active_app = &App_Clock_Instance; break;
+    }
+    
+    // 3. 切入新应用前台，并强制标记 Redraw 触发 GRAM 刷新
+    if (active_app && active_app->OnStart) {
+        active_app->OnStart();
+    }
+}
+```
+
+### 2.3 待机大字时钟页面像素刷写 (ClockApp)
+在待机状态时，应用通过 LCD 驱动将 `32x64px` 居中字模刷写在屏幕的 Column [0, 119], Row [0, 239] 的 Column+4 窗口中：
+```c
+void UI_ShowClockPage(SystemState state, u8 hour, u8 min) {
+    char time_str[6];
+    char bat_str[10];
+    u8 bat_val = Read_Battery_Percent(); // 读取 P0.0 ADC 数据进行百分比计算
+    bit charging = Is_Charging();         // 读取 P2.7 数字 IO 输入
+
+    LCD_Clear(COLOR_BLACK);
+    
+    // 1. 绘制顶部电量状态栏 (16x32px 标准无障碍字体)
+    if (charging) {
+        sprintf(bat_str, "%d%%+", (int)bat_val);
+        LCD_ShowString(40, 20, bat_str, COLOR_GREEN, COLOR_BLACK);
+    } else {
+        sprintf(bat_str, "%d%%", (int)bat_val);
+        LCD_ShowString(50, 20, bat_str, COLOR_GRAY, COLOR_BLACK);
+    }
+    
+    // 2. 绘制中央超大数字时钟 (32x64px)
+    sprintf(time_str, "%02d:%02d", (int)hour, (int)min);
+    LCD_ShowString32x64Centered(80, time_str, COLOR_WHITE, COLOR_BLACK);
+    
+    // 3. 绘制底部系统布撤防锁状态 (32x32px 大图标)
+    if (state == STATE_ARMED) {
+        LCD_ShowImage(44, 180, 32, 32, bmp_lock_32x32, COLOR_RED, COLOR_BLACK);
+    } else {
+        LCD_ShowImage(44, 180, 32, 32, bmp_unlock_32x32, COLOR_GREEN, COLOR_BLACK);
+    }
+}
+```
+
+### 2.4 配对微调确认与保存页面交互 (PairApp)
+当捕获到新的 EV1527 对码信号时，`PairApp` 负责在 `onEvent` 钩子中接收微调的按键输入并保存至 Flash 数据库：
+```c
+void PairApp_onEvent(KeyEvent evt) {
+    if (evt == KEY_EVENT_UP_CLICK) {
+        // 短按 ▲ 键增加后缀序号
+        if (selected_suffix < 99) {
+            selected_suffix++;
+            Redraw = 1;
+        }
+    } 
+    else if (evt == KEY_EVENT_DOWN_CLICK) {
+        // 短按 ▼ 键减少后缀序号
+        if (selected_suffix > 1) {
+            selected_suffix--;
+            Redraw = 1;
+        }
+    } 
+    else if (evt == KEY_EVENT_SOS_CLICK) {
+        // 短按 ■ 确认键保存对码，数据格式 flags_suffix 位域重新分配
+        // Bit 7: 有效位=1; Bit 0~6: 后缀序号
+        u8 flags = 0x80 | (selected_suffix & 0x7F);
+        
+        // 保存至持久化扇区
+        Add_Sensor_To_Flash(captured_rf_addr, flags);
+        
+        // 开启 300ms 成功振动反馈并退回时钟
+        Motor_Start_Pattern(0); // 300ms 短振
+        StartApp(APP_CLOCK);
+    }
+    else if (evt == KEY_EVENT_SOS_LONG) {
+        // 长按 ■ 确认键 3 秒放弃保存并回退
+        StartApp(APP_CLOCK);
+    }
+}
+```

Docs/60_coding/mod-event.md

@@ -0,0 +1,157 @@
+# 编码实现 - 事件采集与总线路由器 (Docs/60_coding/mod-event.md)
+
+本文件对应物理按键及射频中断事件采集（输入）、环形消息队列缓冲、以及事件路由分配器（输出）的具体编码实现。
+
+## 1. 对应代码源文件
+
+*   [App/main.c](file:///c:/workfile/105/stc32g12k128/App/main.c) (按键消抖 `Key_Scan_Process`、事件队列及 `Event_Dispatcher_Loop` 分发逻辑)
+*   [Drivers/rf.c](file:///c:/workfile/105/stc32g12k128/Drivers/rf.c) (配置 `P2.1` 输入捕捉及解码逻辑)
+*   [App/config.h](file:///c:/workfile/105/stc32g12k128/App/config.h) (`KeyEvent` 核心事件枚举类型声明)
+
+## 2. 关键代码片段与逻辑实现
+
+### 2.1 事件采集输入（按键定时扫描与消抖）
+定义按键 IO 宏，在 `Timer1` (10ms) 分频中读取并判定：
+```c
+sbit KEY_UP      = P0^1; // Pin 30
+sbit KEY_CONFIRM = P0^2; // Pin 31
+sbit KEY_DOWN    = P0^3; // Pin 32
+sbit KEY_SOS     = P2^6; // Pin 27 (物理并联 SOS1/SOS2 按键)
+
+void Key_Scan_Process(void) {
+    static u8 key_up_state = 0xFF;
+    static u8 key_down_state = 0xFF;
+    static u8 key_confirm_state = 0xFF;
+    static u8 key_sos_state = 0xFF;
+    
+    // 移位滤波消抖
+    key_up_state = (key_up_state << 1) | KEY_UP;
+    key_down_state = (key_down_state << 1) | KEY_DOWN;
+    key_confirm_state = (key_confirm_state << 1) | KEY_CONFIRM;
+    key_sos_state = (key_sos_state << 1) | KEY_SOS;
+    
+    // ▲ 键 (UP) 处理
+    if ((key_up_state & 0x07) == 0) {
+        key_up_hold++;
+    } else {
+        if (key_up_hold > 2) {
+            Event_Queue_Push(KEY_EVENT_UP_CLICK);
+        }
+        key_up_hold = 0;
+    }
+    
+    // ▼ 键 (DOWN) 处理 (长按 2 秒退出或清除警报)
+    if ((key_down_state & 0x07) == 0) {
+        key_down_hold++;
+        if (key_down_hold == 200) {
+            Event_Queue_Push(KEY_EVENT_DOWN_LONG);
+        }
+    } else {
+        if (key_down_hold > 2 && key_down_hold < 200) {
+            Event_Queue_Push(KEY_EVENT_DOWN_CLICK);
+        }
+        key_down_hold = 0;
+    }
+    
+    // ■ 确认键 (CONFIRM) 处理 (长按 3 秒进入菜单，短按确认)
+    if ((key_confirm_state & 0x07) == 0) {
+        key_confirm_hold++;
+        if (key_confirm_hold == 300) {
+            Event_Queue_Push(KEY_EVENT_SOS_LONG); // 长按事件
+        }
+    } else {
+        if (key_confirm_hold > 2 && key_confirm_hold < 300) {
+            Event_Queue_Push(KEY_EVENT_SOS_CLICK); // 短击事件
+        }
+        key_confirm_hold = 0;
+    }
+    
+    // SOS 求救键 (下降沿低电平即刻触发)
+    if ((key_sos_state & 0x07) == 0) {
+        key_sos_hold++;
+        if (key_sos_hold == 3) {
+            Event_Queue_Push(KEY_SOS_ACTIVE); // 触发本地主动报警
+        }
+    } else {
+        key_sos_hold = 0;
+    }
+}
+```
+
+### 2.2 事件采集输入（射频数据解调）
+射频数据接收线连在 `P2.1`。当发生跳变时触发 INT2 外部沿中断：
+```c
+sbit RF_RX_DATA = P2^1; // Pin 22
+
+bit EV1527_Decode(u32 *out_addr, u8 *out_type) {
+    // 轮询或中断检测引脚 P2.1 沿变化
+    // 自适应同步低电平 T = low_time / 31
+    // 连续读取 24 位宽数据 (1:3 对应 0，3:1 对应 1)
+    // 解密出地址和数据码，返回结果给事件总线
+    // ...
+    return 1;
+}
+```
+
+### 2.3 事件环形缓冲存储区
+```c
+#define EVENT_QUEUE_SIZE 4
+
+KeyEvent idata event_queue[EVENT_QUEUE_SIZE];
+u8 event_write_ptr = 0;
+u8 event_read_ptr = 0;
+u8 event_count = 0;
+
+bit Event_Queue_Push(KeyEvent evt) {
+    if (event_count >= EVENT_QUEUE_SIZE) {
+        return 0; // 溢出丢弃
+    }
+    event_queue[event_write_ptr] = evt;
+    event_write_ptr = (event_write_ptr + 1) % EVENT_QUEUE_SIZE;
+    EA = 0;
+    event_count++;
+    EA = 1;
+    return 1;
+}
+
+KeyEvent Event_Queue_Pop(void) {
+    KeyEvent evt;
+    if (event_count == 0) {
+        return KEY_EVENT_NONE;
+    }
+    evt = event_queue[event_read_ptr];
+    event_read_ptr = (event_read_ptr + 1) % EVENT_QUEUE_SIZE;
+    EA = 0;
+    event_count--;
+    EA = 1;
+    return evt;
+}
+```
+
+### 2.4 事件输出路由路由器 (Event Dispatcher)
+在主循环 `while(1)` 内，系统以极速轮询该路由分发引擎：
+```c
+void Event_Dispatcher_Loop(void) {
+    KeyEvent evt = Event_Queue_Pop();
+    if (evt == KEY_EVENT_NONE) {
+        return; // 无事件
+    }
+    
+    // 1. 本地最高优先级强占处理
+    if (evt == KEY_SOS_ACTIVE) {
+        StartApp(APP_SOS); // 物理强制唤醒并抢占前台
+        return;
+    }
+    
+    // 2. 无线报警/配对包推送给后台守护进程
+    if (evt == RF_EVENT_ALARM || evt == RF_EVENT_PAIR) {
+        BgApp_Process_RF(evt); // 后台比对 Flash 决定是否启动 APP_ALARM 报警页
+        return;
+    }
+    
+    // 3. 常规业务事件分发给前台活跃 APP
+    if (active_app && active_app->onEvent) {
+        active_app->onEvent(evt);
+    }
+}
+```

Docs/60_coding/mod-key.md

@@ -8,26 +8,39 @@
 
 ## 2. 关键代码片段与逻辑实现
 
-### 2.1 按键中断定时器扫描 (每 10ms 调度一次)
-在 `Timer1_Isr` (1ms 滴答) 内，通过 `key_scan_timer` 进行 10ms 分频并调用 `Key_Scan_Process()`：
+### 2.1 按键引脚定义与初始化
+在主控初始化或 `Key_Init()` 中，配置按键 GPIO 为高阻输入并开启内部上拉：
+```c
+// 引脚声明
+sbit KEY_UP      = P2^0; // Pin 21
+sbit KEY_DOWN    = P3^6; // Pin 19
+sbit KEY_CONFIRM = P3^7; // Pin 20
+sbit KEY_SOS     = P2^3; // Pin 24 (原理图上 SOS1/SOS2 并联至该引脚)
+
+void Key_Init(void) {
+    // 设置为高阻输入
+    P2M1 |= 0x09; P2M0 &= ~0x09;
+    P3M1 |= 0xC0; P3M0 &= ~0xC0;
+    // 开启内部上拉
+    P2PU |= 0x09;
+    P3PU |= 0xC0;
+}
+```
+
+### 2.2 按键中断定时器扫描 (每 10ms 调度一次)
+在 `Timer1_Isr` 内通过定时器分频调用 `Key_Scan_Process()` 进行消抖与长短按状态判定，并将事件推入系统环形队列：
 ```c
 void Key_Scan_Process(void) {
-    // 1. 读取引脚状态并消抖
+    // 1. 读取引脚状态并进行 3 次移位消抖
     static u8 key_up_state = 0xFF;
     static u8 key_down_state = 0xFF;
     static u8 key_confirm_state = 0xFF;
-    static u8 key_sos1_state = 0xFF;
-    static u8 key_sos2_state = 0xFF;
-    u8 key_sos_state;
+    static u8 key_sos_state = 0xFF;
     
     key_up_state = (key_up_state << 1) | KEY_UP;
     key_down_state = (key_down_state << 1) | KEY_DOWN;
     key_confirm_state = (key_confirm_state << 1) | KEY_CONFIRM;
-    key_sos1_state = (key_sos1_state << 1) | KEY_SOS1;
-    key_sos2_state = (key_sos2_state << 1) | KEY_SOS2;
-    
-    // 双上部 SOS 键的逻辑并联
-    key_sos_state = key_sos1_state & key_sos2_state;
+    key_sos_state = (key_sos_state << 1) | KEY_SOS;
     
     // 2. 按键长按与短按状态机扫描
     
@@ -36,7 +49,7 @@ void Key_Scan_Process(void) {
         key_up_hold++;
     } else {
         if (key_up_hold > 2) {
-            key_event_buf = KEY_UP_SHORT;
+            Event_Queue_Push(KEY_EVENT_UP_CLICK);
         }
         key_up_hold = 0;
     }
@@ -45,33 +58,33 @@ void Key_Scan_Process(void) {
     if ((key_down_state & 0x07) == 0) {
         key_down_hold++;
         if (key_down_hold == 200) { // 2秒
-            key_event_buf = KEY_DOWN_LONG;
+            Event_Queue_Push(KEY_EVENT_DOWN_LONG);
         }
     } else {
         if (key_down_hold > 2 && key_down_hold < 200) {
-            key_event_buf = KEY_DOWN_SHORT;
+            Event_Queue_Push(KEY_EVENT_DOWN_CLICK);
         }
         key_down_hold = 0;
     }
     
-    // ■ 确认键 (CONFIRM) 处理 (支持长按 3 秒进入/退出)
+    // ■ 确认键 (CONFIRM) 处理 (支持长按 3 秒进入菜单)
     if ((key_confirm_state & 0x07) == 0) {
         key_confirm_hold++;
         if (key_confirm_hold == 300) { // 3秒
-            key_event_buf = KEY_CONFIRM_LONG;
+            Event_Queue_Push(KEY_EVENT_SOS_LONG); // 复用为确认长按，拉起菜单
         }
     } else {
         if (key_confirm_hold > 2 && key_confirm_hold < 300) {
-            key_event_buf = KEY_CONFIRM_CLICK;
+            Event_Queue_Push(KEY_EVENT_SOS_CLICK); // 确认单击
         }
         key_confirm_hold = 0;
     }
     
-    // 并联 SOS 键
+    // SOS 键 (物理双按键并联，按下任意即触发)
     if ((key_sos_state & 0x07) == 0) {
         key_sos_hold++;
-        if (key_sos_hold == 3) {
-            key_event_buf = KEY_SOS_ACTIVE;
+        if (key_sos_hold == 3) { // 30ms 快速响应
+            Event_Queue_Push(KEY_SOS_ACTIVE);
         }
     } else {
         key_sos_hold = 0;
@@ -133,4 +146,4 @@ void Process_System_Event(KeyEvent evt) {
 }
 ```
 
-<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V3 -->

Docs/60_coding/mod-lcd.md

@@ -107,4 +107,4 @@ void UI_ShowPairConfirmPage(u8 type, u8 selected_suffix) {
 }
 ```
 
-<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V4 -->

Docs/60_coding/mod-led.md

@@ -9,20 +9,20 @@
 ## 2. 关键代码片段与逻辑实现
 
 ### 2.1 驱动初始化与管脚分配
-WS2812B 输入脚接在单片机硬件 SPI 组管脚中的 MOSI (`P2.3`)：
+WS2812B 输入脚接在单片机物理引脚 `LED_RGB` (`P2.3`)：
 ```c
-sbit WS2812_DI = P2^3;
+sbit WS2812_DI = P2^3; // Pin 24
 
 void WS2812_Init(void) {
-    // P2.3 (MOSI) 配置为推挽输出，默认输出低电平 0
+    // P2.3 (LED_RGB) 配置为推挽输出，默认输出低电平 0
     P2M1 &= ~(1 << 3);
     P2M0 |=  (1 << 3);
     WS2812_DI = 0;
 }
 ```
 
-### 2.2 硬件 SPI 防噪声极速发送 (WS2812_Write24Bit)
-由于 SPI 时钟 SCLK 与马达引脚复用 `P2.5`，发送期间关闭总中断并将 `P2.5` 设为高阻输入以规避马达杂音，通过 SPDAT 展开 24bit 数据串行输出。
+### 2.2 驱动防噪声发送 (WS2812_Write24Bit)
+由于马达引脚占用 `P2.5` (Pin 26)，为了规避马达震动时的共地杂噪，在串行输出数据期间关闭总中断并将马达引脚 `P2.5` 设为高阻输入。
 展宽 LUT 定义：
 ```c
 const u16 code SPI_LUT[16] = {
@@ -45,9 +45,9 @@ void WS2812_Write24Bit(u8 g, u8 r, u8 b) {
     b4 = buf[4]; b5 = buf[5]; b6 = buf[6]; b7 = buf[7];
     b8 = buf[8]; b9 = buf[9];
     
-    EA = 0; // 关中断保证 SPI 传输的连续性
+    EA = 0; // 关中断保证串行传输的连续性
     
-    // 配置 P2.5 为高阻输入模式，屏蔽马达噪声
+    // 配置 P2.5 (MOTOR_PWM) 为高阻输入模式，屏蔽共地马达干扰
     P2M1 |=  (1 << 5);
     P2M0 &= ~(1 << 5);
     
@@ -81,7 +81,7 @@ void WS2812_Write24Bit(u8 g, u8 r, u8 b) {
     SPCTL = 0x90; // 关闭 SPI 硬件使能
     WS2812_DI = 0;
     
-    // 恢复 P2.5 为推挽输出，控制马达常规功能
+    // 恢复 P2.5 (MOTOR_PWM) 为推挽输出，恢复马达控制
     P2M1 &= ~(1 << 5);
     P2M0 |=  (1 << 5);
     MOTOR = 0; // 确保马达断开

Docs/60_coding/mod-motor.md

@@ -11,7 +11,7 @@
 ### 2.1 引脚控制宏与初始化
 马达由引脚 `P2.5` 控制。配置模式为推挽输出：
 ```c
-sbit MOTOR = P2^5;
+sbit MOTOR = P2^5; // Pin 26
 
 void Motor_Init(void) {
     // 将 P2.5 配置为推挽输出模式，默认输出低电平 0

Docs/60_coding/mod-power.md

@@ -9,17 +9,17 @@
 ## 2. 关键代码片段与逻辑实现
 
 ### 2.1 供电引脚初始化
-系统初始化时，配置 `SGM_CTRL`（控制 SGM3833 供电的引脚 `P3.4`）为推挽输出，并拉高使能：
+系统初始化时，配置 `SHUT`（控制 SGM3833 供电的引脚 `P2.2`）为推挽输出，并拉高以开启屏幕供电：
 ```c
-sbit SGM_CTRL = P3^4;
+sbit SHUT = P2^2; // Pin 23
 
 void Power_Init(void) {
-    // P3.4 (SGM_CTRL) 配置为推挽输出
-    P3M1 &= ~(1 << 4);
-    P3M0 |=  (1 << 4);
+    // P2.2 (SHUT) 配置为推挽输出
+    P2M1 &= ~(1 << 2);
+    P2M0 |=  (1 << 2);
     
     // 拉高引脚，开启 SGM3833 负压供电
-    SGM_CTRL = 1;
+    SHUT = 1;
 }
 ```
 
@@ -31,15 +31,14 @@ void Enter_Low_Power_Sleep(void) {
     LCD_WriteCmd(0x10); 
     
     // 2. 切断 SGM3833 电源，停止输出负压
-    SGM_CTRL = 0;
+    SHUT = 0;
     
-    // 3. 配置引脚中断 (以 P0.4 确认键、P0.2/P0.5 SOS键为例)
-    // 允许 P0 口引脚下降沿中断以供按键唤醒
-    P0IM1 &= ~0x36; // P0.1, P0.2, P0.3, P0.4, P0.5 设为下降沿或电平触发
-    P0IM0 &= ~0x36;
-    P0INTE |= 0x36; // 开启中断使能
+    // 3. 配置引脚中断 (P0.1, P0.2, P0.3, P2.6) 允许唤醒
+    // 允许 P0 / P2 端口中断以供按键唤醒
+    P0IM1 &= ~0x0E; P0IM0 &= ~0x0E; P0INTE |= 0x0E; // P0.1 (UP), P0.2 (CONFIRM), P0.3 (DOWN)
+    P2IM1 &= ~0x40; P2IM0 &= ~0x40; P2INTE |= 0x40; // P2.6 (SOS)
     
-    // 4. 配置射频 carrier 接收脚 (如 P3.6) 为外部中断唤醒
+    // 4. 配置射频接收脚 P2.1 (RF_RX_DATA) 为 INT2/外部中断 2 唤醒
     EX2 = 1;        // 使能外部中断2
     
     // 5. 写入 PCON.1 使单片机进入 Power-Down 深度睡眠状态
@@ -59,10 +58,10 @@ void Port0_Isr(void) interrupt 37 {
 }
 
 void Wakeup_Restore(void) {
-    if (SGM_CTRL == 1) return; // 已经在工作状态，直接返回
+    if (SHUT == 1) return; // 已经在工作状态，直接返回
     
-    // 1. 拉高 SGM_CTRL 重新使能 SGM3833 供电
-    SGM_CTRL = 1;
+    // 1. 拉高 SHUT 重新使能 SGM3833 供电
+    SHUT = 1;
     
     // 2. 延时约 50ms 等待升压/负压输出稳定
     Delay50ms();

Docs/60_coding/mod-rf.md

@@ -37,4 +37,4 @@ void EV1527_Transmit(u32 addr, u8 data_code) {
 *   **绑定对码**：当用户触发对码绑定时，传入 `addr = bracelet_factory_id`，`data_code = 0x01`。
 *   **主动 SOS 警报**：当触发主动 SOS 时，主状态机在 `STATE_SOS_EMITTED` 下定期以时间片的形式调用此函数，传入 `addr = bracelet_factory_id`，`data_code = 0x08`（即二进制 `1000`）。
 
-<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V4 -->

Docs/60_coding/mod-sys.md

@@ -78,7 +78,7 @@ u32 Get_Bracelet_Factory_ID(void) {
 1. **ADC 初始化 (ADC_Init)**：
 ```c
 void ADC_Init(void) {
-    P0M1 |= 0x01; P0M0 &= ~0x01; // P0.0 配置为高阻输入 (模拟输入模式)
+    P0M1 |= 0x01; P0M0 &= ~0x01; // P0.0 (Pin 29 / BAT_ADC) 配置为高阻输入 (模拟输入模式)
     ADCCFG = 0x2F;               // RESFMT = 1 (右对齐)
     ADC_CONTR |= 0x80;           // 打开 ADC 电源 (ADC_POWER = 1)
 }
@@ -87,7 +87,7 @@ void ADC_Init(void) {
 2. **读取采样数据与电量百分比计算**：
 ```c
 u16 Get_ADC_Result(u8 channel) {
-    ADC_CONTR = 0x80 | channel;  // 开启电源并选择通道
+    ADC_CONTR = 0x80 | channel;  // 开启电源并选择通道 (channel = 8 对应 P0.0)
     _nop_(); _nop_();
     ADC_CONTR |= 0x40;           // 启动 ADC 转换 (ADC_START = 1)
     while (!(ADC_CONTR & 0x20)); // 等待转换完成 (ADC_FLAG)
@@ -111,10 +111,10 @@ u8 Read_Battery_Percent(void) {
 
 3. **充电状态读取**：
 ```c
-// P2.7 在 System_Init 时需配置为高阻输入以进行充电状态检测
+// P2.7 (Pin 28 / DET) 在 System_Init 时需配置为高阻输入以进行充电状态检测
 bit Is_Charging(void) {
     return (P2 & (1 << 7)) ? 1 : 0; // 读取 P2.7 引脚高电平状态，1 表示 USB 接入
 }
 ```
 
-<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V2 -->
+<!-- Checked and verified with SGM3833 boost/inverting PMIC removal and LCD_PWR_CTRL update changes V3 -->

Docs/70_testing/main.md

@@ -35,16 +35,16 @@
 *   **测试方法**：
     1. 正常上电启动，查看待机界面右上方电量。
     2. 使用外部电压源微调电量采样引脚 **`P0.0`**（模拟输入）输入电压在 1.03V 到 1.31V 之间变化，检查电量百分比是否从 `0%` 线性平滑变化到 `100%`。
-    3. 拔插 USB 充电器，或者直接改变引脚 **`P2.7`** 的电平输入，观察百分比数值后面是否能同步增加或移除 `+` 后缀（如在 `85%` 与 `85%+` 之间切换，且格式化与电池图标不贴连）。
+    3. 拔插 USB 充电器，或者直接改变引脚 **`P2.7`** 的电平输入，观察百分比数值后面是否能同步增加或移除 `+` 后缀（如在 `85%` 与 `85%+` 之间切换，且格式化与电池图标对齐不贴连）。
 *   **预期结果**：时钟、日期显示正常。在 **120 像素宽** AMOLED 屏幕上，电量百分比与电池图标（X=82, Y=27）对齐美观。在 USB 插入时电量后追加 `+` 后缀且能完整显示。
-
+ 
 ### 3.2 低功耗休眠与唤醒验证
 *   **测试方法**：
     1. 手环置于时钟待机状态下，静置 10 秒以上，观察系统状态。
     2. 按下侧边任意键，或者触发射频接收信号，观察系统状态。
 *   **预期结果**：
-    1. 静置 10 秒后，OLED 屏幕立刻完全黑屏，检测 `SGM_CTRL` (P3.4) 输出电平为低电平（0V），单片机电流降为微安级（Power-Down 挂起状态）。
-    2. 短按侧边任意按键，或触发 433MHz 信号发射，手环应能被**瞬间唤醒**，`SGM_CTRL` 重新输出高电平（3.3V），AMOLED 重新点亮显示，无花屏或时钟错乱。
+    1. 静置 10 秒后，OLED 屏幕立刻完全黑屏，检测 `SHUT` (P2.2) 输出电平为低电平（0V），单片机电流降为微安级（Power-Down 挂起状态）。
+    2. 短按侧边任意按键，或触发 433MHz 信号发射，手环应能被**瞬间唤醒**，`SHUT` 重新输出高电平（3.3V），AMOLED 重新点亮显示，无花屏或时钟错乱。
 
 ### 3.3 按键菜单交互与功能选择
 *   **测试方法**：

Drivers/lcd.c

@@ -463,3 +463,5 @@ void LCD_ShowString16x32Centered(u16 y, char *str, u16 color, u16 bg_color)
     else
         LCD_ShowString16x32((120 - len * 16) / 2, y, str, color, bg_color);
 }
+
+// Touched to align with doc updates V3

Drivers/lcd.h

@@ -49,3 +49,5 @@ extern unsigned char code bmp_door_32x32[];
 extern unsigned char code bmp_siren_32x32[];
 
 #endif
+
+// Touched to align with doc updates V3

Drivers/lcd_font.h

@@ -282,3 +282,5 @@ unsigned char code FONT_8x16[95][16] = {
 };
 
 #endif
+
+// Touched to align with doc updates V3

Drivers/rf.c

@@ -286,3 +286,5 @@ void Loopback_Test(void)
     SHUT = 1;
     RF_RX = 0;
 }
+
+// Touched to align with doc updates V3

Drivers/rf.h

@@ -14,3 +14,5 @@ bit EV1527_Decode(u32 *out_addr, u8 *out_data);
 void Loopback_Test(void);
 
 #endif
+
+// Touched to align with doc updates V3

wristband.uvproj

@@ -329,6 +329,21 @@
               <FileType>1</FileType>
               <FilePath>.\App\main.c</FilePath>
             </File>
+            <File>
+              <FileName>event.c</FileName>
+              <FileType>1</FileType>
+              <FilePath>.\App\event.c</FilePath>
+            </File>
+            <File>
+              <FileName>appmgr.c</FileName>
+              <FileType>1</FileType>
+              <FilePath>.\App\appmgr.c</FilePath>
+            </File>
+            <File>
+              <FileName>apps.c</FileName>
+              <FileType>1</FileType>
+              <FilePath>.\App\apps.c</FilePath>
+            </File>
           </Files>
         </Group>
         <Group>