feat(windows): 向导内置 HiTi Windows 驱动一键安装(对齐 mac 的"装 App 即用"体验)

用户实测定论: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 更新双平台放置约定
This commit is contained in:
dzc committed 2026-09-21 16:38:11 +08:00
1 parent 527baf7ec5
commit 170e9ddc5e
4 files changed
+156 -53

No files matched your search

+8 -7
View File
@@ -1,9 +1,10 @@
# HiTi Mac 驱动安装包目录
# HiTi 驱动安装包目录
此目录用于打包时**内置 HiTi macOS 打印驱动**(向导"一键安装驱动"功能的数据源):
此目录用于打包时**内置 HiTi 打印驱动**(向导"一键安装驱动"功能的数据源):
- 构建 macOS 安装包前,把 `HiTiCardTypeMacDrivers_2.4.2.dmg`(约 25MB)放入本目录,
然后执行 `bash tool/package_macos.sh`——驱动会随 dmg 安装包分发
- **dmg 文件本身不入 git**(.gitignore 已忽略 `assets/drivers/*.dmg`)
- 缺少 dmg 时构建不受影响;向导会自动降级为"官网链接手动下载"模式
- **Windows 不需要此目录放任何东西**(PavoApi 直打,驱动可选)
- **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`),构建安装包的机器放好后再打包
- 缺失时构建不受影响;向导自动降级为"官网链接手动下载"模式