Files
MeshPort/docs/ui-implementation.md
shenleiandClaude Haiku 5.5 2f185f914d Snapshot uncommitted work: proxy UI, sing-box integration, socks bridge
- 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>
2026-10-12 10:06:15 +09:00

3.3 KiB

移动端与桌面客户端界面实现

更新:2026-10-10。沿用 V4 的四个主导航,以下是代码中的实际页面,不是设计图上的示例数据。Flutter 同时供 macOS 与 Android 使用;视觉效果仍需设备与不同屏幕尺寸的人工验收。

页码 页面 入口与已接入功能
1 概览 主导航;连接、分功能状态、实际节点 RTT 和流量
2 代理 主导航;功能、入口、模式、草稿节点与运行出口
3 组网 主导航;实际节点、配置与诊断入口
4 设置 主导航;DNS、默认配置、后台、日志、引导与关于
5 导入代理配置 代理;文本解析、预览、确认、失败保留输入
6 订阅管理 代理;HTTPS 更新、删除与来源管理
7 代理节点详情 点击节点;参数与认证隐藏,手动编辑/订阅复制
8 分流规则 代理;顺序、编辑、删除、默认动作,组网优先固定
9 基础配置 组网;网络名称、密钥、IP/DHCP、初始节点、运行入口
10 连接与打洞 组网;协议、监听、P2P、UDP/TCP/对称 NAT 打洞、STUN
11 高级配置 组网;私有模式、惰性 P2P、强制 P2P、外部中继限制
12 线路策略 组网;优化模式、优势阈值、观察/冷却时间、候选节点
13 节点详情 点击组网节点;路由、链路 RTT/估算、直连可用性与流量
14 自动接入子网 组网;公告合并、接受/安装/失效保护状态,无手动列表
15 子网详情 点击子网;发布者、下一跳、接入状态与拒绝原因边界
16 网络诊断 组网或设置;SDK 实际 TCP/UDP 测试
17 DNS 设置 设置;启动/代理 DNS、组网后缀 DNS、FakeIP 与排除项
18 默认配置 设置;配置优先级、恢复内置草稿,需确认
19 启动与后台 设置;说明已保存配置自动回填、平台后台限制
20 运行日志 设置;会话内事件、复制与清空,凭据脱敏
21 首次使用 设置中的使用引导;介绍三种功能与入口,不自动连接
22 添加代理节点 代理;六种协议表单、TLS/Reality、传输、草稿连通检测
23 编辑订阅 订阅管理;名称、URL、保存与更新分离
24 编辑分流规则 分流规则;域名/后缀/CIDR、动作和输入检查

表单保存只修改配置草稿;运行期间应用配置会确认重连,现有连接可能中断。表单未保存退出有确认。HTTP 检测耗时不等于网络 RTT;组网延迟注明来源,控制流量和应用流量不混称。

扫码、文件选择导入、自动订阅更新、规则集和应用启动自动连接已实现;macOS 13+ 登录启动已接入系统状态与授权入口,Android 不接入开机广播。详见 高级客户端功能。自动选出口按用户要求不实现。引导可从设置进入,尚无首次启动强制流程。关于页与公共授权/错误/重连确认不是额外导航项。

实现主要文件:configuration_pages.dart、detail_pages.dart、proxy_source_pages.dart、proxy_node_editor.dart、proxy_panel.dart、lab_screen.dart。原型图见 UI 设计,平台和验证范围见 客户端运行控制。