Ruflo

项目概述

Ruflo 是面向 Claude Code 与 Codex 的智能体元运行框架（meta-harness）。模型负责"思考"，框架则提供工具、记忆、循环、沙箱与控制能力。Ruflo 在 Claude Code 与 Codex 之上增加 100 多个专业智能体、可协同的群体、自学习记忆、跨机器联邦通信以及企业级安全护栏，使智能体不仅能运行，还能协作。

执行一次 npx ruflo init 即可为 Claude Code 装配"神经系统"：智能体自组织为群体、从每次任务中学习、跨会话保留记忆，并通过联邦协议与其他机器上的智能体安全通信而不泄露数据。用户继续编写代码，Ruflo 负责协调。

自学习 / 自优化 智能体架构

用户 --> Ruflo (CLI/MCP) --> 路由器 --> 群体 --> 智能体 --> 记忆 --> 大模型供应商
                          ^                           |
                          +---- 学习回路 <-------+

两种安装路径

Ruflo 提供差异显著的两种安装方式，需按场景选择。

路径 A：Claude Code 插件（轻量，仅斜杠命令）

# 添加市场源
/plugin marketplace add ruvnet/ruflo

# 安装核心插件及所需功能
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo
/plugin install ruflo-neural-trader@ruflo

此方式仅新增斜杠命令与智能体定义。ruflo-core 会在安装时注册其专属 MCP 服务，工具以 mcp__plugin_ruflo-core_ruflo__* 前缀调用，而非 CLI 路径下裸的 memory_store/swarm_init/agent_spawn 命名。

路径 B：CLI 安装（完整循环）

macOS / Linux / WSL / Git-Bash：

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

全平台（含 Windows 原生 PowerShell / cmd）：

# 交互式向导
npx ruflo@latest init wizard

# 快速非交互初始化
npx ruflo@latest init

注册为 MCP 服务：

claude mcp add claude-flow -- npx ruflo@latest mcp start

核心能力

• 100+ 智能体：涵盖编码、测试、安全、文档、架构等专用角色
• 通信层：零信任联邦，跨机器/跨组织的智能体可发现、认证并安全交换任务
• 群体协调：支持分层、网状、自适应拓扑及共识机制
• 自学习机制：SONA 神经模式、ReasoningBank、轨迹学习
• 向量记忆：基于 HNSW 索引的 AgentDB，N=20k 时约比暴力搜索快 1.9 倍，N=5k 时快 3.2–4.7 倍（recall@10 ≈ 0.99）
• 后台工作器：12 个自动触发的后台任务（审计、优化、测试缺口等）
• 插件市场：33 个原生 Claude Code 插件 + 21 个 npm 插件
• 多模型支持：Claude、GPT、Gemini、Cohere、Ollama 智能路由
• 安全防护：AIDefence、输入验证、CVE 修复、路径遍历防护
• 智能体联邦：跨安装的智能体协作，默认零信任安全

Web UI 与目标规划器

Web UI（flo.ruv.io）是多模型 AI 聊天界面，内置 MCP 工具调用。开箱即用 6 个前沿模型（Qwen 3.6 Max、Claude Sonnet 4.6、Claude Haiku 4.5、Gemini 2.5 Pro、Gemini 2.5 Flash、OpenAI），支持并行触发 4–6+ 工具，并可接入任意 OpenAI 兼容端点。记忆由 AgentDB + HNSW 持久化。支持 Docker 自托管（INCLUDE_DB=true 构建嵌入 MongoDB）。

目标规划器（goal.ruv.io）基于 GOAP A* 算法，将自然语言目标拆解为前置条件、动作与状态空间路径，并实时在 /agents 仪表盘展示智能体的角色、当前步骤、记忆命名空间、代币预算与状态。

智能体联邦

联邦为智能体提供跨信任边界的共享工作区。远程智能体默认不受信任，通过 mTLS + ed25519 挑战响应证明身份。出站消息经 14 类 PII 检测管线处理，按信任级别执行 BLOCK / REDACT / HASH / PASS 策略。信任评分公式为 0.4×成功率 + 0.2×在线率 + 0.2×威胁度 + 0.2×完整性，升级需历史积累，降级即时生效。

npx claude-flow@latest federation init
npx claude-flow@latest federation join wss://team-b.example.com:8443
npx claude-flow@latest federation send --to team-b --type task-request \
  --message "分析交易模式的账户异常"

架构总览

用户 --> Claude Code / CLI
          |
          v
    编排层（MCP 服务、路由器、27 个钩子）
          |
          v
    群体协调（女王节点、拓扑、共识）
          |
          v
    100+ 专业智能体（编码、测试、审查、架构、安全……）
          |
          v
    记忆与学习（AgentDB、HNSW、SONA、ReasoningBank）
          |
          v
    大模型供应商（Claude、GPT、Gemini、Cohere、Ollama）