Files
pangolin/plan/phase-2-客户端MVP.md
T
wangjia cf96989e01
deploy-pangolin / deploy (push) Has been cancelled
Phase 0: 容器化数据面 + CI/CD 自动部署
- deploy/: Xray VLESS+REALITY (11443, 经宿主 nginx SNI 分流) + sing-box Hysteria2 (UDP 443) docker-compose
- 幂等 deploy.sh / gen-secrets.sh / print-clients.sh;受限 nginx-apply 特权脚本 + 一次性 root-setup
- .gitea/workflows/deploy.yml: NAS runner 经 SSH 远程部署到 EC2
- docs/ plan/: 设计方案与实施计划

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-05-30 11:48:47 +08:00

1.7 KiB

阶段 2 —— 客户端 MVP(2–4 周)

目标:先用 sing-box 官方 app 改品牌,接入登录 / 节点信号灯 / 免费额度,快速出自有客户端;一上来就 Flutter 自研,避免卡进度。 门禁(进入阶段3):改品牌客户端日活留存达标;客诉集中在体验而非"连不上"。

最终客户端走 Flutter 自研 UI(阶段3),本阶段是过渡。


任务清单

T2.1 选基底

  • 基于 sing-box 官方 app(SFA/SFI/SFM/SFW)或 FlClash 改造(遵守各自许可证)
  • 替换 logo / 配色 / 名称

T2.2 账号与订阅打通

  • 内置注册 / 登录(邮箱或设备 ID + 卡密)
  • 登录后自动拉取该用户订阅,免手动粘贴
  • 展示剩余额度 / 到期时间(调阶段1 面板 API)

T2.3 小白友好核心(需求 5)

  • 首屏一个大连接按钮 + 当前节点 + 信号灯
  • 默认「智能选择」(URLTest 自动选最优可用节点)
  • 默认开 Kill-switch + 防 DNS / WebRTC 泄露

T2.4 节点状态展示(需求 4)

  • 接阶段1 的 status API,节点列表显示绿/黄/红信号灯 + 延迟 ms

T2.5 多端打包

  • Android APK(官网 + GitHub Releases + 海外 Google Play)
  • iOS(海外开发者账号上架 / TestFlight / AltStore;中国区会下架)
  • 桌面 Win/macOS(就基底支持范围)

交付物

  • 改品牌的多端客户端安装包
  • 客户端 ↔ 面板 API 对接说明
  • 用户上手指引(截图版)

验收标准

  • 小白用户:下载 → 登录 → 一键连接,无需任何配置
  • 自动选线可用,信号灯准确
  • 免费额度 / 看广告提额钩子可用(广告阶段3 接)
  • 留存与客诉达门禁要求