docs: WEB BUILD SUCCEEDS. build_web.sh helper, TODO status update. lib 6 (util_io deferred), web 0 errors

TODO.md

@@ -1,7 +1,12 @@
-# TODO — Flutter Wisetronic Dart 3 空安全迁移（剩余工作）
+# TODO — Flutter Wisetronic Dart 3 空安全迁移
 
-> **当前进度**：错误从峰值 **2374** 降到 **118（lib）/ 112（web 构建）**，0 语法损坏。
-> 分支 `dev2`，最新提交已 clean。Web 构建 (`flutter build web`) 目标：0 error → 可运行。
+> ## ✅ Web 构建已成功！（2026-08-01）
+> **`flutter build web --no-tree-shake-icons` → ✓ Built build/web/（main.dart.js 4.5M）**
+> - `dart analyze lib`: 仅剩 **6 error**，全部在 `utils/util_io.dart`（原生路径，Web 已排除，见 §5 延后）。
+> - Web 可达错误: **0**。
+> - 峰值 2374 → 6（全部 util_io 原生）。0 语法损坏。分支 `dev2`。
+> - 构建脚本: `./build_web.sh`（构建）/ `./build_web.sh run`（Chrome 运行）。
+> - **关键修复**: `cross_file` override 到 `0.3.4+2`（旧版 0.3.1+4 用了 Dart3 移除的 `UnmodifiableUint8ListView`；0.3.5+ 需 Dart 3.10）。
 
 ---
 
@@ -10,10 +15,11 @@
 ```bash
 cd /Users/peima/StudioProjects/flutter_wisetronic
 git log --oneline -1                       # 确认在最新提交
-dart analyze lib | tail -5                 # 看当前错误（应 118 error）
-flutter build web 2>&1 | grep -c '^Error:' # web 错误（应 112）
+dart analyze lib | tail -5                 # 当前: 仅 6 error(util_io.dart)
+./build_web.sh                             # 构建: ✓ Built build/web/
+./build_web.sh run                         # Chrome 运行调试
 
-# 重跑自动修复脚本（安全，带损坏自检，可随时跑）
+# 重跑自动修复脚本（安全，带损坏自检，可随时跑）—— 已无 web 可达错误，通常无需再跑
 python3 tools/nullfix.py --max-rounds 12
 ```