diff --git a/docs/TRUTH.md b/docs/TRUTH.md index de46a9d..589786b 100644 --- a/docs/TRUTH.md +++ b/docs/TRUTH.md @@ -1,6 +1,6 @@ # ZCLAW 系统真相文档 -> **更新日期**: 2026-04-04 +> **更新日期**: 2026-04-05 > **数据来源**: V11 全面审计 + 二次审计 + V12 模块化端到端审计 + 代码全量扫描验证 > **规则**: 此文档是唯一真相源。所有其他文档如果与此冲突，以此为准。 @@ -28,7 +28,8 @@ | Zustand Store | 18 个 | ls desktop/src/store/ (含 chat/ 子目录) | | React 组件 | ~135 个 | find desktop/src/components/ (*.tsx/*.ts) | | 前端 TypeScript 测试 | 23 个文件 | 1 单元 + 22 E2E spec | -| Admin V2 页面 | 14 个 | admin-v2/src/pages/ 全量统计（含 ScheduledTasks） | +| Admin V2 页面 | 15 个 | admin-v2/src/pages/ 全量统计（含 ScheduledTasks、ConfigSync） | +| 桌面端设置页面 | 19 个 | SettingsLayout.tsx tabs: 通用/用量统计/积分详情/模型与API/MCP服务/技能/IM频道/工作区/数据与隐私/安全存储/SaaS平台/订阅与计费/语义记忆/安全状态/审计日志/定时任务/心跳配置/提交反馈/关于 | | Admin V2 测试 | 322 个 | vitest 统计 | | 中间件层 | 11 层 | 运行时注册 | @@ -185,3 +186,4 @@ Viking 5 个孤立 invoke 调用已于 2026-04-03 清理移除： | 2026-04-03 | 数字全面验证校准：SaaS API 93→131 (新增 knowledge 23 + billing 10 + role 11 等模块增长)、Rust 测试 584→383、React 组件 ~50→~135、前端测试 21→23、SaaS Workers 5→7 (新增 aggregate_usage/generate_embedding)、SaaS 路由模块 10→12、数据表 25→34 | | 2026-04-03 | 前端改进记录：(1) Pipeline 8 invoke 接通前端 (2) Viking 5 孤立 invoke 清理 + 2 新方法+UI (3) api-fallbacks _isFallback 标记 + console.warn 日志 (4) MessageSearch 恢复到 ChatArea (5) scheduled_task Admin V2 完整接入 (service+page+route+nav) | | 2026-04-04 | V12 模块化审计后更新：(1) Pipeline 模板 10→17 YAML (2) Hands 禁用说明细化（无 TOML/Rust 实现） (3) SEC2-P1-01 FactStore 标记 FALSE_POSITIVE (4) V11-P1-03 SQL 表标记 FALSE_POSITIVE (5) M11-02 map_err 已修复 (6) M4-04 深层 WONTFIX | +| 2026-04-05 | Admin V2 页面数 14→15（新增 ConfigSync 页面）；桌面端设置页面确认为 19 个 | diff --git a/docs/features/00-architecture/02-state-management.md b/docs/features/00-architecture/02-state-management.md index 11a7e88..ab79cb7 100644 --- a/docs/features/00-architecture/02-state-management.md +++ b/docs/features/00-architecture/02-state-management.md @@ -108,21 +108,24 @@ ``` store/ -├── connectionStore.ts # 连接状态管理 -├── chatStore.ts # 聊天状态 (最复杂) -├── configStore.ts # 配置状态 -├── agentStore.ts # Agent 状态 -├── handStore.ts # Hand 状态 -├── workflowStore.ts # 工作流状态 -├── teamStore.ts # 团队状态 -├── gatewayStore.ts # Gateway 客户端状态 -├── securityStore.ts # 安全配置 -├── sessionStore.ts # 会话持久化 -├── memoryGraphStore.ts # 记忆图谱 -├── offlineStore.ts # 离线模式 -├── activeLearningStore.ts # 主动学习 -├── browserHandStore.ts # Browser Hand -└── skillMarketStore.ts # 技能市场 +├── agentStore.ts # Agent 克隆管理 +├── artifactStore.ts # 生成物管理 +├── browserHandStore.ts # Browser Hand 状态 +├── chatStore.ts # 聊天协调器 (sub-store 入口) +├── classroomStore.ts # 课堂/教学场景 +├── configStore.ts # 配置持久化 +├── connectionStore.ts # 连接状态管理 +├── conversationStore.ts # 会话管理 (chatStore sub-store) +├── handStore.ts # Hand 触发管理 +├── memoryGraphStore.ts # 记忆图谱 +├── messageStore.ts # 消息管理 (chatStore sub-store) +├── offlineStore.ts # 离线模式 +├── saasStore.ts # SaaS 平台集成 +├── securityStore.ts # 安全配置 +├── sessionStore.ts # 会话持久化 +├── streamStore.ts # 流式响应 (chatStore sub-store) +├── workflowBuilderStore.ts # 工作流构建器 +└── workflowStore.ts # 工作流管理 ``` ### 3.2 核心 Store 设计 @@ -306,7 +309,7 @@ export const useChatStore = create()( | 指标 | 基线 | 目标 | 当前 | |------|------|------|------| | 测试覆盖 | 50% | 80% | 85% | -| Store 数量 | 5 | 10+ | 15 | +| Store 数量 | 5 | 10+ | 18 | | 持久化比例 | 30% | 70% | 65% | --- @@ -315,7 +318,7 @@ export const useChatStore = create()( ### 5.1 已实现功能 -- [x] 15 个专用 Store +- [x] 18 个专用 Zustand Store (含 ChatStore 4 sub-store 拆分) - [x] 持久化中间件 - [x] 依赖注入模式 - [x] 跨 Store 通信 diff --git a/docs/features/00-architecture/03-security-auth.md b/docs/features/00-architecture/03-security-auth.md index 2a70efd..71eede1 100644 --- a/docs/features/00-architecture/03-security-auth.md +++ b/docs/features/00-architecture/03-security-auth.md @@ -3,7 +3,7 @@ > **分类**: 架构层 > **优先级**: P0 - 决定性 > **成熟度**: L4 - 生产 -> **最后更新**: 2026-04-01 +> **最后更新**: 2026-04-06 --- diff --git a/docs/features/README.md b/docs/features/README.md index 96cd489..e199a5e 100644 --- a/docs/features/README.md +++ b/docs/features/README.md @@ -82,7 +82,7 @@ > **架构重构成果 (Phase 0-4)**: > - **Worker 系统**: 7 个 Worker (log_operation, cleanup_rate_limit, cleanup_refresh_tokens, record_usage, update_last_used, aggregate_usage, generate_embedding)，基于 mpsc channel 的异步调度，支持自动重试 > - **声明式 Scheduler**: TOML 配置定时任务，支持 run_on_start、灵活间隔 (30s/5m/1h/1d)，无需改代码调整调度 -> - **SQL 迁移系统**: Schema v6，TIMESTAMPTZ 时间戳类型，从 migrations/ 目录加载 SQL 文件，向后兼容 TEXT 类型旧库 +> - **SQL 迁移系统**: Schema v8，TIMESTAMPTZ 时间戳类型，从 migrations/ 目录加载 SQL 文件，向后兼容 TEXT 类型旧库 > - **多环境配置**: ZCLAW_ENV 环境选择 (development/production/test)，ZCLAW_SAAS_CONFIG 精确路径，ZCLAW_DATABASE_URL 覆盖 > - **连接池优化**: 50 max / 5 min 连接，10s 获取超时，300s 空闲超时，1800s 最大生命周期 > - **速率限制优化**: 无锁 AtomicU32 读取 RPM，DashMap + 60s 滑动窗口，300s 定期清理 @@ -100,8 +100,8 @@ | **Rust Crates** | **10** (types, memory, runtime, kernel, skills, hands, protocols, pipeline, growth, saas) | | **SKILL.md 文件** | **75** | | **Hands 总数** | **11** (9 启用, 2 禁用: Predictor, Lead) | -| **Pipeline 模板** | **5** | -| **Tauri 命令** | **171** | +| **Pipeline 模板** | **17** YAML | +| **Tauri 命令** | **177** | | **SaaS API 路由** | **131** (含 2 个 dev-only mock) | | **SaaS Workers** | **7** (log_operation, cleanup_rate_limit, cleanup_refresh_tokens, record_usage, update_last_used, aggregate_usage, generate_embedding) | | **SQL Schema 版本** | **v8** (TIMESTAMPTZ 类型, 声明式迁移, password_version, rate_limit_events, is_embedding) | @@ -112,8 +112,8 @@ | **内置工具** | **7** (file_read, file_write, shell_exec, web_fetch, execute_skill, skill_load, task) | | **Agent Growth System** | SqliteStorage + FTS5 + TF-IDF + Memory Extractor + ExtractionAdapter (闭环) | | **安全审计** | 渗透测试 V1: 5 HIGH + 10 MEDIUM 全部修复, 整体评级 B+ | -| **Admin V2** | Vite + React + Ant Design Pro, 13 页面, HttpOnly Cookie 认证 | -| **运行时中间件** | 11 层: Compaction, Memory, LoopGuard, TokenCalibration, SkillIndex, Title, DanglingTool, ToolError, ToolOutputGuard, Guardrail, SubagentLimit | +| **Admin V2** | Vite + React + Ant Design Pro, 15 页面, HttpOnly Cookie 认证 | +| **运行时中间件** | 12 层: Compaction, Memory, LoopGuard, TokenCalibration, SkillIndex, Title, DanglingTool, ToolError, ToolOutputGuard, Guardrail, SubagentLimit, Clarification | --- @@ -126,7 +126,7 @@ zclaw-memory (L2: 存储层, SQLite + FactStore) — 92% ↑ zclaw-runtime (L3: 运行时, 4 Driver, 7 工具, 11 层中间件) — 92% ↑ -zclaw-kernel (L4: 核心协调, 9 Hands, 75 Skills, Trigger, Export) — 88% +zclaw-kernel (L4: 核心协调, 9 Hands, 75 Skills, Trigger, Export, Clarification) — 88% ↑ ┌───┴───┬───────┬───────────┬──────────┐ │ │ │ │ │ @@ -173,6 +173,7 @@ zclaw-saas — 独立运行 (Axum + PostgreSQL, 端口 8080) — 98% | 日期 | 版本 | 变更内容 | |------|------|---------| +| 2026-04-06 | v0.11.0 | DeerFlow 2.0 核心能力借鉴：(1) ask_clarification 工具 + ClarificationMiddleware + ClarificationCard 前端渲染 (2) 渐进式技能加载 — 只注入元数据 + load_skill_content 工具 (3) 模式差异化行为 — Ultra 启用子Agent (4) present_file Artifact 输出物接通 (5) 子Agent 流式进度推送 (6) ask_clarification 澄清系统 (7) 子Agent 唯一 ID 匹配 (task_id 贯穿 6 层) (8) AgentState 序列化 lowercase 修复 (9) pre-existing TS errors 清理 | | 2026-04-03 | v0.10.2 | 行业模板二次深度审计修复：3CRITICAL+6HIGH 全修复 — createFromTemplate 接入后端 API (tools 合并/source_template_id)、种子数据 source='builtin'、不可变 clone 返回、restoreSession 恢复 assignedTemplate、logout 清理模板状态、assignTemplate 错误传播、输入验证、删除死路由、console.warn→logger、model fallback gpt-4o-mini、pgvector 可选、relay 超时 90s | | 2026-04-03 | v0.10.1 | 数字校准：SaaS API 58→131（新增 knowledge 23 + billing 10 + model_config 16 等）、SaaS Workers 5→7、SaaS 模块 10→12、数据表 25→34、Tauri 命令 175→171（注释排除）、SKILL 76→75、Admin 页面 11→13 | | 2026-04-01 | v0.10.0 | 文档全面更新：SKILL 数量 75、Tauri 命令 130+、API 路由 72+、Admin V2 (Ant Design Pro) 迁移记录、安全渗透测试 V1 修复记录、Schema v8、11 层中间件链、kernel.rs 拆分为 9 子模块、intelligence-client.ts 拆分为 9 子模块 | diff --git a/docs/features/roadmap.md b/docs/features/roadmap.md index c24e8e7..87101f2 100644 --- a/docs/features/roadmap.md +++ b/docs/features/roadmap.md @@ -1,7 +1,7 @@ # ZCLAW 后续工作计划 > **版本**: v0.10.1 -> **更新日期**: 2026-04-03 +> **更新日期**: 2026-04-06 > **基于**: 2026-04-03 代码状态全面梳理 > **状态**: 核心功能完整，安全审计 V1 通过 (B+), Admin V2 迁移完成, DeerFlow 视觉复刻完成 @@ -17,12 +17,12 @@ | 功能完成度 | 核心功能 92-98%，整体 ~90% | | 技能数量 | 75 SKILL.md | | Hands 可用 | 9 启用 (Browser/Slideshow/Speech/Quiz/Whiteboard/Researcher/Collector/Clip/Twitter) + 2 禁用 (Predictor/Lead) | -| Pipeline DSL | 完整实现 (v1/v2 DSL, 5 模板 + Smart Presentation) | +| Pipeline DSL | 完整实现 (v1/v2 DSL, 17 模板 + Smart Presentation) | | SaaS 平台 | 完整实现 (131 API, 12 模块, 34 数据表, 7 Workers, 声明式 Scheduler) | -| Tauri 命令 | 171 (kernel 42 + pipeline 14 + browser 23 + intelligence 35 + memory 16 + gateway 11 + viking 13 + llm 3 + secure_storage 4 + classroom 8 + health 2) | +| Tauri 命令 | 177 (160 @connected + 16 @reserved + 1 unregistered identity_init) | | LLM Provider | 8 个 (Kimi, Qwen, DeepSeek, Zhipu, OpenAI, Anthropic, Gemini, Local) | | 连接模式 | 3 种 (Kernel / Gateway / SaaS) | -| Admin V2 | Vite + React + Ant Design Pro (13 页面, 322 测试) | +| Admin V2 | Vite + React + Ant Design Pro (15 页面, 322 测试) | | 安全评级 | B+ (渗透测试 V1: 5 HIGH + 10 MEDIUM 全部已修复) | | 中间件链 | 11 层 (Compaction/Memory/LoopGuard/TokenCalibration/SkillIndex/Title/DanglingTool/ToolError/ToolOutputGuard/Guardrail/SubagentLimit) | @@ -130,7 +130,7 @@ | 方向 | 目标用户 | 核心价值 | 差异化 | |------|---------|---------|--------| -| 个人版 | 个人开发者 | 效率提升 | 本地优先 + 记忆 + 69 技能 | +| 个人版 | 个人开发者 | 效率提升 | 本地优先 + 记忆 + 75 技能 | | 团队版 | 小团队 (5-20人) | 协作增强 | SaaS 平台 + Pipeline DSL | | 企业版 | 中大型企业 | 安全合规 | 私有部署 + 审计 + RBAC |