Files

99 lines
9.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 验证记录
日常回归可使用 `python3 scripts/test.py`。模块选择、原生库测试、吞吐诊断及 JSON/JUnit 报告见 [自动化测试](automated-testing.md)。以下为各阶段的历史验证记录。
## Android 阶段(2026-10-10)
ARM64 Rust 原生库、JNI 桥接、Android debug/release APK 构建通过。OPPO PJZ110(API 37,4 KB 页面)已完成 Android Keystore 独立测试存储的保存/重新读取/删除,以及 SDK 经隔离公告子网的 TCP/UDP 回显。系统 VPN 授权后,Java 和 Dart 普通系统 Socket 的 TCP/UDP 回显、公告子网自动安装与撤销全部通过。修复了 JNI 绝对路径依赖、受保护 DNS resolver 功能缺失和 Android 网络注册时序。隔离 USB 夹具不覆盖公网打洞、长期后台运行或移动网络切换。
最新源代码 Flutter analyze 无问题、7 项 widget 测试通过(3 项依赖原生 macOS 库的测试跳过),Rust workspace 测试及 doc-tests 通过。正式客户端界面的新版 APK 已打包,设备离线时尚未安装;测试夹具已关闭。需要设备重新连接完成剩余测试。详见 android.md。
2026-10-09,macOS Apple Silicon。
已经通过:
- Rust workspace 首次构建。
- 打洞 UDP 连接即使上游 directly_connected_conns 为空仍判为直连;关闭连接、外网逻辑连接不误判。
- 配置不允许 TUN、系统路由/DNS选项;未知字段拒绝;解析错误不泄漏密钥。
- 两个实际 EasyTier 原生实例通过本机 UDP tunnel 连接,虚拟 IP TCP echo 与 UDP数据校验。
- 实际通信后上传/下载计数增加、采样速率大于零、默认链路 RTT 测量成功。
- 停止实例及3次重新创建/停止。
- C ABI context 创建、停止态、非法/失效句柄、重复释放。
- 穿透详细日志 opt-in 采集、保留节点 ID、过滤其他应用模块日志。
- Dart后台isolate → C ABI → Rust → 两节点EasyTier UDP通信,校验字节与来源。
- Flutter widget 初始未连接状态、设置入口。
- Flutter 组网表单填写并保存 → 概览连接 → 实际原生引擎启动 → 状态显示 → 断开连接(`native_connect_test.dart`)。
- C 示例编译并读取原生实例状态。
- Flutter Redmi_AX6 打洞直连显示 7.5 ms 实测 RTT,排除错误中继标签。
- Flutter 节点 RTT、路由估算、流量速率和中继统计范围显示测试;已有直连但实际路由经中继时正确区分。
- Flutter macOS debug 构建。
注意:首次 UDP测试发现上游只接收已发送过的远端会话报文;测试按上游会话模型显式预热,不把它当成通用 UDP监听。游戏服务端的普通 socket 回包路径仍需实际服务器验证。
运行命令:
```sh
scripts/cargo-local.sh test --workspace --locked
scripts/cargo-local.sh clippy --workspace --all-targets --no-deps --locked -- -D warnings
cd apps/meshport_lab
flutter analyze
flutter test
# 包含真实原生引擎的测试(先构建 Rust 库)。未设置环境变量时这些测试显示为 skip。
MESHPORT_LIBRARY="$(cd ../.. && pwd)/target/debug/libmeshport_ffi.dylib" \
MESHPORT_PROXY_LIBRARY="$(cd ../.. && pwd)/target/debug/libmeshport_proxy.dylib" \
flutter test
dart run tool/native_smoke.dart ../../target/debug/libmeshport_ffi.dylib
```
最后一条从 apps/meshport_lab 执行,也可传入 Rust 库的绝对路径。
后续:真实游戏服务器发布版互通、网络切换/中继故障、长时内存与并发、用户态UDP首次入站支持、异步ABI、移动端打包与真机测试。
## 跨国优化第一轮回归
已通过:Rust workspace 12 个测试及 doc-tests;策略阈值、持续时间、冷却、候选限制与失效回退;两个实际 EasyTier 实例同时建立 TCP/UDP,确认 UDP 被选择,关闭 UDP 后选择 TCP。Dart → C ABI → 实际 overlay 质量采样验证成功回包、下一跳及超时结果。Flutter analyze 无问题,包含原生导入的 6 个测试全部通过;更新后的 macOS debug 包构建和签名通过。
Clippy 使用 --no-deps 检查 MeshPort 工作区且 -D warnings 通过。保留的上游源码在 Rust 1.99 下有 8 条既有弃用/未使用警告。
尚未完成真实跨国线路的长期对比、满负载游戏测试、UDP 黑洞恢复时延测试以及全部候选路径的端到端自动探测;本机功能测试不证明公网加速效果。
## macOS 系统组网阶段(2026-10-10)
已通过 Rust workspace 13 项测试及 doc-tests、Flutter analyze、Flutter 8 项测试(包含 Unix 控制通道并发请求顺序及关闭清理)、macOS debug 构建和 codesign 深度校验。
系统模式自检曾完成真实 OS TCP/UDP → utun → EasyTier 的回显,并检查停止删除接口、默认路由不变。重复自检发现网卡初始化系统命令存在间歇性等待;macOS 命令已改为后台线程等待,避免依赖 Tokio 的进程信号通知;helper 增加原生操作 60 秒退出保护。最终代码连续两轮特权自检均通过:普通 OS TCP/UDP 经 utun 回显正确,停止后接口删除,启动期间及停止后默认路由保持不变。结果记录在 /tmp/meshport-system-vpn-final.log,阶段日志 PID 23903、23924。Clippy --no-deps -D warnings 通过。
Keychain 调用已编译,尚未执行保存/恢复的 GUI 端到端测试。此阶段的 Android/iOS 系统模式尚未实现(Android 最新验证见本文开头);真实游戏、跨国长期压测和故障切换仍需后续验证。
## 指定远端子网修复(2026-10-10)
Rust 13 项测试及 doc-tests、Flutter 8 项测试、analyze、Clippy --no-deps -D warnings、macOS 构建与签名通过。系统模式开启显式私有子网接入,拒绝默认路由、公网网段及本机接口网段重叠。
在 v2rayN TUN 开启时,特权自检为 10.253.78.0/24 添加 MeshPort 路由,经普通 OS TCP/UDP 完成额外子网的回显;确认目标路由指向测试 utun,停止后该接口及子网路由清理,默认路由不变。记录 /tmp/meshport-subnet-self-test.log。这验证的是本机额外子网路由和数据面;Redmi_AX6 发布的真实局域网及屏幕共享仍需用新版重连实测。当前显式接入,不自动接受全部节点发布的子网。
## 自动公告子网接入(2026-10-10)
此版本取代上一阶段的手动子网列表。应用内与系统模式使用相同的私有 IPv4 /16~/32、32 项上限、虚拟网段和本机接口冲突过滤规则。runtime.subnet_routes 配置与 UI 字段均已删除。
应用内集成测试使用真正的发布节点:将 loopback 服务映射发布为 10.253.79.0/24,SDK 客户端自动学习后通过该子网完成 TCP 和 UDP 双向回显;发布节点清空公告后确认接入列表消失。测试节点启用独立 packet proxy host capability,生产客户端无需启用子网发布或 KCP/QUIC。
系统特权自检通过自动公告学习安装额外子网路由,经普通 OS TCP/UDP 回显;发布节点清空公告后确认路由删除,停止后 utun 消失,默认路由不变。记录 /tmp/meshport-auto-system-final.log。该自检的服务位于另一节点的虚拟 IP,应用内映射子网测试另外覆盖了后端服务访问。
此前实际 Redmi_AX6 子网 192.168.21.0/24 的屏幕共享端口已验证返回 RFB 握手;用户确认访问问题已解决。新版在真实网络中的自动接入仍需用新客户端重连验证,已有真实验证使用的是手动路由版本。
最终检查:Rust 工作区 16 项测试及 doc-tests、Clippy --no-deps -D warnings、Flutter 8 项测试(含最终原生库导入)、analyze、macOS 构建和严格签名验证通过。独立应用 outputs/macos/MeshPortLab-20261010121113.app。
## 代理 TUN 先启动时的物理网卡连接(2026-10-10)
macOS 网络地址收集不再追加默认出口探测到的 TUN 地址;IPv6 使用同一物理网卡过滤。networksetup 硬件检测改用阻塞线程池等待。诊断增加 bind_device 和接口候选地址。
在 v2rayN utun58(172.18.0.1)保持开启时运行 `scripts/cargo-local.sh test -p meshport-easytier physical_bootstrap_with_existing_tun -- --ignored --nocapture`,通过物理地址启动独立测试网络并完成 EasyTier TCP 握手,同时断言候选不包含任何 utun 地址。测试不修改 OS 路由。这是本机真实套接字回归,不能替代用户远端节点在相同启动顺序下的互通验证。记录 /tmp/meshport-tun-bootstrap.log。
## 配置保存与 MeshPort 品牌(2026-10-10)
设置页增加独立保存、重新载入和删除;启动自动回填,不自动连接。保存的未编辑高级 TOML 原样保留。Flutter 测试覆盖未连接保存、重建界面后回填名称/密钥/节点/IP、保持断开、删除,以及高级参数保留。测试调用真实 FFI,钥匙串 MethodChannel 使用隔离内存替身,不覆盖用户已有钥匙串配置。原生 macOS Keychain 实现随应用编译,真实钥匙串跨重启访问授权仍以设备实测为准。
FFI 测试验证普通 validate 不返回密钥,只有显式 include_profile 才返回表单所需字段。应用正式名称为 MeshPort;macOS/iOS/Android/Windows 图标及 Flutter 页头配置为已设计图标。其他平台尚未打包验证。
最终验证:Flutter 10 项测试及 analyze、FFI 3 项测试、Clippy --no-deps -D warnings、macOS 构建和严格签名验证通过。已打开正式应用,窗口标题为 MeshPort,页头为新图标,设置页顶部“保存配置”按钮可见。独立应用 outputs/macos/MeshPort-20261010144609.app(0.1.0 预览版)。实机检查未保存测试配置,避免污染用户配置。