Files
zclaw_openfang/docs/features/roadmap.md
iven 834aa12076
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
fix: P0 panic风险修复 + P1编译warnings清零 + P2代码/文档清理
P0 安全性:
- account/handlers.rs: .unwrap() → .expect() 语义化错误信息
- relay/handlers.rs: SSE Response .unwrap() → .expect()

P1 编译质量 (6 warnings → 0):
- kernel.rs: 移除未使用的 Capability import 和 config_clone 变量
- pipeline_commands.rs: 未使用变量 id → _id
- db.rs: 移除多余括号
- relay/service.rs: 移除未使用的 StreamExt import
- telemetry/service.rs: 抑制 param_idx 未读赋值警告
- main.rs: TcpKeepalive::with_retries() Linux-only 条件编译

P2 代码清理:
- 移除 handStore/HandsPanel/HandTaskPanel/gateway-api/SchedulerPanel 调试 console.log
- SchedulerPanel: 修复 updateWorkflow 未解构导致 TS 编译错误
- 文档清理 zclaw-channels 已移除 crate 的引用
2026-03-30 11:33:47 +08:00

174 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ZCLAW 后续工作计划
> **版本**: v0.7.0
> **更新日期**: 2026-03-28
> **基于**: 2026-03-28 代码分析
> **状态**: 核心功能完整SaaS 平台上线
---
## 一、执行摘要
### 1.1 当前状态
| 指标 | 状态 |
|------|------|
| Rust Crates | **11 个** (types, memory, runtime, kernel, skills, hands, protocols, pipeline, growth, channels, saas) |
| 功能完成度 | 核心功能 90-95%,整体 ~85% |
| 技能数量 | 69 SKILL.md |
| Hands 可用 | 9 (编程式注册2 个标记 demo) |
| Pipeline DSL | 完整实现 (5 模板 + Smart Presentation) |
| SaaS 平台 | 完整实现 (76+ API, 9 模块, 25 数据表) |
| Tauri 命令 | 58+ (kernel 29 + pipeline 13 + viking 13 + llm 3) |
| LLM Provider | 8 个 (含 Gemini) |
| 连接模式 | 3 种 (Kernel / Gateway / SaaS) |
| 测试覆盖 | ~135 tests |
### 1.2 Crate 完整度
| Crate | 层级 | 完整度 | 说明 |
|-------|------|--------|------|
| zclaw-types | L1 | 95% | 完全可用 |
| zclaw-memory | L2 | 90% | SQLite WAL |
| zclaw-runtime | L3 | 90% | 4 Driver, 5 工具, LoopGuard |
| zclaw-kernel | L4 | 85% | 9 Hands, 69 Skills, Trigger, Approval |
| zclaw-skills | L5 | 80% | Wasm/Native 待实现 |
| zclaw-hands | L5 | 85% | 9 Hands, 2 demo |
| zclaw-protocols | L5 | 75% | MCP 可用, A2A 待完善 |
| zclaw-pipeline | L5 | 95% | DSL + Smart Presentation |
| zclaw-growth | L5 | 95% | FTS5 + TF-IDF + Memory Extractor |
| zclaw-saas | 独立 | 95% | Axum + PostgreSQL, 76+ API |
| ~~zclaw-channels~~ | ~~L5~~ | **已移除** | crate 已清理,功能通过飞书 API 实现 |
---
## 二、短期计划 (1-2 周)
### 2.1 P0 - 必须完成
| ID | 任务 | 预估 | 状态 |
|----|------|------|------|
| S1 | 实现 Approval 管理后端 (非存根) | 4h | 待开始 |
| S2 | 完善 A2A 协议完整度 | 4h | 待开始 |
| S3 | hand_run_status / hand_run_list 真实实现 | 3h | 待开始 |
| S4 | scheduled_task_create 自动执行 | 3h | 待开始 |
### 2.2 P1 - 应该完成
| ID | 任务 | 预估 | 状态 |
|----|------|------|------|
| S5 | 提升 SaaS 测试覆盖率 | 8h | 待开始 |
| S6 | 完善 MCP 协议工具验证 | 3h | 待开始 |
| S7 | Browser Hand 稳定性增强 | 4h | 待开始 |
| S8 | Admin UI 完善批量操作 | 3h | 待开始 |
### 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 错误提示中文化 | ✅ 完成 |
---
## 三、中期计划 (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 |
---
*文档结束*