Files
MeshPort/docs/ui-design.md
T
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

60 lines
3.7 KiB
Markdown
Raw 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.
# MeshPort 移动端 UI 设计 V4
更新日期:2026-10-10。包含 24 个页面和 4 个公共状态示例,覆盖组网与代理组合客户端的目标交互。此文档为下一阶段设计依据,图片中的数据为示例,不表示客户端已经实现全部功能。
配套文档:[交互规则与验收场景](../outputs/ui/meshport-ui-v4-interactions.md)、[下一阶段架构](next-stage-architecture.md)、[V3 审查记录](../outputs/ui/meshport-ui-v3-review.md)、[图片生成提示词](../outputs/ui/meshport-ui-v4-prompts.md)。
## 1–4:主页面
概览、代理、组网、设置。组合模式分别显示两侧状态;代理模式只控制普通互联网流量;统计区分链路测量与路由估算。
![主页面:概览、代理、组网、设置](../outputs/ui/meshport-ui-v4-main.png)
## 5–8:代理配置
导入代理配置、订阅管理、代理节点详情、分流规则。订阅是节点来源;选中、检测可用和正在运行是不同状态。普通导入只提取支持的节点,不覆盖受管理的路由和 DNS。
![代理配置:导入、订阅、节点详情、分流规则](../outputs/ui/meshport-ui-v4-proxy.png)
## 9–12:组网配置
基础配置、连接与打洞、高级配置、线路策略。参数按 SDK 能力开放,未支持项禁用;配置保存与运行生效分开,候选中继不表示强制中继。
![组网配置:基础、打洞、高级、线路策略](../outputs/ui/meshport-ui-v4-network-config.png)
## 13–16:节点与路由
节点详情、自动接入子网、子网详情、网络诊断。公告子网区分学习与实际生效,接入方式决定状态文案。同 CIDR 多发布者合并展示;列表顶部数字为状态统计,不是筛选标签。
![节点与路由:节点详情、公告子网、子网详情、诊断](../outputs/ui/meshport-ui-v4-network-details.png)
## 17–20:应用设置
DNS 设置、默认配置、启动与后台、运行日志。DNS 定义域名范围、服务器、出口与失败策略;启动、恢复功能选择和自动连接分别控制;日志始终脱敏。
![应用设置:DNS、默认配置、启动后台、日志](../outputs/ui/meshport-ui-v4-settings.png)
## 21–24:引导与编辑
首次使用、添加代理节点、编辑订阅、编辑分流规则。首次使用按所选功能要求配置,进入首页不隐式连接;节点字段按协议变化,保存和测试草稿分别执行。
![引导与编辑:首次使用、代理节点、订阅、规则](../outputs/ui/meshport-ui-v4-editors.png)
## 公共状态与确认
等待 VPN 授权、导入失败、保存后重连、订阅更新导致当前节点失效。它们是当前流程中的状态或确认视图,不是额外导航页面。
![公共状态:授权、失败、重连、节点失效](../outputs/ui/meshport-ui-v4-states.png)
## 实现约束
- 统一运行功能排列:仅组网 / 仅代理 / 代理+组网。生成图中个别控件排列、图标、换行以实际组件统一。
- 只有所选能力全部就绪才显示全部可用;权限未完成、没有节点、部分失败均有独立状态。
- 配置区分草稿、持久化配置和运行快照;重建网络入口前提示现有连接可能中断。
- 有效组网目标优先,故障或撤销时不静默交给互联网代理;具体保护、撤销和本地冲突处理见交互规则。
- 尚未实现的功能按平台和 SDK 能力禁用,不能接受配置后忽略。
完整的 24 页修正对应关系和后续功能验收条件见 [V4 交互说明](../outputs/ui/meshport-ui-v4-interactions.md)。
当前客户端已接入主要页面,实际能力与禁用项见 [界面实现清单](ui-implementation.md)。原型图片仍为目标视觉设计,不代表全部未来功能已经完成。