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

37 lines
3.3 KiB
Markdown

# 移动端与桌面客户端界面实现
更新: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 不接入开机广播。详见 [高级客户端功能](advanced-client-features.md)。自动选出口按用户要求不实现。引导可从设置进入,尚无首次启动强制流程。关于页与公共授权/错误/重连确认不是额外导航项。
实现主要文件:`configuration_pages.dart`、`detail_pages.dart`、`proxy_source_pages.dart`、`proxy_node_editor.dart`、`proxy_panel.dart`、`lab_screen.dart`。原型图见 [UI 设计](ui-design.md),平台和验证范围见 [客户端运行控制](client-runtime.md)。