# ZCLAW 后续工作计划

> **版本**: v0.10.1
> **更新日期**: 2026-04-03
> **基于**: 2026-04-03 代码状态全面梳理
> **状态**: 核心功能完整，安全审计 V1 通过 (B+), Admin V2 迁移完成, DeerFlow 视觉复刻完成

---

## 一、执行摘要

### 1.1 当前状态

| 指标 | 状态 |
|------|------|
| Rust Crates | **10 个** (types, memory, runtime, kernel, skills, hands, protocols, pipeline, growth, saas) |
| 功能完成度 | 核心功能 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) |
| 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) |
| LLM Provider | 8 个 (Kimi, Qwen, DeepSeek, Zhipu, OpenAI, Anthropic, Gemini, Local) |
| 连接模式 | 3 种 (Kernel / Gateway / SaaS) |
| Admin V2 | Vite + React + Ant Design Pro (13 页面, 322 测试) |
| 安全评级 | B+ (渗透测试 V1: 5 HIGH + 10 MEDIUM 全部已修复) |
| 中间件链 | 11 层 (Compaction/Memory/LoopGuard/TokenCalibration/SkillIndex/Title/DanglingTool/ToolError/ToolOutputGuard/Guardrail/SubagentLimit) |

### 1.2 Crate 完整度

| Crate | 层级 | 完整度 | 说明 |
|-------|------|--------|------|
| zclaw-types | L1 | 95% | 完全可用 |
| zclaw-memory | L2 | 92% | SQLite WAL + FactStore |
| zclaw-runtime | L3 | 92% | 4 Driver, 7 工具, 11 层中间件, PromptBuilder |
| zclaw-kernel | L4 | 88% | 9 Hands, 75 Skills, Trigger, Approval, Scheduler, Export |
| zclaw-skills | L5 | 85% | 语义路由 + DAG 编排, Wasm/Native 待实现 |
| zclaw-hands | L5 | 88% | 9 Hands 全部实现 (含 Twitter 12 API) |
| zclaw-protocols | L5 | 80% | MCP 完整, A2A 消息路由+群组+发现 |
| zclaw-pipeline | L5 | 95% | v1/v2 DSL + Smart Presentation + 意图路由 |
| zclaw-growth | L5 | 95% | FTS5 + TF-IDF + 记忆闭环 (提取/检索/注入) |
| zclaw-saas | 独立 | 98% | Axum + PostgreSQL, 131 API, 安全审计 B+ |

---

## 二、短期计划 (1-2 周)

### 2.1 P0 - 必须完成

| ID | 任务 | 预估 | 状态 |
|----|------|------|------|
| S1 | 实现 Approval 管理后端 (非存根) | 4h | ✅ 已完成 (P0 KernelClient 修复) |
| S2 | 完善 A2A 协议完整度 | 4h | ✅ 已完成 (消息重入+广播修复+group管理) |
| S3 | hand_run_status / hand_run_list 真实实现 | 3h | ✅ 已完成 (P0 KernelClient 修复) |
| S4 | scheduled_task_create 自动执行 | 3h | ✅ 已完成 (SaaS后端+30s轮询) |

### 2.2 P1 - 应该完成

| ID | 任务 | 预估 | 状态 |
|----|------|------|------|
| S5 | 提升 SaaS 测试覆盖率 | 8h | ✅ 已完成 (Admin V2: 322 测试) |
| S6 | 完善 MCP 协议工具验证 | 3h | 待开始 |
| S7 | Browser Hand 稳定性增强 | 4h | 待开始 |
| S8 | 定时任务后端持久化 | 4h | ✅ 已完成 (migration v7 + CRUD + scheduler loop) |

### 2.3 已完成项

| ID | 任务 | 状态 |
|----|------|------|
| S1-old | 智能层接入聊天流程 | ✅ 完成 |
| S2-old | 双存储统一 (VikingStorage) | ✅ 完成 |
| S3-old | Hand 审批流程 | ✅ 完成 |
| S4-old | Gemini/Local LLM 驱动 | ✅ 完成 |
| S5-old | WorkflowBuilder 可视化 | ✅ 完成 |
| S7-old | Compactor 接入聊天流程 | ✅ 完成 |
| S9-old | 消息搜索 (Session + Global) | ✅ 完成 |
| S10-old | Rust 错误提示中文化 | ✅ 完成 |
| Audit | P0-P3 全面审计修复 | ✅ 完成 (6 commits) |
| Deps | serde_yaml 迁移 + workspace 统一 | ✅ 完成 |
| Admin | Admin V2 Ant Design Pro 重写 | ✅ 完成 |
| Clean | console.log 清理 (16 文件) | ✅ 完成 |
| F16 | Auth Token HttpOnly Cookie | ✅ 完成 |
| S4/S8 | 定时任务后端持久化 | ✅ 完成 |
| S2/A2A | 消息重入队列+广播修复+group管理 | ✅ 完成 |

