refactor: 使用flutter对原先的web项目重构，正在进行中

.workbuddy/memory/MEMORY.md

@@ -60,3 +60,14 @@
 - 仅在 `playing` 态显示（`startLevel`/`resume` 显示，菜单/暂停/结算隐藏）；HUD 每帧 `Touch.setGun(P.hasGun)` 控制射击键置灰。
 - 若改键位含义，记得同步 `js/input.js` 的 `BIND` 与 `touch.js` 的 `HELD`/`api` 映射。
 
+## Flutter 移植版（`app/`，脱胎于本 web 源码）
+目标是 android+macos+linux+windows 四平台 100% 复刻 UI/功能/手感。核心约定：
+- **渲染**：自定义 `Ticker` + `CustomPaint`，信箱缩放 800×608 → 适配屏幕；`GameCanvas` 用 `SizedBox.expand`（不要用 `Size.infinite`，零尺寸会让 scale=0 整屏消失）。
+- **循环**：`World.tick(dt)` 固定 60Hz 累加器（`STEP=1000/60`），`Player.update(1)` 定步长 —— 手感 1:1 的关键，别改成 dt 缩放。
+- **输入**：Flutter 按键经 `LogicalKeyboardKey.debugName` 去空格 → 喂给 `Input.onKey()`，得到与 web `KeyboardEvent.code` 完全相同的字符串（`ShiftLeft/KeyZ/KeyR/Backspace/Escape`）。
+- **`Positioned` 必须是 `Stack` 的直接子级**（血泪）：把它写在 `ValueListenableBuilder.builder` 的返回值里会丢弃定位数据 → 子树横向塌缩为 0 宽 → 表现为"黑屏"。一律写成 `Positioned(child: ValueListenableBuilder(...))`。
+- **凡是"某状态决定某子树显隐"，该状态必须可监听**：`World.state` 已改由 `ValueNotifier<String> stateN` 承载（曾在 `build()` 里读普通字段导致 HUD 永不出现）。
+- **音频不能拖垮游戏**：`Sfx` 有 `broken` 永久静音开关；`AppError.reportZone` 会把 audioplayers 的插件噪声降级为日志。
+- **测试**：widget 测试永远覆盖不到 `main()` 的 bootstrap；断言要用 `tester.getSize()` 查**可见尺寸**（`find` 不查可见性）。游戏有常驻 Ticker → **禁用 `pumpAndSettle`**。原生构建需真实机器；本沙箱 Flutter 写不了自己的 `/opt/flutter/bin/cache` 缓存。
+- 手感回归请跑 `flutter test`（含 `test/gameplay_test.dart` 的跳初速/重力/松手-guard/死亡重生断言）。
+