iven/zclaw_openfang
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
14f8d4d3ad3e9e448383c01eb48d51e954ac96b1
zclaw_openfang/docs/features/roadmap.md
iven 14f8d4d3ad
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
Details
CI / Unit Tests (push) Has been cancelled
Details
CI / Build Frontend (push) Has been cancelled
Details
CI / Rust Check (push) Has been cancelled
Details
CI / Security Scan (push) Has been cancelled
Details
CI / E2E Tests (push) Has been cancelled
Details
feat(presentation): add Smart Presentation Layer for Pipeline output 
- Add PresentationAnalyzer in Rust backend (13 tests passing)
- Add PresentationContainer with auto type detection
- Add TypeSwitcher for manual type switching
- Add ChartRenderer, QuizRenderer, SlideshowRenderer, DocumentRenderer
- Integrate ResultModal into PipelinesPanel for result display
- Update docs: pipeline-overview.md, README.md, roadmap.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-26 18:32:23 +08:00

9.1 KiB
Raw Blame History

ZCLAW 后续工作计划

版本: v0.5.0 创建日期: 2026-03-16 更新日期: 2026-03-26 基于: 代码深度分析报告 状态: 活跃开发中

一、执行摘要

1.1 当前状态 (2026-03-26 代码分析)

指标 状态
Rust Crates 8 个 (types, memory, runtime, kernel, skills, hands, protocols, pipeline)
功能完成度 90-95% (核心功能 L4)
技能数量 78+ SKILL.md
Hands 可用 9/11 (82%)
Pipeline DSL ✅ 完整实现
Smart Presentation ✅ 完整实现 (Chart, Quiz, Slideshow, Document)
测试覆盖 ~65% (需提升)
文档覆盖 25+ 功能文档

1.2 Crate 完整度评估

Crate 层级 完整度 核心可用性
zclaw-types L1 95% 完全可用
zclaw-memory L2 90% 完全可用 (SQLite)
zclaw-runtime L3 90% 完全可用 (5 工具, 流式响应)
zclaw-kernel L4 85% 基本可用 (Approval 存根)
zclaw-skills L5 80% 可用 (WASM/Native 待实现)
zclaw-hands L5 85% 可用 (9/11 Hands)
zclaw-protocols L5 75% MCP 可用，A2A 待完善
zclaw-pipeline L5 95% 完全可用 + Smart Presentation

1.3 核心结论

优势:

  • 8 层 Rust Workspace 架构清晰
  • Agent 记忆系统完善 (ICE: 630)
  • L4 自演化能力已实现
  • 多 LLM Provider 支持 (8 个)
  • Pipeline DSL 成熟
  • 技能生态丰富 (78+)
  • Smart Presentation Layer 完成 - 自动类型检测和多渲染器支持

待改进:

  • Approval 管理是存根实现
  • A2A 协议需要更多工作
  • 测试覆盖率需要提升 (~65% → 80%)
  • 部分 Hand 需要外部依赖 (FFmpeg, Twitter API)

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

2.1 P0 - 必须完成

ID 任务 负责人 预估 验收标准
S1 实现 Approval 管理后端 Rust 4h 非存根实现，支持审批队列
S2 提升 A2A 协议完整度 Rust 4h Agent 间通信可用
S3 增加测试覆盖率 Rust/TS 8h 从 60% 提升到 75%
S4 完善功能文档覆盖 AI 2h 所有模块有文档

2.2 P1 - 应该完成

ID 任务 负责人 预估 验收标准
S5 优化审批 UI TS 3h 批量审批可用
S6 添加消息搜索功能 TS 4h 支持关键词搜索
S7 优化错误提示 TS 2h 错误有恢复建议
S8 添加用户反馈入口 TS 3h 反馈可收集和追踪

2.3 本周执行清单

- [x] Smart Presentation Layer (Chart, Quiz, Slideshow, Document 渲染器)
- [x] PresentationContainer 集成到 PipelinesPanel
- [ ] S1: 实现 Kernel Approval 管理 (非存根)
- [ ] S2: 完善 A2A 协议实现
- [ ] S3: 增加单元测试 (目标 +15%)
- [ ] S4: 更新功能文档基于代码分析
- [ ] S5: 实现批量审批组件
- [ ] S6: 添加 ChatArea 搜索框
- [ ] S7: 完善错误边界组件
- [ ] S8: 在 RightPanel 添加反馈按钮

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

3.1 架构优化

ID 任务 价值 风险 优先级
M1 完成 WASM/Native 技能模式 高 中 P1
M2 实现 Predictor Hand 中 低 P2
M3 实现 Lead Hand 中 低 P2
M4 完善测试覆盖到 80% 高 低 P1

3.2 用户体验优化

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

M5 记忆图谱详细设计:

