flutter-ai-integration

Flutter AI 集成

将模型行为集成为一种不可靠、异步的外部能力，并明确定义产品契约。除非用户要求迁移，否则保留项目现有的提供商、后端、网络客户端、状态管理、持久化和 UI 架构。

不要仅仅因为选择了此技能，就添加提供商 SDK、账户设置、凭据或后端。

前置检查

阅读 pubspec.yaml、SDK 约束、现有 AI 或 API 适配器、后端边界、身份验证、模型配置、状态归属、持久化、隐私要求、测试和平台目标。在选择模型、提供商、SDK 或 UI 工具包之前，先明确预期能力和故障处理行为。

通过由应用维护的狭窄接口封装模型和提供商的细节。将输出、工具参数、引用和结构化数据视为不可信输入。定义取消、超时、重试、部分结果、配额、离线和不支持的能力等情况的处理方式。

按需加载参考资料

• 在选择客户端与后端的职责、凭据、提供商抽象、安全、隐私或模型配置时，阅读服务边界与机密信息。
• 在实现流式输出、对话、附件、结构化响应或工具／函数调用时，阅读流式处理、工具与状态。
• 仅当项目正在使用或考虑使用这些 Flutter 包时，才阅读Flutter AI Toolkit 与 GenUI。默认情况下不要引入它们。

边界

• flutter-networking 负责通用 HTTP、WebSocket、SSE、身份验证刷新和传输可靠性；此技能负责在此基础上处理模型特有的语义。
• dart-concurrency 负责通用的流竞争、取消原语和 isolate 行为。
• flutter-persistence 负责持久化存储和离线同步；此技能定义可保留哪些对话或模型状态。
• flutter-security 负责全面的威胁审查；此技能负责执行模型边界、凭据放置、不可信输出处理和最小权限工具原则。
• flutter-ui-patterns 和 flutter-accessibility 负责通用界面组合和无障碍支持。

验证

常规自动化测试使用确定性的模拟模型或录制的适配器。覆盖部分数据块、取消、超时、格式错误的结构化输出、工具拒绝与失败、重复或乱序事件、配额错误和提供商不可用等情况。仅当凭据、费用、网络访问和环境明确纳入范围时，才使用真实提供商；此类测试应单独执行且不得产生破坏性影响。

在受影响的平台上验证可见流和状态转换，并在有需要时验证重启或恢复后的行为。报告哪些行为经过模拟测试、哪些经过端到端测试、相关的确切提供商／模型配置，以及任何未经验证的费用、安全或后端边界。

来源

• Flutter AI 概览
• Flutter AI Toolkit
• Flutter GenUI
• Flutter 网络