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 服务注册
安装步骤
- 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
- 02
或运行交互式安装向导(全平台,含原生 Windows PowerShell):`npx ruflo@latest init wizard`
$ npx ruflo@latest init wizard
- 03
仅用 Claude Code:先添加市场(`/plugin marketplace add ruvnet/ruflo`),再 `/plugin install ruflo-core@ruflo`
验证接入成功
- 运行 `ruflo verify`,以密码学方式证明你安装的字节与签名见证人(signed witness)一致
03DSH 适配与能力边界
已收录于 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。
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 仅能看到发现信息而非你的记忆。
07相关的 DSH 工作流
reactive-resume
作者 amruthpillai
注重隐私的开源简历生成器,安全、可定制、可移植,永久免费,支持自托管。
everos
作者 evermind-ai
为所有 AI 智能体提供的便携统一记忆层,本地优先、Markdown 原生、数据归用户所有,跨应用与工作流自进化。
yao
作者 yaoapp
在桌面、移动端、浏览器或 API 上统一管理你的智能体与工作区,看板式任务追踪,支持自托管。
openpencil
作者 zseven-w
全球首个开源 AI 原生矢量设计工具,支持并发智能体团队,可在画布上直接通过提示词生成 UI。
08数据与来源
An agent meta-harness for Claude Code and Codex.
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 个值得优先安装的插件,覆盖各个分类。
