docs: complete features docs sync — roadmap, TRUTH, security-auth

- roadmap.md: Tauri 177, skills 75, Pipeline 17 templates, Admin 15 pages - TRUTH.md: Admin V2 15 pages, desktop settings 19 tabs, changelog entry - 02-state-management.md: expanded Store details and descriptions - 03-security-auth.md: updated date - README.md: DeerFlow 2.0 description, skill count correction
2026-04-06 22:49:07 +08:00
parent efc391a165
commit 29a1b3db5b
5 changed files with 37 additions and 31 deletions
--- 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 个 |
--- a/docs/features/00-architecture/02-state-management.md
+++ b/docs/features/00-architecture/02-state-management.md
@@ -108,21 +108,24 @@

 ```
 store/
+├── agentStore.ts           # Agent 克隆管理
+├── artifactStore.ts        # 生成物管理
+├── browserHandStore.ts     # Browser Hand 状态
+├── chatStore.ts            # 聊天协调器 (sub-store 入口)
+├── classroomStore.ts       # 课堂/教学场景
+├── configStore.ts          # 配置持久化
 ├── connectionStore.ts      # 连接状态管理
-├── chatStore.ts          # 聊天状态 (最复杂)
-├── configStore.ts        # 配置状态
-├── agentStore.ts         # Agent 状态
-├── handStore.ts          # Hand 状态
-├── workflowStore.ts      # 工作流状态
-├── teamStore.ts          # 团队状态
-├── gatewayStore.ts       # Gateway 客户端状态
+├── conversationStore.ts    # 会话管理 (chatStore sub-store)
+├── handStore.ts            # Hand 触发管理
+├── memoryGraphStore.ts     # 记忆图谱
+├── messageStore.ts         # 消息管理 (chatStore sub-store)
+├── offlineStore.ts         # 离线模式
+├── saasStore.ts            # SaaS 平台集成
 ├── securityStore.ts        # 安全配置
 ├── sessionStore.ts         # 会话持久化
-├── memoryGraphStore.ts   # 记忆图谱
-├── offlineStore.ts       # 离线模式
-├── activeLearningStore.ts # 主动学习
-├── browserHandStore.ts   # Browser Hand
-└── skillMarketStore.ts   # 技能市场
+├── streamStore.ts          # 流式响应 (chatStore sub-store)
+├── workflowBuilderStore.ts # 工作流构建器
+└── workflowStore.ts        # 工作流管理
 ```

 ### 3.2 核心 Store 设计
@@ -306,7 +309,7 @@ export const useChatStore = create<ChatState & ChatActions>()(
 | 指标 | 基线 | 目标 | 当前 |
 |------|------|------|------|
 | 测试覆盖 | 50% | 80% | 85% |
-| Store 数量 | 5 | 10+ | 15 |
+| Store 数量 | 5 | 10+ | 18 |
 | 持久化比例 | 30% | 70% | 65% |

 ---
@@ -315,7 +318,7 @@ export const useChatStore = create<ChatState & ChatActions>()(

 ### 5.1 已实现功能

- [x] 15 个专用 Store
+- [x] 18 个专用 Zustand Store (含 ChatStore 4 sub-store 拆分)
 - [x] 持久化中间件
 - [x] 依赖注入模式
 - [x] 跨 Store 通信
--- 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

 ---

--- 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 子模块 |
--- 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 |