zclaw_openfang/docs/knowledge-base/feature-checklist.md

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