OpenSail架构面板揭秘:React Flow画布如何让人与AI共同编写代码
OpenSail架构面板揭秘:React Flow画布如何让人与AI共同编写代码
OpenSail 是一款开源的 AI 智能体开发平台,其**架构面板(Architecture Panel)**基于 React Flow(XYFlow)构建了一张可视化画布:人与 AI 代理共同读写同一个配置文件,在同一个画布上完成容器编排、服务连线与代码生成。本文将带你快速看懂这张画布的节点、连线与人机协同机制。
一张画布,看清整个项目拓扑 🗺️
在 OpenSail 中,每个项目都有一个架构面板。它把"应用由哪些容器组成、服务之间如何连接、密钥如何流动、最终部署到哪里"全部呈现在一张画布上——这是项目的唯一事实来源(Single Source of Truth)。
进入方式很简单:打开项目后,切换到 Architecture 标签页,画布即刻渲染出完整拓扑。支持缩放、平移、拖拽节点,还有缩略图导航辅助定位。
快速上手:进入架构面板的3个步骤
- 在左侧项目列表中打开目标项目(如 Client site)
- 点击顶部标签栏的 Architecture,即可看到所有容器节点与依赖连线
- 点击 Auto Layout 按钮,画布会用 Dagre 算法自动排列节点,让结构一目了然
画布上的4种节点,各管一摊 🧩
容器节点(ContainerNode)
前端、后端、数据库等容器都是卡片节点,按角色着色:绿色是 base、蓝色是 service、紫色是 external、青色是 hybrid。卡片上直接显示运行状态、端口和技术栈标签;点击节点打开右侧属性面板,双击则直接进入代码编辑器。核心实现见 ContainerNode.tsx。
浏览器预览节点(BrowserPreviewNode)
这是画布上的"画中窗":一个可缩放的 iframe 小浏览器,带前进/后退/刷新和地址栏。你可以在连线架构的同时,实时看到正在运行的应用效果。
部署目标节点(DeploymentTargetNode)
Vercel、Cloudflare 等云厂商的品牌卡片,带环境标签(production / staging / preview)和部署历史。把部署目标拖到基础容器上,即可完成分配。
Hosted Agent 节点:把 AI 放进架构图 🤖
OpenSail 还支持把托管 AI Agent 作为节点放进画布:配置 system prompt、绑定工具与 MCP、指定模型偏好,再通过紫色的 "invokes" 虚线调用其他服务。节点实现见 HostedAgentNode.tsx。
连线即依赖:6种边类型一眼看懂数据流
| 边类型 | 样式 | 含义 |
|---|---|---|
http_api |
蓝色实线(动画) | HTTP 服务依赖 |
database |
绿色实线 | 持久化依赖 |
cache |
红色虚线 | Redis / memcached |
env_injection |
橙色虚线 | 环境变量注入(密钥流向可见) |
browser_preview |
紫色虚线 | 容器 → 预览窗口 |
deployment |
橙色箭头虚线 | 容器 → 部署目标 |
每条边都是一个类型化依赖,人和 AI 都能读懂。边组件统一放在 edges/ 目录下,画布整体由 ArchitectureView.tsx 组装。
人机协同的秘诀:一个配置文件,两个作者 ✍️
架构面板渲染的是 .tesslate/config.json。当 AI 代理新增一个 Postgres 容器并把 DATABASE_URL 注入后端时,新节点和连线会实时出现在画布上;反过来,当你拖入一个新服务,AI 在下一次迭代就能看到更新后的图。一个文件,两个作者,共享状态——这就是人与 AI 共同编写代码的底层机制。
双击容器进入代码编辑器后,AI 的每次修改都以结构化 diff 呈现,你可以逐条审核并"允许编辑",真正做到协同而非失控:
自动布局与性能:大画布为何依然流畅 ⚡
- Dagre 自动布局:autoLayout.ts 中的
getLayoutedElements会把节点按依赖关系分层排列,并区分容器(180×100)与预览窗口(320×280)的尺寸差异 - 精细记忆化:GraphCanvas.tsx 使用
memo+ 自定义arePropsEqual比较,只在节点/边真正变化时重绘,并关闭了自动平移等高开销特性
想深入?这些资料值得收藏 📚
- 画布核心文档:docs/app/components/graph/README.md
- 架构面板完整说明:docs/app/pages/project-graph.md
- Hosted Agent 节点扩展:docs/app/components/canvas/CLAUDE.md
OpenSail 用一张 React Flow 画布,把"人"与"AI"写进了同一份配置里。当画布成为双方共享的状态,架构设计、密钥流向与部署目标第一次真正变得可视化、可审核、可协同。



