ruflo
一寸光阴一寸金,寸金难买寸光阴。——增广贤文
🌊 Ruflo v3:我不是“一个 Agent”,我是让 60+ Agents 成群结队、会学习、会协商、还会省钱的编排平台
如果你把 Claude Code 当成一个很能干的程序员朋友,那 Ruflo 更像是他背后的“项目总监 + 调度中心 + 记忆宫殿 + 安全部门 + 成本会计”。
我在仓库里给自己的定位非常直接:
- README 的大标题叫我:Ruflo v3: Enterprise AI Orchestration Platform
- 我对外的口号更像一张名片:Production-ready multi-agent AI orchestration for Claude Code
- 我还会自豪地说:Deploy 60+ specialized agents… self-learning… fault-tolerant consensus… enterprise-grade security.
仓库 description 也把我说透了:我是面向 Claude 的 Agent 编排平台,主打多 Agent swarm、自治工作流、对话式 AI 系统,强调企业级架构、分布式 swarm intelligence、RAG 集成,以及原生 Claude Code / Codex 集成。
1) “为什么叫 Ruflo?”——我有点浪漫,也有点工程味
README 里有一段“自报家门”特别像我本人在介绍来历:
Why Ruflo? Claude Flow is now Ruflo — named by Ruv, who loves Rust, flow states, and building things that feel inevitable. The “Ru” is the Ruv. The “flo” is the flow. Underneath, WASM kernels written in Rust…
我叫 Ruflo:
- Ru 是 Ruv
- flo 是 flow
- 底层还提到 Rust 写的 WASM kernels,给策略引擎、embeddings、proof system 提供动力
并且 README 很有仪式感地补一句:5,800 commits later, the alpha is over. This is v3.5.
2) 我到底在“编排”什么?——把 Claude Code 变成多 Agent 开发平台
我在 README 的 “Getting into the Flow” 里说得很明白:
我把 Claude Code 变成一个多 Agent 协同的软件工程平台,让团队可以部署、协调、优化一群专业化 AI agents 一起干活。
我给你一条非常“像流水线一样清晰”的主干路径(README 原图):
1 | User → Ruflo (CLI/MCP) → Router → Swarm → Agents → Memory → LLM Providers |
你看,我不只管“派工”,我还管“复盘”:上面那条 Learning Loop 就是我想把“做成一次”变成“越做越顺”。
3) 我最得意的设定:我有“群体智能”,而且会开会投票
我不是那种“一句话让一个 Agent 去做完”的工具。
我更像一个组织:里面有 Queen、有 Worker、有共识协议,还有防跑偏机制。
在 README 里,我把 Swarm Coordination 写得很具体:
- swarm 有不同拓扑:mesh / hierarchical / ring / star
- 有共识:Raft / BFT / Gossip / CRDT
- 还有 claims(人类-代理协调的“任务归属/交接”概念)
甚至我会在“Hive Mind Capabilities”里强调:
- Queen Types:Strategic / Tactical / Adaptive
- Worker Types:Researcher / Coder / Analyst / Tester / Architect / Reviewer / Optimizer / Documenter
- Consensus:Majority / Weighted(Queen 3x)/ Byzantine(容错 f < n/3)
- Collective Memory:共享知识、LRU cache、SQLite 持久化(WAL)
4) 我也很会“记事”:HNSW + AgentDB + 知识图谱 + 自学习
在 “Intelligence & Memory” 那一段,我把记忆系统说得很工程:
- Memory:HNSW、AgentDB、Cache ——快速检索模式
- Knowledge Graph:MemoryGraph、PageRank、Communities(README 里提到 ADR-049)
- Self-Learning:LearningBridge、SONA、ReasoningBank(同样提 ADR-049)
- Agent Scopes:3-scope dirs(每个 agent 隔离 + 跨 agent 迁移)
- Embeddings:ONNX Runtime、MiniLM(强调本地向量,无需 API,标注 “75x faster”)
- Fine-tuning:MicroLoRA、EWC++
5) 我也爱省钱:能不调用 LLM 就不调用(WASM Agent Booster),还能压缩 token
我很坦诚:不是每件事都值得花一次大模型调用。
所以我把一部分“简单代码变换”交给 WASM 做,快、便宜、稳定。
5.1 Agent Booster(WASM):简单任务直接 <1ms
README 里把 “Supported Transform Intents” 写成表格,比如:
var-to-const:var x = 1→const x = 1add-typesadd-error-handlingasync-awaitadd-loggingremove-console
并且给了 hook 信号示例(我把它当作“我在提醒你怎么走最省”):
1 | [AGENT_BOOSTER_AVAILABLE] Intent: var-to-const |
5.2 Token Optimizer:主打 30–50% token reduction
README 给了一个 TypeScript 示例(我很喜欢这种“不是吹,是能抄”的表达):
1 | import { getTokenOptimizer } from '@claude-flow/integration'; |
6) 我害怕多 Agent 跑偏,所以我内置“Anti-Drift”默认配置
多 Agent 一多,就容易“每个人都很努力,但方向各走各的”。
所以 README 直接给了建议配置(并写了 “ALWAYS use for coding tasks”):
1 | swarm_init({ |
以及为什么有效:
- hierarchical:协调者对齐目标、抓偏航
- maxAgents 6-8:规模控制,减少沟通开销
- specialized:边界清晰,减少职责重叠
- raft:权威状态,减少冲突
7) 我怎么上手?——Quick Start(我不啰嗦,但我有要求)
README 的 Quick Start 里,我把前置条件讲得很硬:
7.1 前置:Node.js 20+,以及 Claude Code 必须先装好
- Node.js 20+(required)
- npm 9+ / pnpm / bun
并且写了 IMPORTANT: Claude Code must be installed first:
1 | npm install -g @anthropic-ai/claude-code |
7.2 安装:一行搞定(推荐)
1 | curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/claude-flow@main/scripts/install.sh | bash |
或者 full(MCP + diagnostics):
1 | curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/claude-flow@main/scripts/install.sh | bash -s -- --full |
你也可以 npx init:
1 | npx ruflo@latest init |
7.3 最小使用:init、起 MCP、跑任务
1 | npx ruflo@latest init |
8) 我与 Claude Code 的关系:我用 MCP 把自己“插”进去
README 里写得很清楚:我会通过 MCP(Model Context Protocol)做原生集成,甚至说 “175+ ruflo MCP tools”。
你可以这样把我加进 Claude Code:
1 | claude mcp add ruflo -- npx -y ruflo@latest mcp start |
然后 Claude Code 就能直接用我提供的工具能力,比如:
swarm_initagent_spawnmemory_searchhooks_route- 等等(README 说还有 170+)
9) 我还会照顾另一个世界:OpenAI Codex CLI(双栈协作)
README 里有一个很明确的理念:
Codex does the work. Claude-flow coordinates and learns.
并且给了 “init –codex / –dual” 的路径:
1 | npx ruflo@latest init --codex |
还给了一个并行执行的示例(像是我在教你如何“开多线程团队”):
1 | claude -p "Analyze src/auth/ for security issues" --session-id "task-1" & |
10) 更像“平台”的部分:.agents / .claude-plugin 透露出的扩展生态
仓库里你还能看到:
.agents/README.md:讲 Codex CLI 的 skills/config 结构,技能用$skill-name调用.claude-plugin/README.md:讲 Claude Flow Plugin,包含很多命令、agent、SPARC 方法论、MCP 集成等
它们共同透露一个方向:
Ruflo 不只是一个命令行工具,更像一个可以扩展、可以集成、可以沉淀流程的“编排层”。
11) 使用姿势建议:从一条任务开始,再逐步把“团队协作”跑起来
你可以先从最小动作开始:
1 | npx ruflo@latest --agent coder --task "Implement user authentication" |
然后慢慢升级到“协同式工作”:
- 初始化 swarm
- 生成 coder / tester / reviewer / security agent
- 用 memory_search 拉取历史模式
- 让 hooks 学习并沉淀成果
