docs: 更新功能文档 — 反映架构重构成果

- docs/features/README.md — 技能数 69→70, Hands 11个, 成熟度更新 - 智能层文档成熟度上调 (身份演化 L3, 反思引擎 L3) - 后端集成文档更新 SaaS 迁移系统说明 - 知识库添加架构重构记录
2026-03-29 19:42:37 +08:00
parent a0ca35c9dd
commit b7ec317d2c
4 changed files with 186 additions and 39 deletions
--- a/docs/features/02-intelligence-layer/01-identity-evolution.md
+++ b/docs/features/02-intelligence-layer/01-identity-evolution.md
@@ -1,11 +1,10 @@
 # 身份演化系统 (Identity Evolution)

 > **成熟度**: L4 - 生产
-> **最后更新**: 2026-03-25
+> **最后更新**: 2026-03-29
 > **负责人**: Intelligence Layer Team
 > **验证状态**: ✅ 代码已验证
 > **后端实现**: Rust (identity.rs) - **90% 完整度**
-> **新增组件**: persona_evolver.rs, mesh.rs (待完善)

 ## 概述

@@ -208,22 +207,12 @@ identity.proposeChange() → 创建变更提案
 2. **变更提案通知缺失** - 提案创建后无主动通知用户
 3. **Tauri 模式下文件存储** - 当前使用内存存储，重启后丢失

-### 新增组件 (2026-03-25)
-
-| 组件 | 位置 | 状态 | 说明 |
-|------|------|------|------|
-| persona_evolver.rs | `desktop/src-tauri/src/intelligence/` | 🆕 新增 | 人格演进引擎 (待完善) |
-| mesh.rs | `desktop/src-tauri/src/intelligence/` | 🆕 新增 | 智能网格 (待完善) |
-| pattern_detector.rs | `desktop/src-tauri/src/intelligence/` | 🆕 新增 | 模式检测 (待完善) |
-| trigger_evaluator.rs | `desktop/src-tauri/src/intelligence/` | 🆕 新增 | 触发评估 (待完善) |
-
 ### 未来改进

 1. **文件系统持久化** - 将身份文件写入 `~/.zclaw/agents/{agentId}/`
 2. **变更提案通知** - 添加桌面通知或消息提示
 3. **人格版本对比** - 可视化 diff 显示变更内容
 4. **多人格切换** - 支持同一 Agent 保存多套人格配置
-5. **智能网格集成** - 与 mesh.rs 集成实现多 Agent 协作演化

 ---

--- a/docs/features/02-intelligence-layer/03-reflection-engine.md
+++ b/docs/features/02-intelligence-layer/03-reflection-engine.md
@@ -3,10 +3,9 @@
 > **分类**: 智能层
 > **优先级**: P1 - 重要
 > **成熟度**: L4 - 生产
-> **最后更新**: 2026-03-25
+> **最后更新**: 2026-03-29
 > **验证状态**: ✅ 代码已验证
 > **后端实现**: Rust (reflection.rs) - **85% 完整度**
-> **新增组件**: pattern_detector.rs (待完善)

 ---

--- a/docs/features/06-tauri-backend/00-backend-integration.md
+++ b/docs/features/06-tauri-backend/00-backend-integration.md
@@ -3,7 +3,7 @@
 > **分类**: Tauri 后端
 > **优先级**: P0 - 决定性
 > **成熟度**: L4 - 生产
-> **最后更新**: 2026-03-28
+> **最后更新**: 2026-03-29
 > **验证状态**: 代码已验证
 > **架构**: 内部 Kernel，无需外部进程

@@ -21,7 +21,7 @@ ZCLAW Tauri 后端是桌面应用的核心，集成内部 ZCLAW Kernel，提供
 | 优先级 | P0 |
 | 成熟度 | L4 |
 | 依赖 | Tauri Runtime 2.x, zclaw-kernel crate |
-| Tauri 命令总数 | **58+** (kernel 29 + pipeline 13 + viking 13 + llm 3) |
+| Tauri 命令总数 | **130+** (kernel 34 + pipeline 10 + browser 22 + intelligence 35 + memory 14 + cli 13 + viking 13 + llm 3 + secure_storage 4) |
 | Rust Crates | 11 个 (types, memory, runtime, kernel, skills, hands, protocols, pipeline, growth, channels, saas) |

 ### 1.2 相关文件
