feat: Windows PavoApi ffi 直打后端（Phase 3 代码完成，待实机验收）

- lib/print/pavo/：PavoApiW_x64.dll 的 dart:ffi 绑定（结构体布局对齐 C#，W 后缀导出名回退兼容）
- pavo_printer.dart：枚举（UTF-8/UTF-16 自动解码）/状态/色带信息/单卡直打/忙碌轮询（3 分钟超时）/LayerHolder 非托管内存管理
- pavo_backend.dart：全部 ffi 调用与像素转换跑在 Isolate.run，主 isolate HTTP 服务零阻塞
- lib/image/card_image.dart：PNG data URL → 纵横比选卡面 → 手动 alpha 铺白底 → BGR24/Gray8 紧凑像素（image 包 compositeImage 对全透明像素非 src-over 语义，改为逐像素混合对齐 C#）
- windows/ 目录：从 Flutter SDK windows.tmpl 手动实例化（mac 上 flutter create 拒绝生成的绕过），窗口标题"饭卡打印助手"
- windows/vendor/：收录 SDK 的 PavoApiW_x64.dll/PavoCardSDK_x64.dll/HeatTB3.dll/heatthcd.bin，CMake POST_BUILD 自动拷到 exe 旁
- backend.dart 工厂接通 Windows 分支；analyze 零问题、单测 12 个全过

README.md

@@ -32,7 +32,13 @@ lib/
 ├── print/
 │   ├── backend.dart       # PrintBackend 抽象 + OS 工厂
 │   ├── mock_backend.dart  # --mock 模拟（打印 2.5s 完成）
-│   └── cups_backend.dart  # macOS：lpoptions 发现队列 + lp 提交（参数列表传参防注入）
+│   ├── cups_backend.dart  # macOS：lpoptions 发现队列 + lp 提交（参数列表传参防注入）
+│   └── pavo/              # Windows：HiTi PavoApi ffi 直打
+│       ├── pavo_ffi.dart  #    结构体/导出绑定（PavoApiW_x64.dll，W 后缀回退兼容）
+│       ├── pavo_printer.dart # 枚举/状态/色带/单卡直打/轮询/内存管理（对齐 C# PavoPrinter.cs）
+│       └── pavo_backend.dart # 后端实现（全部跑在 Isolate.run，主 isolate 不阻塞）
+├── image/
+│   └── card_image.dart    # PNG data URL → 缩放铺白底 → BGR24/Gray8（对齐 C# CardImage.cs）
 ├── utils/
 │   └── command_runner.dart # 外部命令执行（LC_ALL=C、超时杀进程、参数列表）
 bin/agent.dart              # headless 入口（开发联调，行为对齐 C# 控制台助手）
@@ -71,6 +77,13 @@ flutter build macos --release
 
 - [x] Phase 1：协议服务器 + mock + 任务队列 + 端口顺延（单测 5 个全过，接口自测全过）
 - [x] Phase 2：macOS CUPS 后端（真机 status `HiTi CS-200e, 2.4.2 就绪`；真实出卡一张，printer-state 4→3 约 24s）
-- [ ] Phase 3：Windows PavoApi ffi 后端（需 Windows 实机 + windows/ 目录）
+- [x] Phase 3 代码：Windows PavoApi ffi 后端（mac 上完成编码，analyze 零问题 + 单测 12 个全过；windows/ 目录已从 SDK 模板手动实例化，vendor 收录 SDK DLL/bin 并在 CMake 构建后自动拷贝）——**待 Windows 实机验收**（编译/直打/色带/不装驱动直打验证）
 - [ ] Phase 4：托盘/首次引导/URL scheme 唤起（zaxprint scheme 已写入 Info.plist）/开机自启
 - [ ] Phase 5：打包签名分发（mac ad-hoc 就地签名；参考 C# 版签名铁律）
+
+### Windows 实机验收清单（Phase 3 收尾）
+1. `flutter create --platforms windows .` 对照生成的目录结构核对手动实例化的差异（或直接构建）
+2. `flutter build windows --release` 编译过；确认 vendor 四文件拷到 exe 旁
+3. `dart run bin/agent.dart`（或直接跑 App）→ status 返回真机型号/固件/色带余量
+4. 提交测试卡真实出卡（tool/make_test_card.dart 生成后走 print 接口）
+5. 顺带实测：不装 HiTi 官方驱动能否直打（PavoApiW_x64 疑似用户态直连 USB）