wanBox v3.0.7-preview.15

wanBox 3.0.7-preview.15 · 安装数据恢复修复

作者：@author 雾晚

本次更新

• 恢复进度持久化：安装数据每个步骤成功后保存进度。数据库已提交、末尾确认失败后，重试只完成剩余步骤，不重复归档或重写数据库。
• 恢复操作仅在主进程执行：后台磁贴不会与管理界面同时恢复 App 数据；待处理期间提示打开管理 App 完成原选择。
• 测速忙碌状态清理：批量 HTTP/TCP 测速取消、页面销毁或异常结束后，在所有子任务结束时释放标记，避免后续安装数据处理一直被阻塞。
• 订阅取消修复：WorkManager 管理服务与配置保持在 :bg 进程，取消请求有 15 秒边界；失败仍保留数据保护。
• 明确错误提示：待处理状态不再误报缺少 Root 权限；恢复失败显示完整步骤与过滤后的错误代码。日志只记录阶段、异常类型和固定代码，不记录备份内容或节点凭据。
• 保留 preview.14 的模块覆盖更新恢复、立即节点切换、分应用自动应用和国内外分流预设。

安装与更新

仅面向 Android 12 及以上、arm64-v8a、已 Root 设备。管理 APK 需要配套 Root 模块。

1. 可直接保留数据覆盖安装；不要卸载旧 App。带 APK 模块支持安装或覆盖更新管理器；不带 APK 包请手动更新管理 APK。
2. 安装器使用音量上切换、音量下确认。默认保留全部；仅保留节点和订阅会清除路由规则及其他设置，全新安装还会清除节点和订阅。
3. 已选择“仅保留节点/全新安装”却未完成时，打开新版管理 App，继续原数据选择。原备份与令牌保留，不能通过删除待处理记录强行连接。
4. 若仍失败，请导出应用日志；新提示会指出具体失败步骤。旧截图没有完整异常，不能仅据截图认定该手机的全部失败原因。

包名 com.lit008834.pixel.wanboxforandroid、原签名、Room/备份格式与 sing-box v1.15.0-alpha.10 不变。APK versionCode=1780，模块 versionCode=356。

下载文件

• wanBoxForAndroid-3.0.7-preview.15-arm64-v8a-release.apk：管理 APK。
• wanbox-root-module-with-manager-arm64-v8a.zip：带管理 APK 模块。
• wanbox-root-module-arm64-v8a.zip：不带 APK 模块。
• SHA256SUMS：附件校验和。

实现与验证

新增逐步骤失败重入、检查点失败、取消传播与脱敏单测；仪器测试使用实际备份生成器、AtomicFile 和 Room，验证确认失败后重试不重复清理数据库，并实际调用订阅取消入口。发布前执行单元测试、Go/race、签名/ABI、覆盖升级及数据库回归。

恢复流程与数据边界。

wanBox v3.0.7-preview.13

wanBox 3.0.7-preview.13 · 节点切换与国内外分流

作者：@author 雾晚

本次更新

• 手动切换立即提交：切换节点绕过连续编辑的合并窗口，不再被旧界面状态拦截。快速连续点击以最后选择为准，同一节点支持重新提交；进行中的原子应用完整结束后继续应用新选择。
• 运行节点与选择分离：模块确认实际运行的节点；旧状态回报不覆盖新选择。切换期间拒绝把旧节点的落地 IP 和通道延迟显示为新节点结果。
• 分应用自动应用：名单、白/黑名单模式及开关保存后进入现有 400ms 合并队列，不再需要手动点应用。停止时只保存配置，不自动连接。
• 国内外分流预设：在“路由 → 预设”选择“国内域名/IP 直连，其余走代理”。确认后启用规则模式和 DNS 分流，复用现有中国域名/IP 数据；已有指定应用、域名或节点规则仍优先。重复应用不会复制规则。
• 规则和 DNS 顺序修复：旧式纯 geosite/geoip 规则按宽泛兜底处理，保留层内排序；地理 IP 匹配前按当前 DNS 策略解析，使用官方核心支持的有界 resolve 动作。

安装与更新

仅面向 Android 12 及以上、arm64-v8a、已 Root 设备。管理 APK 需要配套 Root 模块。

1. 在 Magisk/KernelSU/APatch 安装带或不带 APK 的模块 ZIP；音量上切换，音量下确认。
2. 默认保留全部。仅保留节点和订阅会清除路由规则及其他设置；全新安装还会清除节点和订阅。
3. 带 APK 包支持覆盖更新或跳过管理器；不带 APK 包请手动覆盖安装新版 APK。不要先卸载旧 App。
4. 节点切换仍需生成并原子应用完整配置，实际核心切换可能短暂断流；并非保证零耗时切换。