@@ -69,9 +69,9 @@ ZCLAW Tauri 后端是桌面应用的核心，集成内部 ZCLAW Kernel，提供
 | zclaw-types | L1 | 基础类型 | AgentId, SessionId, Message, ZclawError (18 变体), Capability (12 种), Event (20+ 种) |
 | zclaw-memory | L2 | SQLite 存储层 | Session 持久化, KV Store, Schema 管理 |
 | zclaw-runtime | L3 | LLM 运行时 | 4 个 Driver (Anthropic/OpenAI/Gemini/Local), 5 个内置工具, AgentLoop, LoopGuard, Compaction |
-| zclaw-kernel | L4 | 核心协调 | Agent 注册/调度, EventBus, SkillRegistry, HandRegistry (9 Hands), TriggerManager, Approval |
-| zclaw-skills | L5 | 技能系统 | SKILL.md 解析, 69 个技能, PromptOnly/Python/Shell 三种模式 |
-| zclaw-hands | L5 | 自主能力 | Hand trait, 9 个 Hand (Browser/Slideshow/Speech/Quiz/Whiteboard/Researcher/Collector/Clip/Twitter) |
+| zclaw-kernel | L4 | 核心协调 | Agent 注册/调度, EventBus, SkillRegistry, HandRegistry (11 Hands), TriggerManager, Approval |
+| zclaw-skills | L5 | 技能系统 | SKILL.md 解析, 70 个技能, PromptOnly/Python/Shell 三种模式 |
+| zclaw-hands | L5 | 自主能力 | Hand trait, 11 个 Hand (9 启用: Browser/Slideshow/Speech/Quiz/Whiteboard/Researcher/Collector/Clip/Twitter; 2 禁用: Predictor/Lead) |
 | zclaw-protocols | L5 | 协议支持 | MCP (stdio transport), A2A (基础协议定义) |
 | zclaw-pipeline | L5 | 工作流 DSL | YAML 声明式, 状态管理, 5 类模板 |
 | zclaw-growth | L5 | 记忆增长 | SqliteStorage + FTS5 + TF-IDF + MemoryExtractor |
@@ -92,7 +92,7 @@ ZCLAW Tauri 后端是桌面应用的核心，集成内部 ZCLAW Kernel，提供

 ## 三、Tauri 命令分类

-### 3.1 Kernel 命令 (29 个)
+### 3.1 Kernel 命令 (34 个)

 **核心管理:**

@@ -137,6 +137,7 @@ ZCLAW Tauri 后端是桌面应用的核心，集成内部 ZCLAW Kernel，提供
 | `hand_cancel` | 取消 Hand (跨 Hand 验证) | ✅ |
 | `hand_run_status` | 运行状态 | ⚠️ 桩命令 |
 | `hand_run_list` | 运行列表 | ⚠️ 桩命令 |
+| `hand_run_cancel` | 取消 Hand 运行 | ✅ |

 **Trigger:**

@@ -158,7 +159,16 @@ ZCLAW Tauri 后端是桌面应用的核心，集成内部 ZCLAW Kernel，提供
 | `scheduled_task_create` | 创建定时任务 (基于 Trigger) | ✅ |
 | `scheduled_task_list` | 列出定时任务 | ✅ |

-### 3.2 Pipeline 命令 (13 个)
+**A2A (Agent-to-Agent) 通信:**
+
+| 命令 | 说明 | 状态 |
+|------|------|------|
+| `agent_a2a_send` | Agent 间发送消息 | ✅ |
+| `agent_a2a_broadcast` | 广播消息 | ✅ |
+| `agent_a2a_discover` | 发现其他 Agent | ✅ |
+| `agent_a2a_delegate_task` | 委派任务 | ✅ |
+
+### 3.2 Pipeline 命令 (10 个)

 | 命令 | 说明 | 状态 |
 |------|------|------|
@@ -201,7 +211,151 @@ ZCLAW Tauri 后端是桌面应用的核心，集成内部 ZCLAW Kernel，提供
 | `embedding_create` | Embedding 生成 | ✅ |
 | `embedding_providers` | 列出可用 Embedding Provider | ✅ |

