From 34f4654039dfef5881c748565d80552f7e56c711 Mon Sep 17 00:00:00 2001
From: iven <iven_h@qq.com>
Date: Sun, 22 Mar 2026 09:08:25 +0800
Subject: [PATCH] docs: update architecture to reflect internal Rust kernel

---
 CLAUDE.md | 47 +++++++++++++++++++++++++++++++++++------------
 1 file changed, 35 insertions(+), 12 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 98bf14f..55ed8cd 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -29,23 +29,32 @@ ZCLAW 是面向中文用户的 AI Agent 桌面端，核心能力包括：
 
 ```text
 ZCLAW/
-├── desktop/              # Tauri 桌面应用
+├── crates/                   # Rust Workspace (核心能力)
+│   ├── zclaw-types/          # L1: 基础类型 (AgentId, Message, Error)
+│   ├── zclaw-memory/         # L2: 存储层 (SQLite, KV, 会话管理)
+│   ├── zclaw-runtime/        # L3: 运行时 (LLM驱动, 工具, Agent循环)
+│   ├── zclaw-kernel/         # L4: 核心协调 (注册, 调度, 事件, 工作流)
+│   ├── zclaw-skills/         # 技能系统 (SKILL.md解析, 执行器)
+│   ├── zclaw-hands/          # 自主能力 (Hand/Trigger 注册管理)
+│   ├── zclaw-channels/       # 通道适配器 (Telegram, Discord, Slack)
+│   └── zclaw-protocols/      # 协议支持 (MCP, A2A)
+├── desktop/                  # Tauri 桌面应用
 │   ├── src/
-│   │   ├── components/   # React UI 组件
-│   │   ├── store/        # Zustand 状态管理
-│   │   └── lib/          # 客户端通信 / 工具函数
-│   └── src-tauri/        # Tauri Rust 后端
-├── skills/               # SKILL.md 技能定义
-├── hands/                # HAND.toml 自主能力配置
-├── config/               # TOML 配置文件
-├── docs/                 # 架构文档和知识库
-└── tests/                # Vitest 回归测试
+│   │   ├── components/       # React UI 组件
+│   │   ├── store/            # Zustand 状态管理
+│   │   └── lib/              # 客户端通信 / 工具函数
+│   └── src-tauri/            # Tauri Rust 后端 (集成 Kernel)
+├── skills/                   # SKILL.md 技能定义
+├── hands/                    # HAND.toml 自主能力配置
+├── config/                   # TOML 配置文件
+├── docs/                     # 架构文档和知识库
+└── tests/                    # Vitest 回归测试
 ```
 
 ### 2.1 核心数据流
 
 ```text
-用户操作 → React UI → Zustand Store → Gateway Client → 后端服务 → Skills / Hands
+用户操作 → React UI → Zustand Store → Tauri Commands → zclaw-kernel → LLM/Tools/Skills/Hands
 ```
 
 ### 2.2 技术栈
@@ -57,7 +66,21 @@ ZCLAW/
 | 桌面框架 | Tauri 2.x             |
 | 样式方案 | Tailwind CSS          |
 | 配置格式 | TOML                  |
-| 后端服务 | Rust (端口 50051)       |
+| 后端核心 | Rust Workspace (8 crates) |
+
+### 2.3 Crate 依赖关系
+
+```text
+zclaw-types          (无依赖)
+    ↑
+zclaw-memory         (→ types)
+    ↑
+zclaw-runtime        (→ types, memory)
+    ↑
+zclaw-kernel         (→ types, memory, runtime)
+    ↑
+desktop/src-tauri    (→ kernel, skills, hands, channels, protocols)
+```
 
 ***