返回目录

ruflo

维护状态: 活跃

ruvnet/ruflo

原版智能体元框架(meta-harness):支持多智能体集群部署、自主工作流编排与对话式 AI 系统构建,内置自适应记忆、自学习智能与 RAG 检索,原生集成 Claude Code / Codex / Hermes 等大量工具。

前往 GitHub项目主页
$ curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

71,633

星标

8,474

Fork

TypeScript

语言

MIT

许可证

2025-06-02

创建于

2026-09-08

最近推送

MIT 协议的 Agent 元框架,面向 Claude Code / Codex,提供集群编排、自学习向量记忆、零信任联邦与 MetaHarness 审计;以 `npx ruflo init` 或 Claude Code 插件方式接入。

DSH 适配

生态相关

作者声明

安全审计

未审计

最后核验

2026-08-22

许可证

MIT

01它能帮你完成什么?

  • 在 Claude Code 或 CLI 中编排多 Agent 集群与自主工作流

    自组织的 Agent 集群(层级 / 网状 / 自适应拓扑)、持久化 HNSW 向量记忆、100+ 专用 Agent,以及跨机器协作的联邦层

    使用 Claude Code / Codex、希望获得超越单模型的 Agent 协作、记忆与后台自动化的工程师与独立开发者

  • 在发布前审计并加固 Agent 工程环境

    MetaHarness 审计:对 Agent 环境就绪度打分(1–100)、扫描工具配置的安全问题、对项目做快照以发现回归

    需要在生产使用前对 Agent 工具有治理 / 安全审查需求的团队

02如何接入 DeepSeek Harness?

前置条件

  • Node.js + npm(CLI 通过 `npx ruflo` 与 `npm install -g ruflo` 分发)
  • Claude Code(可选)——用于 Claude Code 插件路径与 MCP 服务注册

安装步骤

  1. 01

    通过一行式 POSIX 安装器安装:`curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash`

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

  2. 02

    或运行交互式安装向导(全平台,含原生 Windows PowerShell):`npx ruflo@latest init wizard`

    $ npx ruflo@latest init wizard

  3. 03

    仅用 Claude Code:先添加市场(`/plugin marketplace add ruvnet/ruflo`),再 `/plugin install ruflo-core@ruflo`

验证接入成功

  • 运行 `ruflo verify`,以密码学方式证明你安装的字节与签名见证人(signed witness)一致

03DSH 适配与能力边界

DSH 适配生态相关

已收录于 DSH 插件目录(话题 `dsh-plugin`);README 将 Ruflo 描述为面向 Claude Code / Codex 的 Agent 元框架(meta-harness),提供 100+ Agent 的集群编排、MCP 服务、自学习记忆与零信任联邦。本 README 未描述 DeepSeek Harness(dsh)的具体接入方式。

  • 集群编排与 100+ Agent

    编码 / 测试 / 安全 / 文档 / 架构类任务自组织的 Agent 集群,支持层级、网状与自适应拓扑及共识

  • 自学习向量记忆(AgentDB + HNSW)

    Agent 轨迹、文档与知识跨会话持久化的 HNSW 索引向量记忆,亚毫秒级检索

    记忆以文件形式持久化并跨会话保留
  • Agent 联邦(零信任)

    跨机器 / 组织的任务与工作请求基于 mTLS+ed25519 身份、发送前剥离 PII 的加密跨实例 Agent 协作

    出站消息在离开本节点前会被扫描并剥离 PII

04适合谁?何时不该用?

适合

  • 使用 Claude Code / Codex、希望获得超越单模型的 Agent 协作、记忆与后台自动化的工程师与独立开发者
  • 需要在生产使用前对 Agent 工具有治理 / 安全审查需求的团队

不适合

  • 联邦与多供应商模型路由会把数据发往远端端点;联邦会在消息离开本节点前剥离 PII 并对消息签名,但跨机器协作仍需联网并完成信任配置。

05兼容性、维护与安全提示

  • 一行式 `curl ... | bash` 安装需要 POSIX shell(Git-Bash、WSL、MSYS);在原生 Windows PowerShell / cmd 下请改用 `npx ruflo@latest init wizard`。
  • 联邦与多供应商模型路由会把数据发往远端端点;联邦会在消息离开本节点前剥离 PII 并对消息签名,但跨机器协作仍需联网并完成信任配置。
  • 多供应商模型路由(Claude、GPT、Gemini、Cohere、Ollama)需要为每个启用的供应商配置 API key / 端点;托管 Web UI 使用 OpenRouter。
2025-06-022026-08-21v3.38.16

MIT · 活跃维护中(最新发布 v3.38.16,2026-08-21)

06常见问题

Ruflo 和 DeepSeek Harness(dsh)是什么关系?

Ruflo 已作为 `dsh-plugin` 收录于 DSH 插件目录,但本 README 只描述了它围绕 Claude Code / Codex 的集成(100+ Agent、MCP 服务、集群)。若想在 dsh 中使用,可参考其 MCP 服务注册方式(`claude mcp add ...` 的同款思路)自行桥接;README 未给出 dsh 专用命令。

怎么安装 Ruflo?

POSIX 环境用一行安装器 `curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash`;任意平台(含原生 Windows PowerShell)用 `npx ruflo@latest init wizard`。仅用 Claude Code 则先 `/plugin marketplace add ruvnet/ruflo` 再 `/plugin install ruflo-core@ruflo`。

安装后怎么验证?

运行 `ruflo verify`,以密码学方式证明你安装的字节与签名见证人(signed witness)一致,做到“信任但验证”。

记忆与联邦数据安全吗?

向量记忆(AgentDB + HNSW)以文件形式持久化并跨会话保留;联邦在消息离开本节点前会剥离 PII(14 类检测管线)剥离隐私信息,并用 mTLS + ed25519 验证身份,未信任的 Agent 仅能看到发现信息而非你的记忆。

08数据与来源

  • 作者声明github.com5234333c3462…

    An agent meta-harness for Claude Code and Codex.

  • 作者声明github.com5234333c3462…

    One `npx ruflo init` gives Claude Code a nervous system: agents self-organize into swarms, learn from every task, rememb…

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-22。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。