-### 3.5 智能层钩子 (intelligence_hooks.rs)
+### 3.5 Browser 自动化命令 (22 个)
+
+| 命令 | 说明 | 状态 |
+|------|------|------|
+| `browser_create_session` | 创建浏览器会话 (Fantoccini WebDriver) | ✅ |
+| `browser_close_session` | 关闭会话 | ✅ |
+| `browser_list_sessions` | 列出所有活跃会话 | ✅ |
+| `browser_get_session` | 获取会话详情 | ✅ |
+| `browser_navigate` | 导航到 URL | ✅ |
+| `browser_back` | 浏览器后退 | ✅ |
+| `browser_forward` | 浏览器前进 | ✅ |
+| `browser_refresh` | 刷新页面 | ✅ |
+| `browser_get_url` | 获取当前 URL | ✅ |
+| `browser_get_title` | 获取页面标题 | ✅ |
+| `browser_find_element` | 查找单个元素 (CSS/XPath) | ✅ |
+| `browser_find_elements` | 查找多个元素 | ✅ |
+| `browser_click` | 点击元素 | ✅ |
+| `browser_type` | 输入文本 | ✅ |
+| `browser_get_text` | 获取元素文本 | ✅ |
+| `browser_get_attribute` | 获取元素属性 | ✅ |
+| `browser_wait_for_element` | 等待元素出现 | ✅ |
+| `browser_execute_script` | 执行 JavaScript | ✅ |
+| `browser_screenshot` | 页面截图 | ✅ |
+| `browser_element_screenshot` | 元素截图 | ✅ |
+| `browser_get_source` | 获取页面源码 | ✅ |
+| `browser_scrape_page` | 抓取页面结构化数据 | ✅ |
+| `browser_fill_form` | 批量填写表单 | ✅ |
+
+### 3.6 Intelligence 智能层命令 (35 个)
+
+**Heartbeat Engine (10 个):**
+
+| 命令 | 说明 | 状态 |
+|------|------|------|
+| `heartbeat_init` | 初始化心跳引擎 | ✅ |
+| `heartbeat_start` | 启动心跳定时器 | ✅ |
+| `heartbeat_stop` | 停止心跳 | ✅ |
+| `heartbeat_tick` | 手动执行一次巡检 | ✅ |
+| `heartbeat_get_config` | 获取当前配置 | ✅ |
+| `heartbeat_update_config` | 更新配置 | ✅ |
+| `heartbeat_get_history` | 获取历史记录 | ✅ |
+| `heartbeat_update_memory_stats` | 更新记忆统计 | ✅ |
+| `heartbeat_record_correction` | 记录纠正事件 | ✅ |
+| `heartbeat_record_interaction` | 记录交互事件 | ✅ |
+
+**Context Compactor (4 个):**
+
+| 命令 | 说明 | 状态 |
+|------|------|------|
+| `compactor_estimate_tokens` | 估算文本 Token 数 | ✅ |
+| `compactor_estimate_messages_tokens` | 估算消息列表 Token 数 | ✅ |
+| `compactor_check_threshold` | 检查是否需要压缩 | ✅ |
+| `compactor_compact` | 执行上下文压缩 | ✅ |
+
+**Reflection Engine (6 个):**
+
+| 命令 | 说明 | 状态 |
+|------|------|------|
+| `reflection_init` | 初始化反思引擎 | ✅ |
+| `reflection_record_conversation` | 记录对话用于反思 | ✅ |
+| `reflection_should_reflect` | 检查是否应触发反思 | ✅ |
+| `reflection_reflect` | 执行反思分析 | ✅ |
+| `reflection_get_history` | 获取反思历史 | ✅ |
+| `reflection_get_state` | 获取引擎状态 | ✅ |
+
+**Agent Identity Manager (15 个):**
+
+| 命令 | 说明 | 状态 |
+|------|------|------|
+| `identity_get` | 获取 Agent 所有身份文件 | ✅ |
+| `identity_get_file` | 读取单个身份文件 | ✅ |
+| `identity_build_prompt` | 构建完整人格 Prompt | ✅ |
+| `identity_update_user_profile` | 更新用户画像 | ✅ |
+| `identity_append_user_profile` | 追加用户画像内容 | ✅ |
+| `identity_propose_change` | 创建身份变更提案 | ✅ |
+| `identity_approve_proposal` | 批准变更提案 | ✅ |
+| `identity_reject_proposal` | 拒绝变更提案 | ✅ |
+| `identity_get_pending_proposals` | 获取待审批提案 | ✅ |
+| `identity_update_file` | 更新身份文件 (自动创建快照) | ✅ |
+| `identity_get_snapshots` | 获取版本快照列表 | ✅ |
+| `identity_restore_snapshot` | 恢复到指定快照 | ✅ |
+| `identity_list_agents` | 列出所有 Agent 身份 | ✅ |
+| `identity_delete_agent` | 删除 Agent 身份数据 | ✅ |
+
+### 3.7 Memory 持久化命令 (14 个)
+
+**Memory Persistence (13 个):**
+
+| 命令 | 说明 | 状态 |
+|------|------|------|
+| `memory_init` | 初始化记忆存储 | ✅ |
+| `memory_store` | 存储记忆条目 | ✅ |
+| `memory_get` | 获取单条记忆 | ✅ |
+| `memory_search` | 搜索记忆 (关键词+语义) | ✅ |
+| `memory_delete` | 删除单条记忆 | ✅ |
+| `memory_delete_all` | 清空所有记忆 | ✅ |
+| `memory_stats` | 记忆统计信息 | ✅ |
+| `memory_export` | 导出记忆数据 | ✅ |
+| `memory_import` | 导入记忆数据 | ✅ |
+| `memory_db_path` | 获取数据库路径 | ✅ |
+| `memory_configure_embedding` | 配置 Embedding | ✅ |
+| `memory_is_embedding_configured` | 检查 Embedding 配置状态 | ✅ |
+| `memory_build_context` | 构建记忆上下文 | ✅ |
+
+**Memory Extraction (2 个):**
+
+| 命令 | 说明 | 状态 |
+|------|------|------|
+| `extract_session_memories` | 从会话提取记忆 | ✅ |
+| `extract_and_store_memories` | 提取并存储记忆 | ✅ |
+
+**Context Builder (1 个):**
+
+| 命令 | 说明 | 状态 |
+|------|------|------|
+| `estimate_content_tokens` | 估算内容 Token 数 | ✅ |
+
+### 3.8 ZCLAW CLI Wrapper 命令 (13 个)
+
+| 命令 | 说明 | 状态 |
+|------|------|------|
+| `zclaw_status` | Gateway 状态查询 (JSON) | ✅ |
+| `zclaw_start` | 启动 Gateway | ✅ |
+| `zclaw_stop` | 停止 Gateway | ✅ |
+| `zclaw_restart` | 重启 Gateway | ✅ |
+| `zclaw_local_auth` | 读取本地认证 Token | ✅ |
+| `zclaw_prepare_for_tauri` | 更新 Tauri Origins 配置 | ✅ |
+| `zclaw_approve_device_pairing` | 批准设备配对请求 | ✅ |
+| `zclaw_doctor` | 运行诊断 | ✅ |
+| `zclaw_health_check` | 综合健康检查 (进程+端口+延迟) | ✅ |
+| `zclaw_process_list` | ZCLAW 进程列表 | ✅ |
+| `zclaw_process_logs` | 进程日志查询 | ✅ |
+| `zclaw_version` | 版本信息查询 | ✅ |
+| `zclaw_ping` | 快速存活检查 | ✅ |
+
+### 3.9 Secure Storage 命令 (4 个)
+
+| 命令 | 说明 | 状态 |
+|------|------|------|
+| `secure_store_set` | 存储密钥到 OS Keyring/Keychain | ✅ |
+| `secure_store_get` | 从 OS Keyring/Keychain 读取密钥 | ✅ |
+| `secure_store_delete` | 从 OS Keyring/Keychain 删除密钥 | ✅ |
+| `secure_store_is_available` | 检查 OS Keyring/Keychain 可用性 | ✅ |
+
+### 3.10 智能层钩子 (intelligence_hooks.rs)

 | 钩子 | 说明 | 集成点 |
 |------|------|--------|
