iven/zclaw_openfang
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

docs: 更新功能文档 — 反映架构重构成果
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
Details
CI / Unit Tests (push) Has been cancelled
Details
CI / Build Frontend (push) Has been cancelled
Details
CI / Rust Check (push) Has been cancelled
Details
CI / Security Scan (push) Has been cancelled
Details
CI / E2E Tests (push) Has been cancelled
Details

Browse Source 
- docs/features/README.md — 技能数 69→70, Hands 11个, 成熟度更新
- 智能层文档成熟度上调 (身份演化 L3, 反思引擎 L3)
- 后端集成文档更新 SaaS 迁移系统说明
- 知识库添加架构重构记录
This commit is contained in:
iven
2026-03-29 19:42:37 +08:00
parent a0ca35c9dd
commit b7ec317d2c
4 changed files with 186 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

180
docs/features/06-tauri-backend/00-backend-integration.md
View File

@@ -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