 dzc
|
1cd36f9754
|
11
|
2026-09-28 10:44:47 +08:00 |
|
|
dzc
|
726210edcb
|
feat: 本地日志文件系统 + 修复双击打不开/向导完成无反应
用户实测两个问题（先装好驱动的机器）：
1. 双击 App 图标不一定能打开——根因 single_instance：唤醒端口 38210 被
残留占用（上次异常退出/TIME_WAIT）时，connect 无应答仍返回 false →
main 直接 exit(0)。修复：端口被占但无应答判定为残留占用，照常启动
（仅唤醒功能降级，FileLog 留痕）；有应答才作为第二实例退出。
2. 向导第三步点"完成"没反应——根因 _finish 只有 finally 没有 catch：
Autostart/UrlScheme(reg 三连)/FirstRun 任一抛异常被静默吞，Navigator.pop
永不执行=对话框锁死。修复：每步独立 try-catch + 分步日志，成败都关闭
向导，失败汇总 SnackBar 提示"详见运行日志"。
本地日志文件系统（用户要求：仔细记录、可发回分析、定时删除）：
- lib/utils/file_log.dart：按天滚动 app-YYYYMMDD.log、单文件 5MB 轮转加
序号、启动清理 7 天前旧文件（按文件名日期判定）；全同步追加写（低频
日志，保证异常退出前落盘）；目录 mac ~/Library/Logs/zax-desktop-plugin/
win %APPDATA%\zax-desktop-plugin\logs\（不引第三方依赖）
- AgentLog.write 挂文件输出（一处改动覆盖全部 22 个现有调用点）；
main.dart FileLog.init 提到最前，bootWarning/startError 全部落日志，
启动横幅记录平台/exe 路径/参数
- pavo isolate 的 [pavo-diag] 诊断日志传日志路径（纯数据，isolate 安全）
直接写文件——GUI 模式下 isolate stdout 本来就丢
- 插件页技术详情加"打开日志文件夹"按钮（Explorer/Finder 直达，用户打包
app-*.log 发回分析）
19 个测试全过、analyze 零问题。
|
2026-09-22 15:09:24 +08:00 |
|
|
dzc
|
62909609d1
|
fix(windows): 枚举解码误判 UTF-16 为 UTF-8 导致设备路径碎片化——0x80 全假象
用户 Windows 无驱动实测日志破案：PavoApiW_x64 枚举成功（size=256），缓冲是
UTF-16LE 的裸 USB 设备路径（\\?\usb#vid_0d16&pid_0309#serial#{guid}），
但 printableRatio 把 \0 计为可打印字符，UTF-8 误判通过 → 路径被 \0 拆成
单字符碎片（first='\'）→ CheckPrinterStatus/PrintOneCard 全部 0x80——
此前所有"离线"均为碎片名所致，设备与通信从未真正尝试过。
结论反转：**Windows 免驱动成立且必须免驱动**——PavoApi 直连裸 USB 设备
（GUID_DEVINTERFACE_USB_DEVICE）；装 HiTi 驱动反而接管 USB 接口导致枚举为空
（用户实测：装驱动前枚举到、装后 size=0、卸载后又枚举到）。
修复：
- decodeAuto 增加 UTF-16LE 特征判定（奇数位字节全零）优先于比例启发；
新增守护测试（设备路径形态整串不碎片化）
- 向导 Windows 分支反转：不再提供驱动安装（mac only），文案明确
"SDK 直连无需驱动；已装 HiTi 驱动请卸载（驱动占用 USB 接口导致无法直连）"
|
2026-09-21 17:49:15 +08:00 |
|
|
dzc
|
1deb3125be
|
fix: Pavo 布局自检期望值错误（80→88）——上一轮审查时手数错了指针数
用户 Windows 实测触发 HitiCardPrintParameter 布局 assert。mac 实测 sizeOf
坐实：HitiCardPrintParameter=88（4×uint32 + 8×uint8 + 8×pointer = 24+64，
8 个指针=front BGR/K/O + back BGR/K/O + Reserve×2），其余三个（32/16/48）
正确——结构体布局本身与 C# 实机版一致，错的只是 assert 里手写的期望值 80。
顺带：此错误当时被 pavo_isolate_test 的 catch 转 offline 文案掩盖（断言只查
unsendable），新增 test/pavo_ffi_layout_test 直接 expect 四个 sizeOf，
布局回归在 mac 上即红，不必等 Windows 实机。15 测试全过。
|
2026-09-21 16:19:32 +08:00 |
|
|
dzc
|
e00086c01c
|
fix: Pavo 后端 isolate 闭包捕获实例链导致 Windows 状态查询必炸（unsendable）
用户 Windows 实测：未装驱动点跳过后页面报"状态读取失败 Illegal argument in
isolate message: object is unsendable - _Timer"。堆栈定位：
Isolate.run(_statusSync) 的方法 tear-off 会连带 this（PavoPrintBackend）→
_log（agent.log.write tear-off）→ AgentLog → StreamController → UI 日志订阅链
→ 向导轮询 Timer——Timer 不可跨 isolate 发送，消息序列化直接抛错。mac 上
CUPS 后端不走 Isolate.run，从未暴露。
修复：isolate 入口全部改为顶层函数（pavoStatusSync / pavoPrintSync），不捕获
任何实例状态；printOneCard 先解出纯字符串（data URL/份数）再进闭包，最小化
捕获面。新增守护测试 pavo_isolate_test：在活跃日志订阅下调 getStatus，
回归捕获 this 时会立即复现 unsendable。14 测试全过、analyze 零问题。
|
2026-09-21 16:15:27 +08:00 |
|
|
dzc
|
bee734fd5b
|
feat: 后台托盘 + 资安信品牌化 + 修复布局断言（Phase 4 部分）
- 后台托盘（mac/Windows）：window_manager 拦截关窗改隐藏，服务持续运行；
托盘单击恢复窗口、右键菜单（显示主界面/退出），退出入口仅放托盘菜单
- 品牌：App 更名"资安信插件助手"（mac PRODUCT_NAME/xib、win main.cpp+Runner.rc(code_page 65001)、
MaterialApp/侧栏/托盘 tooltip/日志）；图标全家桶换资安信盾牌 logo
（tool/gen_app_icons.dart 生成 mac AppIcon 7 尺寸/win ICO 7 尺寸/托盘白底圆盘版/assets logo）
- 修复启动布局断言：SliverList 内 Row(stretch) 需 IntrinsicHeight 包裹，
否则子项收到 h=Infinity 约束（用户实测报错，test/ui_smoke_test.dart 守护复现）
- Agent.stop 幂等（托盘退出与窗口销毁竞态安全）
- 测试修复：smoke 测试改 tester.runAsync 包真实 socket I/O（fake async zone 里会永久挂起）、
显式 pump 替代 pumpAndSettle；13 个测试全过，analyze 零问题，release 构建实测通过
|
2026-09-21 13:16:23 +08:00 |
|
|
dzc
|
0a78ff1b58
|
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 个全过
|
2026-09-21 12:19:07 +08:00 |
|
|
dzc
|
689a07ca44
|
feat: 饭卡打印助手 Flutter 版（Phase 1/2：协议服务器 + macOS CUPS 真机打印）
- 协议与 C# 版 card-printer-agent 逐字段对齐（38200-38202 顺延、CORS *、串行任务队列、30 分钟保留）
- macOS CUPS 后端：lpoptions 队列发现 + lp 参数列表提交（LC_ALL=C 防本地化粘连坑）
- --mock 模拟模式 + bin/agent.dart headless 入口 + 测试卡生成工具
- 真机验收：HiTi CS-200e status 就绪 + 真实出卡；macOS 通用二进制构建通过
- App Sandbox 已关闭（服务需绑回环端口并调用 lp 子进程）；zaxprint URL scheme 已注册
|
2026-09-21 12:03:27 +08:00 |
|