VoHive Plus 1.0.3

VoHive Plus 1.0.3

这是 VoHive Plus 的维护版本。相对 v1.0.2，本次发布包含 WSL USB 准备修复，以及本机号码识别和手动补全能力。

更新内容

• 设备详情页的“本机号码”新增编辑入口；当 SIM/eSIM 未写入本机号码时，可以手动保存或清除当前 SIM 的号码。
• 本机号码显示优先级调整为“手动录入 > VoWiFi 学习 > 模组/SIM 自动读取”，避免自动来源覆盖用户确认过的号码。
• AT 后端在 AT+CNUM 为空时，会继续尝试读取 SIM 文件 EF_MSISDN，用于兼容部分把号码写在 SIM 文件里的卡。
• API 新增 PATCH /api/devices/{device_id}/local-phone，保存时会绑定当前确认的 IMSI/ICCID；切卡身份未确认时返回冲突提示，避免把号码写到旧卡上。
• OpenAPI、前端类型和仓库文档测试已同步补充本机号码编辑契约。
• 修复 WSL USB 准备阶段漏给 qmi_wwan 登记 DJI/Baiwang 2ca3:4006 动态 ID 的问题（对应提交 46c3740）；在 QMI 拓扑下会先写入 qmi_wwan/new_id 再绑定控制接口，避免出现 bind: no such device 后无法生成 /dev/cdc-wdm0 和 wwan0。
• 保持 ECM 与 QMI 的 USB 准备分支互斥：ECM 控制接口继续走 cdc_ether，只有 vendor-specific QMI 接口才登记并绑定 qmi_wwan，避免切换 USB 模式后被错误拉回 QMI。

已知说明

• 很多 SIM/eSIM 本身不会写入 MSISDN。本次修复可以读取更多自动来源，但如果 AT+CNUM 和 EF_MSISDN 都为空，程序无法凭空推断号码，需要用户手动录入。
• WSL USB 修复只解决 qmi_wwan 动态 ID 漏登记导致的准备失败；如果 WSL2 USB/IP 下 QMI 控制面仍超时，仍需继续按 ECM/MBIM、qmi-proxy/libqmi 侧车或 VirtualBox USB 直通方向验证。
• WSL2、usbipd-win 和 WebView2 仍是 Windows 桌面路线的外部前置环境，便携包不会自动安装这些系统组件。

产物

• vohive-plus-desktop_1.0.3_windows_x64.zip：Windows 桌面软件便携包，内含桌面壳、Linux amd64 后端运行时、默认配置和 WSL USB 准备脚本。
• vohive-plus-firmware_1.0.3_linux_amd64：Linux amd64 后端运行时，可用于 WSL2 或 Linux 主机。
• vohive-plus-firmware_1.0.3_linux_arm64：Linux arm64 后端运行时。
• vohive-plus-firmware_1.0.3_linux_armv7：Linux armv7 后端运行时。
• *.sha256：对应产物的 SHA256 校验文件。

VoHive Plus 1.0.2

VoHive Plus 1.0.2

这是 VoHive Plus 的维护版本。相对 v1.0.1，本次发布聚焦桌面壳运行状态识别、版本辨识，以及卡策略里“驻网、蜂窝数据、数据漫游”的语义修正。

主要更新

• 桌面壳运行环境新增 停止 WSL 操作，可在界面中显式终止 Ubuntu-24.04 发行版；连接 USB 到 WSL 仍只提示用户先启动 WSL，不会自动启动。
• 修复从 GitHub 下载版桌面壳接管既有 WSL 后端时，“健康检查正常但后端进程显示未运行”的误报；现在会探测 WSL 内 /opt/vohive/bin/vohive 进程，并在进程探测不可用但 /ping 正常时显示为运行中。
• 桌面壳标题显示 VoHive Plus v版本号，Web 管理壳侧栏显示运行中后端版本 VoHive v版本号，便于区分本地编译版、Release 版和当前后端。
• 修正卡策略语义：驻网与短信、蜂窝数据、数据漫游 现在是三个独立开关；关闭蜂窝数据不影响模块驻网和收短信。
• 将原“漫游”策略正式定义为“数据漫游”：当设备处于 RegStatus=5 漫游驻网时，关闭后阻止数据网络/代理出站，但不阻止模块注册网络或收短信。
• 普通卡策略不再自动发送 AT+QCFG="roamservice"；该 AT 命令保留为高级 AT 模板或手动命令能力。
• API 和 Web UI 将 RegStatus=5 明确显示为 roaming / 漫游驻网，不再和归属地注册混成同一个 registered 状态。
• 切卡期间 SIM 身份未确认时，不再把目标 ICCID 当作当前卡写策略，也不继续展示旧卡的信号、运营商和漫游注册态，避免误导用户认为切卡已经成功。
• 数据漫游关闭时，除了阻止新建数据连接，也会在运行态刷新发现设备进入漫游驻网后自动断开既有数据连接。
• 桌面壳的 准备 WSL USB 和 停止后端 不再在 WSL 停止时隐式启动发行版；会先提示用户启动 WSL 或显示当前不可执行原因。
• 桌面壳健康检查会严格识别 VoHive /ping 响应，避免端口 7575 被其它本机服务占用时误报后端运行中。
• OpenAPI 文档移除设备配置层的 roaming_enabled，数据漫游只作为卡策略和 live 动作能力暴露。

