Ruflo

原名 Claude Flow，现名 Ruflo。面向 Claude Code 的多 Agent 编排框架，将单 Agent 编程助手扩展为带记忆、自学习、跨机器联邦协作的企业级 Agent 团队。

npm: ruflo / claude-flow | License: MIT | Author: RuvNet | Web UI: flo.ruv.io | Goal Planner: goal.ruv.io

核心定位

User → CLI/MCP → Router → Swarm → Agents → Memory → LLM Providers
                      ↑                          │
                      └──── Learning Loop ←──────┘

Ruflo 不是 LLM，不是 Agent 本身，而是编排层：

• 将 Claude Code 的单 Agent 能力扩展为多 Agent 协作
• 提供共享记忆（HNSW vector search）、自学习（SONA）、联邦安全通信
• 自身不运行 LLM，调用 Claude/GPT/Gemini/Ollama 等外部 Provider

安装路径（两条路）

架构总览

┌──────────────────────────────────────────────────────────┐
│                      Entry Layer                          │
│  CLI (49 commands) + MCP Server (300+ tools)            │
└────────────────────┬─────────────────────────────────────┘
                     │
┌────────────────────▼─────────────────────────────────────┐
│                   Routing Layer                           │
│  Q-Learning Router + MoE (8 Experts) + 130+ Skills      │
│  27 Hooks (pre-task / post-edit / post-task / ...)      │
└────────────────────┬─────────────────────────────────────┘
                     │
┌────────────────────▼─────────────────────────────────────┐
│               Swarm Coordination Layer                     │
│  SwarmCoordinator (hierarchical/mesh/ring/star)          │
│  Consensus: Raft / BFT / Gossip                         │
│  Queen-led 层级 + Claims (Human-Agent 协调)              │
└────────────────────┬─────────────────────────────────────┘
                     │
┌────────────────────▼─────────────────────────────────────┐
│              100+ Specialized Agents                      │
│  coder / tester / reviewer / architect / security-architect │
│  15 个固定角色（ADR-002 DDD）                             │
└────────────────────┬─────────────────────────────────────┘
                     │
┌────────────────────▼─────────────────────────────────────┐
│               Memory & Intelligence                       │
│  AgentDB (HNSW, 150x-12500x faster)                     │
│  SONA 自学习 + ReasoningBank + Hyperbolic Poincaré       │
│  RuVector: Int8 量化 + LoRA/MicroLoRA                    │
└──────────────────────────────────────────────────────────┘

V3 模块结构（v3/ 目录）

Domain-Driven Design（ADR-002）

V3 采用 DDD 架构：

SwarmCoordinator (application) — 编排协调
  ├── Agent (domain/entity) — Agent 实体
  ├── Task (domain/entity) — Task 实体
  ├── SwarmState (domain/value-object)
  └── Consensus Mechanism (domain/service)

HybridBackend / SQLiteBackend / AgentDBBackend (infrastructure)
  └── Memory domain — MemoryEntity / Memory

关键类型（v3/@claude-flow/shared/src/types.ts）

15 个固定 Agent 角色：

queen-coordinator (#1) | security-architect (#2) | security-implementer (#3)
security-tester (#4) | core-architect (#5) | core-implementer (#6)
memory-specialist (#7) | swarm-specialist (#8) | mcp-specialist (#9)
integration-architect (#10) | cli-hooks-developer (#11) | neural-learning-dev (#12)
tdd-test-engineer (#13) | performance-engineer (#14) | release-engineer (#15)

Task 类型： security-audit/fix/test, architecture-design, implementation, memory-optimization, swarm-coordination, mcp-enhancement, integration, cli-development, neural-training, test-writing, benchmark, deployment, documentation

Swarm 拓扑： hierarchical-mesh / mesh / hierarchical / centralized

共识机制： Raft（leader 维护状态）/ BFT（Byzantine Fault Tolerance）/ Gossip

核心模块详解

1. SwarmCoordinator（v3/src/coordination/application/SwarmCoordinator.ts）

协调多 Agent Swarm 的核心引擎，基于 agentic-flow 的 AttentionCoordinator 模式：

export class SwarmCoordinator {
  private topology: SwarmTopology;
  private agents: Map<string, Agent>;
  private connections: MeshConnection[];
  private eventBus: EventEmitter;

  async initialize(): Promise<void>
  async shutdown(): Promise<void>
  async spawnAgent(config: AgentConfig): Promise<Agent>
  // ...
}

支持 hierarchical（Queen 控制）和 hierarchical-mesh（Queen + peer 通信）两种拓扑。

2. MCPServer（v3/src/infrastructure/mcp/MCPServer.ts）

Model Context Protocol 服务端，暴露 300+ tools 给 Claude Code：

export class MCPServer {
  private toolRegistry: Map<string, MCPTool>;
  private port: number;
  private host: string;

  async start(): Promise<void>
  async stop(): Promise<void>
  registerTool(tool: MCPTool): void
}

3. CLI（v3/@claude-flow/cli/src/index.ts）

现代化 CLI 架构，支持 lazy command loading：

export class CLI {
  private parser: CommandParser;  // 支持嵌套 subcommand
  private output: OutputFormatter;

  async run(args: string[]): Promise<void>
  // 命令：init / agent / swarm / memory / mcp / hooks / config / ...
}

命令行注册表（commands/index.ts）：26 个同步加载 + 24 个 lazy loading commands，减少启动时间 ~200ms。

4. Hooks 系统（@claude-flow/hooks）

27 个 hooks 覆盖完整开发周期：

5. 自学习系统（RuVector Intelligence）

6. 12 背景 Workers

自动触发：audit / optimize / testgaps / document / map / deepdive 等。

安全特性（ADR-096 加密存储 / ADR-097 联邦预算）

• 加密存储： AES-256-GCM vault，RFE1 magic byte，CLAUDE_FLOW_ENCRYPT_AT_REST=1 启用
• 高风险 store 加密： sessions / terminals / .swarm/memory.db（sql.js SQLite + ONNX embeddings）
• 联邦预算熔断： federation_send 支持 budget/maxHops/spent 元数据，默认 maxHops: 8
• 命令注入防护： github-safe.js / statusline.js / github-tools MCP / update/executor
• 环境变量门控： LD_PRELOAD / NODE_OPTIONS / DYLD_* 在 terminal_create 边界被 validateEnv() 拒绝
• 文件权限： session/terminal/memory stores 使用 fs-secure.writeFileRestricted（mode 0600）
• MCP stdin DoS 防护： bin/mcp-server.js / bin/cli.js 限制 10MB 输入

Web UI

32 个插件生态

验证系统（verification.md）

每条修复用 Ed25519 签名（keyed off git commit）。ruflo verify 命令：

1. Fetch manifest
2. 重新计算每个引用文件的 SHA-256
3. 从 git commit 重新派生公钥
4. 验证签名

相关 Wiki 条目

• entities/vue-termui — Vue 3 TUI 框架（ Ruflo 的 Web UI vs 终端 UI 对比参考）
• pi-coding-agent — TypeScript 交互式 Coding Agent 参考
• deepseek-tui — Rust TUI Coding Agent 完整参考
• concepts/agent-loop — Agent 核心执行循环模式
• concepts/agent-swarm — 多 Agent 协作架构模式
• agent-cli-tui-learning-path — Agent-CLI/TUI 构建入手路径