iven/zclaw_openfang
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

feat(hands): restructure Hands UI with Chinese localization

Browse Source 
Major changes:
- Add HandList.tsx component for left sidebar
- Add HandTaskPanel.tsx for middle content area
- Restructure Sidebar tabs: 分身/HANDS/Workflow
- Remove Hands tab from RightPanel
- Localize all UI text to Chinese
- Archive legacy OpenClaw documentation
- Add Hands integration lessons document
- Update feature checklist with new components

UI improvements:
- Left sidebar now shows Hands list with status icons
- Middle area shows selected Hand's tasks and results
- Consistent styling with Tailwind CSS
- Chinese status labels and buttons

Documentation:
- Create docs/archive/openclaw-legacy/ for old docs
- Add docs/knowledge-base/hands-integration-lessons.md
- Update docs/knowledge-base/feature-checklist.md
- Update docs/knowledge-base/README.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
iven
2026-03-14 23:16:32 +08:00
parent 67e1da635d
commit 07079293f4
126 changed files with 36229 additions and 1035 deletions
Download Patch File Download Diff File Expand all files Collapse all files

532
docs/openclaw-to-openfang-migration-brainstorm.md Normal file
View File

@@ -0,0 +1,532 @@
# ZClaw: 从 OpenClaw 切换到 OpenFang 头脑风暴分析
> **分析日期**：2026-03-13
> **目标**：评估 ZClaw 从 OpenClaw 切换到 OpenFang 的可行性、成本和收益
---
## 一、核心架构对比
### 1.1 当前 ZClaw 架构 (基于 OpenClaw)
```
┌─────────────────────────────────────────────────────────────────┐
│ ZClaw Desktop (当前) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ React 19 │ │ Zustand │ │ TypeScript │ │
│ │ UI Layer │───►│ Store │───►│ Gateway │ │
│ │ │ │ │ │ Client │ │
│ └─────────────┘ └─────────────┘ └──────┬──────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ OpenClaw Gateway (Node.js) │ │
│ │ ws://127.0.0.1:18789 │ │
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
│ │ │Sessions │ │Channels │ │ Config │ │ Cron │ │ │
│ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Plugins/Skills (TypeScript) │ │
│ │ • zclaw-chinese-models • zclaw-feishu • zclaw-ui │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
技术栈：Tauri 2.0 + React 19 + TypeScript + Node.js Gateway
内存占用：>1GB (含 Node.js)
启动时间：2-5 秒
```
### 1.2 切换后架构 (基于 OpenFang)
```
┌─────────────────────────────────────────────────────────────────┐
│ ZClaw Desktop (OpenFang) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ React 19 │ │ Zustand │ │ TypeScript │ │
│ │ UI Layer │───►│ Store │───►│ Gateway │ │
│ │ │ │ │ │ Client │ │
│ └─────────────┘ └─────────────┘ └──────┬──────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ OpenFang Kernel (Rust) │ │
│ │ ws://127.0.0.1:???? │ │
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
│ │ │ Runtime │ │ Hands │ │ 16-Layer│ │ 40 │ │ │
│ │ │ Engine │ │ System │ │ Security│ │ Channels│ │ │
│ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Skills + Hands (Rust/WASM) │ │
│ │ • 60 内置技能 • 7 个 Hands • MCP 模板 • WASM 沙箱 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
技术栈：Tauri 2.0 + React 19 + TypeScript + Rust Gateway
内存占用：~40MB
启动时间：180ms
```
---
## 二、功能维度分析
### 2.1 功能增强
| 功能 | OpenClaw | OpenFang | 影响 |
|------|----------|----------|------|
| **Hands 自主系统** | ❌ 无 | ✅ 7 个 Hands | 🔥 **重大增强**：可提供自主工作流 |
| **Workflow 引擎** | ❌ 基础 Cron | ✅ 完整 Workflow | 🔥 **重大增强**：多步骤编排 |
| **通道支持** | 20+ | 40 | ✅ **增强**：覆盖更广 |
| **LLM 提供商** | 50+ | 27 | ⚠️ **略减**：但覆盖主流 |
| **技能生态** | 13,729+ | 60 内置 + 兼容 | ⚠️ **需要迁移**：生态差异 |
| **Trigger 引擎** | ❌ 基础 | ✅ 9 种事件 | 🔥 **重大增强**：事件驱动 |
### 2.2 Hands 系统对 ZClaw 的价值
```
┌─────────────────────────────────────────────────────────────────┐
│ OpenFang Hands 对 ZClaw 的潜在价值 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Clip Hand - 视频处理 │ │
│ │ • 用户发送 YouTube 链接 → 自动生成竖屏短视频 │ │
│ │ • 自动添加字幕和 AI 配音 │ │
│ │ • 直接发布到社交媒体 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Lead Hand - 销售线索 │ │
│ │ • 每日自动发现潜在客户 │ │
│ │ • 生成评分报告 │ │
│ │ • 适合 B2B 用户 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Researcher Hand - 深度研究 │ │
│ │ • 跨源交叉验证 │ │
│ │ • CRAAP 可信度评估 │ │
│ │ • 适合知识工作者 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Browser Hand - 网页自动化 │ │
│ │ • 自动填表、点击、导航 │ │
│ │ • 多步骤工作流 │ │
│ │ • 审批门控（安全） │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
💡 用户价值：从"被动响应"到"主动工作"的体验升级
```
### 2.3 功能风险
| 风险 | 描述 | 缓解措施 |
|------|------|----------|
| **技能迁移** | 现有 zclaw-* 插件需要重写 | OpenFang 提供迁移工具，支持 SKILL.md 格式 |
| **API 差异** | Gateway 协议可能不同 | 需要适配新的 WebSocket 协议 |
| **生态不成熟** | OpenFang 社区较小 | 可考虑贡献代码，建立合作关系 |
---
## 三、安全性维度分析
### 3.1 安全架构对比
```
┌─────────────────────────────────────────────────────────────────┐
│ 安全架构对比 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ OpenClaw (3 层) OpenFang (16 层) │
│ ───────────── ──────────────── │
│ │
│ ┌─────────────────┐ ┌─────────────────────────────┐ │
│ │ 1. 应用级权限 │ │ 1. WASM 双重计量沙箱 │ │
│ │ 2. DM 配对 │ │ 2. Merkle 哈希链审计 │ │
│ │ 3. 沙箱隔离 │ │ 3. 信息流污染追踪 │ │
│ └─────────────────┘ │ 4. Ed25519 签名代理清单 │ │
│ │ 5. SSRF 防护 │ │
│ │ 6. 机密零化 │ │
│ │ 7. OFP 互认证 │ │
│ │ 8. 能力门控 │ │
│ │ 9. 安全头 │ │
│ │ 10. 健康端点编辑 │ │
│ │ 11. 子进程沙箱 │ │
│ │ 12. 提示注入扫描器 │ │
│ │ 13. 循环守卫 │ │
│ │ 14. 会话修复 │ │
│ │ 15. 路径遍历防护 │ │
│ │ 16. GCRA 速率限制 │ │
│ └─────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
```
### 3.2 安全性对用户体验的影响
| 安全特性 | 用户体验影响 | 评分 |
|----------|-------------|------|
| **WASM 沙箱** | 透明，用户无感知 | ✅ 正面 |
| **Merkle 审计链** | 可提供操作历史查看 | ✅ 正面 |
| **提示注入扫描** | 可能误报，需要用户确认 | ⚠️ 中性 |
| **能力门控 (RBAC)** | 首次使用需授权 | ⚠️ 轻微负面 |
| **循环守卫** | 自动断路，保护用户 | ✅ 正面 |
| **速率限制** | 高频使用时可能触发 | ⚠️ 轻微负面 |
### 3.3 安全性营销价值
```
┌─────────────────────────────────────────────────────────────────┐
│ 安全性作为产品卖点 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ "基于 OpenFang 的 ZClaw 提供： │
│ │
│ ✅ 16 层纵深防御 - 金融级安全保障 │
│ ✅ WASM 沙箱隔离 - 代码执行安全可控 │
│ ✅ Merkle 审计链 - 所有操作可追溯 │
│ ✅ Ed25519 签名 - 设备身份验证 │
│ ✅ 信息流追踪 - 防止数据泄露 │
│ │
│ 适合：企业用户、金融行业、医疗健康、政府机构 │
│ " │
│ │
└─────────────────────────────────────────────────────────────────┘
💡 安全性可成为企业版/专业版的差异化卖点
```
---
## 四、性能维度分析
### 4.1 性能指标对比
| 指标 | OpenClaw | OpenFang | 提升幅度 |
|------|----------|----------|----------|
| **冷启动时间** | 5.98s | 180ms | **33x 更快** |
| **空闲内存** | 394MB | 40MB | **90% 更少** |
| **安装大小** | 500MB | 32MB | **94% 更小** |
| **响应延迟** | ~100ms | ~10ms | **10x 更快** |
### 4.2 性能对用户体验的影响
```
┌─────────────────────────────────────────────────────────────────┐
│ 性能提升带来的 UX 改善 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 启动体验： │
│ ───────── │
│ OpenClaw: 点击图标 → 等待 6 秒 → 可用 │
│ OpenFang: 点击图标 → 等待 0.2 秒 → 可用 ⚡ "秒开"体验 │
│ │
│ 运行时体验： │
│ ────────── │
│ OpenClaw: 后台占用 400MB+ 内存，多任务时卡顿 │
│ OpenFang: 后台占用 40MB 内存，几乎无感 💪 轻盈 │
│ │
│ 安装体验： │
│ ───────── │
│ OpenClaw: 下载 500MB，安装 2-3 分钟 │
│ OpenFang: 下载 32MB，安装 10 秒 🚀 快速部署 │
│ │
│ 低配设备： │
│ ───────── │
│ OpenClaw: 8GB 以下内存设备体验差 │
│ OpenFang: 可在 4GB 内存设备流畅运行 📱 覆盖更广 │
│ │
└─────────────────────────────────────────────────────────────────┘
💡 性能提升 = 更好的首次印象 + 更广的设备覆盖 + 更低的用户流失
```
---
## 五、开发成本分析
### 5.1 迁移工作量估算
| 模块 | 工作内容 | 工作量 | 风险 |
|------|----------|--------|------|
| **GatewayClient** | 适配 OpenFang WebSocket 协议 | 3-5 天 | 中 |
| **插件迁移** | 重写 zclaw-* 插件 | 10-15 天 | 高 |
| **技能迁移** | 转换 SKILL.md 格式 | 2-3 天 | 低 |
| **UI 适配** | 新增 Hands/Workflow 管理界面 | 5-7 天 | 低 |
| **测试** | 全量回归测试 | 5-7 天 | 中 |
| **文档更新** | 更新用户/开发文档 | 2-3 天 | 低 |
**总计**：27-40 天（约 1.5-2 个月）
### 5.2 技术栈变化
| 方面 | 变化 | 影响 |
|------|------|------|
| **后端语言** | TypeScript → Rust | 需要学习 Rust 或依赖社区 |
| **插件开发** | TypeScript → Rust/WASM | 插件开发门槛提高 |
| **调试工具** | Node.js 调试 → Rust 调试 | 调试方式变化 |
| **构建流程** | npm/pnpm → Cargo + npm | CI/CD 需要调整 |
### 5.3 风险缓解
```
┌─────────────────────────────────────────────────────────────────┐
│ 迁移风险缓解策略 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 1. 渐进式迁移 │
│ ───────────── │
│ • 先保持 OpenClaw 版本维护 │
│ • 并行开发 OpenFang 版本 │
│ • 双版本并行运行一段时间 │
│ │
│ 2. 兼容层设计 │
│ ───────────── │
│ • 实现 OpenClaw 协议适配器 │
│ • 现有插件无需修改即可运行 │
│ • 逐步迁移到原生 OpenFang API │
│ │
│ 3. 社区合作 │
│ ───────────── │
│ • 与 OpenFang 团队建立联系 │
│ • 贡献代码换取优先支持 │
│ • 参与路线图讨论 │
│ │
└─────────────────────────────────────────────────────────────────┘
```
---
## 六、用户使用体验分析
### 6.1 用户体验变化矩阵
| 维度 | 变化 | 用户感知 | 重要性 |
|------|------|----------|--------|
| **启动速度** | 6s → 0.2s | ⭐⭐⭐⭐⭐ 极大提升 | 高 |
| **内存占用** | 400MB → 40MB | ⭐⭐⭐⭐ 显著提升 | 中 |
| **安装包大小** | 500MB → 32MB | ⭐⭐⭐⭐ 显著提升 | 中 |
| **功能丰富度** | 基础 → +Hands | ⭐⭐⭐⭐⭐ 极大提升 | 高 |
| **安全感** | 3 层 → 16 层 | ⭐⭐⭐⭐ 提升 | 中 |
| **学习曲线** | 相似 | ⭐⭐⭐ 无变化 | - |
| **稳定性** | 相似或更好 | ⭐⭐⭐⭐ 可能提升 | 高 |
### 6.2 新功能带来的用户体验升级
```
┌─────────────────────────────────────────────────────────────────┐
│ OpenFang 带来的 UX 升级 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 场景 1：内容创作者 │
│ ────────────────── │
│ Before: 手动下载视频 → 剪辑 → 添加字幕 → 上传 │
│ After: 发送 YouTube 链接 → Clip Hand 自动完成全流程 │
│ 价值：节省 90% 时间 │
│ │
│ 场景 2：销售人员 │
│ ──────────────── │
│ Before: 手动搜索潜在客户 → 整理信息 → 评分 │
│ After: Lead Hand 每日自动发现 → 生成报告 → 推送通知 │
│ 价值：被动获客，效率倍增 │
│ │
│ 场景 3：研究人员 │
│ ──────────────── │
│ Before: 手动搜索 → 多源对比 → 整理引用 │
│ After: Researcher Hand 自动研究 → CRAAP 评估 → APA 引用 │
│ 价值：研究效率提升 5x │
│ │
│ 场景 4：日常办公 │
│ ──────────────── │
│ Before: 手动填表 → 点击按钮 → 重复操作 │
│ After: Browser Hand 自动化工作流 → 审批确认 → 完成 │
│ 价值：从重复劳动中解放 │
│ │
└─────────────────────────────────────────────────────────────────┘
```
### 6.3 潜在负面体验
| 负面因素 | 描述 | 缓解措施 |
|----------|------|----------|
| **首次授权繁琐** | RBAC 需要用户确认权限 | 设计友好的授权引导流程 |
| **速率限制** | 高频使用可能触发限制 | 可配置的速率限制策略 |
| **功能缺失** | 部分技能尚未迁移 | 明确标注"即将推出" |
| **学习成本** | Hands/Workflow 新概念 | 提供交互式教程 |
---
## 七、商业化影响分析
### 7.1 产品定位升级
```
┌─────────────────────────────────────────────────────────────────┐
│ 产品定位变化 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 当前 (OpenClaw)： │
│ ───────────────── │
│ "基于 OpenClaw 的 AI Agent 桌面客户端" │
│ 定位：个人 AI 助手 │
│ 差异化：桌面客户端、中文优化 │
│ │
│ 升级后 (OpenFang)： │
│ ────────────────── │
│ "基于 OpenFang 的生产级 AI Agent 桌面客户端" │
│ 定位：生产力工具 / 企业级助手 │
│ 差异化： │
│ • 16 层金融级安全 │
│ • Hands 自主工作流 │
│ • 33x 更快启动 │
│ • 90% 更低资源占用 │
│ │
└─────────────────────────────────────────────────────────────────┘
```
### 7.2 定价策略影响
| 版本 | 当前定价建议 | 升级后定价建议 | 理由 |
|------|-------------|---------------|------|
| **免费版** | 基础功能 | 基础功能 + 1 个 Hand | 吸引用户体验 |
| **专业版** | ¥99/月 | ¥149/月 | Hands 带来价值提升 |
| **企业版** | ¥299/月 | ¥499/月 | 安全合规价值 |
| **定制版** | 按需 | 按需 + Hands 定制 | 新增服务收入 |
### 7.3 目标客户变化
| 客户群 | 当前匹配度 | 升级后匹配度 | 变化原因 |
|--------|-----------|-------------|----------|
| **个人用户** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 功能更强但可能过于复杂 |
| **内容创作者** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | Clip Hand 完美匹配 |
| **销售人员** | ⭐⭐ | ⭐⭐⭐⭐⭐ | Lead Hand 完美匹配 |
| **研究人员** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | Researcher Hand 完美匹配 |
| **企业用户** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 16 层安全 + 审计 |
| **金融/医疗** | ⭐⭐ | ⭐⭐⭐⭐⭐ | 合规 + 安全 |
---
## 八、决策建议
### 8.1 SWOT 分析
```
┌─────────────────────────────────────────────────────────────────┐
│ SWOT 分析 │
├──────────────────────┬──────────────────────────────────────────┤
│ 优势 (S) │ 劣势 (W) │
├──────────────────────┼──────────────────────────────────────────┤
│ • 33x 启动速度提升 │ • 迁移成本 1.5-2 个月 │
│ • 90% 内存减少 │ • 插件需要重写 │
│ • 16 层安全防护 │ • 社区生态较小 │
│ • Hands 自主系统 │ • Rust 开发门槛 │
│ • Workflow 引擎 │ • API 需要适配 │
│ • 40 通道支持 │ │
├──────────────────────┼──────────────────────────────────────────┤
│ 机会 (O) │ 威胁 (T) │
├──────────────────────┼──────────────────────────────────────────┤
│ • 企业市场拓展 │ • OpenFang 项目不够成熟 │
│ • 金融/医疗行业 │ • 社区支持可能不足 │
│ • 内容创作者市场 │ • 技术路线变化风险 │
│ • 差异化竞争 │ • 用户学习成本 │
│ • 定价提升空间 │ │
└──────────────────────┴──────────────────────────────────────────┘
```
### 8.2 推荐策略
```
┌─────────────────────────────────────────────────────────────────┐
│ 推荐策略：渐进式双轨 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 阶段 1：调研验证 (1-2 周) │
│ ──────────────────────── │
│ • 深入研究 OpenFang API 文档 │
│ • 评估 GatewayClient 适配工作量 │
│ • 与 OpenFang 团队建立联系 │
│ • 评估插件迁移可行性 │
│ │
│ 阶段 2：原型验证 (2-3 周) │
│ ──────────────────────── │
│ • 实现基础 GatewayClient 适配 │
│ • 验证核心功能可用性 │
│ • 评估性能提升实际效果 │
│ • 收集团队反馈 │
│ │
│ 阶段 3：并行开发 (1-2 月) │
│ ──────────────────────── │
│ • 保持 OpenClaw 版本维护 │
│ • 并行开发 OpenFang 版本 │
│ • 实现插件兼容层 │
│ • 内部测试和优化 │
│ │
│ 阶段 4：灰度发布 (2-4 周) │
│ ──────────────────────── │
│ • 选择部分用户进行 Beta 测试 │
│ • 收集反馈并优化 │
│ • 完善文档和教程 │
│ │
│ 阶段 5：正式切换 │
│ ──────────────── │
│ • 发布 OpenFang 版本为默认 │
│ • OpenClaw 版本进入维护模式 │
│ • 持续优化和迭代 │
│ │
└─────────────────────────────────────────────────────────────────┘
```
### 8.3 最终建议
| 条件 | 建议 |
|------|------|
| **如果追求快速迭代** | 保持 OpenClaw，关注 OpenFang 发展 |
| **如果追求企业市场** | **强烈建议切换** OpenFang |
| **如果追求差异化竞争** | **建议切换** OpenFang |
| **如果资源有限** | 保持 OpenClaw，渐进评估 |
| **如果目标是内容创作者/销售** | **强烈建议切换** OpenFang |
---
## 九、结论
### 切换到 OpenFang 的核心价值
```
┌─────────────────────────────────────────────────────────────────┐
│ │
│ 🚀 性能：33x 启动速度 + 90% 内存节省 │
│ │
│ 🔒 安全：16 层纵深防御 + 金融级合规 │
│ │
│ 🤖 智能：Hands 自主系统 + Workflow 引擎 │
│ │
│ 📈 商业：企业市场 + 定价提升空间 │
│ │
│ ⚠️ 成本：1.5-2 个月迁移 + 插件重写 │
│ │
└─────────────────────────────────────────────────────────────────┘
💡 总结：如果 ZClaw 的目标是成为"生产级 AI Agent 客户端"，
切换到 OpenFang 是值得投入的战略选择。
```
---
*分析日期：2026-03-13*
*分析版本：v1.0*