desktop-plugin

31 Commits 1 Branch 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
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	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

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

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