FrameAI 使用 Gateway 作为对外业务入口，并将用户、生成、AI 控制、媒体、工作区、工作流、计费、平台配置、故事与 Agent 分拆为独立服务。Docker Compose 负责本地/生产容器编排，数据库迁移由单次 db-migrate 作业执行。

服务拓扑

用户端 / 管理端
        |
      Nginx
        |
    Gateway :9999
        |
  +----- 业务服务 -----+
  | 用户 | 生成 | 媒体 |
  | 工作区 | 工作流 | 计费 |
  | AI 控制 | 平台配置 | 故事 | Agent |
  +--------------------+
        |
   MySQL / 对象存储 / 可选 Qdrant

端口边界

端口	服务	对公网建议
80、443	边缘 Nginx	对用户开放。
8080	管理端诊断入口	仅绑定本机，不对公网开放。
9999	Gateway	仅在容器网络内。
20000-20009	用户、生成、AI 控制、媒体、工作区、工作流、计费、平台配置、故事、Agent 服务	仅在容器网络内。
3306	MySQL	不对公网开放。
6379	Redis（如部署）	不对公网开放。

启动依赖

1. MySQL 启动并通过健康检查。
2. db-migrate 执行版本化 MySQL 迁移。
3. 数据库服务等待迁移成功后再启动。
4. Gateway、前端和 Nginx 连接已启动的服务。

应用服务不应在启动时自行执行 DDL。迁移目录以 database/migrations/mysql 为准；生产变更必须通过新的前向迁移完成。

外部依赖

• MySQL 8.4+：当前受支持的关系型数据库。
• 对象存储：用于上传素材、参考链接和生成结果；当前部署配置支持七牛。
• AI 上游：由 AI 控制服务和渠道配置管理。
• Qdrant（可选）：供 Agent/RAG 相关能力使用。
• Redis（预留）：部署模板可启动，但当前业务服务没有 Redis 运行时依赖。

Agent 工具调用策略

画布 Agent 的模型提议、策略裁决和业务执行是分层的。生成图片、生成视频、生成音频、 生成 TXT 或生成 Markdown 文档需要由前端先选择明确模式；生成结果默认作为对话附件，不会自动写入画布。涉及创建、 修改、连接、删除或写回时，必须经过意图校验、目标节点校验和 Preview/Approve/Execute 流程。完整的工具白名单、模糊请求澄清、幂等、版本冲突和审计规则见 企业级 Agent 工具调用与画布写入架构。

上一页后台开发与发布

下一页企业级 Agent 工具调用与画布写入