ruflo 插件怎么用?安装配置与使用全流程
如果你在用 Claude Code 或 Codex 写代码,大概率遇到过这样的尴尬:模型很聪明,但每次对话都是"失忆"的,没有工具、没有记忆、没有协作能力。ruflo 就是来解决这个问题的——它把自己定位为"智能体元框架",简单说,模型负责写,ruflo 负责让模型真正"干活"。
ruflo 到底解决什么问题?
官方描述里有一句话很扎心:智能体 = 模型 + 框架。模型负责编写,框架赋予工具、记忆、循环、沙箱和控制能力。ruflo 就是那个框架——它给 Claude Code 和 Codex 加上了 100 多个专业智能体、自学习记忆、跨机器联邦通信和企业级安全防护。
用大白话说:装完 ruflo 之后,你的 AI 不再是"一问一答"的聊天框,而是一个能自主规划任务、调用工具、记住上次学到的东西,甚至和别的机器上的智能体协作的系统。
安装前提
ruflo 是 DeepSeek Harness(dsh)插件站里的一个插件,安装前你需要先确保 dsh CLI 引擎已经就绪。具体安装命令以 dsh 站点上的说明为准,这里不展开。
两种安装路径,差别很大
ruflo 官方提供了两条完全不同的安装路线,覆盖范围差异很大,选错了可能白折腾。
路径 A:Claude Code 插件(精简版)
适合想先试试水、不想污染工作区的场景。在 Claude Code 里执行:
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
这条路线只提供斜杠命令 + 少量技能 + 代理定义,工作区零文件写入。注意:只有 ruflo-core 会注册 MCP 服务器,其他插件一般不附带。如果你想要完整的工具链,走路径 B。
路径 B:CLI 完整安装(生产推荐)
# 一行安装(macOS / Linux / WSL / Git-Bash)
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
# 或者交互式向导(所有平台通用)
npx ruflo@latest init wizard
# 快速非交互式
npx ruflo@latest init
这条路会给你的工作区写入 .claude/、.claude-flow/、CLAUDE.md 等文件,注册 MCP 服务器、安装 hooks、启动守护进程。包含 98 个代理、60+ 命令、30 项技能,是完整版。
核心功能怎么用?
装完之后,你不需要记住 314 个 MCP 工具或 26 条 CLI 命令。正常用 Claude Code 就行——hooks 系统会自动路由任务、从成功模式中学习、在后台协调代理。
几个高频使用场景:
- 多智能体协作:装
ruflo-swarm,让多个代理组成团队干活,适合复杂任务拆解 - 长期记忆:
ruflo-rvf跨会话保存记忆,ruflo-agentdb提供向量数据库,ruflo-rag-memory做智能检索 - 自学习优化:
ruflo-intelligence让代理从过去的成功中学习 - 代码质量:
ruflo-testgen自动生成缺失测试,ruflo-jujutsu分析 git 差异并推荐审查者 - 安全防护:
ruflo-aidefence阻止提示注入、检测 PII
插件生态非常丰富,官方列了 35 个,分门别类覆盖:核心编排、记忆知识、智能学习、代码测试、安全合规、架构方法论、DevOps 可观测性、可扩展性、领域特定(比如 ruflo-neural-trader 做 AI 交易、ruflo-iot-cognitum 做 IoT 设备管理)。
常见问题
Q:装完插件版,能用 CLI 版的工具名吗?
不能。插件版的工具以 mcp__plugin_ruflo-core_ruflo__ 形式调用,和 CLI 版的裸工具名(如 memory_store、swarm_init)不一样。想要完整循环,用路径 B。
Q:Windows 能装吗?
可以。npx ruflo@latest init wizard 在所有平台运行方式相同,包括原生 Windows PowerShell / cmd。
Q:需要学很多命令吗?
不需要。官方明确说:init 之后正常用 Claude Code 即可,hooks 会自动路由。
Q:想自己写插件?
有 ruflo-plugin-creator 插件,负责搭建、验证、发布你自己的插件。
小结
ruflo 的价值在于把 AI 从"对话工具"升级成"协作系统"——有记忆、有工具、有集群、有安全边界。如果你是重度 Claude Code / Codex 用户,值得一试。具体安装命令和完整中文 README,去 dsh 插件站点搜 ruflo 就能看到,那里有最新的版本信息和详细配置说明。