包名 com.lit008834.pixel.wanboxforandroid、原签名、数据库/备份格式及 sing-box v1.15.0-alpha.10 不变。APK versionCode=1770，模块 versionCode=354。

下载文件

• wanBoxForAndroid-3.0.7-preview.13-arm64-v8a-release.apk：管理 APK。
• wanbox-root-module-with-manager-arm64-v8a.zip：带管理 APK 模块。
• wanbox-root-module-arm64-v8a.zip：不带 APK 模块。
• SHA256SUMS：附件校验和。

验证与实现

发布流程在 Android 单元测试、Go/race、签名/ABI、覆盖升级、Room/配置生成的模拟器测试通过后才发布。未修改核心版本或引入参考项目私有 eBPF、DNS group、match_only 字段，不以规则移植宣称吞吐提升。

实现、来源和边界。

wanBox v3.0.7-preview.9

wanBox 3.0.7-preview.9 · Root 模块安装修复

作者：雾晚

本次变更

• 修复模块更新时安装器仍在写入文件、热切换却已开始的竞态。现在等待安装进程退出及更新标记就绪，再校验暂存包并切换代码。
• 兼容管理器收尾时移除安装脚本与说明文件；核心、控制程序等运行文件仍严格校验。成功后移走已应用的暂存包，避免下次开机重复覆盖。
• 等待超时或暂存包被替换时不切换旧代码；启动失败使用已有回滚流程，保留持久配置和恢复副本。热更新会短暂重启运行中的核心。
• 删除纯 Root 模块下不适用的六项设置及帮助入口：唤醒锁、休眠后重置连接、切网后重置连接、按流量计费网络、通知显示分组、系统 HTTP 代理绕过列表。历史设置值保留。
• 保持原界面风格、节点/订阅/路由、磁贴与快捷方式。包名、原发布签名、数据格式和 sing-box v1.15.0-alpha.10 不变。
• 提供带管理 APK、不带管理 APK 两个模块包及独立签名 APK；公开文件为 arm64-v8a，最低 Android 12，APK versionCode=1750。

安装与升级

请先导出备份。仅安装 APK 不能连接，需要配套 Root 模块。

1. 在 Magisk/KernelSU 管理器安装 wanbox-root-module-with-manager-arm64-v8a.zip（带 APK）或 wanbox-root-module-arm64-v8a.zip（不带 APK）。首次安装前停止其他接管 TUN 的模块。
2. 等管理器安装完成后稍候，模块会尝试热切换，无需主动重启手机。等待期间不要再次覆盖模块。未完成热更新时保留管理器暂存包，仍可按管理器标准流程重启应用更新。
3. 不带 APK 的包需要手动覆盖安装配套 APK；带 APK 的自动安装被系统拒绝时也可手动安装。打开管理 App，允许 Root 后连接。

默认更新保留全部数据。需要全新安装或仅保留节点/订阅时，先到管理 App「设置 → 模式与入站设置 → 模块更新数据」确认处理，再安装 ZIP。这会同时处理 App 和模块数据并保存恢复备份；处理中断可从同页继续。模块持久数据仍位于 /data/adb/wanbox，不随代码更新清除。

验证

本地 221 项 Android 单元测试、Preview Debug 构建、32 项模块 Go 测试、Go vet、3 项打包测试、安全契约检查和 ARM64 控制程序编译通过。发布流程另外执行 Linux race、原签名覆盖升级及 API 35 模拟器数据更新回归，并在这些检查成功后发布。

模块仍为实验预览；上述自动测试不代表所有 Root 管理器和设备的安装、SELinux、休眠与切网行为均已验证。

实现依据与失败边界见 安装方式对照。

wanBox v3.0.7-preview.11

wanBox 3.0.7-preview.11 · 路由与后台刷新修复

作者：@author 雾晚

本次更新

• 路由规则应用修复：保存、删除或排序规则后，从当前数据库重新生成模块配置，执行原有校验、原子应用与失败回滚；不再只重启旧快照。停止状态不会因编辑规则而自动连接。
• 返回前台刷新修复：模块状态与网速读取不再等待 App 的网络回调。规则单独指定的节点与 endpoint 纳入实际流量计数。
• 落地 IP 查询修复：缓存按节点与有效期隔离，退到后台取消查询和旧回调；本地代理请求可及时取消，失败时不退回直连并误报运营商 IP。IP 栏显示默认出口，独立应用路由应在目标 App 中检查新连接的出口。
• 移除通知栏通知与控制按钮：取消运行、订阅更新、测速通知和通知权限弹窗，启动时清理旧版通知；应用内停止、切换、测速进度及订阅更新保留。
• 模块运行优化：连接就绪后停止启动探测；相同内容的配置提交避免重复写盘、校验和重启，空闲统计避免重复写入。
• 管理 APK 精简：排除仅供模块使用的重复独立核心，保留管理器 JNI、协议支持和模块核心，继续采用压缩原生库打包。该变更减少重复打包，不作为未经实测的耗电或吞吐提升宣称。