技术方案:
- React Flow 可视化
- 力导向图布局
- 节点类型: fact, preference, lesson, context, task
- 边类型: 引用, 关联, 派生

交互设计:
- 点击节点: 显示详情
- 拖拽: 重新布局
- 筛选: 按类型/时间/重要性
- 搜索: 高亮匹配节点

M6 技能市场 MVP 范围:

功能范围:
- 技能浏览和搜索
- 技能详情展示
- 一键安装/卸载
- 技能评分和评论

不包含 (后续版本):
- 付费技能
- 技能提交
- 版本管理

3.3 性能优化

ID 任务 目标 当前 改进
M9 消息列表虚拟化 1000条流畅 100条流畅 10x
M10 记忆索引优化 <20ms ~50ms 2.5x
M11 启动时间优化 <2s ~3s 1.5x
M12 SQLite 查询优化 <10ms ~30ms 3x

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

4.1 产品方向

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

4.2 技术演进

阶段 重点 关键里程碑
Q2 稳定性 测试覆盖 80%，Approval 完善，A2A 完整
Q3 能力扩展 WASM 技能，云同步，主动学习
Q4 生态建设 社区，插件市场，企业部署

4.3 商业化路径

阶段 1: 产品完善 (Q2)
    │
    ├── 完善核心功能
    ├── 提升测试覆盖
    └── 完善文档
    │
    ▼
阶段 2: 开源建设 (Q3)
    │
    ├── 完善开源版本
    ├── 建立社区
    └── 收集反馈
    │
    ▼
阶段 3: 增值服务 (Q4)
    │
    ├── 云同步服务 (订阅)
    ├── 高级技能包 (付费)
    └── 技术支持 (企业)

4.4 待实现功能

功能 优先级 预计完成
WASM/Native 技能模式 P1 Q3
向量搜索集成 P2 Q3
云同步服务 P2 Q4
技能共享社区 P3 Q4
企业部署版本 P3 Q4

五、关键决策

5.1 待定决策

决策项 选项 建议 截止日期
目标用户 个人/团队/企业 先个人，后团队 Q2 结束
记忆存储 纯本地/云同步 本地优先，可选云同步 Q2 结束
模型策略 单一/多模型 多模型切换 已确定
开源策略 完全/部分 核心开源，增值闭源 Q3 开始
定价模式 免费/付费 基础免费，高级付费 Q3 开始

5.2 决策框架

决策评估维度:
1. 用户价值 (1-10)
2. 技术可行性 (1-10)
3. 商业可行性 (1-10)
4. 资源需求 (1-10, 越低越好)
5. 风险程度 (1-10, 越低越好)

综合得分 = (用户价值 + 技术可行性 + 商业可行性) / (资源需求 + 风险程度)

六、风险与缓解

6.1 技术风险

风险 概率 影响 缓解措施 负责人
LLM API 变更 中 高 抽象层隔离 架构师
性能瓶颈 中 中 监控和优化 开发
安全漏洞 低 高 安全审计 安全

6.2 产品风险

风险 概率 影响 缓解措施 负责人
用户需求变化 高 中 敏捷迭代 产品
竞品压力 高 中 差异化定位 产品
采用率低 中 高 用户调研 产品

6.3 商业风险

风险 概率 影响 缓解措施 负责人
变现困难 中 高 多元化收入 商业
成本失控 中 中 成本监控 运营
合规问题 低 高 法务咨询 法务

七、资源需求

7.1 人力资源

角色 当前 需求 差距
前端开发 1 2 +1
后端开发 0.5 1 +0.5
产品设计 0 1 +1
测试 0.5 1 +0.5

7.2 基础设施

资源 用途 月成本
云服务器 云同步服务 $50-200
LLM API 智能功能 $100-500
存储 用户数据 $20-50

八、成功指标

8.1 产品指标

指标 当前 Q2 目标 Q3 目标
DAU - 100 1000
留存率 (7天) - 40% 50%
NPS - 30 50
功能使用率 - 60% 75%

8.2 技术指标

指标 当前 Q2 目标 Q3 目标
测试覆盖率 80% 85% 90%
错误率 - <1% <0.5%
响应时间 - <200ms <100ms
可用性 - 99% 99.9%

8.3 商业指标

指标 当前 Q2 目标 Q3 目标
付费用户 0 - 100
MRR $0 - $1000
CAC - - <$50
LTV - - >$200

九、附录

A. 相关文档

B. 更新历史

日期 版本 变更内容
2026-03-26 v0.5.0 完成 Smart Presentation Layer (Chart, Quiz, Slideshow, Document 渲染器)
2026-03-25 v0.4.0 基于代码深度分析更新：8 Crates 评估，78+ 技能确认，测试覆盖现状
2026-03-16 v1.0 初始版本

文档结束