@@ -249,8 +403,9 @@ Embedding Providers: OpenAI, Zhipu, Doubao, Qwen, DeepSeek, Local/TF-IDF
 - autonomous: 全部自动执行

 ### 5.5 Kernel Boot 注册
-9 个 Hands 在 `Kernel::boot()` 中编程式注册:
-Browser, Slideshow, Speech, Quiz (含 LlmQuizGenerator), Whiteboard, Researcher, Collector, Clip, Twitter
+11 个 Hands 在 `Kernel::boot()` 中编程式注册:
+9 启用: Browser, Slideshow, Speech, Quiz (含 LlmQuizGenerator), Whiteboard, Researcher, Collector, Clip, Twitter
+2 禁用: Predictor, Lead (无 Rust 实现)

 ---

@@ -264,6 +419,9 @@ Browser, Slideshow, Speech, Quiz (含 LlmQuizGenerator), Whiteboard, Researcher,
 - [x] Pipeline DSL + Smart Presentation
 - [x] Agent Growth System
 - [x] SaaS 云端模式
+- [x] Browser 自动化 (Fantoccini, 22 个 Tauri 命令)
+- [x] Secure Storage (OS Keyring/Keychain)
+- [x] A2A Agent-to-Agent 通信

 ### 短期计划
 - [ ] hand_run_status/run_list 真实实现