发布产物

• vohive-plus-desktop_1.0.2_windows_x64.zip：Windows 桌面软件便携包，内含桌面壳、Linux amd64 后端运行时、默认配置和 WSL USB 准备脚本。
• vohive-plus-firmware_1.0.2_linux_amd64：Linux amd64 后端运行时，可用于 WSL2 或 Linux 主机。
• vohive-plus-firmware_1.0.2_linux_arm64：Linux arm64 后端运行时。
• vohive-plus-firmware_1.0.2_linux_armv7：Linux armv7 后端运行时。
• *.sha256：对应产物的 SHA256 校验文件。

这里的“固件”指 VoHive Plus 的 Linux 后端运行时二进制，不是大疆模块或通信模组的硬件固件，不会刷写硬件。

环境要求

• Windows 10/11 x64。
• 已安装并可运行 WSL2，推荐发行版 Ubuntu-24.04；安装说明见 Microsoft WSL 文档。
• 已安装 usbipd-win；项目主页见 dorssel/usbipd-win，安装包见 usbipd-win Releases。USB 绑定到 WSL 时可能需要管理员权限。
• 已安装 Microsoft Edge WebView2 Runtime；Windows 11 和多数 Windows 10 通常已内置，精简系统可从 Microsoft WebView2 安装 Evergreen Runtime。
• 使用可传输数据的 USB 线连接大疆 4G 模块，并准备可用 SIM 卡。

已知限制

• 桌面便携包不会安装或配置 WSL2，也不会下载、内置或安装 usbipd-win；普通用户无需安装 Go、Node、Rust、pnpm、Docker 或 VirtualBox。
• 首次安装 WSL 发行版后，需要先启动一次 Ubuntu-24.04 完成 Linux 用户初始化；如 USB attach 或 WSL 驱动模块异常，可先执行 wsl --update 后重试。
• 当前主路线是 WSL2；VirtualBox Headless + 最小 Debian 仍在后续阶段规划中。
• 默认登录仍为 admin/admin，默认监听所有地址，这是当前版本保留的项目默认行为。

VoHive Plus 1.0.1

VoHive Plus 1.0.1

这是 VoHive Plus 的维护版本。相对 v1.0.0，本次发布聚焦 WSL2 路线的可用性修复、桌面便携包交付边界和普通用户安装说明。

主要更新

• 修复 DJI/Baiwang 2ca3:4006 在 WSL2 下添加设备时的后端选择：对 AT 口稳定、raw QMI 控制面容易超时的设备，添加设备默认使用 AT 后端，避免保存时被发现结果覆盖为 QMI。
• 改进 QMI 启动容错：自动选择 qmi-proxy 但系统缺少 proxy 可执行文件时，可回退 raw QMI；显式启用 proxy 的配置仍保持严格 proxy 行为。
• 优化 WSL USB 准备流程和设备重试，减少 USB 重枚举、驱动瞬时未就绪时的误判。
• 降低状态型 URC 日志刷屏，只压重复状态日志，不影响短信、USSD、来电等事件分发。
• 清理桌面内置 Linux 后端二进制的 Git 跟踪和历史大对象，Release 继续由 CI 构建并打包运行时资源。
• 删除旧容器发布 workflow，当前 GitHub Actions 不再构建或上传容器镜像，也不再要求容器仓库账号密码。
• README 合并上游 windloom/vohive-open 能力说明，并明确本项目已 fork 为 swordstudiox/vohive-plus。
• 补充普通用户依赖说明：桌面版会在点击 启动后端 时自动部署内置 Linux 后端到 WSL /opt/vohive；便携包不会下载、内置或安装 WSL2、usbipd-win 或 WebView2 Runtime。

发布产物

