refactor: 统一项目名称从OpenFang到ZCLAW
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled

重构所有代码和文档中的项目名称,将OpenFang统一更新为ZCLAW。包括:
- 配置文件中的项目名称
- 代码注释和文档引用
- 环境变量和路径
- 类型定义和接口名称
- 测试用例和模拟数据

同时优化部分代码结构,移除未使用的模块,并更新相关依赖项。
This commit is contained in:
iven
2026-03-27 07:36:03 +08:00
parent 4b08804aa9
commit 0d4fa96b82
226 changed files with 7288 additions and 5788 deletions

View File

@@ -1,7 +1,7 @@
# ZCLAW 系统偏离分析与演化路线图
**分析日期**: 2026-03-14 (更新: 2026-03-15)
**分析版本**: OpenFang v0.4.0 + ZClaw Desktop v0.2.0
**分析版本**: ZCLAW v0.4.0 + ZClaw Desktop v0.2.0
**目的**: 识别系统当前偏离点,规划后续演化方向
**Skills 集成**: ✅ agency-agents 仓库迁移完成!
@@ -11,8 +11,8 @@
### 1.1 项目定位
ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核心价值:
- 真实连接 OpenFang Kernel
ZCLAW 是基于 **ZCLAW** (Rust Agent OS) 的 AI Agent 桌面客户端,核心价值:
- 真实连接 ZCLAW Kernel
- 真实驱动 Agents / Skills / Hands / Workflows
- 真实读写 TOML 配置与工作区
- 真实反映运行时状态与审计日志
@@ -126,7 +126,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
| code-review | ✅ 已定义 | 审查代码, code review |
| translation | ✅ 已定义 | 翻译, translate |
**偏离**: OpenFang 内置 60+ 技能ZClaw 仅定义 4 个。
**偏离**: ZCLAW 内置 60+ 技能ZClaw 仅定义 4 个。
#### Hands 目录
@@ -146,12 +146,12 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
| 文件 | 格式 | 用途 | 状态 |
|------|------|------|------|
| `chinese-providers.toml` | TOML | LLM 提供商配置 | ✅ OpenFang |
| `openclaw.default.json` | JSON | OpenClaw 遗留配置 | ⚠️ 待迁移 |
| `chinese-providers.toml` | TOML | LLM 提供商配置 | ✅ ZCLAW |
| `zclaw.default.json` | JSON | ZCLAW 遗留配置 | ⚠️ 待迁移 |
| `SOUL.md` / `AGENTS.md` | Markdown | Agent 人格定义 | ✅ |
| `USER.md` | Markdown | 用户偏好 | ✅ |
**偏离**: 保留 OpenClaw JSON 配置,需迁移到 OpenFang TOML。
**偏离**: 保留 ZCLAW JSON 配置,需迁移到 ZCLAW TOML。
### 2.4 类型定义偏离
@@ -174,7 +174,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
│ 偏离根因分析 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 1. OpenFang API 不完整 (30%) │
│ 1. ZCLAW API 不完整 (30%) │
│ ├── /api/audit/logs 返回 404 │
│ ├── /api/security/status 返回 404 │
│ └── 部分端点未在 v0.4.0 实现 │
@@ -186,7 +186,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
│ │
│ 3. 设计决策 (20%) │
│ ├── 使用 Mock 数据便于 UI 开发 │
│ ├── 保留 OpenClaw 兼容性 │
│ ├── 保留 ZCLAW 兼容性 │
│ └── 逐步迁移而非一次性重写 │
│ │
│ 4. 技术债务 (10%) │
@@ -202,7 +202,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
#### 可接受的偏离(不修正)
1. **OpenAI 兼容 API 缺失** - 非核心功能,第三方集成用
2. **Credits 页面硬编码** - 依赖 OpenFang 积分系统 API
2. **Credits 页面硬编码** - 依赖 ZCLAW 积分系统 API
3. **About 版本检查** - 可延后实现
#### 需要修正的偏离(必须修正)
@@ -249,15 +249,15 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
### Phase 3: 配置迁移 (P1)
**目标**: 完成从 OpenClaw 到 OpenFang 的配置迁移
**目标**: 完成从 ZCLAW 到 ZCLAW 的配置迁移
**时间**: 1 周
| 任务 | 说明 | 状态 |
|------|------|------|
| 迁移 openclaw.default.json | 转换为 config.toml | ✅ 已完成 |
| 补充主 config.toml | OpenFang 服务器配置 | ✅ 已完成 |
| 清理 OpenClaw 遗留代码 | 移除兼容层 | ✅ 已完成 |
| 迁移 zclaw.default.json | 转换为 config.toml | ✅ 已完成 |
| 补充主 config.toml | ZCLAW 服务器配置 | ✅ 已完成 |
| 清理 ZCLAW 遗留代码 | 移除兼容层 | ✅ 已完成 |
### Phase 4: 类型系统完善 (P2)
@@ -337,8 +337,8 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
| 债务 | 位置 | 影响 | 清理方案 | 状态 |
|------|------|------|----------|------|
| ~~OpenClaw JSON 配置~~ | ~~`config/openclaw.default.json`~~ | ~~配置格式混合~~ | ~~迁移到 TOML~~ | ✅ 已清理 |
| ~~缺少主配置文件~~ | ~~`config/`~~ | ~~OpenFang 配置不完整~~ | ~~创建 config.toml~~ | ✅ 已清理 |
| ~~ZCLAW JSON 配置~~ | ~~`config/zclaw.default.json`~~ | ~~配置格式混合~~ | ~~迁移到 TOML~~ | ✅ 已清理 |
| ~~缺少主配置文件~~ | ~~`config/`~~ | ~~ZCLAW 配置不完整~~ | ~~创建 config.toml~~ | ✅ 已清理 |
### 5.3 类型层面
@@ -378,10 +378,10 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
### 6.3 Phase 3 完成标准
- [x] 创建 OpenFang config.toml
- [x] 迁移 OpenClaw JSON 配置到 TOML
- [x] OpenClaw JSON 配置已归档到 docs/archive/openclaw-legacy/
- [x] 默认路径从 ~/.openclaw 更新为 ~/.openfang
- [x] 创建 ZCLAW config.toml
- [x] 迁移 ZCLAW JSON 配置到 TOML
- [x] ZCLAW JSON 配置已归档到 docs/archive/zclaw-legacy/
- [x] 默认路径从 ~/.zclaw 更新为 ~/.zclaw
- [x] 默认端口从 18789 更新为 50051
### 6.4 Phase 4 完成标准
@@ -427,7 +427,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
| 风险 | 概率 | 影响 | 缓解措施 |
|------|------|------|----------|
| OpenFang API 变更 | 中 | 高 | 版本锁定,变更日志跟踪 |
| ZCLAW API 变更 | 中 | 高 | 版本锁定,变更日志跟踪 |
| Session API 未实现 | 高 | 高 | 使用 localStorage 临时方案 |
| 安全层 API 未实现 | 高 | 中 | UI 显示"等待 API"状态 |
| 工作流编辑器复杂度高 | 中 | 中 | 先实现简化版,逐步增强 |
@@ -459,7 +459,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
| 类别 | 组件数 | 完全实现 | 部分实现 | 未实现 |
|------|--------|----------|----------|--------|
| 核心功能 | 5 | 5 | 0 | 0 |
| OpenFang 特有 | 10 | 10 | 0 | 0 |
| ZCLAW 特有 | 10 | 10 | 0 | 0 |
| 设置页面 | 10 | 10 | 0 | 0 |
| Team 协作 | 5 | 5 | 0 | 0 |
| **总计** | **30** | **28** | **0** | **2** |
@@ -516,7 +516,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
* ✅ 添加分身、Hands、工作流、团队四个主功能入口
* 设置页面优化:
* ✅ 主题切换持久化 - 连接 `gatewayStore.saveQuickConfig`
* ✅ 移除 OpenFang 后端下载提示,简化 UI
* ✅ 移除 ZCLAW 后端下载提示,简化 UI
* ✅ 用量统计增强 - 时间范围筛选 (7天/30天/全部)
* ✅ 统计卡片 - 会话数、消息数、输入/输出 Token
* ✅ Token 使用概览条形图
@@ -593,7 +593,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
*`gatewayStore.test.ts` (17 tests)
*`chatStore.test.ts` (11 tests)
* 集成测试:
*`openfang-api.test.ts` (34 tests) - MockServer API 测试
*`zclaw-api.test.ts` (34 tests) - MockServer API 测试
*`general-settings.test.tsx` (2 tests) - 设置 UI 测试
* 测试总数: 148 tests ✅
* 代码质量: