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,4 +1,4 @@
# ZClaw OpenFang 迁移 - 新会话提示词
# ZClaw ZCLAW 迁移 - 新会话提示词
> **更新日期**: 2026-03-13 (Session 4)
> **状态**: Phase 1-7 基本完成
@@ -9,13 +9,13 @@
### ✅ 已完成
1. **OpenFang 打包架构** (Phase 1-2) ✅
- 创建 `prepare-openfang-runtime.mjs` 跨平台下载脚本
1. **ZCLAW 打包架构** (Phase 1-2) ✅
- 创建 `prepare-zclaw-runtime.mjs` 跨平台下载脚本
- 更新 Rust `lib.rs` 支持二进制运行时
- 配置 Tauri 打包 `resources/openfang-runtime/`
- 配置 Tauri 打包 `resources/zclaw-runtime/`
- 验证构建成功
2. **OpenFang 特性 UI 组件**
2. **ZCLAW 特性 UI 组件**
- `HandsPanel.tsx` - Hands 管理界面 (含审批流程)
- `WorkflowList.tsx` - 工作流列表
- `SecurityStatus.tsx` - 16层安全状态
@@ -23,15 +23,15 @@
- `AuditLogsPanel.tsx` - 审计日志 (已集成到 RightPanel)
3. **状态管理更新**
- `gatewayStore.ts` 添加 OpenFang 类型定义
- `gatewayStore.ts` 添加 ZCLAW 类型定义
- `gateway-config.ts` 配置管理
- `loadHands()`, `loadWorkflows()`, `loadTriggers()`, `loadSecurityStatus()` 方法
- `approveHand()`, `cancelHand()`, `cancelWorkflow()` 方法
- `isLoading` 状态管理
- `connect()` 后自动加载 OpenFang 数据
- `connect()` 后自动加载 ZCLAW 数据
4. **Gateway Client**
- `gateway-client.ts` 已适配 OpenFang 协议
- `gateway-client.ts` 已适配 ZCLAW 协议
- WebSocket 连接到 `ws://127.0.0.1:4200/ws`
- REST API 调用 `/api/*` 端点
- Ed25519 设备认证 + JWT
@@ -39,13 +39,13 @@
5. **后端切换功能**
- `Settings/General.tsx` 添加后端类型选择器
- 支持 OpenClaw (TypeScript) 和 OpenFang (Rust) 切换
- 支持 ZCLAW (TypeScript) 和 ZCLAW (Rust) 切换
- localStorage 持久化 `zclaw-backend`
6. **Tauri 后端完善** (Phase 5) ✅
- `openfang_process_list` - 列出 OpenFang 进程
- `openfang_process_logs` - 获取进程日志
- `openfang_version` - 获取版本信息
- `zclaw_process_list` - 列出 ZCLAW 进程
- `zclaw_process_logs` - 获取进程日志
- `zclaw_version` - 获取版本信息
- 前端 `tauri-gateway.ts` 适配
7. **Hand 审批流程** (Phase 6.1) ✅
@@ -54,13 +54,13 @@
- 运行中取消执行功能
8. **测试基础设施** (Phase 7) ✅
- `tests/fixtures/openfang-mock-server.ts` - 完整 Mock Server
- `tests/fixtures/zclaw-mock-server.ts` - 完整 Mock Server
- 支持 REST API 和 WebSocket 模拟
- `tests/desktop/integration/openfang-api.test.ts` - 34 个集成测试
- `tests/desktop/integration/zclaw-api.test.ts` - 34 个集成测试
- 所有 63 个桌面端测试全部通过
9. **构建脚本修复**
- `tauri-build-bundled.mjs` 更新为使用 `prepare-openfang-runtime.mjs`
- `tauri-build-bundled.mjs` 更新为使用 `prepare-zclaw-runtime.mjs`
### 📋 可选后续工作
@@ -80,27 +80,27 @@
ZClaw-Desktop-Setup.exe
├── desktop.exe # Tauri 应用
└── resources/
└── openfang-runtime/
├── openfang.exe # 57MB OpenFang 二进制
├── openfang.cmd # Windows 启动脚本
├── openfang.sh # Unix 启动脚本
└── zclaw-runtime/
├── zclaw.exe # 57MB ZCLAW 二进制
├── zclaw.cmd # Windows 启动脚本
├── zclaw.sh # Unix 启动脚本
└── runtime-manifest.json
```
### 运行时解析优先级
1. `ZCLAW_OPENFANG_BIN` 环境变量
2. 打包的 `openfang-runtime/` 目录
3. 系统 PATH (`openfang`)
1. `ZCLAW_BIN` 环境变量
2. 打包的 `zclaw-runtime/` 目录
3. 系统 PATH (`zclaw`)
### 端点和协议
| 项目 | OpenClaw (旧) | OpenFang (新) |
| 项目 | ZCLAW (旧) | ZCLAW (新) |
|------|---------------|---------------|
| WebSocket | `ws://127.0.0.1:18789` | `ws://127.0.0.1:4200/ws` |
| REST API | 无 | `http://127.0.0.1:4200/api` |
| 配置格式 | JSON | TOML |
| 配置目录 | `~/.openclaw/` | `~/.openfang/` |
| 配置目录 | `~/.zclaw/` | `~/.zclaw/` |
---
@@ -122,7 +122,7 @@ pnpm vitest run tests/desktop/gatewayStore.test.ts
### Mock Server
Mock Server (`tests/fixtures/openfang-mock-server.ts`) 提供:
Mock Server (`tests/fixtures/zclaw-mock-server.ts`) 提供:
- **REST API**: 所有 `/api/*` 端点
- **WebSocket**: `/ws` 路径握手
@@ -133,12 +133,12 @@ Mock Server (`tests/fixtures/openfang-mock-server.ts`) 提供:
## 下一步工作
### 优先级 1: 真实 OpenFang 集成测试
### 优先级 1: 真实 ZCLAW 集成测试
```bash
# 1. 启动 OpenFang
cd desktop/src-tauri/resources/openfang-runtime
./openfang.exe gateway start
# 1. 启动 ZCLAW
cd desktop/src-tauri/resources/zclaw-runtime
./zclaw.exe gateway start
# 2. 运行 Tauri 开发模式
pnpm tauri:dev
@@ -151,7 +151,7 @@ pnpm tauri:dev
### 优先级 2: 插件迁移 (chinese-writing)
`plugins/zclaw-chinese-models` 中的模型配置迁移到 OpenFang TOML 格式。
`plugins/zclaw-chinese-models` 中的模型配置迁移到 ZCLAW TOML 格式。
参考: `config/chinese-providers.toml`
@@ -163,11 +163,11 @@ pnpm tauri:dev
# 开发
pnpm tauri:dev
# 生产构建 (自动下载 OpenFang)
# 生产构建 (自动下载 ZCLAW)
pnpm tauri:build:bundled
# 手动准备运行时
pnpm prepare:openfang-runtime
pnpm prepare:zclaw-runtime
```
---
@@ -175,22 +175,22 @@ pnpm prepare:openfang-runtime
## 参考文档
- 迁移计划: `plans/immutable-imagining-naur.md`
- OpenFang 技术参考: `docs/openfang-technical-reference.md`
- 运行时 README: `desktop/src-tauri/resources/openfang-runtime/README.md`
- OpenFang GitHub: https://github.com/RightNow-AI/openfang
- ZCLAW 技术参考: `docs/zclaw-technical-reference.md`
- 运行时 README: `desktop/src-tauri/resources/zclaw-runtime/README.md`
- ZCLAW GitHub: https://github.com/RightNow-AI/zclaw
---
## 新会话提示词模板
```
我正在开发 ZClaw Desktop一个从 OpenClaw 迁移到 OpenFang 的 AI Agent 桌面客户端。
我正在开发 ZClaw Desktop一个从 ZCLAW 迁移到 ZCLAW 的 AI Agent 桌面客户端。
当前状态:
- Phase 1-7 基本完成
- 63 个测试全部通过
- Mock Server 集成测试可用
请阅读 docs/new-session-prompt-openfang-migration.md 了解详细上下文,然后继续以下工作:
请阅读 docs/new-session-prompt-zclaw-migration.md 了解详细上下文,然后继续以下工作:
[具体任务]
```