refactor: 清理未使用代码并添加未来功能标记
Some checks failed
CI / Rust Check (push) Has been cancelled
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled

style: 统一代码格式和注释风格

docs: 更新多个功能文档的完整度和状态

feat(runtime): 添加路径验证工具支持

fix(pipeline): 改进条件判断和变量解析逻辑

test(types): 为ID类型添加全面测试用例

chore: 更新依赖项和Cargo.lock文件

perf(mcp): 优化MCP协议传输和错误处理
This commit is contained in:
iven
2026-03-25 21:55:12 +08:00
parent aa6a9cbd84
commit bf6d81f9c6
109 changed files with 12271 additions and 815 deletions

View File

@@ -1,11 +1,11 @@
# ZCLAW 功能全景文档
> **版本**: v0.3.0
> **版本**: v0.4.0
> **更新日期**: 2026-03-25
> **项目状态**: 内部 Kernel 架构Streaming + MCP 协议Pipeline DSL 系统
> **架构**: Tauri 桌面应用Rust 后端 + React 前端
> **项目状态**: 完整 Rust Workspace 架构8 个核心 Crates78+ 技能Pipeline DSL 系统
> **架构**: Tauri 桌面应用Rust Workspace (8 crates) + React 前端
> 📋 **重要**: ZCLAW 现已采用内部 Kernel 架构,所有核心能力集成在 Tauri 桌面应用中,无需外部进程
> 📋 **重要**: ZCLAW 采用 Rust Workspace 架构,包含 8 个分层 Crates (types → memory → runtime → kernel → skills/hands/protocols/pipeline),所有核心能力集成在 Tauri 桌面应用中
---
@@ -57,16 +57,16 @@
| 文档 | 功能 | 成熟度 | UI 集成 |
|------|------|--------|---------|
| [00-skill-system.md](04-skills-ecosystem/00-skill-system.md) | Skill 系统概述 | L4 | ✅ 通过 Tauri 命令 |
| [01-builtin-skills.md](04-skills-ecosystem/01-builtin-skills.md) | 内置技能 (**69个** SKILL.md) | L4 | N/A |
| [01-builtin-skills.md](04-skills-ecosystem/01-builtin-skills.md) | 内置技能 (**78+** SKILL.md) | L4 | N/A |
| [02-skill-discovery.md](04-skills-ecosystem/02-skill-discovery.md) | 技能发现 (动态扫描) | **L4** | ✅ **已集成** |
> ✅ **更新**: Skills 动态扫描已实现。Kernel 集成 `SkillRegistry`,通过 Tauri 命令 `skill_list` 和 `skill_refresh` 动态发现所有 **69 个**技能。**新增 `execute_skill` 工具**,允许 Agent 在对话中直接调用技能。
> ✅ **更新**: Skills 动态扫描已实现。Kernel 集成 `SkillRegistry`,通过 Tauri 命令 `skill_list` 和 `skill_refresh` 动态发现所有 **78+ 个**技能。**新增 `execute_skill` 工具**,允许 Agent 在对话中直接调用技能。
### 1.6 Hands 系统 - ✅ 9/11 已实现 (2026-03-24 更新)
### 1.6 Hands 系统 - ✅ 9/11 已实现 (2026-03-25 更新)
| 文档 | 功能 | 成熟度 | 可用 Hands |
|------|------|--------|-----------|
| [00-hands-overview.md](05-hands-system/00-hands-overview.md) | Hands 概述 (11个) | L3 | **9/11 (82%)** |
| [00-hands-overview.md](05-hands-system/00-hands-overview.md) | Hands 概述 (11个) | L4 | **9/11 (82%)** |
> ✅ **更新**: 9 个 Hands 已有完整 Rust 后端实现:
> - ✅ **Browser** - Fantoccini WebDriver支持 Chrome/Firefox
@@ -207,23 +207,40 @@
| 指标 | 数值 |
|------|------|
| 功能模块总数 | 25+ |
| SKILL.md 文件 | **69** |
| 动态发现技能 | 69 (100%) |
| **Rust Crates** | **8** (types, memory, runtime, kernel, skills, hands, protocols, pipeline) |
| **SKILL.md 文件** | **78+** |
| 动态发现技能 | 78+ (100%) |
| Hands 总数 | 11 |
| **已实现 Hands** | **9 (82%)** |
| **Kernel 注册 Hands** | **9/9 (100%)** |
| **Pipeline 模板** | **5** (教育/营销/法律/研究/生产力) |
| **Pipeline 分类** | **5** |
| Zustand Store | 15+ |
| Tauri 命令 | 100+ |
| 代码行数 (前端) | ~25,000 |
| 代码行数 (后端 Rust) | ~12,000 |
| Zustand Store | **18+** |
| Tauri 命令 | **80+** |
| 代码行数 (前端) | ~30,000 |
| 代码行数 (后端 Rust) | ~15,000 |
| LLM Provider 支持 | **8** (Kimi, Qwen, DeepSeek, Zhipu, OpenAI, Anthropic, Gemini, Local/Ollama) |
| 智能层组件 | 5 (Memory, Heartbeat, Reflection, Identity, Compaction) |
| MCP 协议 | ✅ 已实现 |
| 智能层组件 | **6** (Memory, Heartbeat, Reflection, Identity, Compaction, Mesh) |
| MCP 协议 | ✅ 已实现 (stdio transport) |
| execute_skill 工具 | ✅ 已实现 |
| **Pipeline DSL** | ✅ **新增** |
| **Pipeline DSL** | ✅ 完整实现 |
| **内置工具** | **5** (file_read, file_write, shell_exec, web_fetch, execute_skill) |
### 5.1 Crate 依赖关系
```
zclaw-types (L1: 基础类型, 无依赖) - 95% 完整度
zclaw-memory (L2: 存储层, SQLite) - 90% 完整度
zclaw-runtime (L3: 运行时, LLM 驱动, 工具执行) - 90% 完整度
zclaw-kernel (L4: 核心协调, Agent 调度) - 85% 完整度
┌───┴───┬───────┬───────────┬──────────┐
│ │ │ │ │
skills hands protocols pipeline channels
(80%) (85%) (75%) (90%) (规划中)
```
---
@@ -231,8 +248,9 @@
| 日期 | 版本 | 变更内容 |
|------|------|---------|
| 2026-03-25 | v0.4.0 | **代码现状深度分析**8 个 Rust Crates 完整度评估78+ 技能确认18+ Store 状态管理,新增 Mesh/Persona 智能组件 |
| 2026-03-25 | v0.3.0 | **Pipeline DSL 系统实现**5 类 Pipeline 模板Agent 智能推荐,结果预览组件 |
| 2026-03-24 | v0.2.5 | **execute_skill 工具实现**,智能层完全实现验证,技能数更新为 69 |
| 2026-03-24 | v0.2.5 | **execute_skill 工具实现**,智能层完全实现验证,技能数更新为 78+ |
| 2026-03-24 | v0.2.4 | Hands Review: 修复 BrowserHand Kernel 注册问题,所有 9 个已实现 Hands 均可访问 |
| 2026-03-24 | v0.2.3 | Hands 后端集成: 9/11 Hands 可用 (新增 Clip, Twitter) |
| 2026-03-24 | v0.2.2 | Hands 后端集成: 7/11 Hands 可用 (新增 Researcher, Collector) |