docs(wiki): Hermes Phase 1-4 wiki 同步
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

- hands-skills: 新增 concurrency() 声明要求不变量
- log: 追加 Hermes Phase 1-4 变更记录
- index: 更新日期
This commit is contained in:
iven
2026-04-24 08:54:48 +08:00
parent 06e93a21af
commit b60b96225d
3 changed files with 36 additions and 12 deletions

View File

@@ -1,6 +1,6 @@
---
title: ZCLAW 项目知识库
updated: 2026-04-22
updated: 2026-04-24
status: active
---
@@ -8,29 +8,29 @@ status: active
> 面向中文用户的 AI Agent 桌面客户端。管家模式 + 多模型 + 7 自主能力 + 75 技能。
> **使用方式**: 找到你要处理的模块,读对应页面,直接开始工作。
> **数据来源**: 2026-04-22 代码全量扫描验证,非文档推测。
> **数据来源**: 2026-04-23 代码全量扫描验证,非文档推测。
## 项目画像
| 维度 | 值 |
|------|-----|
| 定位 | AI Agent 桌面客户端 (Tauri 2.x) |
| 技术栈 | Rust 10 crates + src-tauri (~102K行, 357 .rs) + React 19 + TypeScript + PostgreSQL |
| 技术栈 | Rust 10 crates + src-tauri (~148K行, 384 .rs) + React 19 + TypeScript + PostgreSQL |
| 阶段 | 发布前稳定化,功能冻结中 |
## 关键数字2026-04-22 代码验证)
## 关键数字2026-04-23 代码验证)
| 指标 | 值 |
|------|-----|
| Rust Crates | 10 + src-tauri |
| Rust 代码 | 101,967 行 (357 .rs文件) |
| Rust 测试 | 987 定义 / 797 通过 |
| Tauri 命令 | 190 定义 / 97 @reserved / 104 invoke |
| Rust 代码 | 148,185 行 (384 .rs文件) |
| Rust 测试 | 997 定义 (619 #[test] + 378 #[tokio::test]) |
| Tauri 命令 | 193 定义 / 104 invoke |
| SaaS API | 137 .route() / 16 模块 / 38 SQL 迁移 / 42 表 |
| 中间件 | 14 层 runtime + 10 层 SaaS HTTP |
| SKILL / HAND | 75 技能目录 / 7 注册 Hand (6 TOML + _reminder) |
| Pipeline | 18 YAML 模板 (8 目录) |
| 前端 | 25 Store / 102 组件 / 75 lib / 17 Admin 页面 |
| 前端 | 25 Store / 103 组件 / 78 lib / 17 Admin 页面 |
| Intelligence | 16 .rs 文件 |
| 质量指标 | 0 cargo warnings / 2 TODO/FIXME / 0 dead_code |
@@ -38,13 +38,13 @@ status: active
| 类别 | 功能 | 入口 | Wiki |
|------|------|------|------|
| 对话 | 发消息、流式响应、多模型切换 | 聊天面板 | [[chat]] |
| 分身 | 创建/切换/配置 Agent | 侧边栏 Agent 列表 | [[chat]] |
| 对话 | 发消息、流式响应、多模型切换、LLM 动态建议 | 聊天面板 | [[chat]] |
| 分身 | 创建/切换/配置 Agent、跨会话身份记忆 (soul.md) | 侧边栏 Agent 列表 | [[chat]] |
| 自主 | 触发 Browser/Collector/Twitter 等 | 自动化面板 | [[hands-skills]] |
| 记忆 | 搜索历史、自动注入上下文 | 设置 > 语义记忆 | [[memory]] |
| 记忆 | 搜索历史、自动注入上下文、身份信号提取 | 设置 > 语义记忆 | [[memory]] |
| 配置 | 模型/API/工作区/安全存储 | 设置面板 (19 页) | [[development]] |
| SaaS | 登录注册、订阅计费、Admin 管理 | SaaS 平台 / Admin 后台 | [[saas]] |
| 管家 | 痛点积累、行业配置、简洁/专业模式 | 聊天面板 (默认模式) | [[butler]] |
| 管家 | 痛点积累、行业配置、简洁/专业模式、跨会话身份、动态建议 | 聊天面板 (默认模式) | [[butler]] |
| Pipeline | YAML 模板选择、配置、DAG 执行 | 工作流面板 | [[pipeline]] |
| 安全 | JWT 认证、TOTP 2FA、操作审计 | 设置 > 安全存储 | [[security]] |
| 数据 | PostgreSQL (42表) + SQLite/FTS5 (本地记忆) | — | [[data-model]] |
@@ -97,5 +97,7 @@ ZCLAW
| Agent 创建失败 | [[chat]] | [[saas]] | 权限或持久化问题 |
| Pipeline 执行卡住 | [[pipeline]] | [[middleware]] | DAG 循环 / 依赖缺失 |
| Admin 页面 403 | [[saas]] | [[security]] | JWT 过期 / admin_guard 拦截 |
| Agent 名字不记住 | [[butler]] | [[memory]] | soul.md 写入失败 / identity signal 未提取 |
| 建议不个性化 | [[chat]] | [[butler]] | 4路上下文超时 / ExperienceExtractor 未初始化 |
> 数字真相源: `docs/TRUTH.md` — 如有冲突以代码实际为准