From 67e1da635d56f141fc9d26b50fc73edbf2288ffc Mon Sep 17 00:00:00 2001 From: iven Date: Fri, 13 Mar 2026 18:04:53 +0800 Subject: [PATCH] docs: add new session prompt for OpenFang migration Co-Authored-By: Claude Opus 4.6 --- docs/new-session-prompt-openfang-migration.md | 161 ++++++++++++++++++ 1 file changed, 161 insertions(+) create mode 100644 docs/new-session-prompt-openfang-migration.md diff --git a/docs/new-session-prompt-openfang-migration.md b/docs/new-session-prompt-openfang-migration.md new file mode 100644 index 0000000..c79a88f --- /dev/null +++ b/docs/new-session-prompt-openfang-migration.md @@ -0,0 +1,161 @@ +# ZClaw OpenFang 迁移 - 新会话提示词 + +> **更新日期**: 2026-03-13 +> **状态**: Phase 1-2 基础设施已完成，继续 Phase 3-7 + +--- + +## 当前状态 + +### ✅ 已完成 + +1. **OpenFang 打包架构** (Phase 1-2) + - 创建 `prepare-openfang-runtime.mjs` 跨平台下载脚本 + - 更新 Rust `lib.rs` 支持二进制运行时 + - 配置 Tauri 打包 `resources/openfang-runtime/` + - 验证构建成功 + +2. **OpenFang 特性 UI 组件** + - `HandsPanel.tsx` - Hands 管理界面 + - `WorkflowList.tsx` - 工作流列表 + - `SecurityStatus.tsx` - 16层安全状态 + - `TriggersPanel.tsx` - 触发器管理 + - `AuditLogsPanel.tsx` - 审计日志 + +3. **状态管理更新** + - `gatewayStore.ts` 添加 OpenFang 类型定义 + - `gateway-config.ts` 配置管理 + +### 🔄 进行中 + +- **OpenFangClient 实现**: 需要完成 WebSocket 客户端适配 OpenFang 协议 + +### 📋 待完成 (Phase 3-7) + +| Phase | 任务 | 状态 | +|-------|------|------| +| Phase 3 | 状态迁移 (gatewayStore 适配) | 待开始 | +| Phase 4 | 插件迁移 (zclaw-*) | 待开始 | +| Phase 5 | Tauri 后端完善 | 待开始 | +| Phase 6 | UI 增强 (Hands/Workflow) | 待开始 | +| Phase 7 | 测试验证 | 待开始 | + +--- + +## 关键架构 + +### 打包结构 + +``` +ZClaw-Desktop-Setup.exe +├── desktop.exe # Tauri 应用 +└── resources/ + └── openfang-runtime/ + ├── openfang.exe # 57MB OpenFang 二进制 + ├── openfang.cmd # Windows 启动脚本 + ├── openfang.sh # Unix 启动脚本 + └── runtime-manifest.json +``` + +### 运行时解析优先级 + +1. `ZCLAW_OPENFANG_BIN` 环境变量 +2. 打包的 `openfang-runtime/` 目录 +3. 系统 PATH (`openfang`) + +### 端点和协议 + +| 项目 | OpenClaw (旧) | OpenFang (新) | +|------|---------------|---------------| +| 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/` | + +--- + +## 下一步工作 + +### 优先级 1: OpenFangClient 实现 + +文件: `desktop/src/lib/openfang-client.ts` + +```typescript +// 需要实现 +class OpenFangClient implements GatewayBackend { + private ws: WebSocket; + private url = 'ws://127.0.0.1:4200/ws'; + + async connect(): Promise { /* OpenFang 认证协议 */ } + async chat(message: string, opts?: ChatOptions): Promise<{runId: string}> { /* chat 格式 */ } + onStream(callback: StreamCallback): () => void { /* 流式事件 */ } +} +``` + +### 优先级 2: gatewayStore 适配 + +文件: `desktop/src/store/gatewayStore.ts` + +```typescript +// 添加后端切换 +interface GatewayStore { + backendType: 'openclaw' | 'openfang'; + switchBackend(type: 'openclaw' | 'openfang'): void; +} +``` + +### 优先级 3: 测试 OpenFang 集成 + +```bash +# 1. 启动 OpenFang +cd desktop/src-tauri/resources/openfang-runtime +./openfang.exe gateway start + +# 2. 运行 Tauri 开发模式 +pnpm tauri:dev + +# 3. 验证连接 +# - WebSocket 连接到 4200 端口 +# - 消息发送和接收 +# - Hands/Workflow 功能 +``` + +--- + +## 构建命令 + +```bash +# 开发 +pnpm tauri:dev + +# 生产构建 (自动下载 OpenFang) +pnpm tauri:build:bundled + +# 手动准备运行时 +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 Desktop，一个从 OpenClaw 迁移到 OpenFang 的 AI Agent 桌面客户端。 + +当前状态: +- OpenFang 打包架构已完成 +- UI 组件已创建 (Hands, Workflow, Security) +- 需要继续: OpenFangClient 实现、状态迁移、插件迁移 + +请阅读 docs/new-session-prompt-openfang-migration.md 了解详细上下文，然后继续以下工作: +[具体任务] +```