1. 一句话定义

Ruflo 是目前架构最重的多智能体编排平台，定位是企业级"AI 蜂群指挥系统"。它内置 100+ 专业代理、5 种集群拓扑（分级/网格/环形/星形/自适应）、5 种共识与协调机制（Raft/BFT/Gossip/CRDT/加权投票），支持跨机器的零信任联邦协作。不是让一个 AI 更强，而是让一群 AI 协作。

和 GSD/gstack 的区别：GSD 管上下文腐烂，gstack 管角色分工，Ruflo 管多机多代理集群——可以跨机器、跨组织调度 AI 代理。

---

2. 适用场景

适合 1→10 阶段。 当你已经有了规模化需求——跨机器部署、多代理集群、需要共识协议保证决策质量时，Ruflo 最为适用。如果你的项目还处于单机开发、只有一两个人的 0→1 阶段，Ruflo 的集群拓扑和共识协议完全是负担，不如用 GSD 或 gstack。

---

3. 它解决了什么问题

单个 AI 代理有上限：上下文窗口有限、推理能力有限、知识范围有限。要处理大型项目，需要多个 AI 代理分工协作。但多个代理之间怎么通信、怎么同步、怎么达成共识？这不是简单创建子代理就能解决的。

Ruflo 解决的是企业级多代理协调的问题：跨机器部署、跨组织协作、代理之间的共识和信任、知识共享和记忆持久化。

---

4. 核心亮点

4.1 100+ 专业代理

覆盖编码、测试、安全、文档、架构等领域的 100+ 专业代理。每个代理有独立的知识和工具集，可以按需调度组合。

4.2 五种集群拓扑

拓扑	适用场景
Queen-led（分级）	一个主代理指挥多个子代理，适合明确分工
Mesh（网格）	所有代理平等协作，适合探索式任务
Ring（环形）	代理按顺序接力传递任务
Star（星形）	中心代理分发任务给周边节点
Adaptive（自适应）	根据任务自动切换拓扑

4.3 五种共识与协调机制

代理之间做决策时需要达成一致，Ruflo 支持 5 种机制：

• Raft — 选主投票
• BFT（拜占庭容错） — 防恶意代理（容忍 f < n/3 故障节点）
• Gossip — 快速信息扩散，最终一致性
• CRDT — 无冲突复制数据类型，合并多代理状态
• Quorum / Weighted — 加权投票（Queen 代理 3x 权重），多数决策

4.4 零信任联邦

跨机器、跨组织的代理可以安全协作。基于零信任架构实现跨网络自动发现和认证，底层使用 mTLS + ed25519 质询-应答机制完成身份验证。

4.5 自学习记忆

• SONA 神经模式：自动从工作流中学习模式
• HNSW 向量数据库：150x-12,500x 加速记忆检索
• ReasoningBank：推理缓存，避免重复思考

4.6 多模型支持

不绑定 Claude，支持 Claude、GPT、Gemini、Cohere、Ollama 等，智能路由选择最合适的模型。

4.7 插件市场

32 个原生 Claude Code 插件 + 21 个 npm 插件，可以通过插件市场扩展能力。

---

5. 概览

项目	数据
仓库	github.com/ruvnet/ruflo
Stars	46.9K+
分叉	5.2K+
许可证	MIT
作者	rUv（技术方：Cognitum.One）
最新版本	v3.x（npm 包 ruflo，迭代频繁）
核心语言	TypeScript（65.8%）、JavaScript（21.5%）

Ruflo 的前身是 Claude Flow，后更名为 Ruflo。它是编排框架里架构最深的一个——其他框架是"插件/技能"，Ruflo 是一个完整的平台。目前仍在快速迭代中，是五家编排框架中架构最深、发布最密集的一个。

---

6. 优点 & 缺点

✅ 优点	❌ 缺点
架构最深，企业级多代理集群	迭代极快，版本间可能有 breaking change
100+ 专业代理 + 5 种共识/协调机制	简单项目用 Ruflo 太重
零信任联邦（mTLS + ed25519），跨机器协作	跨平台可靠性有用户反馈问题（如 Windows daemon）
自学习记忆系统（SONA + HNSW + ReasoningBank）	需要了解集群拓扑、共识等概念
多模型支持不限 Claude	学习曲线最陡，issue 区积压较多

---

7. 安装方式

方式一：用插件市场装（轻量版）（支持平台：仅 Claude Code）

在 Claude Code 中输入：

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-autopilot@ruflo
/plugin install ruflo-federation@ruflo

方式二：一键安装（完整版）（支持平台：macOS / Linux）

终端执行，自动安装完整平台：

curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

方式三：用 npx 装（支持平台：macOS / Linux / Windows）

终端执行：

npx ruflo@latest init --wizard

会进入交互式初始化向导。

方式四：用 npm 装（支持平台：macOS / Linux / Windows）

终端执行：

npm install -g ruflo@latest

然后运行 npx ruflo@latest init wizard 初始化。

Ruflo 的安装方式较多，可按需选择：只想用基础功能走插件市场；需要完整集群能力走一键安装或 npx。

---

8. 实战示例：用 Ruflo 搭建多智能体代码审查流水线

