07079293f4
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>
318 lines
10 KiB
Markdown
318 lines
10 KiB
Markdown
# ZCLAW Desktop 功能清单
|
||
|
||
> 列出所有功能模块，逐一验证完整性和可用性。
|
||
|
||
**验证日期**: 2026-03-14
|
||
**验证环境**: Windows 11, OpenFang 0.4.0, Tauri Desktop
|
||
|
||
---
|
||
|
||
## 1. 核心聊天功能
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| 发送消息 | `ChatArea.tsx` | ✅ 通过 | REST API 已验证 |
|
||
| 流式响应 | `chatStore.ts` | ✅ 通过 | WebSocket text_delta 已验证 |
|
||
| 对话历史 | `ConversationList.tsx` | ⚠️ UI待验证 | localStorage 持久化 |
|
||
| Agent 切换 | `CloneManager.tsx` | ✅ 通过 | 10 个 Agent 可用 |
|
||
| 新建对话 | `ChatArea.tsx` | ⚠️ UI待验证 | 需手动验证 |
|
||
|
||
## 2. 分身管理 (Agents/Clones)
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| 分身列表 | `CloneManager.tsx` | ✅ 通过 | API 返回 10 个 Agent |
|
||
| 创建分身 | `CloneManager.tsx` | ⚠️ UI待验证 | API 支持 |
|
||
| 编辑分身 | `RightPanel.tsx` | ⚠️ UI待验证 | API 支持 |
|
||
| 删除分身 | `CloneManager.tsx` | ⚠️ UI待验证 | API 支持 |
|
||
|
||
## 3. IM 频道
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| 频道列表 | `ChannelList.tsx` | ✅ 通过 | API 返回 40 个频道 |
|
||
| 飞书集成 | `Settings/IMChannels.tsx` | ⚠️ 未配置 | 需配置 API Key |
|
||
| 频道连接 | `gatewayStore.ts` | ⚠️ UI待验证 | 需手动验证 |
|
||
|
||
## 4. 定时任务
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| 任务列表 | `TaskList.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 |
|
||
| 任务状态 | `gatewayStore.ts` | ❌ API 404 | OpenFang 0.4.0 未实现 |
|
||
|
||
## 5. OpenFang 特有功能
|
||
|
||
### 5.1 Hands 面板
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| Hands 列表 | `HandList.tsx` | ✅ 通过 | 左侧导航显示 8 个 Hands |
|
||
| Hand 任务面板 | `HandTaskPanel.tsx` | ✅ 通过 | 中间区域显示任务和结果 |
|
||
| 触发 Hand | `HandTaskPanel.tsx` | ⚠️ UI待验证 | 6 个 requirements_met=true |
|
||
| 审批流程 | `HandsPanel.tsx` | ⚠️ UI待验证 | 需手动验证 |
|
||
| 取消执行 | `gateway-client.ts` | ⚠️ UI待验证 | API 已实现 |
|
||
|
||
> **更新 (2026-03-14)**: Hands UI 已重构：
|
||
> - 左侧 Sidebar 显示 `HandList` 组件
|
||
> - 中间区域显示 `HandTaskPanel` 组件
|
||
> - 右侧面板已移除 Hands 标签
|
||
> - 所有 UI 文本已中文化
|
||
|
||
### 5.2 Workflows
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| Workflow 列表 | `WorkflowList.tsx` | ✅ 通过 | API 返回空数组 (无配置) |
|
||
| 执行 Workflow | `RightPanel.tsx` | ⚠️ 无数据 | 无可用 Workflow |
|
||
|
||
### 5.3 Triggers
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| Trigger 列表 | `TriggersPanel.tsx` | ✅ 通过 | API 返回空数组 (无配置) |
|
||
| 启用/禁用 | `TriggersPanel.tsx` | ⚠️ 无数据 | 无可用 Trigger |
|
||
|
||
### 5.4 审计日志
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| 日志列表 | `AuditLogsPanel.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 |
|
||
| 刷新日志 | `AuditLogsPanel.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 |
|
||
|
||
### 5.5 安全状态
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| 安全层显示 | `SecurityStatus.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 |
|
||
| 安全等级 | `SecurityStatus.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 |
|
||
|
||
## 6. 设置页面
|
||
|
||
### 6.1 通用设置
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| Gateway 连接 | `Settings/General.tsx` | ✅ 通过 | 连接状态正确显示 |
|
||
| 后端切换 | `Settings/General.tsx` | ⚠️ UI待验证 | OpenClaw/OpenFang 切换 |
|
||
| 主题切换 | `Settings/General.tsx` | ⚠️ UI待验证 | 深色/浅色 |
|
||
| 开机自启 | `Settings/General.tsx` | ⚠️ UI待验证 | Tauri 专用 |
|
||
|
||
### 6.2 模型与 API
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| 模型选择 | `Settings/ModelsAPI.tsx` | ⚠️ UI待验证 | 多个提供商可用 |
|
||
| API Key 管理 | `Settings/ModelsAPI.tsx` | ⚠️ UI待验证 | .env 配置 |
|
||
|
||
### 6.3 其他设置
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| 技能目录 | `Settings/Skills.tsx` | ✅ 通过 | API 返回空 (无配置) |
|
||
| MCP 服务 | `Settings/MCPServices.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 |
|
||
| 工作区配置 | `Settings/Workspace.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 |
|
||
| 隐私设置 | `Settings/Privacy.tsx` | ⚠️ UI待验证 | UI 存在 |
|
||
| 用量统计 | `Settings/UsageStats.tsx` | ✅ 通过 | API 返回 Agent 统计 |
|
||
| 关于页面 | `Settings/About.tsx` | ✅ 通过 | 显示版本 0.2.0 |
|
||
|
||
## 7. 右侧面板
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| 连接状态 | `RightPanel.tsx` | ✅ 通过 | 显示 connected |
|
||
| 运行时信息 | `RightPanel.tsx` | ✅ 通过 | 版本 0.4.0 |
|
||
| 会话统计 | `RightPanel.tsx` | ⚠️ UI待验证 | 需手动验证 |
|
||
|
||
## 8. 侧边栏
|
||
|
||
| 功能 | 组件位置 | 验证状态 | 说明 |
|
||
|------|----------|----------|------|
|
||
| 分身 Tab | `Sidebar.tsx` | ⚠️ UI待验证 | 需手动验证 |
|
||
| Hands Tab | `Sidebar.tsx` | ✅ 通过 | 显示 `HandList` 组件 |
|
||
| Workflow Tab | `Sidebar.tsx` | ⚠️ UI待验证 | 显示 `TaskList` 组件 |
|
||
| 设置入口 | `Sidebar.tsx` | ⚠️ UI待验证 | 需手动验证 |
|
||
|
||
> **更新 (2026-03-14)**: Sidebar 已重构：
|
||
> - Tab 从 "分身/IM/任务" 改为 "分身/HANDS/Workflow"
|
||
> - Hands Tab 使用 `HandList` 组件显示自主能力包
|
||
> - IM 频道功能移至设置页面
|
||
|
||
---
|
||
|
||
## 验证结果汇总
|
||
|
||
| 类别 | 总数 | 通过 | 部分通过 | 失败 | 待UI验证 |
|
||
|------|------|------|----------|------|----------|
|
||
| 核心聊天 | 5 | 2 | 0 | 0 | 3 |
|
||
| 分身管理 | 4 | 1 | 0 | 0 | 3 |
|
||
| IM 频道 | 3 | 1 | 0 | 0 | 2 |
|
||
| 定时任务 | 2 | 0 | 0 | 2 | 0 |
|
||
| Hands | 4 | 1 | 0 | 0 | 3 |
|
||
| Workflows | 2 | 1 | 0 | 0 | 1 |
|
||
| Triggers | 2 | 1 | 0 | 0 | 1 |
|
||
| 审计日志 | 2 | 0 | 0 | 2 | 0 |
|
||
| 安全状态 | 2 | 0 | 0 | 2 | 0 |
|
||
| 设置页面 | 12 | 3 | 0 | 3 | 6 |
|
||
| 右侧面板 | 3 | 2 | 0 | 0 | 1 |
|
||
| 侧边栏 | 4 | 0 | 0 | 1 | 3 |
|
||
| **总计** | **45** | **12** | **0** | **10** | **23** |
|
||
|
||
---
|
||
|
||
## 验证方法
|
||
|
||
1. **API 测试**: 通过 curl/Node.js 直接测试后端 API
|
||
2. **UI 验证**: 在 Tauri 窗口中手动操作验证
|
||
3. **状态检查**: 检查 Zustand store 状态变化
|
||
|
||
---
|
||
|
||
## 图例
|
||
|
||
- ✅ 通过 - 功能完整可用
|
||
- ⚠️ 部分通过 - 基本功能可用，有已知问题
|
||
- ❌ 失败 - 功能不可用或严重 bug
|
||
- ⏳ 待验证 - 尚未测试
|
||
|
||
---
|
||
|
||
## 关键发现
|
||
|
||
### API 已验证功能
|
||
|
||
| API 端点 | 状态 | 返回数据 |
|
||
|----------|------|----------|
|
||
| `/api/health` | ✅ | `{status: "ok", version: "0.4.0"}` |
|
||
| `/api/agents` | ✅ | 10 个 Agent |
|
||
| `/api/hands` | ✅ | 8 个 Hands (6 个就绪) |
|
||
| `/api/channels` | ✅ | 40 个频道 |
|
||
| `/api/usage` | ✅ | Agent 统计数据 |
|
||
| `/api/workflows` | ✅ | 空数组 (无配置) |
|
||
| `/api/triggers` | ✅ | 空数组 (无配置) |
|
||
| `/api/skills` | ✅ | 空数组 (无配置) |
|
||
| `/api/config` | ✅ | 配置信息 |
|
||
| `/api/status` | ✅ | 运行状态 |
|
||
|
||
### WebSocket 流式聊天验证
|
||
|
||
| 验证项 | 状态 |
|
||
|--------|------|
|
||
| 连接成功 | ✅ |
|
||
| connected 事件 | ✅ |
|
||
| typing 事件 | ✅ |
|
||
| phase 事件 | ✅ |
|
||
| text_delta 事件 | ✅ |
|
||
| response 事件 | ✅ |
|
||
|
||
### OpenFang 0.4.0 未实现的 API
|
||
|
||
以下 API 返回 404，在当前版本中不可用：
|
||
|
||
- `/api/tasks` - 定时任务
|
||
- `/api/audit/logs` - 审计日志
|
||
- `/api/security/status` - 安全状态
|
||
- `/api/plugins` - 插件管理
|
||
- `/api/workspace` - 工作区配置
|
||
|
||
---
|
||
|
||
## 建议优先级
|
||
|
||
### P0 - 核心功能 (必须验证)
|
||
|
||
1. ✅ 流式聊天 - 已验证
|
||
2. ⚠️ 对话历史 - 需 UI 验证
|
||
3. ⚠️ Agent 切换 - 需 UI 验证
|
||
|
||
### P1 - 重要功能
|
||
|
||
1. ⚠️ Hands 触发 - 需 UI 验证
|
||
2. ⚠️ 设置页面 - 需 UI 验证
|
||
3. ⚠️ IM 频道 - 需配置后验证
|
||
|
||
### P2 - 可延后
|
||
|
||
1. ❌ 定时任务 - OpenFang 未实现
|
||
2. ❌ 审计日志 - OpenFang 未实现
|
||
3. ❌ 安全状态 - OpenFang 未实现
|
||
|
||
---
|
||
|
||
## 手动 UI 验证清单
|
||
|
||
请在 Tauri 桌面窗口中进行以下测试：
|
||
|
||
### 聊天功能
|
||
- [ ] 发送消息，验证流式响应显示
|
||
- [ ] 创建新对话
|
||
- [ ] 切换对话
|
||
- [ ] 删除对话
|
||
|
||
### 分身管理
|
||
- [ ] 查看 10 个 Agent
|
||
- [ ] 切换 Agent
|
||
- [ ] 编辑 Agent 名称
|
||
|
||
### Hands 面板
|
||
- [ ] 查看 8 个 Hands
|
||
- [ ] 触发一个 requirements_met=true 的 Hand
|
||
- [ ] 验证审批流程
|
||
|
||
### 设置页面
|
||
- [ ] 验证后端切换 (OpenClaw/OpenFang)
|
||
- [ ] 验证主题切换
|
||
- [ ] 查看用量统计
|
||
|
||
---
|
||
|
||
## 更新历史
|
||
|
||
| 日期 | 变更 |
|
||
|------|------|
|
||
| 2026-03-14 | Hands UI 重构：新增 `HandList.tsx`、`HandTaskPanel.tsx`，移除右侧 Hands 标签 |
|
||
| 2026-03-14 | 初始版本，完成 API 级别验证 |
|
||
| 2026-03-14 | 完成 Web 前端验证 (Vite 代理测试) |
|
||
|
||
---
|
||
|
||
## Web 前端验证结果 (2026-03-14)
|
||
|
||
### 前端资源加载
|
||
|
||
| 验证项 | 状态 |
|
||
|--------|------|
|
||
| HTML 加载 | ✅ 200 OK |
|
||
| React 引用 | ✅ |
|
||
| Root 节点 | ✅ |
|
||
| Script 标签 | ✅ |
|
||
|
||
### API 代理测试 (通过 Vite)
|
||
|
||
| API 端点 | 状态 | 说明 |
|
||
|----------|------|------|
|
||
| `/api/health` | ✅ 200 | 健康检查 |
|
||
| `/api/agents` | ✅ 200 | Agent 列表 |
|
||
| `/api/hands` | ✅ 200 | Hands 列表 |
|
||
| `/api/channels` | ✅ 200 | 频道列表 |
|
||
| `/api/status` | ✅ 200 | 系统状态 |
|
||
| `/api/usage` | ✅ 200 | 用量统计 |
|
||
| `/api/config` | ✅ 200 | 配置信息 |
|
||
| `/api/workflows` | ✅ 200 | Workflows |
|
||
| `/api/triggers` | ✅ 200 | Triggers |
|
||
| `/api/skills` | ✅ 200 | Skills |
|
||
|
||
### WebSocket 代理测试
|
||
|
||
| 验证项 | 状态 |
|
||
|--------|------|
|
||
| 代理连接 | ✅ |
|
||
| 消息发送 | ✅ |
|
||
| 流式响应 | ✅ |
|
||
|
||
### 访问地址
|
||
|
||
- **Web 前端**: http://localhost:1420
|
||
- **API 基础路径**: http://localhost:1420/api
|
||
- **WebSocket**: ws://localhost:1420/api/agents/{agentId}/ws
|