本项目面向移动端 AI 应用快速开发场景,提供一套"Flutter 原生壳 + H5 业务模块"的混合架构范式。
业务背景:
AI 能力(对话、文生图、图像修复)迭代极快,但移动端原生发版受 App Store 审核约束,无法快速上线
团队需要 H5 前端、Flutter 容器、AI 后端三层解耦:H5 负责 UI 灵活性,Flutter 负责原生能力(权限、平台通道、本地存储),AI 后端负责模型能力
老照片修复等图像类需求依赖 GPU 推理,直接端侧不现实,H5 调用云端是最经济方案
同时用户对端侧隐私(权限滥用、Root/越狱环境)有要求,需要可信的"容器"层
本项目把上述需求整合成可复用模板,既能演示多 LLM 对话 + 多模态图像修复,又能体现 Flutter 与 H5 协作、平台通道、原生安全检测等关键技术点。
本项目包含 4 大功能模块:
AI 智能对话:支持多 LLM 切换(Anthropic Claude、OpenAI、DeepSeek、自定义 OpenAI 兼容端点),流式 Markdown 渲染,多会话历史,系统提示词切换(翻译官 / 代码专家 / 写作教练 / 通用),自定义智能体(可挂载 Skills + MCP 工具)。
AI 智能修复:WebView 加载 H5 修复页面,8 个 mode 走 H5(老照片修复、无损放大、黑白上色、动漫化等),Flutter 通过 runJavaScript 传 mode 参数,接收 H5 回调。
设备安全检查:通过 Platform Channels 调用 Android / iOS 原生层,检测无障碍服务、设备管理器、敏感权限应用、Root / 越狱、ADB、VPN / 录屏等可疑配置;无法检测的项目(运营商级监听、麦克风 / 摄像头占用)诚实展示为"无法检测",不欺骗用户。
Flutter-H5 交互演示:演示 4 种核心交互——JS → Flutter、Flutter → JS、URL scheme 拦截、启动传参;3 级页面(L1 根 / L2 子页 / L3 嵌套)统一封装,带电量条、返回、主题色。
个人负责全栈独立开发,涵盖:架构设计、Flutter UI、Dart 业务层、LLM 协议适配、H5 前端、平台通道。
技术栈:
Flutter 3.16+ / Dart 3.2+
webview_flutter 4.4(Flutter-H5 桥)
dio 5.7(流式 HTTP / SSE)
Anthropic Messages API / OpenAI Chat Completions API
MCP(Model Context Protocol)over stdio JSON-RPC
path_provider + 自研 path-based JSON 存储
Android Kotlin / iOS Swift Platform Channels
架构亮点:
Feature-first 目录(chat / photo_restore / security),业务 / UI 分离
5 个 storage 串行化(corruption 备份 + atomic write),杜绝 read-modify-write 竞态
统一 LlmService 抽象,屏蔽 Anthropic / OpenAI 协议差异
共享 Dio 实例,避免每请求 new Dio() 的连接池泄漏
Stream generation counter:stop 后丢弃 in-flight delta,防止已停止的内容又被改写
难点:
流式 SSE 解析 + tool_use / tool_calls 多轮回调
MCP 子进程 stdio JSON-RPC,含进程生命周期、SIGKILL 升级、stderr 限长
XSS 防护:runJavaScript 参数必须 jsonEncode,不能字符串拼接
async / await 大量场景下 mounted / context.mounted 守
评论