ruflo-系统背景
ruflo-系统背景
作品声明：个人观点、仅供参考
1. 背景与目标
描述 Ruflo 系统的边界划分、外部依赖和核心交互关系。
2. 核心名词解释
名词 | 定义 | 关联 |
CLI Entry | 用户通过终端与 Ruflo 交互的入口 | v3/@claude-flow/cli/bin/cli.js |
MCP Server | 通过 stdio 暴露 MCP 工具的服务端 | v3/@claude-flow/cli/bin/mcp-server.js |
3. 系统上下文图
4. 外部依赖清单
依赖 | 用途 | 必需 |
Node.js >= 20 | 运行时 | 是 |
Anthropic API | Claude 模型调用 | 否（可选） |
OpenAI API | Codex 双模式协作 | 否（可选） |
IPFS/Pinata | 插件注册表分发 | 否（插件功能需要） |
ONNX Runtime | 向量嵌入生成 | 否（记忆搜索需要） |
SQLite (sql.js) | AgentDB 持久化 | 是（记忆功能需要） |
5. 边界划分说明
- CLI 边界：用户通过终端或 MCP 协议访问，CLI 是唯一入口
- Agent 边界：Agent 是执行单元，不直接暴露给用户，通过 Swarm 编排
- Memory 边界：所有记忆操作通过 AgentDB Adapter，外部不直接访问 SQLite
- Security 边界：所有用户输入必须通过 Zod 验证（@claude-flow/security）
- Plugin 边界：插件通过 IPFS 分发，本地安装后由 Plugin Manager 加载
6. 待办与问题
- ONNX Runtime 在某些环境下安装失败，需要 fallback 机制
- IPFS/Pinata 依赖需要 API 密钥，影响离线使用