iven/zclaw_openfang
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

chore: 提交所有工作进度 — SaaS 后端增强、Admin UI、桌面端集成

Browse Source 
包含大量 SaaS 平台改进、Admin 管理后台更新、桌面端集成完善、
文档同步、测试文件重构等内容。为 QA 测试准备干净工作树。
This commit is contained in:
iven
2026-03-29 10:46:26 +08:00
parent 9a5fad2b59
commit 5fdf96c3f5
268 changed files with 22011 additions and 3886 deletions
Download Patch File Download Diff File Expand all files Collapse all files

359
docs/features/roadmap.md
View File

@@ -1,60 +1,44 @@
# ZCLAW 后续工作计划
> **版本**: v0.6.0
> **创建日期**: 2026-03-16
> **更新日期**: 2026-03-26
> **基于**: 代码深度分析报告
> **状态**: Agent Growth System 完整实现
> **版本**: v0.7.0
> **更新日期**: 2026-03-28
> **基于**: 2026-03-28 代码分析
> **状态**: 核心功能完整，SaaS 平台上线
---
## 一、执行摘要
### 1.1 当前状态 (2026-03-26 代码分析)
### 1.1 当前状态
| 指标 | 状态 |
|------|------|
| Rust Crates | **9 个** (types, memory, runtime, kernel, skills, hands, protocols, pipeline, **growth**) |
| 功能完成度 | 90-95% (核心功能 L4) |
| 技能数量 | 78+ SKILL.md |
| Hands 可用 | 9/11 (82%) |
| Pipeline DSL | ✅ 完整实现 |
| Smart Presentation | ✅ 完整实现 (Chart, Quiz, Slideshow, Document) |
| **Agent Growth System** | ✅ **完整实现 (SqliteStorage + FTS5 + TF-IDF + Memory Extractor)** |
| 测试覆盖 | **~135 tests** (70 growth + 65 desktop) |
| 文档覆盖 | 25+ 功能文档 |
| 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 完整度评估
### 1.2 Crate 完整度
| 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 |
| **zclaw-growth** | **L5** | **95%** | **完全可用 (SqliteStorage + FTS5 + TF-IDF + Memory Extractor)** |
### 1.3 核心结论
**优势**:
- 9 层 Rust Workspace 架构清晰
- Agent 记忆系统完善 (ICE: 630)
- L4 自演化能力已实现
- 多 LLM Provider 支持 (8 个)
- Pipeline DSL 成熟
- 技能生态丰富 (78+)
- **Smart Presentation Layer 完成** - 自动类型检测和多渲染器支持
- **Agent Growth System 完成** - SqliteStorage + FTS5 + TF-IDF + LLM 驱动记忆提取
**待改进**:
- Approval 管理是存根实现
- A2A 协议需要更多工作
- 测试覆盖率需要提升 (~65% → 80%)
- 部分 Hand 需要外部依赖 (FFmpeg, Twitter API)
| 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 | 10% | 仅 ConsoleChannel |
---
@@ -62,42 +46,34 @@
### 2.1 P0 - 必须完成
| ID | 任务 | 负责人 | 预估 | 验收标准 |
|----|------|--------|------|---------|
| S1 | 实现 Approval 管理后端 | Rust | 4h | 非存根实现，支持审批队列 |
| S2 | 提升 A2A 协议完整度 | Rust | 4h | Agent 间通信可用 |
| S3 | 增加测试覆盖率 | Rust/TS | 8h | 从 60% 提升到 75% |
| S4 | 完善功能文档覆盖 | AI | 2h | 所有模块有文档 |
| 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 | 优化审批 UI | TS | 3h | 批量审批可用 |
| S6 | 添加消息搜索功能 | TS | 4h | 支持关键词搜索 |
| S7 | 优化错误提示 | TS | 2h | 错误有恢复建议 |
| S8 | 添加用户反馈入口 | TS | 3h | 反馈可收集和追踪 |
| ID | 任务 | 预估 | 状态 |
|----|------|------|------|
| S5 | 提升 SaaS 测试覆盖率 | 8h | 待开始 |
| S6 | 完善 MCP 协议工具验证 | 3h | 待开始 |
| S7 | Browser Hand 稳定性增强 | 4h | 待开始 |
| S8 | Admin UI 完善批量操作 | 3h | 待开始 |
### 2.3 本周执行清单
### 2.3 已完成项
```markdown
- [x] Smart Presentation Layer (Chart, Quiz, Slideshow, Document 渲染器)
- [x] PresentationContainer 集成到 PipelinesPanel
- [x] **Agent Growth System** (zclaw-growth crate, 完整实现)
- [x] SqliteStorage + FTS5 全文搜索
- [x] MemoryRetriever + TF-IDF 语义检索
- [x] PromptInjector + Token 预算控制
- [x] MemoryExtractor + LLM 驱动提取
- [x] VikingAdapter + 存储抽象层
- [ ] S1: 实现 Kernel Approval 管理 (非存根)
- [ ] S2: 完善 A2A 协议实现
- [ ] S3: 增加单元测试 (目标 +15%)
- [ ] S4: 更新功能文档基于代码分析
- [ ] S5: 实现批量审批组件
- [ ] S6: 添加 ChatArea 搜索框
- [ ] S7: 完善错误边界组件
- [ ] S8: 在 RightPanel 添加反馈按钮
```
| 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 错误提示中文化 | ✅ 完成 |
---
@@ -107,59 +83,36 @@
| ID | 任务 | 价值 | 风险 | 优先级 |
|----|------|------|------|--------|
| M1 | 完成 WASM/Native 技能模式 | 高 | 中 | P1 |
| M2 | 实现 Predictor Hand | 中 | 低 | P2 |
| M3 | 实现 Lead Hand | 中 | 低 | P2 |
| M4 | 完善测试覆盖到 80% | 高 | 低 | P1 |
| M1 | WASM/Native 技能模式 | 高 | 中 | P1 |
| M2 | A2A 协议完整实现 | 高 | 中 | P1 |
| M3 | Agent 持久化存储优化 | 高 | 低 | P1 |
| M4 | 测试覆盖提升到 80% | 高 | 低 | P1 |
### 3.2 用户体验优化
| ID | 任务 | 价值 | 风险 | 优先级 |
|----|------|------|------|--------|
| M5 | 记忆图谱可视化 | 高 | 中 | P1 |
| M5 | 记忆图谱可视化 (React Flow) | 高 | 中 | P1 |
| M6 | 技能市场 MVP | 高 | 中 | P1 |
| M7 | 工作流编辑器增强 | 高 | 中 | P1 |
| M8 | 主动学习引擎 | 高 | 高 | P1 |
| M8 | 主动学习引擎 | 高 | 高 | P2 |
**M5 记忆图谱详细设计**:
### 3.3 SaaS 增强
```
技术方案:
- React Flow 可视化
- 力导向图布局
- 节点类型: fact, preference, lesson, context, task
- 边类型: 引用, 关联, 派生
| ID | 任务 | 价值 | 风险 | 优先级 |
|----|------|------|------|--------|
| M9 | SaaS 多租户隔离增强 | 高 | 中 | P1 |
| M10 | Prompt A/B 测试 | 中 | 低 | P2 |
| M11 | Agent Template 市场 | 中 | 中 | P2 |
| M12 | Webhook/Callback 系统 | 高 | 低 | P1 |
交互设计:
- 点击节点: 显示详情
- 拖拽: 重新布局
- 筛选: 按类型/时间/重要性
- 搜索: 高亮匹配节点
```
**M6 技能市场 MVP 范围**:
```
功能范围:
- 技能浏览和搜索
- 技能详情展示
- 一键安装/卸载
- 技能评分和评论
不包含 (后续版本):
- 付费技能
- 技能提交
- 版本管理
```
### 3.3 性能优化
### 3.4 性能优化
| ID | 任务 | 目标 | 当前 | 改进 |
|----|------|------|------|------|
| M9 | 消息列表虚拟化 | 1000条流畅 | 100条流畅 | 10x |
| M10 | 记忆索引优化 | <20ms | ~50ms | 2.5x |
| M11 | 启动时间优化 | <2s | ~3s | 1.5x |
| M12 | SQLite 查询优化 | <10ms | ~30ms | 3x |
| P1 | 消息列表虚拟化 | 1000 条流畅 | 100 条流畅 | 10x |
| P2 | 记忆索引优化 | <20ms | ~50ms | 2.5x |
| P3 | 启动时间优化 | <2s | ~3s | 1.5x |
---
@@ -169,48 +122,16 @@
| 方向 | 目标用户 | 核心价值 | 差异化 |
|------|---------|---------|--------|
| **个人版** | 个人开发者 | 效率提升 | 本地优先 + 记忆 + 78+ 技能 |
| **团队版** | 小团队 (5-20人) | 协作增强 | 多 Agent 协作 + Pipeline DSL |
| **企业版** | 中大型企业 | 安全合规 | 私有部署 + 审计 + A2A |
| 个人版 | 个人开发者 | 效率提升 | 本地优先 + 记忆 + 69 技能 |
| 团队版 | 小团队 (5-20人) | 协作增强 | SaaS 平台 + Pipeline DSL |
| 企业版 | 中大型企业 | 安全合规 | 私有部署 + 审计 + RBAC |
### 4.2 技术演进
| 阶段 | 重点 | 关键里程碑 |
|------|------|-----------|
| Q2 | 稳定性 | 测试覆盖 80%，Approval 完善，A2A 完整 |
| Q3 | 能力扩展 | WASM 技能，云同步，主动学习 |
| Q4 | 生态建设 | 社区，插件市场，企业部署 |
### 4.3 商业化路径
```
阶段 1: 产品完善 (Q2)
│
├── 完善核心功能
├── 提升测试覆盖
└── 完善文档
│
▼
阶段 2: 开源建设 (Q3)
│
├── 完善开源版本
├── 建立社区
└── 收集反馈
│
▼
阶段 3: 增值服务 (Q4)
│
├── 云同步服务 (订阅)
├── 高级技能包 (付费)
└── 技术支持 (企业)
```
### 4.4 待实现功能
### 4.2 待实现功能
| 功能 | 优先级 | 预计完成 |
|------|--------|---------|
| WASM/Native 技能模式 | P1 | Q3 |
| 向量搜索集成 | P2 | Q3 |
| A2A 协议完整实现 | P1 | Q3 |
| 云同步服务 | P2 | Q4 |
| 技能共享社区 | P3 | Q4 |
| 企业部署版本 | P3 | Q4 |
@@ -219,127 +140,33 @@
## 五、关键决策
### 5.1 待定决策
### 5.1 已确定
| 决策项 | 选项 | 建议 | 截止日期 |
|--------|------|------|---------|
| 目标用户 | 个人/团队/企业 | 先个人，后团队 | Q2 结束 |
| 记忆存储 | 纯本地/云同步 | 本地优先，可选云同步 | Q2 结束 |
| 模型策略 | 单一/多模型 | 多模型切换 | 已确定 |
| 开源策略 | 完全/部分 | 核心开源，增值闭源 | Q3 开始 |
| 定价模式 | 免费/付费 | 基础免费，高级付费 | Q3 开始 |
| 决策项 | 决策 | 时间 |
|--------|------|------|
| 架构 | 内部 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 决策框架
### 5.2 待定
```text
决策评估维度:
1. 用户价值 (1-10)
2. 技术可行性 (1-10)
3. 商业可行性 (1-10)
4. 资源需求 (1-10, 越低越好)
5. 风险程度 (1-10, 越低越好)
综合得分 = (用户价值 + 技术可行性 + 商业可行性) / (资源需求 + 风险程度)
```
| 决策项 | 选项 | 截止 |
|--------|------|------|
| 记忆存储 | 纯本地 vs 可选云同步 | Q2 结束 |
| 开源策略 | 完全开源 vs 核心闭源 | Q3 开始 |
| 定价模式 | 免费 vs 付费 vs 混合 | Q3 开始 |
---
## 六、风险与缓解
## 六、成功指标
### 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. 相关文档
- [功能索引](README.md)
- [头脑风暴记录](brainstorming-notes.md)
- [CLAUDE.md 规则](../../CLAUDE.md)
### B. 更新历史
| 日期 | 版本 | 变更内容 |
|------|------|---------|
| 2026-03-26 | v0.6.0 | **Agent Growth System 完整实现**: zclaw-growth crate (SqliteStorage + FTS5 + TF-IDF + Memory Extractor), 9 个 Rust Crates |
| 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 | 初始版本 |
| 指标 | Q2 目标 | Q3 目标 |
|------|---------|---------|
| 测试覆盖率 | 80% | 90% |
| SaaS API 完整度 | 100% | 100% |
| 错误率 | <1% | <0.5% |
| 响应时间 | <200ms | <100ms |
---