desktop-plugin

13 Commits 1 Branch 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
dzc	fb399ae8f6	fix(windows): 全量代码审查修复——中文乱码风险/Inno 兼容/ffi 布局自检/部署说明系统性把 mac 踩过的坑逐一在 Windows 对应路径排查后修复四处： 1. runner 加 /utf-8 编译选项（高危）：MSVC 默认按系统代码页（中文 Windows=GBK）解析 UTF-8 源码，main.cpp 的 L"资安信插件助手" 窗口标题会乱码 2. installer.iss 的 x64compatible → x64：前者需 Inno 6.3+，旧版 iscc 直接报错 3. PavoApi 构造加结构体布局 assert（80/32/16/48 字节，对齐 C# 实机验证值）， Windows 首跑（debug）即暴露 ffi 对齐差异 4. README 补 Windows 部署注意：VC++ Redistributable（PavoApiW_x64.dll 可能动态依赖 vcruntime140.dll）、SmartScreen 未签名提示、Inno 6.x 要求其余复查项确认无问题：reg 命令引号（空格路径安全）、Dart/Inno 的 Run 键名一致（ZaxDesktopPlugin）、vendor DLL 拷贝用生成器表达式（Debug/Release 通用）、 pavo 全部 ffi 调用在 Isolate.run、scheme 注册表路径拼接、关窗拦截走 window_manager 的 WM_CLOSE 主路径（无 mac 的 _close: 私有 selector 问题）。	2026-09-21 14:22:16 +08:00
dzc	3ecac9a302	feat: Phase 4 收尾 + Phase 5 打包（首启向导/开机自启/URL scheme 闭环/mac dmg） Phase 4 剩余三项： - 首次引导向导（setup/first_run + ui/setup_wizard）：服务自检（含 C# 助手共存提示）→ 打印机检测与 HiTi 驱动安装指引（官网链接/重新检测，mac 与 win 文案分支，允许无打印机完成）→ 开机自启开关 + scheme 注册；侧栏底部常驻设置区（自启开关 + 重新运行引导） - 开机自启（setup/autostart）：mac 写 LaunchAgent（RunAtLoad 一次性，不用 KeepAlive——托盘退出不能被拉回）；Windows 走 HKCU Run（reg 命令免 win32 依赖） - URL scheme 闭环：单实例唤醒端口 38210（setup/single_instance）——zaxprint:// 唤起或重复双击启动第二进程时通知常驻实例弹窗后自退，跨平台一致（弃用 app_links 的 mac 事件转发不确定性）；Windows 启动时幂等注册 HKCU scheme；前端 cardPrinter.ts 加 launchAgent()（zaxprint://open），开卡抽屉离线时显示 "启动打印助手"按钮，点击唤起后 1s×6 轮询自动上线（biz 前端改动待用户提交） Phase 5： - tool/package_macos.sh：构建 → ad-hoc 就地签名（--deep，勿加 --options=runtime： hardened runtime 库校验会因 ad-hoc 无 Team ID 拒载 framework，实测踩坑）→ hdiutil dmg；实测产出 22MB dmg + 签名后冒烟通过 - windows/installer.iss：Inno Setup 安装包脚本（快捷方式/桌面图标/开机自启 Tasks/zaxprint scheme 注册与卸载清理/HiTi SDK DLL 随 Release 目录打包）依赖 +url_launcher +shared_preferences；13 测试全过、analyze 零问题。	2026-09-21 13:51:42 +08:00

Author

SHA1

Message

Date

dzc

fb399ae8f6

fix(windows): 全量代码审查修复——中文乱码风险/Inno 兼容/ffi 布局自检/部署说明

系统性把 mac 踩过的坑逐一在 Windows 对应路径排查后修复四处：

1. runner 加 /utf-8 编译选项（高危）：MSVC 默认按系统代码页（中文 Windows=GBK）
   解析 UTF-8 源码，main.cpp 的 L"资安信插件助手" 窗口标题会乱码
2. installer.iss 的 x64compatible → x64：前者需 Inno 6.3+，旧版 iscc 直接报错
3. PavoApi 构造加结构体布局 assert（80/32/16/48 字节，对齐 C# 实机验证值），
   Windows 首跑（debug）即暴露 ffi 对齐差异
4. README 补 Windows 部署注意：VC++ Redistributable（PavoApiW_x64.dll 可能
   动态依赖 vcruntime140.dll）、SmartScreen 未签名提示、Inno 6.x 要求

其余复查项确认无问题：reg 命令引号（空格路径安全）、Dart/Inno 的 Run 键名
一致（ZaxDesktopPlugin）、vendor DLL 拷贝用生成器表达式（Debug/Release 通用）、
pavo 全部 ffi 调用在 Isolate.run、scheme 注册表路径拼接、关窗拦截走
window_manager 的 WM_CLOSE 主路径（无 mac 的 _close: 私有 selector 问题）。

2026-09-21 14:22:16 +08:00

dzc

3ecac9a302

feat: Phase 4 收尾 + Phase 5 打包（首启向导/开机自启/URL scheme 闭环/mac dmg）

Phase 4 剩余三项：
- 首次引导向导（setup/first_run + ui/setup_wizard）：服务自检（含 C# 助手共存
  提示）→ 打印机检测与 HiTi 驱动安装指引（官网链接/重新检测，mac 与 win 文案
  分支，允许无打印机完成）→ 开机自启开关 + scheme 注册；侧栏底部常驻设置区
  （自启开关 + 重新运行引导）
- 开机自启（setup/autostart）：mac 写 LaunchAgent（RunAtLoad 一次性，不用
  KeepAlive——托盘退出不能被拉回）；Windows 走 HKCU Run（reg 命令免 win32 依赖）
- URL scheme 闭环：单实例唤醒端口 38210（setup/single_instance）——zaxprint://
  唤起或重复双击启动第二进程时通知常驻实例弹窗后自退，跨平台一致（弃用
  app_links 的 mac 事件转发不确定性）；Windows 启动时幂等注册 HKCU scheme；
  前端 cardPrinter.ts 加 launchAgent()（zaxprint://open），开卡抽屉离线时显示
  "启动打印助手"按钮，点击唤起后 1s×6 轮询自动上线（biz 前端改动待用户提交）

Phase 5：
- tool/package_macos.sh：构建 → ad-hoc 就地签名（--deep，勿加 --options=runtime：
  hardened runtime 库校验会因 ad-hoc 无 Team ID 拒载 framework，实测踩坑）→
  hdiutil dmg；实测产出 22MB dmg + 签名后冒烟通过
- windows/installer.iss：Inno Setup 安装包脚本（快捷方式/桌面图标/开机自启
  Tasks/zaxprint scheme 注册与卸载清理/HiTi SDK DLL 随 Release 目录打包）

依赖 +url_launcher +shared_preferences；13 测试全过、analyze 零问题。

2026-09-21 13:51:42 +08:00