docs: wiki 全量更新 — 2026-04-14 代码验证驱动
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
关键数字修正: - Rust 77K行(274 .rs)、Tauri 189命令、SaaS 137 routes - Admin V2 17页、SaaS 16模块(含industry)、@reserved 22 - SQL 20迁移/42表、TODO/FIXME 4个、dead_code 16 内容更新: - known-issues: V13-GAP 全部标记已修复 + 三端联调测试结果 - middleware: 14层 runtime + 10层 SaaS HTTP 完整清单 - saas: industry模块、路由模块13个、数据表42个 - routing: Store含industryStore、21个Store文件 - butler: 行业配置接入ButlerPanel、4内置行业 - log: 三端联调+V13修复记录追加
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: ZCLAW 项目知识库
|
||||
updated: 2026-04-11
|
||||
updated: 2026-04-14
|
||||
status: active
|
||||
---
|
||||
|
||||
@@ -8,35 +8,38 @@ status: active
|
||||
|
||||
> 面向中文用户的 AI Agent 桌面客户端。管家模式 + 多模型 + 9 自主能力 + 75 技能。
|
||||
> **使用方式**: 找到你要处理的模块,读对应页面,直接开始工作。
|
||||
> **数据来源**: 2026-04-11 代码全量扫描验证,非文档推测。
|
||||
> **数据来源**: 2026-04-14 代码全量扫描验证,非文档推测。
|
||||
|
||||
## 项目画像
|
||||
|
||||
| 维度 | 值 |
|
||||
|------|-----|
|
||||
| 定位 | AI Agent 桌面客户端 (Tauri 2.x) |
|
||||
| 技术栈 | Rust 10 crates + src-tauri (~95K行, 335 .rs文件) + React 19 + TypeScript + PostgreSQL |
|
||||
| 技术栈 | Rust 10 crates + src-tauri (~77K行, 274 .rs文件) + React 19 + TypeScript + PostgreSQL |
|
||||
| 阶段 | 发布前稳定化,功能冻结中 |
|
||||
|
||||
## 关键数字(2026-04-11 代码验证)
|
||||
## 关键数字(2026-04-14 代码验证)
|
||||
|
||||
| 指标 | 值 | 验证方式 |
|
||||
|------|-----|----------|
|
||||
| Rust Crates | 10 + src-tauri | `ls crates/zclaw-*/Cargo.toml` |
|
||||
| Rust 代码 | 95,181 行 (335 .rs文件) | `find crates/ src-tauri/ -name "*.rs"` |
|
||||
| Rust 测试 | ~1,055 (872内联 + 183集成) | 含 #[test] + #[tokio::test] |
|
||||
| Tauri 命令 | 190 定义 / 183 注册 (5 feature-gated) | `#[tauri::command]` / lib.rs handler |
|
||||
| 前端 invoke 调用 | 105 处 | `grep invoke( desktop/src/` |
|
||||
| SaaS .route() | 121 个 | `grep .route( crates/zclaw-saas/` |
|
||||
| Rust 代码 | 77,444 行 (274 .rs文件) | `find crates/ src-tauri/ -name "*.rs"` |
|
||||
| Rust 测试 | 774 (433 #[test] + 341 #[tokio::test]) | `grep '#\[test\]' / '#\[tokio::test\]'` |
|
||||
| Tauri 命令 | 189 定义 | `grep '#\[tauri::command\]'` |
|
||||
| 前端 invoke 调用 | 106 处 | `grep invoke( desktop/src/` |
|
||||
| SaaS .route() | 137 个 | `grep .route( crates/zclaw-saas/` |
|
||||
| SaaS 模块 | 16 个目录 (含 industry) | `ls crates/zclaw-saas/src/*/` |
|
||||
| SKILL 目录 | 75 个 | `ls -d skills/*/` |
|
||||
| HAND 配置 | 9 个 (TOML) | `ls hands/*.HAND.toml` |
|
||||
| Pipeline YAML | 17 个 | `find pipelines/ -name "*.yaml"` |
|
||||
| Zustand Store | 17 文件 + chat/4子store = 21 | `ls desktop/src/store/` |
|
||||
| Zustand Store | 17 文件 + chat/4子store = 21 (含 industryStore) | `find desktop/src/store/` |
|
||||
| React 组件 | 104 个 (.tsx/.ts) | `find desktop/src/components/` |
|
||||
| Admin V2 页面 | 15 个 (.tsx) | `ls admin-v2/src/pages/` |
|
||||
| 中间件 | 15 层 runtime + 6 层 SaaS HTTP | `kernel/mod.rs` + `zclaw-saas middleware` |
|
||||
| Admin V2 页面 | 17 个 (.tsx) | `ls admin-v2/src/pages/` |
|
||||
| 中间件 | 14 层 runtime + 10 层 SaaS HTTP | `kernel/mod.rs` + `zclaw-saas middleware` |
|
||||
| 前端 lib/ | 85 个 .ts | `find desktop/src/lib/` |
|
||||
| TODO/FIXME | 前端 4 + Rust 4 = 8 | `grep TODO/FIXME` |
|
||||
| SQL 迁移 | 20 文件 / 42 CREATE TABLE | `ls crates/zclaw-saas/migrations/*.sql` |
|
||||
| @reserved 标注 | 22 个 | `grep @reserved desktop/src-tauri/src/` |
|
||||
| TODO/FIXME | 前端 1 + Rust 3 = 4 | `grep TODO/FIXME` |
|
||||
|
||||
## 模块导航树
|
||||
|
||||
@@ -52,7 +55,7 @@ ZCLAW
|
||||
│
|
||||
├── [[butler]] 管家模式 — 默认交互范式,语义路由+冷启动+痛点
|
||||
│
|
||||
├── [[middleware]] 中间件链 — 14层,按优先级分类注册
|
||||
├── [[middleware]] 中间件链 — 14层runtime + 10层SaaS HTTP
|
||||
│
|
||||
├── [[memory]] 记忆管道 — 对话→提取→FTS5+TF-IDF→检索→注入
|
||||
│
|
||||
@@ -76,7 +79,7 @@ ZCLAW
|
||||
**Q: 为什么管家模式是默认?**
|
||||
→ 面向医院行政等非技术用户,语义路由(75技能TF-IDF)+痛点积累+方案生成,降低使用门槛。
|
||||
|
||||
**Q: 为什么中间件是14层?**
|
||||
→ 按优先级分4类: 100-199上下文(compaction/memory) → 200-399能力(skill/guardrail) → 400-599安全(loop_guard/data_masking) → 600-799遥测(token/title/trajectory)。Kernel `create_middleware_chain()` 条件注册,skill_index 仅在有技能时注册。
|
||||
**Q: 为什么中间件是14层runtime?**
|
||||
→ 按优先级分4类: 100-199上下文(compaction/memory) → 200-399能力(skill/guardrail) → 400-599安全(loop_guard/data_masking) → 600-799遥测(token/title/trajectory)。Kernel `create_middleware_chain()` 条件注册,skill_index 仅在有技能时注册。另有 10 层 SaaS HTTP 中间件 (限流/认证/配额/CORS/日志等)。
|
||||
|
||||
> 数字真相源: `docs/TRUTH.md` — 如有冲突以代码实际为准
|
||||
|
||||
Reference in New Issue
Block a user