跳转到内容
AI Agent 教程 AI Agent 教程

Ruflo 项目介绍

Ruflo

Multi-agent AI orchestration for Claude Code

项目定位

Ruflo（前身为 Claude Flow）是为 Claude Code 打造的多 Agent 编排层，让 AI Agent 从孤立执行走向群体协作。一个 npx ruflo init 就能为 Claude Code 装上”神经系统”——Agent 自动组成 Swarm 团队，从每次任务中学习，跨会话记忆，并通过联邦机制安全地与其他机器上的 Agent 协作。

核心能力

能力说明
100+ 专业 Agent编码、测试、安全、文档、架构等角色分工
Swarm 编队分层、网状、自适应三种拓扑，Raft/Byzantine/Gossip 三种共识
自学习记忆SONA 神经模式、ReasoningBank 模式库、轨迹学习
向量记忆AgentDB + HNSW 索引，比暴力搜索快 150x-12,500x
210+ MCP 工具5 个服务器组，支持 stdio/HTTP/WebSocket 三种传输
插件生态33 个 Claude Code 原生插件 + 21 个 npm 插件，IPFS 去中心化分发
Agent 联邦跨实例零信任协作，mTLS + ed25519 身份验证，PII 自动脱敏
多 ProviderClaude、GPT、Gemini、Cohere、Ollama 智能路由与故障转移
安全防御AIDefence prompt injection 检测、CVE 修复、输入验证

技术栈

维度技术选型
语言TypeScript (ESM)
运行环境Node.js >= 20.0
构建工具TypeScript Compiler (tsc)
测试框架Vitest
架构风格Domain-Driven Design（四层架构）
包管理npm workspace
向量存储AgentDB + HNSW + sql.js
MCP 框架FastMCP 3.x
前端 UISvelteKit (ruvocal)、Vite + Supabase (goal_ui)

架构概览

快速体验

Terminal window
# 方案 A：Claude Code 插件（轻量级，仅 slash commands）
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo


# 方案 B：CLI 完整安装（推荐，全部功能）
npx ruflo@latest init wizard


# 添加为 MCP 服务器
claude mcp add ruflo -- npx ruflo@latest mcp start

教程导读

Ruflo 教程分为两个部分：

AI 应用通用知识（ai/ 目录）

从 Ruflo 的实现中抽象出的 AI Agent 通用知识，适用于任何 Agent 系统的设计：

章节知识点引用的通用知识教程
01Agent 核心循环与 Hooks 驱动Agent 核心循环设计
02MCP 工具调用协议MCP 协议与生态集成
03多 Agent 编队与共识多 Agent 路由与隔离
04向量记忆与 HNSW 检索记忆系统设计
05Agent 自学习与模式识别首次覆盖 — 新建通用知识教程
06模型路由与故障转移多模型适配架构
07Agent 联邦与零信任首次覆盖 — 新建通用知识教程

编程核心技术（dev/ 目录）

聚焦 Ruflo 的具体工程实践与架构决策：

章节知识点
01V3 Monorepo 架构
02CLI 命令系统
03DDD 四层架构
04TypeScript 工程实践
05构建与分发
06CI/CD 与 GitHub Actions
07前端工程（Web UI + Goal Planner）