安装与更新

仅面向 Android 12 及以上、arm64-v8a、已 Root 设备。管理 APK 需要配套 Root 模块，不能单独作为 VPN 客户端连接。

1. 选择下列任一模块 ZIP，在 Magisk/KernelSU/APatch 管理器安装。音量上切换选项、音量下确认。
2. 默认保留全部数据；也可选择仅保留节点与订阅、全新安装。后两项会清除路由和其他设置，请先导出完整备份，并打开配套新版 App 完成安全数据处理。
3. 带 APK 模块支持安装/覆盖更新或跳过 APK；不带 APK 模块需手动覆盖安装新版管理 APK。覆盖安装沿用原签名，不先卸载 App。
4. 模块更新沿用原热更新流程；核心切换可能短暂断流，安装期间勿重复刷入。未完成热切换时按管理器标准重启流程应用。

保持包名 com.lit008834.pixel.wanboxforandroid、发布签名、用户数据库/备份格式和 sing-box v1.15.0-alpha.10。本版 APK versionCode=1760，模块 versionCode=352，可覆盖更新 preview.10。

下载文件

• wanBoxForAndroid-3.0.7-preview.11-arm64-v8a-release.apk：原签名管理 APK。
• wanbox-root-module-with-manager-arm64-v8a.zip：带管理 APK，可选择安装/覆盖更新或跳过。
• wanbox-root-module-arm64-v8a.zip：不带 APK。
• SHA256SUMS：以上文件的 SHA-256 校验和。

验证记录

本次代码本地 238 项 Android 单元测试、Preview Debug 构建与设备测试源码编译通过。发布流程在生成新版本后执行 Go 测试/race/vet、模块与 APK 校验、签名/版本检查、旧版覆盖安装、OwnBox 共存及 API 35 模拟器的数据与实际路由配置生成测试，全部通过后发布。

实现记录：模块运行优化、前台与路由修复、安装器选项。

wanBox v3.0.7-preview.10

wanBox 3.0.7-preview.10 · 模块安装选项

作者：雾晚

本次变更

• 模块安装时使用音量上循环切换、音量下确认。支持保留全部数据（默认）、仅保留节点和订阅、全新安装。
• 全新安装或仅保留节点和订阅需要再次按音量下确认；音量上或超时取消。首次 10 秒未操作采用默认项，切换后 20 秒未确认取消；按键读取失败取消安装。
• 带管理 APK 包支持安装/覆盖更新或跳过 APK。不带管理 APK 包不会操作已安装 App。覆盖安装不先卸载、不清空 App 数据。
• 删除 App 内「模块更新数据」按钮和重复选择弹窗，其他界面与交互保持原样。
• 修复重新打开 App 自动测速：页面挂载、连接状态同步、落地 IP 查询完成及测速取消不再触发静默测速；点击状态栏或刷新按钮仍可手动测速，节点批量测速保持原样。
• 热更新和标准开机共用已确认请求；完成记录防止重启重复清除新数据。中断后自动继续原备份和事务，不用半清空后的数据覆盖备份。
• 保持包名、原发布签名、数据库 schema、备份格式与 sing-box v1.15.0-alpha.10。公开包仅 arm64-v8a、Android 12+；APK versionCode=1755。

安装与数据处理

先导出备份。仅安装 APK 不能连接，需要配套 Root 模块。

1. 在 Magisk/KernelSU 管理器安装下列任一模块 ZIP，按音量键选择数据方式。首次安装前停止其他接管 TUN 的模块。
2. 带 APK 包可安装或覆盖更新管理 App，也可跳过；不带 APK 包需要手动覆盖安装同版本 APK。自动安装失败时也可手动安装。
3. 等管理器结束后稍候，模块尝试热切换。过程中不要重复刷入或编辑配置；未完成时保留暂存包，仍可按管理器标准开机流程应用更新。运行中的核心会短暂重启，不能保证零断流。
4. **选择全新安装或仅保留节点/订阅后，打开配套新版 App 完成安全数据处理。**安装器记录确认结果，不直接删除 App 数据库；新版 App 先保留完整备份，再完成模块归档与 Room 事务。未完成前暂停连接；跳过 APK 时须自行更新并打开新版 App。

仅保留节点和订阅会保留节点、分组及订阅，清除路由规则、其他设置和旧模块运行配置；全新安装清除以上数据。保留全部沿用现有配置。App 完整备份和模块私有归档均不自动删除；App 备份可用 Root 文件管理器复制到文件选择器可见位置，再通过「工具 → 备份」导入。备份可能包含凭据，请勿公开。

下载文件