• vohive-plus-desktop_1.0.1_windows_x64.zip：Windows 桌面软件便携包，内含桌面壳、Linux amd64 后端运行时、默认配置和 WSL USB 准备脚本。
• vohive-plus-firmware_1.0.1_linux_amd64：Linux amd64 后端运行时，可用于 WSL2 或 Linux 主机。
• vohive-plus-firmware_1.0.1_linux_arm64：Linux arm64 后端运行时。
• vohive-plus-firmware_1.0.1_linux_armv7：Linux armv7 后端运行时。
• *.sha256：对应产物的 SHA256 校验文件。

这里的“固件”指 VoHive Plus 的 Linux 后端运行时二进制，不是大疆模块或通信模组的硬件固件，不会刷写硬件。

环境要求

• Windows 10/11 x64。
• 已安装并可运行 WSL2，推荐发行版 Ubuntu-24.04；安装说明见 Microsoft WSL 文档。
• 已安装 usbipd-win；项目主页见 dorssel/usbipd-win，安装包见 usbipd-win Releases。USB 绑定到 WSL 时可能需要管理员权限。
• 已安装 Microsoft Edge WebView2 Runtime；Windows 11 和多数 Windows 10 通常已内置，精简系统可从 Microsoft WebView2 安装 Evergreen Runtime。
• 使用可传输数据的 USB 线连接大疆 4G 模块，并准备可用 SIM 卡。

已知限制

• 桌面便携包不会安装或配置 WSL2，也不会下载、内置或安装 usbipd-win；普通用户无需安装 Go、Node、Rust、pnpm、Docker 或 VirtualBox。
• 首次安装 WSL 发行版后，需要先启动一次 Ubuntu-24.04 完成 Linux 用户初始化；如 USB attach 或 WSL 驱动模块异常，可先执行 wsl --update 后重试。
• 当前主路线是 WSL2；VirtualBox Headless + 最小 Debian 仍在后续阶段规划中。
• 默认登录仍为 admin/admin，默认监听所有地址，这是当前版本保留的项目默认行为。

VoHive Plus 1.0.0

VoHive Plus 1.0.0

这是 VoHive Plus 的首个正式版本。相对上游 windloom/vohive-open 整合基线，本版本聚焦 Windows + WSL2 下的大疆 4G 模块本地桌面化使用。

主要更新

• 新增 Windows 桌面壳，可从桌面界面完成 WSL2 环境检测、启动 WSL、连接 USB 到 WSL、准备 WSL USB、启动/停止后端和打开 Web 管理页。
• 新增 WSL2 USB 准备流程，针对 2ca3:4006 Baiwang 设备自动完成 option 与 qmi_wwan 绑定，生成 /dev/ttyUSB*、/dev/cdc-wdm0 和 wwan0。
• Web 管理页的添加设备和重新扫描流程会触发后端 USB 准备接口，降低手动探测成本。
• 新增蜂窝网络策略中的漫游开关，支持保存用户策略并下发到设备。
• 修复桌面壳启动后端、停止后端、端口占用、资源缺失、USB attach 幂等、WSL 未运行提示、外部命令超时等稳定性问题。
• 取消 NSIS 安装包，改为发布 Windows x64 便携 zip，避免误导用户以为安装包会自动安装 WSL2 或 usbipd-win。

发布产物

• vohive-plus-desktop_1.0.0_windows_x64.zip：Windows 桌面软件便携包，内含桌面壳、Linux amd64 后端运行时、默认配置和 WSL USB 准备脚本。
• vohive-plus-firmware_1.0.0_linux_amd64：Linux amd64 后端运行时，可用于 WSL2 或 Linux 主机。
• vohive-plus-firmware_1.0.0_linux_arm64：Linux arm64 后端运行时。
• vohive-plus-firmware_1.0.0_linux_armv7：Linux armv7 后端运行时。
• *.sha256：对应产物的 SHA256 校验文件。

这里的“固件”指 VoHive Plus 的 Linux 后端运行时二进制，不是大疆模块或通信模组的硬件固件，不会刷写硬件。

环境要求

• Windows 10/11 x64。
• 已安装并可运行 WSL2，推荐发行版 Ubuntu-24.04。
• 已安装 usbipd-win，USB 绑定到 WSL 时可能需要管理员权限。
• 使用可传输数据的 USB 线连接大疆 4G 模块，并准备可用 SIM 卡。

已知限制

• 桌面便携包不会安装或配置 WSL2，也不会安装 usbipd-win。
• 当前主路线是 WSL2；VirtualBox Headless + 最小 Debian 仍在后续阶段规划中。
• 默认登录仍为 admin/admin，默认监听所有地址，这是当前版本保留的项目默认行为。