--- title: "Ruflo，模型之外的骨架" description: "Simon Sinek 的黄金圈法则告诉我们，最有说服力的叙述先回答为什么，再回答怎么做，最后才是是什么。这篇文章按这个顺序介绍 Ruflo，一个为 AI 编程 Agent 提供元框架的开源项目。" date: "2026-09-08" kind: "note" tags: [AI, Agent, 开源项目] --- Simon Sinek 有个著名的黄金圈法则，最有说服力的叙述先回答为什么，再回答怎么做，最后才是是什么。大多数项目介绍把顺序倒过来，先列特性、再讲功能、最后解释愿景。Ruflo 这篇文章换回来。 先讲为什么 Ruflo 存在。再讲它怎么实现。最后才是它具体交付了什么。 ## Why，Agent 只是模型不够用 AI Agent 这个词被滥用了几年，但把 Agent 拆开看，模型只是一部分。真正让 Agent 能干活的还有工具、记忆、循环、沙箱、控制。README 第一句就写死了这个公式，Agent 等于 Model 加 Harness。模型负责写，Harness 给工具、给记忆、给循环、给沙箱、给控制，让模型真的能工作。 Ruflo 就是这层 Harness。它是 Claude Code、Codex、Hermes 这类编程 Agent 底下的执行层，让多个 Agent 能协作而不是各干各的。 作者 rUv 这个名字很有意思。Ru 是 rUv，flo 是 flow state，工作到凌晨三点那种沉浸状态。项目本身从 2025 年 6 月发布，15 个月迭代到 v3.38.23，71.4k star，8.46k fork。TypeScript 写，MIT 协议。 为什么需要"元框架"这个词。编程 Agent 已经有好几代，Claude Code、Codex、Hermes 都是各自的 Model 加 Harness 组合。再往上还需要一层，把不同的 Agent 编排起来、共享记忆、跨机器通信。这一层就是元框架。Ruflo 想做的就是把这层从每个项目内部抽出来，独立成生态。 ## How，三层架构 Ruflo 的架构可以拆成三段。 最底层是 AgentDB，用 HNSW 向量索引的 Agent 记忆库。官方 benchmark 声称在 N=20k 的数据集上比暴力搜索快 1.9 倍，在 N=5k 上快 3.2 到 4.7 倍，top-10 召回率 0.99。这层解决的是"Agent 记得住吗"这个问题。 中间层是学习循环。每个 Agent 执行完任务，成功模式被提取并存入推理库，下次遇到类似场景能调用过去的经验。Ruflo 把这叫自学习，本质是 trajectory learning 加上 SONA 神经模式。这层解决的是"Agent 会不会重复犯错"。 最上层是 Swarm 编排。分层拓扑、网格拓扑、自适应拓扑加共识机制，让多个 Agent 在同一个任务里协调行动。这层解决的是"Agent 怎么一起干活"。 三层叠加，就是 Ruflo 想提供的"骨架"。 ## Federation，Agent 之间的 Slack 跨机器协作是 Ruflo 的一个独立卖点。README 用了一个很直接的说法，Slack 给了团队通道，Federation 给了 Agent 通道。 Agent 想加入联邦，先用 mTLS 加 ed25519 挑战认证身份，不用 API key、不用共享密钥。所有出向消息经过 14 类 PII 检测管道，按信任等级决定是 BLOCK、REDACT、HASH 还是直接 PASS。信任分数由成功率、在线时长、威胁指标、完整性四个维度加权。升级要历史积累，降级是即时的。审计追踪同时支持 HIPAA、SOC2、GDPR。 这个设计的意图很清楚，Agent 跨组织协作之前，先建立可信边界，再谈共享。Ruflo 把零信任、PII 脱敏、行为信任评分都内置进协议层，不用应用方自己拼。 ## What，Ruflo 交付了什么 98 个专精 Agent，覆盖编码、测试、安全、文档、架构、迁移、可观测性等。 33 个 Claude Code 原生插件加 21 个 npm 插件。 Web UI 在 flo.ruv.io，多模型聊天加并行 MCP 工具调用，一个模型响应能同时触发 4 到 6 个工具，AgentDB 做长期记忆。 GOAP 规划器在 goal.ruv.io，把自然语言目标分解成可执行 Agent 计划，A* 搜索状态空间，实时调度 Agent 到 /agents 面板。 安装是一行 `npx ruflo init`，或者把 Ruflo 注册成 MCP Server。Ruflo 在后台路由任务、从成功模式学习、协调 Agent。用户继续写代码。 ## 小结 Ruflo 解决的问题是模型之外，为什么 Agent 不能自己协作。它给的答案是 Agent 等于 Model 加 Harness，Harness 才是让 Agent 群体化的那层。元框架这个定位在编程 Agent 生态里还比较少见，Ruflo 是想把它独立成生态的第一批。 ## 参考资料 - [ruvnet/ruflo GitHub 仓库](https://github.com/ruvnet/ruflo) - [Ruflo README](https://github.com/ruvnet/ruflo/blob/main/README.md) - [npm 包 claude-flow](https://www.npmjs.com/package/ruflo) - [Ruflo Web UI](https://flo.ruv.io/) - [GOAP Planner](https://goal.ruv.io/) - [Cognitum.One](https://Cognitum.One) - [Simon Sinek，Start With Why](https://www.ted.com/talks/simon_sinek_how_great_leaders_inspire_action)