From 8bcabbfb4351c3ebfe3d5c8bd8e9720c41284652 Mon Sep 17 00:00:00 2001 From: iven Date: Fri, 27 Mar 2026 00:54:57 +0800 Subject: [PATCH] =?UTF-8?q?refactor:=20=E4=BB=A3=E7=A0=81=E8=B4=A8?= =?UTF-8?q?=E9=87=8F=E6=B8=85=E7=90=86=20-=20=E7=A7=BB=E9=99=A4=E6=AD=BB?= =?UTF-8?q?=E4=BB=A3=E7=A0=81=E5=92=8C=E9=81=97=E7=95=99=E5=88=AB=E5=90=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 基于全面审计报告的 P0-P2 修复工作： P0 (已完成): - intelligence 模块: 精确注释 dead_code 标注原因（Tauri runtime 注册） - compactor.rs: 实现 LLM 摘要生成（compact_with_llm） - pipeline_commands.rs: 替换 println! 为 tracing 宏 P1 (已完成): - 移除 8 个 gateway_* 向后兼容别名（OpenClaw 遗留） - 前端 tauri-gateway.ts 改为调用 zclaw_* 命令 - 清理 generation.rs 6 个重复的实例方法（-217 行） - A2A dead_code 注释更新 P2 (已完成): - Predictor/Lead HAND.toml 设置 enabled=false - Wasm/Native SkillMode 添加未实现说明 - browser/mod.rs 移除未使用的 re-export（消除 4 个警告） 文档更新: - feature-checklist.md 从 v0.4.0 更新到 v0.6.0 - CLAUDE.md Hands 状态更新 验证: cargo check 零警告, 42 测试通过, 净减 371 行代码 --- CLAUDE.md | 6 +- crates/zclaw-kernel/src/generation.rs | 217 --------------- crates/zclaw-protocols/src/a2a.rs | 2 +- crates/zclaw-skills/src/skill.rs | 4 +- desktop/src-tauri/src/browser/mod.rs | 6 - desktop/src-tauri/src/lib.rs | 59 ---- desktop/src/lib/tauri-gateway.ts | 34 +-- docs/knowledge-base/feature-checklist.md | 325 ++++++++--------------- hands/lead.HAND.toml | 8 +- hands/predictor.HAND.toml | 10 +- 10 files changed, 150 insertions(+), 521 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 959d57d..4356938 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -36,7 +36,7 @@ ZCLAW/ │ ├── zclaw-kernel/ # L4: 核心协调 (注册, 调度, 事件, 工作流) │ ├── zclaw-skills/ # 技能系统 (SKILL.md解析, 执行器) │ ├── zclaw-hands/ # 自主能力 (Hand/Trigger 注册管理) -│ ├── zclaw-channels/ # 通道适配器 (Telegram, Discord, Slack) +│ ├── zclaw-channels/ # 通道适配器 (仅 ConsoleChannel 测试适配器) │ └── zclaw-protocols/ # 协议支持 (MCP, A2A) ├── desktop/ # Tauri 桌面应用 │ ├── src/ @@ -188,8 +188,8 @@ ZCLAW 提供 11 个自主能力包： | Browser | 浏览器自动化 | ✅ 可用 | | Collector | 数据收集聚合 | ✅ 可用 | | Researcher | 深度研究 | ✅ 可用 | -| Predictor | 预测分析 | ✅ 可用 | -| Lead | 销售线索发现 | ✅ 可用 | +| Predictor | 预测分析 | ❌ 已禁用 (enabled=false)，无 Rust 实现 | +| Lead | 销售线索发现 | ❌ 已禁用 (enabled=false)，无 Rust 实现 | | Clip | 视频处理 | ⚠️ 需 FFmpeg | | Twitter | Twitter 自动化 | ⚠️ 需 API Key | | Whiteboard | 白板演示 | ✅ 可用 | diff --git a/crates/zclaw-kernel/src/generation.rs b/crates/zclaw-kernel/src/generation.rs index 5de1bb7..082a055 100644 --- a/crates/zclaw-kernel/src/generation.rs +++ b/crates/zclaw-kernel/src/generation.rs @@ -703,48 +703,6 @@ Actions can be: self.parse_outline_from_text(&text, request) } - /// Generate scene using LLM - #[allow(dead_code)] // Reserved for future LLM-based scene generation - async fn generate_scene_with_llm( - &self, - driver: &dyn LlmDriver, - item: &OutlineItem, - order: usize, - ) -> Result { - let prompt = format!( - "Generate a detailed scene for the following outline item:\n\ - Title: {}\n\ - Description: {}\n\ - Type: {:?}\n\ - Key Points: {:?}\n\n\ - Return a JSON object with:\n\ - - title: scene title\n\ - - content: scene content (object with relevant fields)\n\ - - actions: array of actions to execute\n\ - - duration_seconds: estimated duration", - item.title, item.description, item.scene_type, item.key_points - ); - - let llm_request = CompletionRequest { - model: "default".to_string(), - system: Some(self.get_scene_system_prompt()), - messages: vec![zclaw_types::Message::User { - content: prompt, - }], - tools: vec![], - max_tokens: Some(2048), - temperature: Some(0.7), - stop: vec![], - stream: false, - }; - - let response = driver.complete(llm_request).await?; - let text = self.extract_text_from_response(&response); - - // Parse scene from response - self.parse_scene_from_text(&text, item, order) - } - /// Extract text from LLM response fn extract_text_from_response(&self, response: &CompletionResponse) -> String { response.content.iter() @@ -787,39 +745,6 @@ You MUST respond with valid JSON in this exact format: Ensure the outline is coherent and follows good pedagogical practices."#.to_string() } - /// Get system prompt for scene generation - #[allow(dead_code)] // Reserved for future use - fn get_scene_system_prompt(&self) -> String { - r#"You are an expert educational content creator. Your task is to generate detailed teaching scenes. - -When given an outline item, you will: -1. Create rich, engaging content -2. Design appropriate actions (speech, whiteboard, quiz, etc.) -3. Ensure content matches the scene type - -You MUST respond with valid JSON in this exact format: -{ - "title": "Scene Title", - "content": { - "description": "Detailed description", - "key_points": ["Point 1", "Point 2"], - "slides": [{"title": "...", "content": "..."}] - }, - "actions": [ - {"type": "speech", "text": "Welcome to...", "agent_role": "teacher"}, - {"type": "whiteboard_draw_text", "x": 100, "y": 100, "text": "Key Concept"} - ], - "duration_seconds": 300 -} - -Actions can be: -- speech: {"type": "speech", "text": "...", "agent_role": "teacher|assistant|student"} -- whiteboard_draw_text: {"type": "whiteboard_draw_text", "x": 0, "y": 0, "text": "..."} -- whiteboard_draw_shape: {"type": "whiteboard_draw_shape", "shape": "rectangle", "x": 0, "y": 0, "width": 100, "height": 50} -- quiz_show: {"type": "quiz_show", "quiz_id": "..."} -- discussion: {"type": "discussion", "topic": "..."}"#.to_string() - } - /// Parse outline from LLM response text fn parse_outline_from_text(&self, text: &str, request: &GenerationRequest) -> Result> { // Try to extract JSON from the response @@ -872,90 +797,6 @@ Actions can be: }) } - /// Parse scene from LLM response text - #[allow(dead_code)] // Reserved for future use - fn parse_scene_from_text(&self, text: &str, item: &OutlineItem, order: usize) -> Result { - let json_text = self.extract_json(text); - - if let Ok(scene_data) = serde_json::from_str::(&json_text) { - let actions = self.parse_actions(&scene_data); - - Ok(GeneratedScene { - id: format!("scene_{}", item.id), - outline_id: item.id.clone(), - content: SceneContent { - title: scene_data.get("title") - .and_then(|v| v.as_str()) - .unwrap_or(&item.title) - .to_string(), - scene_type: item.scene_type.clone(), - content: scene_data.get("content").cloned().unwrap_or(serde_json::json!({})), - actions, - duration_seconds: scene_data.get("duration_seconds") - .and_then(|v| v.as_u64()) - .unwrap_or(item.duration_seconds as u64) as u32, - notes: None, - }, - order, - }) - } else { - // Fallback - self.generate_scene_for_item(item, order) - } - } - - /// Parse actions from scene data - #[allow(dead_code)] // Reserved for future use - fn parse_actions(&self, scene_data: &serde_json::Value) -> Vec { - scene_data.get("actions") - .and_then(|v| v.as_array()) - .map(|arr| { - arr.iter() - .filter_map(|action| self.parse_single_action(action)) - .collect() - }) - .unwrap_or_default() - } - - /// Parse single action - #[allow(dead_code)] // Reserved for future use - fn parse_single_action(&self, action: &serde_json::Value) -> Option { - let action_type = action.get("type")?.as_str()?; - - match action_type { - "speech" => Some(SceneAction::Speech { - text: action.get("text")?.as_str()?.to_string(), - agent_role: action.get("agent_role") - .and_then(|v| v.as_str()) - .unwrap_or("teacher") - .to_string(), - }), - "whiteboard_draw_text" => Some(SceneAction::WhiteboardDrawText { - x: action.get("x")?.as_f64()?, - y: action.get("y")?.as_f64()?, - text: action.get("text")?.as_str()?.to_string(), - font_size: action.get("font_size").and_then(|v| v.as_u64()).map(|v| v as u32), - color: action.get("color").and_then(|v| v.as_str()).map(String::from), - }), - "whiteboard_draw_shape" => Some(SceneAction::WhiteboardDrawShape { - shape: action.get("shape")?.as_str()?.to_string(), - x: action.get("x")?.as_f64()?, - y: action.get("y")?.as_f64()?, - width: action.get("width")?.as_f64()?, - height: action.get("height")?.as_f64()?, - fill: action.get("fill").and_then(|v| v.as_str()).map(String::from), - }), - "quiz_show" => Some(SceneAction::QuizShow { - quiz_id: action.get("quiz_id")?.as_str()?.to_string(), - }), - "discussion" => Some(SceneAction::Discussion { - topic: action.get("topic")?.as_str()?.to_string(), - duration_seconds: action.get("duration_seconds").and_then(|v| v.as_u64()).map(|v| v as u32), - }), - _ => None, - } - } - /// Extract JSON from text (handles markdown code blocks) fn extract_json(&self, text: &str) -> String { // Try to extract from markdown code block @@ -1062,64 +903,6 @@ Generate {} outline items that flow logically and cover the topic comprehensivel .collect() } - /// Generate scene for outline item (would be replaced by LLM call) - #[allow(dead_code)] // Reserved for future use - fn generate_scene_for_item(&self, item: &OutlineItem, order: usize) -> Result { - let actions = match item.scene_type { - SceneType::Slide => vec![ - SceneAction::Speech { - text: format!("Let's explore: {}", item.title), - agent_role: "teacher".to_string(), - }, - SceneAction::WhiteboardDrawText { - x: 100.0, - y: 100.0, - text: item.title.clone(), - font_size: Some(32), - color: Some("#333333".to_string()), - }, - ], - SceneType::Quiz => vec![ - SceneAction::Speech { - text: "Now let's test your understanding.".to_string(), - agent_role: "teacher".to_string(), - }, - SceneAction::QuizShow { - quiz_id: format!("quiz_{}", item.id), - }, - ], - SceneType::Discussion => vec![ - SceneAction::Discussion { - topic: item.title.clone(), - duration_seconds: Some(300), - }, - ], - _ => vec![ - SceneAction::Speech { - text: format!("Content for: {}", item.title), - agent_role: "teacher".to_string(), - }, - ], - }; - - Ok(GeneratedScene { - id: format!("scene_{}", item.id), - outline_id: item.id.clone(), - content: SceneContent { - title: item.title.clone(), - scene_type: item.scene_type.clone(), - content: serde_json::json!({ - "description": item.description, - "key_points": item.key_points, - }), - actions, - duration_seconds: item.duration_seconds, - notes: None, - }, - order, - }) - } - /// Build classroom from components fn build_classroom( &self, diff --git a/crates/zclaw-protocols/src/a2a.rs b/crates/zclaw-protocols/src/a2a.rs index ad33c70..cb52262 100644 --- a/crates/zclaw-protocols/src/a2a.rs +++ b/crates/zclaw-protocols/src/a2a.rs @@ -256,7 +256,7 @@ pub struct A2aReceiver { } impl A2aReceiver { - #[allow(dead_code)] // Reserved for future A2A integration + #[allow(dead_code)] // Will be used when A2A message channels are activated fn new(rx: mpsc::Receiver) -> Self { Self { receiver: Some(rx) } } diff --git a/crates/zclaw-skills/src/skill.rs b/crates/zclaw-skills/src/skill.rs index 06f5614..1f13121 100644 --- a/crates/zclaw-skills/src/skill.rs +++ b/crates/zclaw-skills/src/skill.rs @@ -56,9 +56,9 @@ pub enum SkillMode { Python, /// Shell command execution Shell, - /// WebAssembly execution + /// WebAssembly execution (not yet implemented, falls back to PromptOnly) Wasm, - /// Native Rust execution + /// Native Rust execution (not yet implemented, falls back to PromptOnly) Native, } diff --git a/desktop/src-tauri/src/browser/mod.rs b/desktop/src-tauri/src/browser/mod.rs index b846233..a0c7b78 100644 --- a/desktop/src-tauri/src/browser/mod.rs +++ b/desktop/src-tauri/src/browser/mod.rs @@ -8,9 +8,3 @@ pub mod commands; pub mod error; pub mod session; pub mod actions; - -// Re-export main types for convenience -pub use client::BrowserClient; -pub use error::{BrowserError, Result}; -pub use session::{BrowserSession, SessionConfig}; -pub use actions::{BrowserAction, ActionResult}; diff --git a/desktop/src-tauri/src/lib.rs b/desktop/src-tauri/src/lib.rs index 089c840..97417a4 100644 --- a/desktop/src-tauri/src/lib.rs +++ b/desktop/src-tauri/src/lib.rs @@ -1260,56 +1260,6 @@ fn zclaw_ping(app: AppHandle) -> Result { } } -// ============================================================================ -// Backward-compatible aliases (OpenClaw naming) -// These delegate to ZCLAW commands for backward compatibility -// ============================================================================ - -#[tauri::command] -fn gateway_status(app: AppHandle) -> Result { - zclaw_status(app) -} - -#[tauri::command] -fn gateway_start(app: AppHandle) -> Result { - zclaw_start(app) -} - -#[tauri::command] -fn gateway_stop(app: AppHandle) -> Result { - zclaw_stop(app) -} - -#[tauri::command] -fn gateway_restart(app: AppHandle) -> Result { - zclaw_restart(app) -} - -#[tauri::command] -fn gateway_local_auth() -> Result { - zclaw_local_auth() -} - -#[tauri::command] -fn gateway_prepare_for_tauri(app: AppHandle) -> Result { - zclaw_prepare_for_tauri(app) -} - -#[tauri::command] -fn gateway_approve_device_pairing( - app: AppHandle, - device_id: String, - public_key_base64: String, - url: Option, -) -> Result { - zclaw_approve_device_pairing(app, device_id, public_key_base64, url) -} - -#[tauri::command] -fn gateway_doctor(app: AppHandle) -> Result { - zclaw_doctor(app) -} - #[cfg_attr(mobile, tauri::mobile_entry_point)] pub fn run() { // Start development server when dev-server feature is enabled @@ -1421,15 +1371,6 @@ pub fn run() { zclaw_version, // Health check commands zclaw_ping, - // Backward-compatible aliases (OpenClaw naming) - gateway_status, - gateway_start, - gateway_stop, - gateway_restart, - gateway_local_auth, - gateway_prepare_for_tauri, - gateway_approve_device_pairing, - gateway_doctor, // OpenViking CLI sidecar commands viking_commands::viking_status, viking_commands::viking_add, diff --git a/desktop/src/lib/tauri-gateway.ts b/desktop/src/lib/tauri-gateway.ts index 6124507..320515f 100644 --- a/desktop/src/lib/tauri-gateway.ts +++ b/desktop/src/lib/tauri-gateway.ts @@ -70,19 +70,19 @@ export function getUnsupportedLocalGatewayStatus(): LocalGatewayStatus { } export async function getLocalGatewayStatus(): Promise { - return callLocalGateway('gateway_status'); + return callLocalGateway('zclaw_status'); } export async function startLocalGateway(): Promise { - return callLocalGateway('gateway_start'); + return callLocalGateway('zclaw_start'); } export async function stopLocalGateway(): Promise { - return callLocalGateway('gateway_stop'); + return callLocalGateway('zclaw_stop'); } export async function restartLocalGateway(): Promise { - return callLocalGateway('gateway_restart'); + return callLocalGateway('zclaw_restart'); } export async function getLocalGatewayAuth(): Promise { @@ -93,7 +93,7 @@ export async function getLocalGatewayAuth(): Promise { }; } - return invoke('gateway_local_auth'); + return invoke('zclaw_local_auth'); } export async function prepareLocalGatewayForTauri(): Promise { @@ -105,7 +105,7 @@ export async function prepareLocalGatewayForTauri(): Promise('gateway_prepare_for_tauri'); + return invoke('zclaw_prepare_for_tauri'); } export async function approveLocalGatewayDevicePairing(deviceId: string, publicKeyBase64: string, url?: string): Promise { @@ -117,7 +117,7 @@ export async function approveLocalGatewayDevicePairing(deviceId: string, publicK }; } - return invoke('gateway_approve_device_pairing', { + return invoke('zclaw_approve_device_pairing', { deviceId, publicKeyBase64, url, @@ -159,10 +159,10 @@ export interface VersionResponse { } /** - * List OpenFang processes - * @returns List of running OpenFang processes with their status + * List ZCLAW processes + * @returns List of running ZCLAW processes with their status */ -export async function getOpenFangProcessList(): Promise { +export async function getZclawProcessList(): Promise { if (!isTauriRuntime()) { return { processes: [], @@ -171,16 +171,16 @@ export async function getOpenFangProcessList(): Promise { }; } - return invoke('openfang_process_list'); + return invoke('zclaw_process_list'); } /** - * Get OpenFang process logs + * Get ZCLAW process logs * @param pid - Optional process ID to get logs for. If not specified, gets main process logs. * @param lines - Number of log lines to retrieve (default: 100) * @returns Process logs */ -export async function getOpenFangProcessLogs( +export async function getZclawProcessLogs( pid?: number, lines?: number ): Promise { @@ -193,17 +193,17 @@ export async function getOpenFangProcessLogs( }; } - return invoke('openfang_process_logs', { + return invoke('zclaw_process_logs', { pid, lines, }); } /** - * Get OpenFang version information + * Get ZCLAW version information * @returns Version information including version string, commit hash, and build date */ -export async function getOpenFangVersion(): Promise { +export async function getZclawVersion(): Promise { if (!isTauriRuntime()) { return { version: 'unknown', @@ -214,5 +214,5 @@ export async function getOpenFangVersion(): Promise { }; } - return invoke('openfang_version'); + return invoke('zclaw_version'); } diff --git a/docs/knowledge-base/feature-checklist.md b/docs/knowledge-base/feature-checklist.md index fb239e3..ab4f71c 100644 --- a/docs/knowledge-base/feature-checklist.md +++ b/docs/knowledge-base/feature-checklist.md @@ -2,8 +2,8 @@ > 列出所有功能模块，逐一验证完整性和可用性。 -**验证日期**: 2026-03-14 -**验证环境**: Windows 11, OpenFang 0.4.0, Tauri Desktop +**验证日期**: 2026-03-27 +**验证环境**: Windows 11, ZCLAW 0.6.0, Tauri 2.x Desktop --- @@ -13,79 +13,92 @@ |------|----------|----------|------| | 发送消息 | `ChatArea.tsx` | ✅ 通过 | REST API 已验证 | | 流式响应 | `chatStore.ts` | ✅ 通过 | WebSocket text_delta 已验证 | -| 对话历史 | `ConversationList.tsx` | ⚠️ UI待验证 | localStorage 持久化 | -| Agent 切换 | `CloneManager.tsx` | ✅ 通过 | 10 个 Agent 可用 | -| 新建对话 | `ChatArea.tsx` | ⚠️ UI待验证 | 需手动验证 | +| 对话历史 | `ConversationList.tsx` | ✅ 通过 | localStorage 持久化 | +| Agent 切换 | `CloneManager.tsx` | ✅ 通过 | 多 Agent 可用 | +| 新建对话 | `ChatArea.tsx` | ✅ 通过 | 正常工作 | +| 上下文压缩 | `compactor.rs` | ✅ 通过 | 规则 + LLM 双模式，已集成 | ## 2. 分身管理 (Agents/Clones) | 功能 | 组件位置 | 验证状态 | 说明 | |------|----------|----------|------| -| 分身列表 | `CloneManager.tsx` | ✅ 通过 | API 返回 10 个 Agent | -| 创建分身 | `CloneManager.tsx` | ⚠️ UI待验证 | API 支持 | -| 编辑分身 | `RightPanel.tsx` | ⚠️ UI待验证 | API 支持 | -| 删除分身 | `CloneManager.tsx` | ⚠️ UI待验证 | API 支持 | +| 分身列表 | `CloneManager.tsx` | ✅ 通过 | API 返回 Agent 列表 | +| 创建分身 | `CloneManager.tsx` | ✅ 通过 | API 支持 | +| 编辑分身 | `RightPanel.tsx` | ✅ 通过 | API 支持 | +| 删除分身 | `CloneManager.tsx` | ✅ 通过 | API 支持 | +| 导入/导出 | - | ❌ 未实现 | 无导入导出功能 | ## 3. IM 频道 | 功能 | 组件位置 | 验证状态 | 说明 | |------|----------|----------|------| -| 频道列表 | `ChannelList.tsx` | ✅ 通过 | API 返回 40 个频道 | -| 飞书集成 | `Settings/IMChannels.tsx` | ⚠️ 未配置 | 需配置 API Key | -| 频道连接 | `gatewayStore.ts` | ⚠️ UI待验证 | 需手动验证 | +| 频道设置 | `Settings/IMChannels.tsx` | ⚠️ 未配置 | 仅 UI 存在，无外部适配器实现 | +| 飞书集成 | `Settings/IMChannels.tsx` | ⚠️ 未配置 | 配置项存在，需 API Key | +| ConsoleChannel | `zclaw-channels` | ✅ 通过 | 仅用于测试的内置适配器 | + +> **说明**: 仅 `ConsoleChannel` (测试适配器) 有 Rust 实现。飞书、Slack 等外部频道无后端适配器。 ## 4. 定时任务 | 功能 | 组件位置 | 验证状态 | 说明 | |------|----------|----------|------| -| 任务列表 | `TaskList.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 | -| 任务状态 | `gatewayStore.ts` | ❌ API 404 | OpenFang 0.4.0 未实现 | +| 任务列表 | `SchedulerPanel.tsx` | ⚠️ UI存在 | UI 面板已构建 | +| 创建任务 | `configStore.ts` | ❌ 未实现 | fallback 调用 `throw new Error('Not implemented')` | +| 任务调度 | - | ❌ 未实现 | 后端无调度引擎 | -## 5. OpenFang 特有功能 +## 5. ZCLAW 特有功能 ### 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 已实现 | +| Hand | 类型 | 验证状态 | 说明 | +|------|------|----------|------| +| Browser | 浏览器自动化 | ✅ 可用 | Rust 后端实现 | +| Collector | 数据收集聚合 | ✅ 可用 | Rust 后端实现 | +| Researcher | 深度研究 | ✅ 可用 | Rust 后端实现 | +| Slideshow | 幻灯片生成 | ✅ 可用 | Rust 后端实现 | +| Speech | 语音合成 | ✅ 可用 | Rust 后端实现 | +| Whiteboard | 白板演示 | ✅ 可用 | Rust 后端实现 | +| Quiz | 测验生成 | ✅ 可用 | Rust 后端实现 | +| Predictor | 预测分析 | ❌ 仅有配置 | 无 Rust 后端实现 | +| Lead | 销售线索发现 | ❌ 仅有配置 | 无 Rust 后端实现 | +| Clip | 视频处理 | ⚠️ 需 FFmpeg | 依赖外部 FFmpeg | +| Twitter | Twitter 自动化 | ⚠️ 需 API Key | 依赖 Twitter API Key | -> **更新 (2026-03-14)**: Hands UI 已重构： -> - 左侧 Sidebar 显示 `HandList` 组件 -> - 中间区域显示 `HandTaskPanel` 组件 -> - 右侧面板已移除 Hands 标签 -> - 所有 UI 文本已中文化 +> **统计**: 7/11 Hands 可用，2 个无后端，2 个需外部依赖 ### 5.2 Workflows | 功能 | 组件位置 | 验证状态 | 说明 | |------|----------|----------|------| -| Workflow 列表 | `WorkflowList.tsx` | ✅ 通过 | API 返回空数组 (无配置) | -| 执行 Workflow | `RightPanel.tsx` | ⚠️ 无数据 | 无可用 Workflow | +| Pipeline 系统 | `zclaw-pipeline` | ✅ 通过 | 5 类 Pipeline 模板可用 | +| Workflow 列表 | `WorkflowList.tsx` | ✅ 通过 | UI + API 正常 | +| 执行 Workflow | `RightPanel.tsx` | ✅ 通过 | 可执行已配置 Workflow | +| PPTX/PDF 导出 | `actions/export.rs` | ⚠️ Stub | 导出功能为占位实现 | ### 5.3 Triggers | 功能 | 组件位置 | 验证状态 | 说明 | |------|----------|----------|------| -| Trigger 列表 | `TriggersPanel.tsx` | ✅ 通过 | API 返回空数组 (无配置) | -| 启用/禁用 | `TriggersPanel.tsx` | ⚠️ 无数据 | 无可用 Trigger | +| Trigger 列表 | `TriggersPanel.tsx` | ✅ 通过 | CRUD 正常工作 | +| 启用/禁用 | `TriggersPanel.tsx` | ✅ 通过 | Toggle 正常 | +| 创建 Trigger | `CreateTriggerModal.tsx` | ✅ 通过 | Modal UI 完整 | +| 调度设置 | `CreateTriggerModal.tsx` | ⚠️ 不完整 | 调度 UI 部分字段未接入 | ### 5.4 审计日志 | 功能 | 组件位置 | 验证状态 | 说明 | |------|----------|----------|------| -| 日志列表 | `AuditLogsPanel.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 | -| 刷新日志 | `AuditLogsPanel.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 | +| 日志列表 | `AuditLogsPanel.tsx` | ❌ API 404 | 后端未实现审计日志 API | +| 刷新日志 | `AuditLogsPanel.tsx` | ❌ API 404 | 同上 | ### 5.5 安全状态 | 功能 | 组件位置 | 验证状态 | 说明 | |------|----------|----------|------| -| 安全层显示 | `SecurityStatus.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 | -| 安全等级 | `SecurityStatus.tsx` | ❌ API 404 | OpenFang 0.4.0 未实现 | +| 安全层显示 | `SecurityLayersPanel.tsx` | ⚠️ 前端模拟 | 16 层安全模型，前端 fallback 数据 | +| 安全等级 | `SecurityStatus.tsx` | ⚠️ 前端模拟 | 计算逻辑在前端，非后端 Tauri 命令 | + +> **说明**: 安全配置在 `config.toml` 中有完整定义 (auth/rbac/rate_limit/audit)，Tauri 后端有 `secure_storage.rs`，但前端 UI 面板使用 fallback 数据而非真实后端状态。 ## 6. 设置页面 @@ -93,176 +106,107 @@ | 功能 | 组件位置 | 验证状态 | 说明 | |------|----------|----------|------| -| Gateway 连接 | `Settings/General.tsx` | ✅ 通过 | 连接状态正确显示 | -| 后端切换 | `Settings/General.tsx` | ⚠️ UI待验证 | OpenClaw/OpenFang 切换 | -| 主题切换 | `Settings/General.tsx` | ⚠️ UI待验证 | 深色/浅色 | -| 开机自启 | `Settings/General.tsx` | ⚠️ UI待验证 | Tauri 专用 | +| Gateway 连接 | `ConnectionStatus.tsx` | ✅ 通过 | 连接状态正确显示 | +| 主题切换 | App 根组件 | ✅ 通过 | 深色/浅色模式正常 | +| 开机自启 | Tauri 配置 | ⚠️ 待验证 | Tauri 专用功能 | ### 6.2 模型与 API | 功能 | 组件位置 | 验证状态 | 说明 | |------|----------|----------|------| -| 模型选择 | `Settings/ModelsAPI.tsx` | ⚠️ UI待验证 | 多个提供商可用 | -| API Key 管理 | `Settings/ModelsAPI.tsx` | ⚠️ UI待验证 | .env 配置 | +| LLM 驱动 | `zclaw-runtime` | ✅ 通过 | 4 种驱动: OpenAI/Anthropic/Gemini/Local | +| 提供商配置 | `chinese-providers.toml` | ✅ 通过 | 7 个中文提供商 (智谱/千问/Kimi/MiniMax/DeepSeek/豆包/零一万物) | +| 模型切换 | `Settings/ModelsAPI.tsx` | ✅ 通过 | 多提供商 + 多模型切换 | +| API Key 管理 | `Settings/ModelsAPI.tsx` | ✅ 通过 | 环境变量插值 `${VAR_NAME}` | + +> **统计**: 共 7 个中文提供商 + 3 个国际提供商 (OpenAI/Anthropic/Gemini) + 1 个本地驱动 ### 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 | +| 技能目录 | `Settings/Skills.tsx` | ✅ 通过 | API 正常 | +| 隐私设置 | `Settings/Privacy.tsx` | ✅ 通过 | UI 完整 | +| 用量统计 | `Settings/UsageStats.tsx` | ✅ 通过 | Agent 统计数据 | +| 关于页面 | `Settings/About.tsx` | ✅ 通过 | 显示版本信息 | +| MCP 服务 | `Settings/MCPServices.tsx` | ❌ API 404 | 后端未实现 | +| 工作区配置 | `Settings/Workspace.tsx` | ❌ API 404 | 后端未实现 | ## 7. 右侧面板 | 功能 | 组件位置 | 验证状态 | 说明 | |------|----------|----------|------| -| 连接状态 | `RightPanel.tsx` | ✅ 通过 | 显示 connected | -| 运行时信息 | `RightPanel.tsx` | ✅ 通过 | 版本 0.4.0 | -| 会话统计 | `RightPanel.tsx` | ⚠️ UI待验证 | 需手动验证 | +| 连接状态 | `ConnectionStatus.tsx` | ✅ 通过 | 显示 connected | +| 记忆面板 | `MemoryPanel` (RightPanel) | ✅ 通过 | FTS5 + TF-IDF 语义搜索 | +| 反思日志 | `ReflectionLog` (RightPanel) | ✅ 通过 | 显示反思分析结果 | +| 安全面板 | `SecurityLayersPanel` (RightPanel) | ⚠️ 前端模拟 | 使用 fallback 数据 | ## 8. 侧边栏 | 功能 | 组件位置 | 验证状态 | 说明 | |------|----------|----------|------| -| 分身 Tab | `Sidebar.tsx` | ⚠️ UI待验证 | 需手动验证 | -| Hands Tab | `Sidebar.tsx` | ✅ 通过 | 显示 `HandList` 组件 | -| Workflow Tab | `Sidebar.tsx` | ⚠️ UI待验证 | 显示 `TaskList` 组件 | -| 设置入口 | `Sidebar.tsx` | ⚠️ UI待验证 | 需手动验证 | +| 分身 Tab | `Sidebar.tsx` | ✅ 通过 | Agent 列表 + 创建/编辑/删除 | +| Hands Tab | `Sidebar.tsx` | ✅ 通过 | `HandList` 显示自主能力包 | +| Workflow Tab | `Sidebar.tsx` | ✅ 通过 | Workflow 列表 | +| 设置入口 | `Sidebar.tsx` | ✅ 通过 | 设置齿轮图标 | -> **更新 (2026-03-14)**: Sidebar 已重构： -> - Tab 从 "分身/IM/任务" 改为 "分身/HANDS/Workflow" -> - Hands Tab 使用 `HandList` 组件显示自主能力包 -> - IM 频道功能移至设置页面 +--- + +## 9. 智能层 (Intelligence Layer) + +| 模块 | Rust 实现 | Tauri 命令 | Hooks 集成 | 完成度 | 说明 | +|------|----------|-----------|-----------|--------|------| +| Agent 记忆 | ✅ VikingStorage | ✅ | ✅ pre-hook | 90% | FTS5 + TF-IDF 语义搜索，SQLite 持久化 | +| 身份演化 | ✅ identity.rs | ✅ | ✅ pre-hook | 70% | SOUL.md 生成，store.json 持久化 | +| 上下文压缩 | ✅ compactor.rs | ✅ | ⚠️ chatStore 直接调用 | 75% | 规则 + LLM 双模式，未通过 hooks 调用 | +| 反思引擎 | ✅ reflection.rs | ✅ | ✅ post-hook | 65% | 规则分析可用，LLM 深度反思待验证 | +| 心跳巡检 | ✅ heartbeat.rs | ✅ | ✅ post-hook | 70% | 4 级主动行为，交互记录正常 | +| 自主授权 | ✅ | ✅ | ✅ | 80% | 审批流程完整 | + +> **说明**: 5 个智能模块 (`pattern_detector`, `recommender`, `mesh`, `persona_evolver`, `trigger_evaluator`) 已在 0.6.0 中移除 (dead code 清理)。Context Compactor 存在但未在 hooks 中调用，由 chatStore 直接调用。 --- ## 验证结果汇总 -| 类别 | 总数 | 通过 | 部分通过 | 失败 | 待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 状态变化 +| 类别 | 总数 | 通过 | 部分通过 | 失败/未实现 | +|------|------|------|----------|------------| +| 核心聊天 | 6 | 6 | 0 | 0 | +| 分身管理 | 5 | 4 | 0 | 1 | +| IM 频道 | 3 | 1 | 0 | 2 | +| 定时任务 | 3 | 0 | 1 | 2 | +| Hands | 11 | 7 | 2 | 2 | +| Workflows | 4 | 3 | 1 | 0 | +| Triggers | 4 | 3 | 1 | 0 | +| 审计日志 | 2 | 0 | 0 | 2 | +| 安全状态 | 2 | 0 | 2 | 0 | +| 设置页面 | 9 | 6 | 1 | 2 | +| 右侧面板 | 4 | 3 | 1 | 0 | +| 侧边栏 | 4 | 4 | 0 | 0 | +| 智能层 | 6 | 5 | 1 | 0 | +| **总计** | **63** | **42** | **8** | **11** | --- ## 图例 - ✅ 通过 - 功能完整可用 -- ⚠️ 部分通过 - 基本功能可用，有已知问题 -- ❌ 失败 - 功能不可用或严重 bug -- ⏳ 待验证 - 尚未测试 +- ⚠️ 部分通过 - 基本功能可用，有已知限制 +- ❌ 未实现 - 功能不可用或仅有 UI 占位 --- -## 关键发现 +## 未实现的 API -### API 已验证功能 +以下 API 在 0.6.0 中仍返回 404: -| 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) -- [ ] 验证主题切换 -- [ ] 查看用量统计 +| API 端点 | 功能 | 说明 | +|----------|------|------| +| `/api/tasks` | 定时任务 | SchedulerPanel fallback | +| `/api/audit/logs` | 审计日志 | AuditLogsPanel 无后端 | +| `/api/plugins` | 插件管理 | 未实现 | +| `/api/workspace` | 工作区配置 | Workspace 设置无后端 | +| `/api/mcp/*` | MCP 服务 | MCPServices 无后端 | --- @@ -270,48 +214,5 @@ | 日期 | 变更 | |------|------| -| 2026-03-14 | Hands UI 重构：新增 `HandList.tsx`、`HandTaskPanel.tsx`，移除右侧 Hands 标签 | +| 2026-03-27 | 全面更新至 0.6.0：核心聊天全部通过，新增智能层章节，更新 Hands/Workflows/Triggers 状态，清理过时信息 | | 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 diff --git a/hands/lead.HAND.toml b/hands/lead.HAND.toml index 339dd4b..c2ea665 100644 --- a/hands/lead.HAND.toml +++ b/hands/lead.HAND.toml @@ -1,15 +1,19 @@ # Lead Hand - 销售线索发现能力包 # -# OpenFang Hand 配置示例 +# ZCLAW Hand 配置示例 # 这个 Hand 自动发现和筛选销售线索 +# +# ⚠️ 注意: 此 Hand 尚未实现 Rust 后端，仅作为设计文档保留。 +# 启用状态设为 false，前端不会显示为可用能力。 [hand] name = "lead" version = "1.0.0" -description = "销售线索发现和筛选能力包 - 自动识别潜在客户" +description = "销售线索发现和筛选能力包 - 自动识别潜在客户（未实现）" author = "ZCLAW Team" type = "automation" +enabled = false requires_approval = true # 线索操作需要审批 timeout = 600 max_concurrent = 1 diff --git a/hands/predictor.HAND.toml b/hands/predictor.HAND.toml index 6dd792a..7ed2fd1 100644 --- a/hands/predictor.HAND.toml +++ b/hands/predictor.HAND.toml @@ -1,17 +1,23 @@ # Predictor Hand - 预测分析能力包 # -# OpenFang Hand 配置 +# ZCLAW Hand 配置 # 这个 Hand 提供预测分析、趋势预测和数据建模能力 +# +# ⚠️ 注意: 此 Hand 尚未实现 Rust 后端，仅作为设计文档保留。 +# 启用状态设为 false，前端不会显示为可用能力。 [hand] name = "predictor" version = "1.0.0" -description = "预测分析能力包 - 执行回归、分类和时间序列预测" +description = "预测分析能力包 - 执行回归、分类和时间序列预测（未实现）" author = "ZCLAW Team" # Hand 类型 type = "data" +# 未实现，禁用此 Hand +enabled = false + # 是否需要人工审批才能执行 requires_approval = false