• wanbox-root-module-with-manager-arm64-v8a.zip：含管理 APK，可在安装器选择安装/覆盖更新或跳过。
• wanbox-root-module-arm64-v8a.zip：不含 APK，需配套管理 App。
• wanBoxForAndroid-3.0.7-preview.10-arm64-v8a-release.apk：原签名管理 APK。
• SHA256SUMS：公开文件校验和。

验证

本地 225 项 Android 单元测试、Preview Debug 构建、仪器测试源码编译、41 项模块 Go 测试、Go vet、7 项安装菜单/打包测试、安全契约检查、ARM64 控制程序编译和 ZIP 校验通过。发布流程执行 Linux race、原签名覆盖升级和 API 35 模拟器数据更新回归，成功后发布。

安装时序、数据边界与恢复方法见安装选项说明。

wanBox v3.0.6

wanBox 3.0.6 正式版

作者：@author 雾晚

更新内容

• **应用分流修复：**修复包名和 UID 必须同时匹配、导致指定出站规则失效的问题；VPN 与 Root TUN 统一使用应用规则。包名暂不可解析时仍可使用有效 socket UID；共享 UID 保留全部关联包名，并支持在其他 Android 用户中识别已有包名规则。
• **规则语义保持：**同步修复应用规则的 DNS/FakeIP 分支，同时保留原有规则顺序、出站、反向条件和高级动作参数；不增加针对特定应用或域名的绕行规则。
• **网络与订阅处理：**隔离网络监听者异常，避免单个监听者影响其他监听者及后续通知；订阅强制 DNS 解析共享最多 5 个并发名额，取消更新后不应用迟到的解析结果，并保留既有解析路径、IP 偏好和 TLS 主机名。包含本版本前序预览中的备份、路由与仪表盘改进。

回归测试

• Kotlin 与 Go 测试覆盖应用包名/UID 匹配、共享 UID 与多用户包名映射、DNS/FakeIP 分支，以及出站、规则顺序和其他条件的保留。
• Android 配置生成器测试覆盖 VPN 与 Root TUN、FakeIP 开关下的规则目标与顺序；Go 测试覆盖应用身份匹配及 socket UID/包名处理。
• 网络生命周期与订阅解析测试覆盖监听者异常隔离、并发与取消、迟到解析结果处理，以及 IP 偏好和 TLS 主机名保留。

兼容性与升级

• 正式版 versionName 为 3.0.6；元数据 VERSION_CODE=341，Android versionCode=1705（构建时乘以 5）。核心版本为 sing-box v1.15.0-alpha.10。
• 保持应用包名 com.lit008834.pixel.wanboxforandroid 和既有签名；可覆盖更新现有 wanBox 预览版。
• Release 提供 arm64-v8a、armeabi-v7a、x86、x86_64 四种架构 APK。

wanBox v3.0.5

wanBox 3.0.5

更新内容

便携备份与恢复

• 统一手动、分享、自动及 WebDAV 备份为 wanBox Android Backup JSON 格式 2，减少不同备份/恢复路径之间的格式不兼容。
• 导入前校验文件结构与引用，再以事务恢复；遇到错误或取消时回滚，避免留下部分恢复状态。
• 保留真实旧版备份的读取路径；对 JSON、ZIP、文件名、MIME、条目数量及解压大小设置边界，拒绝损坏或超限输入。
• 不改变 Room schema、备份范围或 WebDAV 凭据存储；日志不输出节点凭据或完整备份正文。

首次批量测速

• 最多同时运行 4 个临时测速实例，每个节点网络探测预算为 5 秒。
• 使用 http://cp.cloudflare.com/generate_204；符合条件的临时核心/测速插件失败延迟 300ms 后最多重试一次，取消不写入失败结果。
• 已连接 VPN/Root 的测速入口、URL、超时及分派路径保持不变。

路由规则与面板

• 增强高级路由规则编辑、字段校验与当前 sing-box 核心配置检查，并保留旧规则兼容。
• 包含 v3.0.5-preview.2 的规则编辑及内置 YACD 修复。

回归测试

覆盖格式 2 读写、旧格式解析、损坏/超限 JSON 与 ZIP、文件名/MIME 异常、取消与事务回滚，以及批量测速并发、超时、重试和取消；路由规则生成/校验及 YACD 初始化也有相应测试覆盖。

兼容性与升级

• 包名 com.lit008834.pixel.wanboxforandroid、原有签名及 sing-box v1.15.0-alpha.9 保持不变。
• 正式版 versionCode 为 337，高于 v3.0.5-preview.2 的 336，可覆盖升级，无需卸载或清除数据。
• 新备份格式面向跨设备迁移；旧客户端不保证可读取格式 2 备份，使用新版备份后不建议降级运行。
• 提供 ARM64、ARMv7、x86、x86_64 APK 与 SHA256SUMS 校验文件。