Ruflo 智能体协调层

Ruflo：安装说明

这个工具包里只有安装说明，由 Mindket 编写。Ruflo、它的插件和它的命令行都来自 ruvnet 的仓库：https://github.com/ruvnet/ruflo

这些说明不是 ruvnet 写的，也没有得到他的认可。README 写道“Built by Reuven Cohen (rUv), originally as Claude Flow”，意思是由 Reuven Cohen（rUv）开发，最早叫 Claude Flow，现在的 Ruflo 就是它。README 的第一行把 Ruflo 称为“An agent meta-harness for Claude Code and Codex.”，意思是给 Claude Code 和 Codex 用的智能体元框架。README 在 https://github.com/ruvnet/ruflo/blob/main/README.md

许可证：MIT。LICENSE 文件（https://github.com/ruvnet/ruflo/blob/main/LICENSE）写的是“Copyright (c) 2024-2026 ruvnet”。

它是什么，用制作者自己的话说

README 说：“Agent = Model + Harness. The model writes; the harness gives it tools, memory, loops, sandboxes, and controls so it can actually work. Ruflo is the harness”，意思是：智能体等于模型加上外围的框架，模型负责写，框架给它工具、记忆、循环、沙箱和控制，让它真正能干活，Ruflo 就是这个框架。它列出一百多个专门的智能体、协作的智能体群、会自我学习的记忆、跨机器的联邦通信，以及安全防护。它还说你不必学会每一个工具：init 之后照常使用 Claude Code，钩子会在后台路由任务、协调智能体。来源：README

制作者自己的指南 RuFlo Explained（https://github.com/ruvnet/ruflo/blob/main/docs/ruflo-explained.md）说得很直白：“You still choose the goal. Your AI model still does the reasoning.”，意思是目标仍由你定，推理仍由你的模型做。它还建议用一个协调者、几个互相独立的任务、固定的预算和明确的终点，并说改动小而直接时，单个智能体往往更合适。

会安装什么

这取决于你选哪条路线，README 说几条路线差别很大。来源：README，Quick Start

• Claude Code 插件：每个插件带斜杠命令、几个技能和智能体定义。README 的表格说它们不在工作区加文件、不装钩子，但 ruflo-core 插件 README 说安装后会加载它的 PreToolUse、PostToolUse、PreCompact 和 Stop 钩子，控制台和 mods 也会在 .claude-flow/ 下保存状态。ruflo 自己的插件里由 ruflo-core 注册 MCP 服务器。外部的 agentic-qe-fleet、agentdb 和 agentic-flow 各自带 MCP 服务器。
• 命令行（npx ruflo init）：README 列出 98 个智能体、60 多个命令、30 个技能、MCP 服务器、钩子和一个守护进程，文件放在 .claude/、.claude-flow/、CLAUDE.md、辅助脚本和设置里。
• 只装 MCP 服务器（npx ruflo@latest mcp start），适合任何能启动本地 stdio 服务器的客户端。

事先需要准备

• Node.js 20 或更高版本。来源：https://github.com/ruvnet/ruflo/blob/main/docs/USERGUIDE.md（Quick Start），ruflo 的 npm 条目在 engines 字段里写的也是 >=20.0.0（https://registry.npmjs.org/ruflo/latest）。
• 一个包管理器：npm 9 或更高版本、pnpm 或 bun。来源：https://github.com/ruvnet/ruflo/blob/main/docs/USERGUIDE.md（Prerequisites）
• 走 Claude Code 的路线，要先装好 Claude Code。User Guide 给的命令是 npm install -g @anthropic-ai/claude-code。
• 插件路线（core、控制台和 mods）需要 Claude Code 2.1.287 或更高版本。来源：README，Get started
• 给智能体用的模型。User Guide 的 MCP 设置里，Claude 模型必需 ANTHROPIC_API_KEY，OPENAI_API_KEY 和 GOOGLE_API_KEY 是可选的。见 setup/tools-and-environment.md。

主要的安装命令

README 的前两条路线。第一条用于 Claude Code，在会话里输入。第二条在你项目的终端里运行设置向导，Codex 和其他 MCP 客户端也能用。

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo

npx ruflo@latest init wizard

来源：README，Get started with Ruflo

各个工具的说明

• setup/claude-code.md：插件、控制台和 mods、命令行，以及 MCP 服务器
• setup/codex.md：init --codex、MCP 配置，以及和 Claude Code 的双模式
• setup/cursor.md
• setup/windsurf.md
• setup/vs-code.md
• setup/jetbrains.md
• setup/claude-desktop.md
• setup/chatgpt.md：托管插件，以及你自己的远程服务器
• setup/grok-build.md
• setup/terminal-ui.md：ruflo tui，在普通终端里用的控制台
• setup/tools-and-environment.md：环境变量、工具组和密钥处理
• setup/federation.md：接入其他机器上的智能体

更新或移除

User Guide 给出这两行更新命令：

npx ruflo@latest init upgrade

npx ruflo@latest init upgrade --add-missing

第一行更新辅助脚本和状态栏，保留你的数据。第二行还会补上新版本里新增的技能、智能体和命令，不覆盖你自己的改动。来源：https://github.com/ruvnet/ruflo/blob/main/docs/USERGUIDE.md（Upgrading）

README 和 User Guide 都没有给卸载步骤。要手动移除的话，这些说明（是 Mindket 的，不是 ruvnet 的）按文档所说 init 会写入的东西来列：.claude/、.claude-flow/ 和 CLAUDE.md 文件，加上 README 为命令行路线列出的辅助脚本和设置。MCP 配置请用你的客户端自己的命令移除。全局安装的话，npm uninstall -g ruflo 是 npm 自己的命令，不是制作者给的。

制作者自己的文档标出的几点

• RuFlo Explained 说：“Some documentation describes different release snapshots, so check the installed CLI help when commands differ.”，意思是有些文档描述的是不同的发布快照，命令对不上时请看已安装 CLI 的帮助。User Guide 开头一行把一个 alpha 版本写成最新版，它的工具数量也和 README 对不上。来源：https://github.com/ruvnet/ruflo/blob/main/docs/ruflo-explained.md
• mods 以你账号的权限运行，没有沙箱，所以安装前先读它们的代码。来源：README
• README 说它的控制台录屏是一次真实的 Claude Haiku 会话，创建了一个 mission 并打开了几个页面。它说工作流动画用的是示例数据，主题演示重放的是渲染器画面，两者都不能证明群协作的工作已经完成，也不能证明记忆召回有效。
• 服务器连上了不等于它能用。RuFlo Explained 说，先跑一次只读调用并保存结果，再添加更多。

来源

• README：https://github.com/ruvnet/ruflo/blob/main/README.md
• User Guide：https://github.com/ruvnet/ruflo/blob/main/docs/USERGUIDE.md
• RuFlo Explained：https://github.com/ruvnet/ruflo/blob/main/docs/ruflo-explained.md
• ruflo-core 插件 README：https://github.com/ruvnet/ruflo/blob/main/plugins/ruflo-core/README.md
• ruflo-console 插件 README：https://github.com/ruvnet/ruflo/blob/main/plugins/ruflo-console/README.md
• Grok Build 指南：https://github.com/ruvnet/ruflo/blob/main/v3/@claude-flow/cli/templates/grok/docs/README.md
• ruflo 的 npm 条目：https://registry.npmjs.org/ruflo/latest