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

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<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 通信

docs/features/00-architecture/03-security-auth.md

@@ -3,7 +3,7 @@
 > **分类**: 架构层
 > **优先级**: P0 - 决定性
 > **成熟度**: L4 - 生产
-> **最后更新**: 2026-04-01
+> **最后更新**: 2026-04-06
 
 ---
 

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

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 |