用户实测定论:CS-2xx 的 USB 是自定义设备(驱动包内含 CS2xxhcd.inf 内核驱动), PavoApi 直打依赖驱动建立的 USB 通道——无驱动时枚举到设备但状态返回离线, "免驱动"假设不成立。产品要求两平台一致:驱动随 App 内置、向导一键安装。 - assets/drivers/CS2xx_Windows_Driver.zip:HiTi 官网 CS-2xx Windows 驱动 (2.6.25.48)整目录 zip(含 CS2xx/Setup64.exe),33MB,不入 git - DriverInstall Windows 分支:Expand-Archive 解压到临时目录 → 递归定位 Setup64.exe(兜底 setup/autorun)→ PowerShell Start-Process -Verb RunAs -Wait 提权安装(UAC 一次)→ 写安装标记(HKCU\Software\zax\desktop-plugin, 系统驱动安装状态无统一可查标志)→ finally 清理临时目录 - 向导第 2 步统一双平台状态机:驱动未装(异步查标记/目录)→"一键安装驱动 (内置安装包)";轮询 3 秒自动刷新安装/连接状态 - bundledInstallerPath 双平台资产路径推导(mac .dmg / win .zip); .gitignore 增 *.zip;assets/drivers/README 更新双平台放置约定
HiTi 驱动安装包目录
此目录用于打包时内置 HiTi 打印驱动(向导"一键安装驱动"功能的数据源):
- macOS:放
HiTiCardTypeMacDrivers_2.4.2.dmg(约 25MB) - Windows:放
CS2xx_Windows_Driver.zip(HiTi 官网 CS-2xx Windows 驱动整个文件夹打成 zip, 内含CS2xx/Setup64.exe;约 33MB)。mac 上打 zip 注意排除__MACOSX:cd <驱动所在目录> && zip -r CS2xx_Windows_Driver.zip CS2_Driver_x.x.x.x -x "*.DS_Store" - 安装包文件不入 git(.gitignore 已忽略
*.dmg/*.exe/*.zip),构建安装包的机器放好后再打包 - 缺失时构建不受影响;向导自动降级为"官网链接手动下载"模式