---

## 三、中期计划 (1-2 月)

### 3.1 架构优化

| ID | 任务 | 价值 | 风险 | 优先级 |
|----|------|------|------|--------|
| M1 | WASM/Native 技能模式 | 高 | 中 | P1 |
| M2 | A2A 协议完整实现 | 高 | 中 | P1 |
| M3 | Agent 持久化存储优化 | 高 | 低 | P1 |
| M4 | 测试覆盖提升到 80% | 高 | 低 | P1 |

### 3.2 用户体验优化

| ID | 任务 | 价值 | 风险 | 优先级 |
|----|------|------|------|--------|
| M5 | 记忆图谱可视化 (React Flow) | 高 | 中 | P1 |
| M6 | 技能市场 MVP | 高 | 中 | P1 |
| M7 | 工作流编辑器增强 | 高 | 中 | P1 |
| M8 | 主动学习引擎 | 高 | 高 | P2 |

### 3.3 SaaS 增强

| ID | 任务 | 价值 | 风险 | 优先级 |
|----|------|------|------|--------|
| M9 | SaaS 多租户隔离增强 | 高 | 中 | P1 |
| M10 | Prompt A/B 测试 | 中 | 低 | P2 |
| M11 | Agent Template 市场 | 中 | 中 | P2 |
| M12 | Webhook/Callback 系统 | 高 | 低 | P1 |

### 3.4 性能优化

| ID | 任务 | 目标 | 当前 | 改进 |
|----|------|------|------|------|
| P1 | 消息列表虚拟化 | 1000 条流畅 | 100 条流畅 | 10x |
| P2 | 记忆索引优化 | <20ms | ~50ms | 2.5x |
| P3 | 启动时间优化 | <2s | ~3s | 1.5x |

---

## 四、长期愿景 (3-6 月)

### 4.1 产品方向

| 方向 | 目标用户 | 核心价值 | 差异化 |
|------|---------|---------|--------|
| 个人版 | 个人开发者 | 效率提升 | 本地优先 + 记忆 + 69 技能 |
| 团队版 | 小团队 (5-20人) | 协作增强 | SaaS 平台 + Pipeline DSL |
| 企业版 | 中大型企业 | 安全合规 | 私有部署 + 审计 + RBAC |

### 4.2 待实现功能

| 功能 | 优先级 | 预计完成 |
|------|--------|---------|
| WASM/Native 技能模式 | P1 | Q3 |
| A2A 协议完整实现 | P1 | Q3 |
| 云同步服务 | P2 | Q4 |
| 技能共享社区 | P3 | Q4 |
| 企业部署版本 | P3 | Q4 |

---

## 五、关键决策

### 5.1 已确定

| 决策项 | 决策 | 时间 |
|--------|------|------|
| 架构 | 内部 Kernel + SaaS 双轨 | 2026-03-24 |
| 模型策略 | 多模型切换 (8 Provider) | 2026-03-24 |
| SaaS 存储 | PostgreSQL (非 SQLite) | 2026-03-27 |
| SaaS 认证 | JWT + API Token + TOTP 2FA | 2026-03-27 |

### 5.2 待定

| 决策项 | 选项 | 截止 |
|--------|------|------|
| 记忆存储 | 纯本地 vs 可选云同步 | Q2 结束 |
| 开源策略 | 完全开源 vs 核心闭源 | Q3 开始 |
| 定价模式 | 免费 vs 付费 vs 混合 | Q3 开始 |

---

## 六、成功指标

| 指标 | Q2 目标 | Q3 目标 |
|------|---------|---------|
| 测试覆盖率 | 80% | 90% |
| SaaS API 完整度 | 100% | 100% |
| 错误率 | <1% | <0.5% |
| 响应时间 | <200ms | <100ms |

---

*文档结束*