feat：新增代码注释

app/actions/registry.py

@@ -25,7 +25,13 @@ ACTION_HANDLERS: dict[str, BaseActionHandler[Any]] = {
 
 def apply_action(screen: Screen, action: Action) -> Screen:
     """接收已通过 Schema 校验的动作，返回修改后的大屏副本，不保存或更新前端"""
+
+    # 根据动作协议中的 type 查找对应处理器
     handler = ACTION_HANDLERS.get(action.type)
+
+    # 如果类型尚未注册，明确报错，避免静默跳过动作
     if handler is None:
         raise ValueError(f"尚未实现动作处理器: {action.type}")
+
+    # 委托处理器校验并修改副本，执行异常交由调用方统一处理
     return handler.apply(screen, action)