假设你要搭建一个代码审查流水线：每次 PR 提交后，三个专业代理（代码审查、安全审计、性能分析）并行审查并汇总结果。以下是完整步骤。

---

Step 1：安装并初始化 Ruflo

在终端执行：

npx ruflo@latest init --wizard

进入交互式初始化向导，你逐条回答提问：

Ruflo → ? Project name?
你    → code-review-pipeline

Ruflo → ? Cluster topology?（集群拓扑）
       → Queen-led / Mesh / Adaptive
你    → Queen-led（分级拓扑）

Ruflo → ? Consensus protocol?（共识协议）
       → Raft / BFT / Gossip
你    → Quorum（加权投票，与 YAML 配置一致）

Ruflo → ? Register agents?
       → 选择需要的代理
你    → code-reviewer, security-auditor, perf-analyzer

初始化完成后，Ruflo 自动在项目目录下生成配置文件：

code-review-pipeline/
├── ruflo.yaml              # 集群主配置
├── agents/                  # 代理定义
│   ├── code-reviewer.yaml
│   ├── security-auditor.yaml
│   └── perf-analyzer.yaml
└── topology.yaml            # 拓扑定义

✅ 集群已初始化。进入下一步配置。

---

Step 2：配置代理角色

打开 topology.yaml 文件手动编辑。这里是 Ruflo 生成的默认内容，你需要按需调整：

# topology.yaml（手动编辑）
mode: queen-led
agents:
  - role: code-reviewer
    model: claude-sonnet-4-6
    tools: [read, grep, review]
  - role: security-auditor
    model: claude-sonnet-4-6
    tools: [read, grep, vuln-scan]
  - role: perf-analyzer
    model: claude-opus-4-7
    tools: [read, grep, benchmark]
consensus: quorum
quorum_min: 2          # 至少 2/3 通过

✋ 你需要手动编辑这个文件（比如改模型、增减代理）。保存后下一步启动集群。

✅ 配置完成。保存文件后启动集群。

---

Step 3：启动集群

在终端执行：

npx ruflo@latest swarm start

Ruflo 自动执行启动流程：

Ruflo → Starting swarm...
       ✓ Queen agent elected
       ✓ 3 worker agents registered
       ✓ Quorum consensus active
       ✓ Swarm ready
       
       Dashboard: http://localhost:3000
       Agents: 3 online

集群运行中，三个代理已经在线并等待任务。你不需要手动启动每个代理。

✅ 集群已运行。可以提交审查任务了。

---

Step 4：提交代码进行审查

在 Claude Code 中输入（需安装 ruflo-swarm 插件）：

/ruflo-swarm submit-review --branch feature/add-auth

Queen 代理收到请求后，自动将任务分发给三个审查代理：

Queen → 收到审查请求: feature/add-auth
       分解任务并分发...

       → 分派给 code-reviewer（代码质量审查）
       → 分派给 security-auditor（安全漏洞审查）
       → 分派给 perf-analyzer（性能影响审查）

       3 个代理并行工作...

你不需要手动分配任务给每个代理，Queen 会自动调度。

✅ 三个代理正在并行审查中。

---

Step 5：查看审查结果

各代理独立工作完成后，自动输出审查报告：

code-reviewer 报告:
  ✅ 代码风格符合规范
  ✅ 单元测试覆盖充分
  ⚠️ src/auth/login.ts:45 — 建议使用 early return 减少嵌套

security-auditor 报告:
  ✅ 无 SQL 注入风险
  ✅ 密码使用 bcrypt 哈希
  ❌ .env 文件包含了数据库连接字符串，有泄露风险

perf-analyzer 报告:
  ✅ 新增接口响应时间在预期范围内
  ✅ 数据库查询已加索引
  ⚠️ 建议对 /api/auth/login 接口添加 Redis 缓存

---

Step 6：共识决策

三个代理报告完成后，Queen 自动执行 Quorum 加权投票决策：

Queen → 汇总共识结果：

       code-reviewer:   ⚠️ 有小问题（建议修复）
       security-auditor: ❌ 发现 1 个阻塞问题（.env 泄露）
       perf-analyzer:   ✅ 无阻塞问题

       Quorum 判定：未通过（安全代理发现阻塞项❌）
       阻塞项：security-auditor → .env 泄露

✋ 你需要手动修复 .env 的问题（比如把密钥移到环境变量），修完后重新提交审查。

✅ 修复后重新提交 review 即可。

---

Step 7：跨机器联邦（可选）

如果团队分布在多台机器上，可以在终端执行：

npx ruflo@latest federation join --remote https://team-b.ruflo.local

Ruflo 自动完成联邦握手：

Ruflo → 零信任握手...
       ✓ 远程集群认证成功
       ✓ 代理资源共享
       ✓ 联邦已建立

之后两个集群的代理可以互相调度。整个过程基于 mTLS + ed25519 零信任握手自动完成，不需要手动配置网络或人工预共享凭据。

---

关键区别：这不是一个 AI 审查代码，而是一群 AI 各司其职、共同决策。有三个代理并行工作，Quorum 加权投票汇总决策，保证审查质量。如需扩容，再加节点即可。