@@ -277,4 +435,4 @@ Browser, Slideshow, Speech, Quiz (含 LlmQuizGenerator), Whiteboard, Researcher,

 ---

-**最后更新**: 2026-03-28
+**最后更新**: 2026-03-29
--- a/docs/features/README.md
+++ b/docs/features/README.md
@@ -1,8 +1,8 @@
 # ZCLAW 功能全景文档

 > **版本**: v0.7.0
-> **更新日期**: 2026-03-28
-> **项目状态**: 完整 Rust Workspace 架构，11 个核心 Crates，69 技能，Pipeline DSL + Smart Presentation + Agent Growth System + SaaS 平台
+> **更新日期**: 2026-03-29
+> **项目状态**: 完整 Rust Workspace 架构，11 个核心 Crates，70 技能，Pipeline DSL + Smart Presentation + Agent Growth System + SaaS 平台
 > **整体完成度**: ~85% (核心功能完整，SaaS 平台全面上线)

 ---
@@ -30,10 +30,10 @@
 | 文档 | 功能 | 成熟度 | 聊天集成 |
 |------|------|--------|---------|
 | [00-agent-memory.md](02-intelligence-layer/00-agent-memory.md) | Agent 记忆 | L4 (90%) | pre-hook (FTS5+TF-IDF+Embedding) |
-| [01-identity-evolution.md](02-intelligence-layer/01-identity-evolution.md) | 身份演化 | L2 (70%) | pre-hook (SOUL.md) |
-| [06-context-compaction.md](02-intelligence-layer/06-context-compaction.md) | 上下文压缩 | L3 (75%) | 内核 AgentLoop 集成 |
-| [03-reflection-engine.md](02-intelligence-layer/03-reflection-engine.md) | 自我反思 | L2 (65%) | post-hook (自动触发) |
-| [04-heartbeat-engine.md](02-intelligence-layer/04-heartbeat-engine.md) | 心跳巡检 | L3 (70%) | post-hook (持久化) |
+| [01-identity-evolution.md](02-intelligence-layer/01-identity-evolution.md) | 身份演化 | L3 (90%) | pre-hook (SOUL.md) |
+| [06-context-compaction.md](02-intelligence-layer/06-context-compaction.md) | 上下文压缩 | L3 (90%) | 内核 AgentLoop 集成 |
+| [03-reflection-engine.md](02-intelligence-layer/03-reflection-engine.md) | 自我反思 | L3 (85%) | post-hook (自动触发) |
+| [04-heartbeat-engine.md](02-intelligence-layer/04-heartbeat-engine.md) | 心跳巡检 | L3 (90%) | post-hook (持久化) |
 | [05-autonomy-manager.md](02-intelligence-layer/05-autonomy-manager.md) | 自主授权 | L3 (75%) | RightPanel UI |

 ### 1.4 上下文数据库 (Context Database)
@@ -49,21 +49,21 @@
 | [00-skill-system.md](04-skills-ecosystem/00-skill-system.md) | Skill 系统概述 | L3 (80%) | Tauri 命令 |
 | [01-intelligent-routing.md](04-skills-ecosystem/01-intelligent-routing.md) | 智能路由 | L2 (50%) | 意图路由 |

