From e88c51fd85fee559ffa5d57756c8243bd61f6237 Mon Sep 17 00:00:00 2001 From: iven Date: Sat, 18 Apr 2026 14:09:47 +0800 Subject: [PATCH] =?UTF-8?q?docs(wiki):=20=E5=8F=91=E5=B8=83=E5=89=8D?= =?UTF-8?q?=E5=AE=A1=E8=AE=A1=E6=95=B0=E5=80=BC=E6=A0=A1=E5=87=86=20?= =?UTF-8?q?=E2=80=94=20TRUTH/CLAUDE/wiki=20=E4=B8=89=E7=AB=AF=E5=90=8C?= =?UTF-8?q?=E6=AD=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit TRUTH.md: - #[test] 433→425, #[tokio::test] 368→309 (2026-04-18 验证) - Zustand Store 21→26, Admin V2 页面 15→17 - Pipeline YAML 17→18 - Hands 启用 9→7 (6 HAND.toml + _reminder)，Whiteboard/Slideshow/Speech 标注开发中 CLAUDE.md §6: - Hands 12 个能力包 (7 注册 + 3 开发中 + 2 禁用) - §13 架构快照同步 wiki/index.md: - 关键数字同步更新 --- CLAUDE.md | 15 ++++++++------- docs/TRUTH.md | 16 +++++++++------- wiki/index.md | 8 ++++---- 3 files changed, 21 insertions(+), 18 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 721ad91..94b6382 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -227,21 +227,22 @@ Client → 负责网络通信和协议转换 ## 6. 自主能力系统 (Hands) -ZCLAW 提供 11 个自主能力包（9 启用 + 2 禁用）： +ZCLAW 提供 12 个自主能力包（7 已注册 + 3 开发中 + 2 禁用）： | Hand | 功能 | 状态 | |------|------|------| | Browser | 浏览器自动化 | ✅ 可用 | | Collector | 数据收集聚合 | ✅ 可用 | | Researcher | 深度研究 | ✅ 可用 | -| Predictor | 预测分析 | ❌ 已禁用 (enabled=false)，无 Rust 实现 | -| Lead | 销售线索发现 | ❌ 已禁用 (enabled=false)，无 Rust 实现 | | Clip | 视频处理 | ⚠️ 需 FFmpeg | | Twitter | Twitter 自动化 | ✅ 可用（12 个 API v2 真实调用，写操作需 OAuth 1.0a） | -| Whiteboard | 白板演示 | ✅ 可用（导出功能开发中，标注 demo） | -| Slideshow | 幻灯片生成 | ✅ 可用 | -| Speech | 语音合成 | ✅ 可用（Browser TTS 前端集成完成） | | Quiz | 测验生成 | ✅ 可用 | +| _reminder | 系统内部提醒 | ✅ 可用（kernel 编程注册，无 HAND.toml） | +| Whiteboard | 白板演示 | 🚧 开发中（HAND.toml 未合并到主分支） | +| Slideshow | 幻灯片生成 | 🚧 开发中（HAND.toml 未合并到主分支） | +| Speech | 语音合成 | 🚧 开发中（HAND.toml 未合并到主分支） | +| Predictor | 预测分析 | ❌ 已禁用 (enabled=false)，无 Rust 实现 | +| Lead | 销售线索发现 | ❌ 已禁用 (enabled=false)，无 Rust 实现 | **触发 Hand 时：** 1. 检查依赖是否满足 @@ -544,7 +545,7 @@ refactor(store): 统一 Store 数据获取方式 | 记忆管道 (Memory) | ✅ 稳定 | 04-17 E2E 验证: 存储+FTS5+TF-IDF+注入闭环，去重+跨会话注入已修复 | | SaaS 认证 (Auth) | ✅ 稳定 | Token池 RPM/TPM 轮换 + JWT password_version 失效机制 | | Pipeline DSL | ✅ 稳定 | 04-01 17 个 YAML 模板 + DAG 执行器 | -| Hands 系统 | ✅ 稳定 | 9 启用 (Browser/Collector/Researcher/Twitter/Whiteboard/Slideshow/Speech/Quiz/Clip) | +| Hands 系统 | ✅ 稳定 | 7 注册 (6 HAND.toml + _reminder)，Whiteboard/Slideshow/Speech 开发中 | | 技能系统 (Skills) | ✅ 稳定 | 75 个 SKILL.md + 语义路由 | | 中间件链 | ✅ 稳定 | 14 层 (ButlerRouter@80, DataMasking@90, Compaction@100, Memory@150, Title@180, SkillIndex@200, DanglingTool@300, ToolError@350, ToolOutputGuard@360, Guardrail@400, LoopGuard@500, SubagentLimit@550, TrajectoryRecorder@650, TokenCalibration@700) | diff --git a/docs/TRUTH.md b/docs/TRUTH.md index 64639d4..e69928e 100644 --- a/docs/TRUTH.md +++ b/docs/TRUTH.md @@ -1,7 +1,7 @@ # ZCLAW 系统真相文档 -> **更新日期**: 2026-04-16 -> **数据来源**: V11 全面审计 + 二次审计 + V12 模块化端到端审计 + 代码全量扫描验证 + 功能测试 Phase 1-5 + 发布前功能测试 Phase 3 + 发布前全面测试代码级审计 + 2026-04-11 代码验证 + V13 系统性功能审计 2026-04-12 + V13 审计修复 2026-04-13 + 发布前冲刺 Day1 2026-04-15 + 发布前深度测试 8 路并行代码级验证 2026-04-16 +> **更新日期**: 2026-04-18 +> **数据来源**: V11 全面审计 + 二次审计 + V12 模块化端到端审计 + 代码全量扫描验证 + 功能测试 Phase 1-5 + 发布前功能测试 Phase 3 + 发布前全面测试代码级审计 + 2026-04-11 代码验证 + V13 系统性功能审计 2026-04-12 + V13 审计修复 2026-04-13 + 发布前冲刺 Day1 2026-04-15 + 发布前深度测试 8 路并行代码级验证 2026-04-16 + 发布前审计 2026-04-18 > **规则**: 此文档是唯一真相源。所有其他文档如果与此冲突，以此为准。 --- @@ -12,7 +12,7 @@ |------|--------|----------| | Rust Crates | 10 个 (编译通过) | `cargo check --workspace` | | Rust 代码行数 | ~77,000 (crates) + ~61,400 (src-tauri) = ~138,400 | wc -l (2026-04-12 V13 验证) | -| Rust 单元测试 | 433 个 (#[test]) + 368 个 (#[tokio::test]) = 801 | `grep '#\[test\]' crates/` + `grep '#\[tokio::test\]'` (2026-04-12 V13 验证) | +| Rust 单元测试 | 425 个 (#[test]) + 309 个 (#[tokio::test]) = 734 | `grep '#\[test\]' crates/` + `grep '#\[tokio::test\]'` (2026-04-18 验证) | | Cargo Warnings (非 SaaS) | **0 个** (仅 sqlx-postgres 外部依赖 1 个) | `cargo check --workspace --exclude zclaw-saas` (2026-04-15 清零) | | Rust 测试运行通过 | 684 workspace + 138 SaaS = 822 | Hermes 4 Chunk `cargo test --workspace` 2026-04-09 | | Tauri 命令 | 190 个 | `grep '#\[.*tauri::command'` (2026-04-16 验证) | @@ -20,21 +20,22 @@ | **Tauri 命令已标注 @reserved** | **89 个** | Rust 源码 @reserved 标注 (2026-04-15 全量标注) | | **Tauri 命令孤儿 (无调用+无标注)** | **~0 个** (190 - 104 invoke - 89 @reserved ≈ -3，差异来自内部命令调用) | (2026-04-16 校准) | | SKILL.md 文件 | 75 个 | `ls skills/*.md \| wc -l` | -| Hands 启用 | 9 个 | Browser/Collector/Researcher/Clip/Twitter/Whiteboard/Slideshow/Speech/Quiz（均有 HAND.toml） | +| Hands 启用 | 7 个 (6 HAND.toml + 1 系统内部 _reminder) | Browser/Collector/Researcher/Clip/Twitter/Quiz = 6 个有 HAND.toml；ReminderHand 通过 kernel 编程注册（`_` 前缀豁免 HAND.toml 扫描） | +| Hands 开发中 | 3 个 | Whiteboard/Slideshow/Speech（HAND.toml 仅存在于 worktree 开发分支，无 `impl Hand for`，未合并到主分支） | | Hands 禁用 | 2 个 | Predictor, Lead（概念定义存在，无 TOML 配置文件或 Rust 实现） | -| Pipeline 模板 | 17 个 YAML | `pipelines/` 目录全量统计（含 _templates/ 和 design-shantou/ 子目录） | +| Pipeline 模板 | 18 个 YAML | `pipelines/` 目录全量统计 (2026-04-18 验证) | | SaaS API 端点 | 137 个 .route() | `grep .route( crates/zclaw-saas/` (2026-04-16 验证) | | SaaS 路由模块 | 12 个 + industry | account/agent_template/auth/billing/knowledge/migration/model_config/prompt/relay/role/scheduled_task/telemetry/industry（scheduled_task: 后端 5 CRUD + Admin V2 前端 service/page/route/nav） | | SaaS 数据表 | 34 个（含 saas_schema_version） | CREATE TABLE 全量统计 | | SaaS Workers | 7 个 | log_operation/cleanup_rate_limit/cleanup_refresh_tokens/record_usage/update_last_used/aggregate_usage/generate_embedding | | LLM Provider | 8 个 | Kimi/Qwen/DeepSeek/Zhipu/OpenAI/Anthropic/Gemini/Local | -| Zustand Store | 21 个 | find desktop/src/store/ -name "*.ts" (2026-04-12 V13 验证) | +| Zustand Store | 26 个 | find desktop/src/store/ -name "*.ts" (2026-04-18 验证，含子目录) | | React 组件 | 105 个 (.tsx/.ts) | find desktop/src/components/ (2026-04-15 新增 HealthPanel.tsx) | | 前端 TypeScript 测试 | 31 个文件 (6 store + 5 lib + 1 config + 1 stabilization + 18 E2E spec) | Phase 3-4 全量 | | 前端 lib | 76 个 .ts | find desktop/src/lib/ (2026-04-15 删除 intelligence-client/ 9 文件) | | 前端测试运行通过 | 344 passed + 1 skipped | `pnpm vitest run` (2026-04-15 验证) | | 生产构建 | **通过** (14.8s, 0 require 残留) | `pnpm build` (2026-04-15 验证) | -| Admin V2 页面 | 15 个 | admin-v2/src/pages/ 全量统计（含 ScheduledTasks、ConfigSync） | +| Admin V2 页面 | 17 个 | admin-v2/src/pages/ 全量统计 (2026-04-18 验证) | | 桌面端设置页面 | 19 个 | SettingsLayout.tsx tabs: 通用/用量统计/积分详情/模型与API/MCP服务/技能/IM频道/工作区/数据与隐私/安全存储/SaaS平台/订阅与计费/语义记忆/安全状态/审计日志/定时任务/心跳配置/提交反馈/关于 | | Admin V2 测试 | 17 个文件 (61 tests) | vitest 统计 | | 中间件层 | 14 层 | `grep chain.register kernel/mod.rs` (2026-04-16 验证: ButlerRouter@80, DataMasking@90, Compaction@100, Memory@150, Title@180, SkillIndex@200, DanglingTool@300, ToolError@350, ToolOutputGuard@360, Guardrail@400, LoopGuard@500, SubagentLimit@550, TrajectoryRecorder@650, TokenCalibration@700) | @@ -205,3 +206,4 @@ Viking 5 个孤立 invoke 调用已于 2026-04-03 清理移除： | 2026-04-12 | V13 系统性功能审计数字校准：(1) Tauri 命令 184→191 (2) 前端 invoke 105→106 (3) @reserved 33→24 (Butler/MCP已接通) (4) 孤儿命令 ~46→~61 (5) Rust 测试 798→801 (433+368) (6) SaaS .route() 122→136 (7) Zustand Store 20→21 (8) dead_code 76→43 (9) Rust LOC crates ~74.6K→~77K | | 2026-04-15 | Heartbeat 统一健康系统：(1) Tauri 命令 182→183 (+health_snapshot) (2) intelligence 模块 15→16 文件 (+health_snapshot.rs +heartbeat.rs 重构) (3) React 组件 104→105 (+HealthPanel.tsx) (4) 前端 lib 85→76 (删除 intelligence-client/ 9 文件) | | 2026-04-16 | 发布前深度测试 8 路并行验证 + 3 项 P0 修复：(1) Tauri 命令 183→190 (2) 前端 invoke 95→104 (3) SaaS .route() 136→137 (4) 中间件 15→14 (实际 chain.register 计数) (5) P0-01 Admin ApiKeys 创建功能修复 (/keys→/tokens 路由对齐) (6) P0-02 账户锁定 unwrap_or(false)→正确错误传播 (7) P0-03 Logout 增加 access token cookie fallback 撤销 refresh token | +| 2026-04-18 | 发布前审计数字校准 + Batch 1 修复：(1) Rust 测试 801→734 (#[test] 433→425 + #[tokio::test] 368→309) (2) Zustand Store 21→26 (3) Admin V2 页面 15→17 (4) Pipeline YAML 17→18 (5) Hands 启用 9→7 (6 HAND.toml + ReminderHand，Whiteboard/Slideshow/Speech 标注开发中) (6) Pipeline executor 内存泄漏 cleanup + 步骤超时 + Delay 上限 (7) Director send_to_agent oneshot channel 重构防死锁 (8) cleanup_rate_limit Worker 实现 (DELETE >1h) | diff --git a/wiki/index.md b/wiki/index.md index be6e899..0b29e53 100644 --- a/wiki/index.md +++ b/wiki/index.md @@ -24,15 +24,15 @@ status: active |------|-----|----------| | Rust Crates | 10 + src-tauri | `ls crates/zclaw-*/Cargo.toml` | | Rust 代码 | 77,811 行 (275 .rs文件) | `find crates/ src-tauri/ -name "*.rs"` | -| Rust 测试 | 801 (433 #[test] + 368 #[tokio::test]) | `grep '#\[test\]' / '#\[tokio::test\]'` (TRUTH.md 04-16) | +| Rust 测试 | 734 (425 #[test] + 309 #[tokio::test]) | `grep '#\[test\]' / '#\[tokio::test\]'` (TRUTH.md 04-18) | | Tauri 命令 | 190 定义 (103 src-tauri + 76 crates + 内部) | `grep '#\[tauri::command\]'` (TRUTH.md 04-16) | | 前端 invoke 调用 | 104 处 | `grep invoke( desktop/src/` (TRUTH.md 04-16) | | SaaS .route() | 137 个 | `grep .route( crates/zclaw-saas/` | | SaaS 模块 | 17 个目录 | `ls crates/zclaw-saas/src/*/` | | SKILL 目录 | 75 个 | `ls -d skills/*/` | -| HAND 配置 | 9 个 + 1 系统内部 (_reminder) (TOML) | `ls hands/*.HAND.toml` | -| Pipeline YAML | 17 个 | `find pipelines/ -name "*.yaml"` | -| Zustand Store | 17 文件 + chat/4子store = 21 (含 industryStore) | `find desktop/src/store/` | +| HAND 配置 | 6 TOML + 1 系统内部 (_reminder) = 7 注册 | `ls hands/*.HAND.toml` + kernel registry | +| Pipeline YAML | 18 个 | `find pipelines/ -name "*.yaml"` | +| Zustand Store | 26 个 (.ts, 含子目录) | `find desktop/src/store/` | | React 组件 | 105 个 (.tsx/.ts) | `find desktop/src/components/` (TRUTH.md 04-16) | | Admin V2 页面 | 17 个 (.tsx) | `ls admin-v2/src/pages/` | | 中间件 | 14 层 runtime + 10 层 SaaS HTTP | `kernel/mod.rs` + `zclaw-saas middleware` |