- Lab app: proxy panel, node editor, configuration and detail pages, responsive layout, and related tests - Add meshport-socks crate and sing-box bridge scripts/docs - Add singbox_flutter binding and meshport_client_core package - FFI, VPN helper (unified mac path), and Android/macOS runner updates - Docs for architecture, client runtime, UI design, and validation - UI design output artifacts under outputs/ui Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
6.2 KiB
2026-10-11 开发验证记录
本轮继续实现统一 TUN、主要 24 页 UI 和 FakeIP。Android 真机验证按用户要求暂缓,没有安装 APK,也没有替换正在使用的 macOS APP。
| 检查 | 结果和范围 |
|---|---|
Go test -race ./... |
12 项顶层测试通过;模式、组网优先、真实 DNS/FakeIP TCP 通信、撤销 DNS、缓存重建、隔离草稿 HTTP 检测、诊断范围隔离及 ABI 生命周期 |
Go vet ./... |
通过 |
Flutter analyze |
无问题 |
| Flutter 客户端测试 | 22 项通过,含原生 Rust/Go 联合启停、Partial、撤销保护、导入、认证隐藏、DNS/规则/组网表单 |
| macOS APP | 构建通过,包含统一 TUN helper;最终开发签名 codesign --verify --deep --strict 通过 |
| Android ARM64 APK | 构建通过;APK v2 签名、zipalign 16 KiB 校验通过,JNI/Rust/Go ELF LOAD 对齐均 ≥ 16 KiB |
| macOS 系统 TUN | 普通 OS TCP/UDP 回显、公告子网自动接入、停止删除测试路由及保持默认路由均通过;范围仅为 10.253.88.0/24 测试网 |
| Rust/FFI 映射子网 UDP | 同一 /24 内相邻 /25 的纯 SDK 和 FFI 回归均通过;测试网关必须编译 proxy-packet,此前 FFI 超时来自测试构建缺少此组件 |
| Android 联合 VPN 真机 | 未执行;入口明确标注待验证 |
Go/Rust 上游仍存在既有链接或弃用警告,不影响上述成功结果。第一次 Go 回归在沙盒中不能监听本机端口,放开本机测试端口后全部通过;不是功能回归。macOS TUN 首轮发现测试构造需要进入 Tokio runtime,随后修正 smoltcp TCP 回显服务提前关闭,以及错误地把出站 SDK UDP socket 当作入站服务的问题;UDP 自检使用远端映射子网和普通 OS 服务;正式流量通路已明确区分物理出口与 lo0 桥接出口;另修复有效前缀与保护前缀重复生成 TUN 路由,避免公告重建时重复删除导致清理失败,并新增回归测试。helper 自检网关已显式启用 proxy-packet,此前 UDP 包到达网关后没有进入子网转发,并非已证实的正式远端网关故障。新增不使用 TUN 的 SDK/FFI 回归覆盖这一场景。TUN 关闭后等待内部地址释放再重建;系统自检已验证重建后路由保留及普通 TCP/UDP 回显,尚不代表长时间稳定性验收。仅组网模式还移除了无对应公告的 IPv6 TUN 地址,避免上游根据空 IPv6 route_address 安装隐式 IPv6 默认路由。
系统自检记录见 macOS 统一 TUN 日志,日志仅含本机测试网络,不包含用户网络配置。
构建产物
- macOS:
apps/meshport_lab/build/macos/Build/Products/Debug/MeshPort.app,构建号20261011095231。 - Android:
outputs/android/MeshPort-0.1.0-1791641256-debug.apk,ARM64 调试签名。
macOS 是本机开发签名,未公证;Android 是调试 APK,均不是正式发布版本。
验证边界
保留用户现有 v2rayN 与已连接 MeshPort,不做全局路由切换。因此 macOS 互联网统一 TUN 的全局 DNS、IPv6、网络切换与长时间运行未实测;不把仅组网的受限路由测试称作全局代理测试。Android 新增联合 VPN 的实际通信、后台和网络切换仍需真机。
公告变化重建 Go 引擎,会中断已有连接,尚无无损热更新。新版概览、代理与 DNS/FakeIP 页面已在 macOS 实际窗口检查,四个导航和编辑入口可达;全部页面的不同尺寸视觉验收仍需继续。
FakeIP 缓存在同一上下文重建时保留,最终释放清理,跨会话重新连接可能影响系统保留的旧 DNS 结果。
页面和限制见 界面实现清单;使用方法与模块边界见 客户端运行控制。
2026-10-11:高级客户端功能
已追加自动订阅更新、source/binary 与内联规则集、DoH/DoT、macOS/Android 原生文件和二维码导入、应用启动自动连接与 macOS 13+ 登录项设置;自动选出口按要求不实现。使用入口、缓存范围和平台差异见 高级客户端功能。
- Flutter 全量测试:34 项通过,3 项专门环境/UI 开关测试跳过;Rust/Go 动态库生命周期测试实际执行。
- Go 全量
test -race ./...和vet ./...通过;新增真实 DoH / DoT 解析、规则集组网优先、HTTPS source 自动刷新、下载失败保留有效规则和直连模式暂停代理 DNS / 规则集测试。 - 并发测试暴露 sing-box 1.14.3 远程规则集读取与更新的竞争,已用 固定版本补丁 修复,复现测试继续保留。
- macOS:构建、深度签名验证通过;真实图片选择器读取测试 QR,并显示 1 个节点的预览,未保存或连接测试节点。
- Android:ARM64 APK 已编译;相机、文档选择与新自动连接尚未真机验证。本轮未连接手机或安装 APK。
- 未开启用户的登录项、自动连接或相机权限,未替换
/Applications/MeshPort.app,保留现有 v2rayN 与 MeshPort 连接。真实登录恢复、相机与公共加密 DNS 在当前网络的可达性需后续验证。
最终高级功能 APP 与 APK 的路径记录在 outputs/validation/advanced-client-20261011.md;APP 位于独立输出目录,避免覆盖用户正在查看的开发构建。
2026-10-11:macOS 连接配置修复
实际客户端连接失败来自 foreign_relay_bps_limit:上游默认 u64::MAX 投影为 JSON 数值后,被 Dart 舍入为浮点数,重新生成 TOML 导致 EasyTier 配置校验失败。FFI 投影和编辑器改为精确十进制字符串,客户端迁移旧的默认无限制值并拒绝其他不精确输入。
- 原生 Rust FFI 投影测试通过;Flutter 原生配置往返与配置页面共 6 项测试通过;Flutter analyze 无问题。
- Rust SDK/helper 与 macOS APP 构建通过,开发签名深度验证通过。
- 修复版:
outputs/macos/MeshPort-0.1.0-config-fix.app。 - 经用户授权,将旧窗口中的代理配置保存到本机钥匙串;修复版重新启动后实际读到现有节点。当前代理 DNS 尚未填写,实际互联网 SOCKS5 验证等待用户选择 DNS。v2rayN 保持运行,未切换系统路由。