-> 技能总数: **69** 个 SKILL.md，3 种执行模式 (PromptOnly/Shell/Python)，Wasm/Native 待实现
+> 技能总数: **70** 个 SKILL.md，3 种执行模式 (PromptOnly/Shell/Python)，Wasm/Native 待实现

 ### 1.6 Hands 系统

 | 文档 | 功能 | 成熟度 | 可用 Hands |
 |------|------|--------|-----------|
-| [00-hands-overview.md](05-hands-system/00-hands-overview.md) | Hands 概述 | L3 (60%) | 9 个 (编程式注册) |
+| [00-hands-overview.md](05-hands-system/00-hands-overview.md) | Hands 概述 | L3 (60%) | 11 个 (9 启用 + 2 禁用) |

-> 9 Hands: Browser, Slideshow, Speech (demo), Quiz, Whiteboard, Researcher, Collector, Clip, Twitter (demo)
+> 11 Hands (9 启用): Browser, Slideshow, Speech, Quiz, Whiteboard, Researcher, Collector, Clip, Twitter (需 API Key); 2 禁用: Predictor, Lead

 ### 1.7 Tauri 后端

 | 文档 | 功能 | 成熟度 | Tauri 命令 |
 |------|------|--------|-----------|
-| [00-backend-integration.md](06-tauri-backend/00-backend-integration.md) | 后端集成 | L4 (85%) | **58+** (kernel 29 + pipeline 13 + viking 13 + llm 3) |
+| [00-backend-integration.md](06-tauri-backend/00-backend-integration.md) | 后端集成 | L4 (85%) | **130+** (kernel 34 + pipeline 10 + browser 22 + intelligence 35 + memory 14 + cli 13 + viking 13 + llm 3 + secure_storage 4) |

 ### 1.8 Pipeline DSL

@@ -86,10 +86,10 @@
 | 指标 | 数值 |
 |------|------|
 | **Rust Crates** | **11** (types, memory, runtime, kernel, skills, hands, protocols, pipeline, growth, channels, saas) |
-| **SKILL.md 文件** | **69** |
-| **Hands 总数** | **9** (编程式注册) |
+| **SKILL.md 文件** | **70** |
+| **Hands 总数** | **11** (9 启用, 2 禁用: Predictor, Lead) |
 | **Pipeline 模板** | **5** |
-| **Tauri 命令** | **58+** |
+| **Tauri 命令** | **130+** |
 | **SaaS API 路由** | **76+** |
 | **Zustand Store** | **14+** |
 | **LLM Provider** | **8** (Kimi, Qwen, DeepSeek, Zhipu, OpenAI, Anthropic, Gemini, Local) |
@@ -109,7 +109,7 @@ zclaw-memory         (L2: 存储层, SQLite) — 90%
    ↑
 zclaw-runtime        (L3: 运行时, 4 Driver, 5 工具) — 90%
    ↑
-zclaw-kernel         (L4: 核心协调, 9 Hands, 69 Skills) — 85%
+zclaw-kernel         (L4: 核心协调, 11 Hands, 70 Skills) — 85%
    ↑
 ┌───┴───┬───────┬───────────┬──────────┬────────┐
 │       │       │           │          │        │
@@ -151,6 +151,7 @@ zclaw-saas — 独立运行 (Axum + PostgreSQL, 端口 8080) — 95%

 | 日期 | 版本 | 变更内容 |
 |------|------|---------|
+| 2026-03-29 | v0.7.0 | 文档同步：SKILL 数量 70, Tauri 命令 130+ (含 Browser/Intelligence/Memory/CLI/SecureStorage), Hands 11 (9 启用+2 禁用), 智能层完成度修正 |
 | 2026-03-28 | v0.7.0 | 基于 2026-03-28 代码状态全面更新：SaaS 平台 76+ API 路由/9 模块/25 表，58+ Tauri 命令，8 LLM Provider，3 种连接模式 |
 | 2026-03-27 | v0.6.4 | 审计修复第四轮，S9 消息搜索跨会话，自主授权后端守卫 |
 | 2026-03-27 | v0.6.0 | 深度审计更新，整体完成度调整 |