From ef3d4e30945cc14fbbb8e4e46d4e7d664e10ef11 Mon Sep 17 00:00:00 2001 From: iven Date: Thu, 26 Mar 2026 18:39:40 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E4=BB=A5=E5=8F=8D=E6=98=A0=20Agent=20Growth?= =?UTF-8?q?=20System=20=E5=AE=9E=E7=8E=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 更新 README.md 版本至 v0.6.0 - 添加 zclaw-growth crate (第 9 个 crate) - 添加 Agent Growth System 组件状态表 - 更新关键指标 (135 tests, 9 crates) - 更新 roadmap.md 当前状态和执行清单 Agent Growth System 包含: - SqliteStorage + FTS5 全文搜索 - MemoryRetriever + TF-IDF 语义检索 - PromptInjector + Token 预算控制 - MemoryExtractor + LLM 驱动提取 - VikingAdapter 存储抽象层 Co-Authored-By: Claude Opus 4.6 --- docs/features/README.md | 35 +++++++++++++++++++++++++---------- docs/features/roadmap.md | 20 +++++++++++++++----- 2 files changed, 40 insertions(+), 15 deletions(-) diff --git a/docs/features/README.md b/docs/features/README.md index 9b92c7c..f855c9d 100644 --- a/docs/features/README.md +++ b/docs/features/README.md @@ -1,11 +1,11 @@ # ZCLAW 功能全景文档 -> **版本**: v0.5.0 +> **版本**: v0.6.0 > **更新日期**: 2026-03-26 -> **项目状态**: 完整 Rust Workspace 架构，8 个核心 Crates，78+ 技能，Pipeline DSL + Smart Presentation -> **架构**: Tauri 桌面应用，Rust Workspace (8 crates) + React 前端 +> **项目状态**: 完整 Rust Workspace 架构，9 个核心 Crates，78+ 技能，Pipeline DSL + Smart Presentation + Agent Growth System +> **架构**: Tauri 桌面应用，Rust Workspace (9 crates) + React 前端 -> 📋 **重要**: ZCLAW 采用 Rust Workspace 架构，包含 8 个分层 Crates (types → memory → runtime → kernel → skills/hands/protocols/pipeline)，所有核心能力集成在 Tauri 桌面应用中 +> 📋 **重要**: ZCLAW 采用 Rust Workspace 架构，包含 9 个分层 Crates (types → memory → runtime → kernel → skills/hands/protocols/pipeline/growth)，所有核心能力集成在 Tauri 桌面应用中 --- @@ -224,7 +224,7 @@ | 指标 | 数值 | |------|------| -| **Rust Crates** | **8** (types, memory, runtime, kernel, skills, hands, protocols, pipeline) | +| **Rust Crates** | **9** (types, memory, runtime, kernel, skills, hands, protocols, pipeline, growth) | | **SKILL.md 文件** | **78+** | | 动态发现技能 | 78+ (100%) | | Hands 总数 | 11 | @@ -234,13 +234,14 @@ | Zustand Store | **18+** | | Tauri 命令 | **80+** | | 代码行数 (前端) | ~30,000 | -| 代码行数 (后端 Rust) | ~15,000 | +| 代码行数 (后端 Rust) | ~18,000 | | LLM Provider 支持 | **8** (Kimi, Qwen, DeepSeek, Zhipu, OpenAI, Anthropic, Gemini, Local/Ollama) | | 智能层组件 | **6** (Memory, Heartbeat, Reflection, Identity, Compaction, Mesh) | | MCP 协议 | ✅ 已实现 (stdio transport) | | execute_skill 工具 | ✅ 已实现 | | **Pipeline DSL** | ✅ 完整实现 | | **内置工具** | **5** (file_read, file_write, shell_exec, web_fetch, execute_skill) | +| **Agent Growth System** | ✅ 完整实现 (SqliteStorage + FTS5 + TF-IDF + Memory Extractor) | ### 5.1 Crate 依赖关系 @@ -253,12 +254,26 @@ zclaw-runtime (L3: 运行时, LLM 驱动, 工具执行) - 90% 完整度 ↑ zclaw-kernel (L4: 核心协调, Agent 调度) - 85% 完整度 ↑ -┌───┴───┬───────┬───────────┬──────────┐ -│ │ │ │ │ -skills hands protocols pipeline channels -(80%) (85%) (75%) (90%) (规划中) +┌───┴───┬───────┬───────────┬──────────┬────────┐ +│ │ │ │ │ │ +skills hands protocols pipeline growth channels +(80%) (85%) (75%) (90%) (95%) (规划中) ``` +### 5.2 Agent Growth System (zclaw-growth) + +**✅ 完整实现 (v0.6.0)** + +| 组件 | 功能 | 状态 | +|------|------|------| +| SqliteStorage | SQLite + FTS5 全文搜索 | ✅ L4 | +| MemoryRetriever | TF-IDF 语义检索 | ✅ L4 | +| PromptInjector | Token 预算控制注入 | ✅ L4 | +| MemoryExtractor | LLM 驱动记忆提取 | ✅ L4 | +| VikingAdapter | 存储抽象层 | ✅ L4 | + +**测试覆盖**: 135 tests (70 zclaw-growth + 65 desktop) + --- ## 六、变更历史 diff --git a/docs/features/roadmap.md b/docs/features/roadmap.md index 1e8648a..3f838c6 100644 --- a/docs/features/roadmap.md +++ b/docs/features/roadmap.md @@ -1,10 +1,10 @@ # ZCLAW 后续工作计划 -> **版本**: v0.5.0 +> **版本**: v0.6.0 > **创建日期**: 2026-03-16 > **更新日期**: 2026-03-26 > **基于**: 代码深度分析报告 -> **状态**: 活跃开发中 +> **状态**: Agent Growth System 完整实现 --- @@ -14,13 +14,14 @@ | 指标 | 状态 | |------|------| -| Rust Crates | 8 个 (types, memory, runtime, kernel, skills, hands, protocols, pipeline) | +| Rust Crates | **9 个** (types, memory, runtime, kernel, skills, hands, protocols, pipeline, **growth**) | | 功能完成度 | 90-95% (核心功能 L4) | | 技能数量 | 78+ SKILL.md | | Hands 可用 | 9/11 (82%) | | Pipeline DSL | ✅ 完整实现 | | Smart Presentation | ✅ 完整实现 (Chart, Quiz, Slideshow, Document) | -| 测试覆盖 | ~65% (需提升) | +| **Agent Growth System** | ✅ **完整实现 (SqliteStorage + FTS5 + TF-IDF + Memory Extractor)** | +| 测试覆盖 | **~135 tests** (70 growth + 65 desktop) | | 文档覆盖 | 25+ 功能文档 | ### 1.2 Crate 完整度评估 @@ -35,17 +36,19 @@ | zclaw-hands | L5 | 85% | 可用 (9/11 Hands) | | zclaw-protocols | L5 | 75% | MCP 可用，A2A 待完善 | | zclaw-pipeline | L5 | 95% | 完全可用 + Smart Presentation | +| **zclaw-growth** | **L5** | **95%** | **完全可用 (SqliteStorage + FTS5 + TF-IDF + Memory Extractor)** | ### 1.3 核心结论 **优势**: -- 8 层 Rust Workspace 架构清晰 +- 9 层 Rust Workspace 架构清晰 - Agent 记忆系统完善 (ICE: 630) - L4 自演化能力已实现 - 多 LLM Provider 支持 (8 个) - Pipeline DSL 成熟 - 技能生态丰富 (78+) - **Smart Presentation Layer 完成** - 自动类型检测和多渲染器支持 +- **Agent Growth System 完成** - SqliteStorage + FTS5 + TF-IDF + LLM 驱动记忆提取 **待改进**: - Approval 管理是存根实现 @@ -80,6 +83,12 @@ ```markdown - [x] Smart Presentation Layer (Chart, Quiz, Slideshow, Document 渲染器) - [x] PresentationContainer 集成到 PipelinesPanel +- [x] **Agent Growth System** (zclaw-growth crate, 完整实现) + - [x] SqliteStorage + FTS5 全文搜索 + - [x] MemoryRetriever + TF-IDF 语义检索 + - [x] PromptInjector + Token 预算控制 + - [x] MemoryExtractor + LLM 驱动提取 + - [x] VikingAdapter + 存储抽象层 - [ ] S1: 实现 Kernel Approval 管理 (非存根) - [ ] S2: 完善 A2A 协议实现 - [ ] S3: 增加单元测试 (目标 +15%) @@ -327,6 +336,7 @@ | 日期 | 版本 | 变更内容 | |------|------|---------| +| 2026-03-26 | v0.6.0 | **Agent Growth System 完整实现**: zclaw-growth crate (SqliteStorage + FTS5 + TF-IDF + Memory Extractor), 9 个 Rust Crates | | 2026-03-26 | v0.5.0 | 完成 Smart Presentation Layer (Chart, Quiz, Slideshow, Document 渲染器) | | 2026-03-25 | v0.4.0 | 基于代码深度分析更新：8 Crates 评估，78+ 技能确认，测试覆盖现状 | | 2026-03-16 | v1.0 | 初始版本 |