OpenFlow Vibe 项目

项目简介

OpenFlow 是一个开源的可视化多智能体工作流构建器：把角色卡片拖到画布上、用连线搭出一条流水线（典型是 planner → architect → coder），保存之后用真正并行的智能体把它跑起来。它建立在 OpenCode 之上——项目以 fork 形式随附 OpenCode，用其无头引擎 opencode serve 驱动底层的智能体，同时 OpenFlow 自己的代码全部集中在 packages/flow 一个包里，不改动上游任何包，因此上游合并始终干净。官方强调这是独立 fork，与 OpenCode 团队无隶属或赞助关系。截至 2026 年 10 月 20 日，仓库在 GitHub 上获得 152 个 Star、12 个 Fork。

核心功能

1. 三种画布模式：pipeline 按依赖顺序串行推进；swarm 让若干平级智能体轮流争论，直到综合者拍板；orchestration 由一张卡把工作交给它能看到的其他卡。
2. Gauntlet 循环打磨：编排模式还能以 gauntlet 方式运行——建设者不断产出，批评者每次都以全新上下文挑刺，直到作品越过你设定的标准线，全程受花费、墙钟时间和停滞检测三重约束。
3. 运行后的教练条：一次运行结束后，界面会给出一条 coach 提示，说明这次结果到底该相信到什么程度。
4. 可视化角色卡与连线：每个节点可配置模型、角色与参数，保存为可复用流水线，并在画布上直观看到数据流向。
5. 多供应商密钥直连：标题栏"api keys"打开两步连接对话框，选供应商、粘贴密钥即刻生效无需重启服务；还能从 OpenCode CLI 的 auth.json 导入已有密钥。
6. 零密钥即可试跑：OpenCode 的 opencode（zen）供应商提供免费额度层，模型 id 以 -free 结尾的可以直接用，不接任何凭证也能先跑一轮。
7. 权限与运行日志：权限默认 auto（单次调用即批准），可切到"ask me"逐条确认，无论哪种选择都会写进运行日志。
8. 跨平台启动脚本：bun openflow.ts 一条命令拉起引擎与画布，另有 PowerShell、shell、fish 三套 shim，把平台参数翻译成环境变量。

技术实现

运行时是 Bun 1.3+，画布前端基于 SolidJS（packages/flow），后端复用 OpenCode 的无头引擎，两者分成两个进程分别监听 4096（引擎）与 5174（画布）端口。仓库根目录的 openflow.ts 是统一启动器：它先解析启动方案（项目目录、引擎端口、是否构建静态产物、是否由画布托管引擎），健康检查通过 /api/health 后再打开浏览器，并且会复用已经在服务的端口、释放被死进程占住的端口——这正是官方反复强调"Unexpected error / ServeError 其实只是端口被占"的原因。三套平台 shim 不含任何启动逻辑，只做参数到环境变量（OPENFLOW_PROJECT、OPENCODE_SERVER_URL、OPENFLOW_BUILT、FLOW_MANAGE_SERVER、OPENFLOW_DRY_RUN）的翻译。智能体配置按节点而非按角色生成，所以合并 agent 之后必须重启引擎——引擎只在启动时读取一次 opencode.json 并长期缓存；为此前置检查会直接拒绝运行，而不是让一个还不存在的 agent 节点被执行。项目目前不上架 npm，只能从仓库运行。

快速上手

1. 准备 Bun 1.3 及以上版本与 Git。
2. git clone https://github.com/SeeRay11/OpenFlow.git 后进入目录，执行 bun install（会一并拉取引擎原生依赖，postinstall 负责给预编译的 node-pty 辅助程序加执行权限）。
3. 执行 bun openflow.ts（Windows 下若 PowerShell 拦截本地脚本，可改用 bun openflow.ts，或把执行策略设为 RemoteSigned），浏览器会自动打开画布。
4. 在标题栏 "api keys" 里选供应商粘密钥，或先用免费 -free 模型跑一轮；把角色卡拖到画布上连成流水线并保存。
5. 用 -p/--project 指定智能体要读写的代码仓库（它们会真的改文件），再点运行；跑完读运行日志与教练条判断结果可信度。

适用人群

已经在用 OpenCode 或其他编码类命令行智能体、希望把多智能体协作流程可视化并沉淀成可复用流水线的开发者；需要让不同角色智能体（规划、架构、编码、评审）按固定流程接力完成的团队；以及喜欢自托管、可审计源码、愿意自己装 Bun 的早期采用者。

官网链接

代码仓库：https://github.com/SeeRay11/OpenFlow 官方社区（Reddit）：https://www.reddit.com/r/OpenFlowAI/ 版本记录：https://github.com/SeeRay11/OpenFlow/releases