feat(engine-core): 添加统一输入系统 (#282)

* perf(core): 优化 EntitySystem 迭代性能，添加 CommandBuffer 延迟命令

ReactiveQuery 快照优化:
- 添加快照机制，避免每帧拷贝数组
- 只在实体列表变化时创建新快照
- 静态场景下多个系统共享同一快照

CommandBuffer 延迟命令系统:
- 支持延迟添加/移除组件、销毁实体、设置实体激活状态
- 每个系统拥有独立的 commands 属性
- 命令在帧末统一执行，避免迭代过程中修改实体列表

Scene 更新:
- 在 lateUpdate 后自动刷新所有系统的命令缓冲区

文档:
- 更新系统文档，添加 CommandBuffer 使用说明

* fix(ci): upgrade first-interaction action to v1.3.0

Fix Docker build failure in welcome workflow.

* fix(ci): upgrade pnpm/action-setup to v4 and fix unused import

- Upgrade pnpm/action-setup@v2 to v4 in all workflow files
- Remove unused CommandType import in CommandBuffer.test.ts

* fix(ci): remove duplicate pnpm version specification

* feat(engine-core): 添加统一输入系统

添加完整的输入系统，支持平台抽象：

- IPlatformInputSubsystem: 扩展接口支持键盘/鼠标/滚轮事件
- WebInputSubsystem: 浏览器实现，支持事件绑定/解绑
- InputManager: 全局输入状态管理器（键盘、鼠标、触摸）
- InputSystem: ECS 系统，连接平台事件到 InputManager
- GameRuntime 集成: 自动创建 InputSystem 并绑定平台子系统

使用方式:
```typescript
import { Input, MouseButton } from '@esengine/engine-core';

if (Input.isKeyDown('KeyW')) { /* 移动 */ }
if (Input.isKeyJustPressed('Space')) { /* 跳跃 */ }
if (Input.isMouseButtonDown(MouseButton.Left)) { /* 射击 */ }
```

* fix(runtime-core): 添加缺失的 platform-common 依赖

* fix(runtime-core): 移除 platform-web 依赖避免循环依赖

* fix(runtime-core): 使用工厂函数注入 InputSubsystem 避免循环依赖

- BrowserPlatformAdapter 通过 inputSubsystemFactory 配置接收输入子系统
- 在 IPlatformInputSubsystem 接口添加可选的 dispose 方法
- 移除对 @esengine/platform-web 的直接依赖

packages/platform-common/src/IPlatformSubsystems.ts

@@ -354,6 +354,7 @@ export interface IPlatformNetworkSubsystem {
 
 /**
  * 触摸点信息
+ * Touch point information
  */
 export interface TouchInfo {
     identifier: number;
@@ -364,6 +365,7 @@ export interface TouchInfo {
 
 /**
  * 触摸事件
+ * Touch event
  */
 export interface TouchEvent {
     touches: TouchInfo[];
@@ -373,57 +375,270 @@ export interface TouchEvent {
 
 /**
  * 触摸事件处理函数
+ * Touch event handler
  */
 export type TouchHandler = (event: TouchEvent) => void;
 
+/**
+ * 键盘事件信息
+ * Keyboard event information
+ */
+export interface KeyboardEventInfo {
+    /** 按键代码 (如 'KeyW', 'Space', 'ArrowUp') | Key code */
+    code: string;
+    /** 按键值 (如 'w', ' ', 'ArrowUp') | Key value */
+    key: string;
+    /** Alt 键是否按下 | Alt key pressed */
+    altKey: boolean;
+    /** Ctrl 键是否按下 | Ctrl key pressed */
+    ctrlKey: boolean;
+    /** Shift 键是否按下 | Shift key pressed */
+    shiftKey: boolean;
+    /** Meta 键是否按下 (Windows/Command) | Meta key pressed */
+    metaKey: boolean;
+    /** 是否重复触发 | Is repeat */
+    repeat: boolean;
+    /** 时间戳 | Timestamp */
+    timeStamp: number;
+}
+
+/**
+ * 键盘事件处理函数
+ * Keyboard event handler
+ */
+export type KeyboardHandler = (event: KeyboardEventInfo) => void;
+
+/**
+ * 鼠标按钮枚举
+ * Mouse button enum
+ */
+export enum MouseButton {
+    /** 左键 | Left button */
+    Left = 0,
+    /** 中键 | Middle button */
+    Middle = 1,
+    /** 右键 | Right button */
+    Right = 2
+}
+
+/**
+ * 鼠标事件信息
+ * Mouse event information
+ */
+export interface MouseEventInfo {
+    /** X 坐标 | X coordinate */
+    x: number;
+    /** Y 坐标 | Y coordinate */
+    y: number;
+    /** 相对上次的 X 偏移 | X movement delta */
+    movementX: number;
+    /** 相对上次的 Y 偏移 | Y movement delta */
+    movementY: number;
+    /** 按下的按钮 | Button pressed */
+    button: MouseButton;
+    /** 所有按下的按钮位掩码 | Buttons bitmask */
+    buttons: number;
+    /** Alt 键是否按下 | Alt key pressed */
+    altKey: boolean;
+    /** Ctrl 键是否按下 | Ctrl key pressed */
+    ctrlKey: boolean;
+    /** Shift 键是否按下 | Shift key pressed */
+    shiftKey: boolean;
+    /** Meta 键是否按下 | Meta key pressed */
+    metaKey: boolean;
+    /** 时间戳 | Timestamp */
+    timeStamp: number;
+}
+
+/**
+ * 鼠标滚轮事件信息
+ * Mouse wheel event information
+ */
+export interface WheelEventInfo {
+    /** X 坐标 | X coordinate */
+    x: number;
+    /** Y 坐标 | Y coordinate */
+    y: number;
+    /** X 轴滚动量 | Delta X */
+    deltaX: number;
+    /** Y 轴滚动量 | Delta Y */
+    deltaY: number;
+    /** Z 轴滚动量 | Delta Z */
+    deltaZ: number;
+    /** 时间戳 | Timestamp */
+    timeStamp: number;
+}
+
+/**
+ * 鼠标事件处理函数
+ * Mouse event handler
+ */
+export type MouseHandler = (event: MouseEventInfo) => void;
+
+/**
+ * 鼠标滚轮事件处理函数
+ * Mouse wheel event handler
+ */
+export type WheelHandler = (event: WheelEventInfo) => void;
+
 /**
  * 输入子系统接口
+ * Input subsystem interface
  */
 export interface IPlatformInputSubsystem {
+    // ========== 触摸事件 | Touch events ==========
+
     /**
      * 监听触摸开始
+     * Listen for touch start
      */
     onTouchStart(handler: TouchHandler): void;
 
     /**
      * 监听触摸移动
+     * Listen for touch move
      */
     onTouchMove(handler: TouchHandler): void;
 
     /**
      * 监听触摸结束
+     * Listen for touch end
      */
     onTouchEnd(handler: TouchHandler): void;
 
     /**
      * 监听触摸取消
+     * Listen for touch cancel
      */
     onTouchCancel(handler: TouchHandler): void;
 
     /**
      * 取消监听触摸开始
+     * Stop listening for touch start
      */
     offTouchStart(handler: TouchHandler): void;
 
     /**
      * 取消监听触摸移动
+     * Stop listening for touch move
      */
     offTouchMove(handler: TouchHandler): void;
 
     /**
      * 取消监听触摸结束
+     * Stop listening for touch end
      */
     offTouchEnd(handler: TouchHandler): void;
 
     /**
      * 取消监听触摸取消
+     * Stop listening for touch cancel
      */
     offTouchCancel(handler: TouchHandler): void;
 
     /**
      * 获取触摸点是否支持压感
+     * Check if touch supports pressure
      */
     supportsPressure?(): boolean;
+
+    // ========== 键盘事件 | Keyboard events ==========
+
+    /**
+     * 监听键盘按下
+     * Listen for key down
+     */
+    onKeyDown?(handler: KeyboardHandler): void;
+
+    /**
+     * 监听键盘释放
+     * Listen for key up
+     */
+    onKeyUp?(handler: KeyboardHandler): void;
+
+    /**
+     * 取消监听键盘按下
+     * Stop listening for key down
+     */
+    offKeyDown?(handler: KeyboardHandler): void;
+
+    /**
+     * 取消监听键盘释放
+     * Stop listening for key up
+     */
+    offKeyUp?(handler: KeyboardHandler): void;
+
+    // ========== 鼠标事件 | Mouse events ==========
+
+    /**
+     * 监听鼠标移动
+     * Listen for mouse move
+     */
+    onMouseMove?(handler: MouseHandler): void;
+
+    /**
+     * 监听鼠标按下
+     * Listen for mouse down
+     */
+    onMouseDown?(handler: MouseHandler): void;
+
+    /**
+     * 监听鼠标释放
+     * Listen for mouse up
+     */
+    onMouseUp?(handler: MouseHandler): void;
+
+    /**
+     * 监听鼠标滚轮
+     * Listen for mouse wheel
+     */
+    onWheel?(handler: WheelHandler): void;
+
+    /**
+     * 取消监听鼠标移动
+     * Stop listening for mouse move
+     */
+    offMouseMove?(handler: MouseHandler): void;
+
+    /**
+     * 取消监听鼠标按下
+     * Stop listening for mouse down
+     */
+    offMouseDown?(handler: MouseHandler): void;
+
+    /**
+     * 取消监听鼠标释放
+     * Stop listening for mouse up
+     */
+    offMouseUp?(handler: MouseHandler): void;
+
+    /**
+     * 取消监听鼠标滚轮
+     * Stop listening for mouse wheel
+     */
+    offWheel?(handler: WheelHandler): void;
+
+    // ========== 输入能力查询 | Input capability queries ==========
+
+    /**
+     * 是否支持键盘输入
+     * Check if keyboard input is supported
+     */
+    supportsKeyboard?(): boolean;
+
+    /**
+     * 是否支持鼠标输入
+     * Check if mouse input is supported
+     */
+    supportsMouse?(): boolean;
+
+    // ========== 生命周期 | Lifecycle ==========
+
+    /**
+     * 释放资源
+     * Dispose resources
+     */
+    dispose?(): void;
 }
 
 // ============================================================================

packages/platform-common/src/index.ts

@@ -29,6 +29,12 @@ export type {
     TouchInfo,
     TouchEvent,
     TouchHandler,
+    KeyboardEventInfo,
+    KeyboardHandler,
+    MouseEventInfo,
+    MouseHandler,
+    WheelEventInfo,
+    WheelHandler,
     // 文件系统
     IPlatformFileSubsystem,
     FileInfo,
@@ -41,6 +47,9 @@ export type {
     SystemInfo
 } from './IPlatformSubsystems';
 
+// 导出枚举值 | Export enum values
+export { MouseButton } from './IPlatformSubsystems';
+
 // WASM 库加载器
 export {
     PlatformType,