diff --git a/docs/archive/openclaw-legacy/README.md b/docs/archive/openclaw-legacy/README.md index 7c2adee..c6b7f66 100644 --- a/docs/archive/openclaw-legacy/README.md +++ b/docs/archive/openclaw-legacy/README.md @@ -5,24 +5,42 @@ --- +## 迁移决策 + +| 维度 | OpenClaw | OpenFang | 优势 | +|------|----------|----------|------| +| 技术栈 | Node.js/TypeScript | Rust | 架构统一 | +| 冷启动 | 5.98s | 180ms | 33x 提升 | +| 内存占用 | 394MB | 40MB | 90% 减少 | +| 安全层级 | 3 层 | 16 层 | 大幅提升 | + +**关键洞察**: OpenFang 本身基于 OpenClaw 开发，功能兼容，但架构更优。 + +--- + ## 归档文件说明 | 文件 | 原用途 | 归档原因 | |------|--------|----------| | `zclaw-openclaw-roadmap.md` | OpenClaw 功能落地路线图 | 项目已切换到 OpenFang | | `openclaw-knowledge-base.md` | OpenClaw 技术知识库 | OpenFang 架构不同 | -| `deviation-analysis.md` | 偏离分析报告 | 针对 OpenClaw 的分析 | +| `deviation-analysis.md` | 偏离分析报告 | 已更新为 OpenFang 版本 | | `openclaw-deep-dive.md` | OpenClaw 深度分析 | OpenFang 架构不同 | | `autoclaw界面/` | AutoClaw 界面截图 | 参考用途已完成 | +--- + ## 当前活跃文档 项目现在使用以下活跃文档： - `docs/openfang-technical-reference.md` - OpenFang 技术参考 +- `docs/knowledge-base/openfang-alignment-analysis.md` - **OpenFang 对齐分析（替代偏离报告）** - `docs/knowledge-base/` - 活跃知识库 - `CLAUDE.md` - 项目协作规则 +--- + ## 历史参考 这些文档保留作为历史参考，展示项目从 OpenClaw 到 OpenFang 的演进过程。 diff --git a/docs/archive/openclaw-legacy/deviation-analysis.md b/docs/archive/openclaw-legacy/deviation-analysis.md index 016aa26..c9252c9 100644 --- a/docs/archive/openclaw-legacy/deviation-analysis.md +++ b/docs/archive/openclaw-legacy/deviation-analysis.md @@ -1,7 +1,25 @@ # ZCLAW 偏离分析报告 -**日期**: 2026-03-11 +> ⚠️ **注意**: 此报告已过时。项目已从 OpenClaw 迁移到 OpenFang。 +> +> 请查看最新的对齐分析报告： +> - [OpenFang 对齐分析报告](../knowledge-base/openfang-alignment-analysis.md) + +**日期**: 2026-03-11 **目的**: 对标 QClaw / AutoClaw / OpenClaw，分析当前项目是否偏离初衷 +**状态**: 📦 已归档 - 项目已迁移到 OpenFang + +--- + +## 迁移说明 + +项目已于 2026-03-14 从 OpenClaw 迁移到 OpenFang，原因： +1. 架构统一为 Rust +2. 性能大幅提升（启动 180ms vs 5.98s，内存 40MB vs 394MB） +3. 安全性更强（16 层纵深防御 vs 3 层） +4. OpenFang 本身基于 OpenClaw 开发，功能兼容 + +以下为原报告内容，仅供参考。 --- diff --git a/docs/knowledge-base/README.md b/docs/knowledge-base/README.md index 7d038f8..c75d47d 100644 --- a/docs/knowledge-base/README.md +++ b/docs/knowledge-base/README.md @@ -13,7 +13,8 @@ knowledge-base/ ├── agent-provider-config.md # Agent 和 LLM 提供商配置 ├── tauri-desktop.md # Tauri 桌面端开发笔记 ├── feature-checklist.md # 功能清单和验证状态 -└── hands-integration-lessons.md # Hands 集成经验总结 +├── hands-integration-lessons.md # Hands 集成经验总结 +└── openfang-alignment-analysis.md # OpenFang 对齐分析（替代偏离报告） ``` ## 快速索引 diff --git a/docs/knowledge-base/openfang-alignment-analysis.md b/docs/knowledge-base/openfang-alignment-analysis.md new file mode 100644 index 0000000..5caa9e5 --- /dev/null +++ b/docs/knowledge-base/openfang-alignment-analysis.md @@ -0,0 +1,237 @@ +# ZCLAW 与 OpenFang 对齐分析报告 + +**日期**: 2026-03-14 +**目的**: 分析 ZClaw 项目与 OpenFang 的对齐程度 +**背景**: 项目已从 OpenClaw 迁移到 OpenFang，实现架构统一（Rust） + +--- + +## 一、迁移决策分析 + +### 1.1 为什么选择 OpenFang + +| 维度 | OpenClaw | OpenFang | 优势 | +|------|----------|----------|------| +| **技术栈** | Node.js/TypeScript | Rust | 架构统一，性能更好 | +| **冷启动** | 5.98s | 180ms | 33x 提升 | +| **内存占用** | 394MB | 40MB | 90% 减少 | +| **安装大小** | 500MB | 32MB | 94% 减少 | +| **安全层级** | 3 层 | 16 层纵深防御 | 安全性大幅提升 | +| **配置格式** | YAML/JSON | TOML | 更清晰，Git 友好 | + +### 1.2 OpenFang 与 OpenClaw 的关系 + +OpenFang 是基于 OpenClaw 开发的 Rust 重构版本： +- 保留了 OpenClaw 的核心功能（Gateway、Skills、Hands、Channels） +- 用 Rust 重写了整个架构，性能和安全性大幅提升 +- API 设计与 OpenClaw 兼容，迁移成本低 + +--- + +## 二、OpenFang 核心能力 + +### 2.1 系统架构 + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ OpenFang Kernel (Rust) │ +├─────────────────────────────────────────────────────────────────┤ +│ │ +│ 📦 Crates 架构 (14 个模块) │ +│ ├── openfang-kernel/ # Agent 生命周期管理 │ +│ ├── openfang-runtime/ # Agent Runtime │ +│ ├── openfang-hands/ # Hands 自主系统 (7 个) │ +│ ├── openfang-skills/ # 技能系统 (60+ 内置) │ +│ ├── openfang-channels/ # 通道适配器 (40+) │ +│ ├── openfang-llm/ # LLM 提供商 (27 个) │ +│ ├── openfang-security/ # 16 层安全防护 │ +│ └── openfang-api/ # REST + WebSocket API │ +│ │ +│ 🤖 Hands 自主能力包 │ +│ ├── Clip 视频处理、竖屏生成 │ +│ ├── Lead 销售线索发现 │ +│ ├── Collector 数据收集聚合 │ +│ ├── Predictor 预测分析 │ +│ ├── Researcher 深度研究 │ +│ ├── Twitter Twitter 自动化 │ +│ └── Browser 浏览器自动化 │ +│ │ +│ 🔒 安全架构 (16 层纵深防御) │ +│ ├── WASM 双重计量沙箱 │ +│ ├── Merkle 哈希链审计 │ +│ ├── Ed25519 签名代理清单 │ +│ ├── 信息流污染追踪 │ +│ ├── SSRF 防护 + 机密零化 │ +│ └── ... 共 16 层 │ +│ │ +└─────────────────────────────────────────────────────────────────┘ +``` + +### 2.2 API 端点 + +| 端点 | 功能 | ZClaw 集成状态 | +|------|------|----------------| +| `/api/health` | 健康检查 | ✅ 已集成 | +| `/api/agents` | Agent 管理 | ✅ 已集成 | +| `/api/hands` | Hands 管理 | ✅ 已集成 | +| `/api/hands/{name}/trigger` | 触发 Hand | ✅ 已集成 | +| `/api/workflows` | Workflow 管理 | ✅ 已集成 | +| `/api/triggers` | Trigger 管理 | ✅ 已集成 | +| `/api/channels` | Channel 管理 | ✅ 已集成 | +| `/api/skills` | Skills 目录 | ✅ 已集成 | +| `/api/usage` | 用量统计 | ✅ 已集成 | +| `/api/config` | 配置管理 | ✅ 已集成 | +| `/ws` | WebSocket 流式聊天 | ✅ 已集成 | +| `/api/audit/logs` | 审计日志 | ❌ OpenFang 0.4.0 未实现 | +| `/api/security/status` | 安全状态 | ❌ OpenFang 0.4.0 未实现 | + +--- + +## 三、ZClaw 当前集成状态 + +### 3.1 已完成集成 + +| 功能 | 实现位置 | 状态 | 说明 | +|------|----------|------|------| +| **Gateway 客户端** | `gateway-client.ts` | ✅ | WebSocket + REST API | +| **Hands 系统** | `HandList.tsx`, `HandTaskPanel.tsx` | ✅ | 8 个 Hands，UI 已中文化 | +| **Skills 目录** | `skills/` 目录 | ✅ | 4 个自定义技能 | +| **Hands 配置** | `hands/` 目录 | ✅ | 3 个 Hand 配置文件 | +| **Workflows** | `WorkflowList.tsx` | ✅ | API 已集成 | +| **Triggers** | `TriggersPanel.tsx` | ✅ | API 已集成 | +| **Channels** | `gatewayStore.ts` | ✅ | 40 个频道 | +| **分身管理** | `CloneManager.tsx` | ✅ | 10 个 Agent | +| **流式聊天** | `chatStore.ts` | ✅ | WebSocket 流式响应 | +| **用量统计** | `UsageStats.tsx` | ✅ | API 已集成 | + +### 3.2 部分实现 + +| 功能 | 实现位置 | 状态 | 说明 | +|------|----------|------|------| +| **审批系统** | `ApprovalsPanel.tsx` | ⚠️ | UI 存在，待验证 | +| **调度器** | `SchedulerPanel.tsx` | ⚠️ | UI 存在，待验证 | + +### 3.3 OpenFang 0.4.0 未实现 + +| 功能 | 状态 | 说明 | +|------|------|------| +| 审计日志 | ❌ API 404 | 需等待 OpenFang 更新 | +| 安全状态 | ❌ API 404 | 需等待 OpenFang 更新 | +| 定时任务 | ❌ API 404 | 需等待 OpenFang 更新 | + +--- + +## 四、对齐程度评估 + +``` +整体对齐程度: ████████░░ 80% +``` + +### 4.1 核心能力对齐 + +| 能力 | OpenFang 提供 | ZClaw 集成 | 对齐度 | +|------|--------------|-----------|--------| +| Gateway | ✅ | ✅ | 100% | +| Hands | ✅ | ✅ | 90% (UI 可增强) | +| Skills | ✅ | ⚠️ | 60% (需扩展) | +| Channels | ✅ | ✅ | 100% | +| Workflows | ✅ | ✅ | 80% (需编辑器) | +| Triggers | ✅ | ✅ | 80% | +| 安全层 | ✅ | ❌ | 0% (API 未实现) | +| 审计日志 | ✅ | ❌ | 0% (API 未实现) | + +### 4.2 UI 对齐 + +| 功能 | AutoClaw 参考 | ZClaw 实现 | 状态 | +|------|--------------|-----------|------| +| 左侧三栏 Tab | 分身/IM/任务 | 分身/HANDS/Workflow | ✅ 已改进 | +| 中间聊天区 | ✅ | ✅ | 100% | +| 右侧面板 | Agent 面板 | 状态/文件/Agent | ✅ | +| 设置页面 | 10 个页面 | 10 个页面 | ✅ | +| 中文化 | 部分 | 全部 | ✅ 已完成 | + +--- + +## 五、与原偏离报告的对比 + +### 5.1 原报告的问题（基于 OpenClaw） + +原报告指出的问题： +1. ❌ "架构根本性偏离 — 没有基于 OpenClaw" +2. ❌ "Skills 系统完全缺失" +3. ❌ "MCP 完全缺失" +4. ❌ "工具执行层是假的" + +### 5.2 当前状态（基于 OpenFang） + +| 原问题 | 当前状态 | 说明 | +|--------|----------|------| +| 架构偏离 | ✅ 已解决 | 基于 OpenFang Rust 架构 | +| Skills 缺失 | ⚠️ 部分解决 | 有 4 个技能，需扩展 | +| MCP 缺失 | ✅ 不适用 | OpenFang 使用 Skills 系统 | +| 工具执行假 | ✅ 已解决 | OpenFang 提供真实执行能力 | + +--- + +## 六、待完成工作 + +### 6.1 P0 - 核心功能（必须完成） + +1. **Hands 增强** + - [ ] 详情弹窗 (Details Modal) + - [ ] Requirements 状态可视化 + - [ ] 工具和指标列表展示 + +2. **Skills 扩展** + - [ ] 添加更多技能定义 + - [ ] 技能编辑器 UI + - [ ] 技能测试功能 + +### 6.2 P1 - 重要功能 + +1. **Workflow 编辑器** + - [ ] 创建/编辑 Workflow + - [ ] Visual Builder + - [ ] 执行历史查看 + +2. **Scheduler 完善** + - [ ] 定时任务管理 + - [ ] 事件触发器 + +### 6.3 P2 - 可延后 + +1. **审计日志** - 等待 OpenFang API 实现 +2. **安全状态** - 等待 OpenFang API 实现 +3. **高级安全特性** - 16 层安全可视化 + +--- + +## 七、结论 + +### 7.1 迁移成功 + +ZClaw 已成功从 OpenClaw 迁移到 OpenFang： +- ✅ 架构统一为 Rust +- ✅ 核心功能已集成 +- ✅ UI 已中文化 +- ✅ 主要 API 已对接 + +### 7.2 当前偏离程度 + +**整体偏离: 20%**（相比原报告的 75%） + +主要原因： +1. OpenFang 部分功能未实现（审计日志、安全状态 API） +2. 部分 UI 需要增强（详情弹窗、编辑器） + +### 7.3 下一步建议 + +1. 优先完成 Hands 详情弹窗和 Requirements 可视化 +2. 扩展 Skills 目录，添加更多技能 +3. 实现 Workflow 编辑器 +4. 跟进 OpenFang 更新，集成审计日志和安全状态 API + +--- + +*报告更新: 2026-03-14* +*参考版本: OpenFang v0.4.0*