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

refactor: 清理未使用代码并添加未来功能标记
Some checks failed
CI / Rust Check (push) Has been cancelled
Details
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 / Security Scan (push) Has been cancelled
Details
CI / E2E Tests (push) Has been cancelled
Details

Browse Source 
style: 统一代码格式和注释风格

docs: 更新多个功能文档的完整度和状态

feat(runtime): 添加路径验证工具支持

fix(pipeline): 改进条件判断和变量解析逻辑

test(types): 为ID类型添加全面测试用例

chore: 更新依赖项和Cargo.lock文件

perf(mcp): 优化MCP协议传输和错误处理
This commit is contained in:
iven
2026-03-25 21:55:12 +08:00
parent aa6a9cbd84
commit bf6d81f9c6
109 changed files with 12271 additions and 815 deletions
Download Patch File Download Diff File Expand all files Collapse all files

149
docs/features/roadmap.md
View File

@@ -1,34 +1,55 @@
# ZCLAW 后续工作计划
> **版本**: v1.0
> **版本**: v0.4.0
> **创建日期**: 2026-03-16
> **基于**: 功能全景分析和头脑风暴会议
> **状态**: 待评审
> **更新日期**: 2026-03-25
> **基于**: 代码深度分析报告
> **状态**: 活跃开发中
---
## 一、执行摘要
### 1.1 当前状态
### 1.1 当前状态 (2026-03-25 代码分析)
| 指标 | 状态 |
|------|------|
| 功能完成度 | 95%+ |
| 测试覆盖 | 317 tests passing |
| Rust Crates | 8 个 (types, memory, runtime, kernel, skills, hands, protocols, pipeline) |
| 功能完成度 | 85-95% (核心功能 L4) |
| 技能数量 | 78+ SKILL.md |
| Hands 可用 | 9/11 (82%) |
| Pipeline DSL | ✅ 完整实现 |
| 测试覆盖 | ~60% (需提升) |
| 文档覆盖 | 25+ 功能文档 |
| 成熟度 | L4 (生产就绪) |
### 1.2 核心结论
### 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 | 90% | 完全可用 |
### 1.3 核心结论
**优势**:
- 8 层 Rust Workspace 架构清晰
- Agent 记忆系统完善 (ICE: 630)
- L4 自演化能力已实现
- 多 Agent 协作框架成熟
- 多 LLM Provider 支持 (8 个)
- Pipeline DSL 成熟
- 技能生态丰富 (78+)
**待改进**:
- 用户引导和体验优化
- 商业化路径不清晰
- 社区生态尚未建立
- Approval 管理是存根实现
- A2A 协议需要更多工作
- 测试覆盖率需要提升 (~60% → 80%)
- 部分 Hand 需要外部依赖 (FFmpeg, Twitter API)
---
@@ -38,47 +59,60 @@
| ID | 任务 | 负责人 | 预估 | 验收标准 |
|----|------|--------|------|---------|
| S1 | 完善功能文档覆盖 | AI | 2h | 所有模块有文档 |
| S2 | 添加用户反馈入口 | AI | 3h | 反馈可收集和追踪 |
| S3 | 优化记忆检索性能 | AI | 4h | 检索延迟 <50ms |
| S1 | 实现 Approval 管理后端 | Rust | 4h | 非存根实现，支持审批队列 |
| S2 | 提升 A2A 协议完整度 | Rust | 4h | Agent 间通信可用 |
| S3 | 增加测试覆盖率 | Rust/TS | 8h | 从 60% 提升到 75% |
| S4 | 完善功能文档覆盖 | AI | 2h | 所有模块有文档 |
### 2.2 P1 - 应该完成
| ID | 任务 | 负责人 | 预估 | 验收标准 |
|----|------|--------|------|---------|
| S4 | 优化审批 UI | AI | 3h | 批量审批可用 |
| S5 | 添加消息搜索功能 | AI | 4h | 支持关键词搜索 |
| S6 | 优化错误提示 | AI | 2h | 错误有恢复建议 |
| S5 | 优化审批 UI | TS | 3h | 批量审批可用 |
| S6 | 添加消息搜索功能 | TS | 4h | 支持关键词搜索 |
| S7 | 优化错误提示 | TS | 2h | 错误有恢复建议 |
| S8 | 添加用户反馈入口 | TS | 3h | 反馈可收集和追踪 |
### 2.3 本周执行清单
```markdown
- [ ] S1: 完善 00-architecture 剩余文档
- [ ] S2: 在 RightPanel 添加反馈按钮
- [ ] S3: 优化 agent-memory.ts 检索算法
- [ ] S4: 实现批量审批组件
- [ ] S5: 添加 ChatArea 搜索框
- [ ] S6: 完善错误边界组件
- [ ] S1: 实现 Kernel Approval 管理 (非存根)
- [ ] S2: 完善 A2A 协议实现
- [ ] S3: 增加单元测试 (目标 +15%)
- [ ] S4: 更新功能文档基于代码分析
- [ ] S5: 实现批量审批组件
- [ ] S6: 添加 ChatArea 搜索框
- [ ] S7: 完善错误边界组件
- [ ] S8: 在 RightPanel 添加反馈按钮
```
---
## 三、中期计划 (1-2 月)
### 3.1 用户体验优化
### 3.1 架构优化
| ID | 任务 | 价值 | 风险 | 优先级 |
|----|------|------|------|--------|
| M1 | 记忆图谱可视化 | 高 | 中 | P1 |
| M2 | 主题系统扩展 | 中 | 低 | P2 |
| M3 | 快捷键系统 | 中 | 低 | P2 |
| M4 | 多语言支持 | 中 | 中 | P2 |
| M1 | 完成 WASM/Native 技能模式 | 高 | 中 | P1 |
| M2 | 实现 Predictor Hand | 中 | 低 | P2 |
| M3 | 实现 Lead Hand | 中 | 低 | P2 |
| M4 | 完善测试覆盖到 80% | 高 | 低 | P1 |
**M1 记忆图谱详细设计**:
### 3.2 用户体验优化
| ID | 任务 | 价值 | 风险 | 优先级 |
|----|------|------|------|--------|
| M5 | 记忆图谱可视化 | 高 | 中 | P1 |
| M6 | 技能市场 MVP | 高 | 中 | P1 |
| M7 | 工作流编辑器增强 | 高 | 中 | P1 |
| M8 | 主动学习引擎 | 高 | 高 | P1 |
**M5 记忆图谱详细设计**:
```
技术方案:
- D3.js / React Flow 可视化
- React Flow 可视化
- 力导向图布局
- 节点类型: fact, preference, lesson, context, task
- 边类型: 引用, 关联, 派生
@@ -90,16 +124,7 @@
- 搜索: 高亮匹配节点
```
### 3.2 能力扩展
| ID | 任务 | 价值 | 风险 | 优先级 |
|----|------|------|------|--------|
| M5 | 技能市场 MVP | 高 | 中 | P1 |
| M6 | 主动学习引擎 | 高 | 高 | P1 |
| M7 | 更多 Hands (3+) | 中 | 低 | P2 |
| M8 | 工作流编辑器 | 高 | 中 | P1 |
**M5 技能市场 MVP 范围**:
**M6 技能市场 MVP 范围**:
```
功能范围:
@@ -121,6 +146,7 @@
| M9 | 消息列表虚拟化 | 1000条流畅 | 100条流畅 | 10x |
| M10 | 记忆索引优化 | <20ms | ~50ms | 2.5x |
| M11 | 启动时间优化 | <2s | ~3s | 1.5x |
| M12 | SQLite 查询优化 | <10ms | ~30ms | 3x |
---
@@ -130,42 +156,52 @@
| 方向 | 目标用户 | 核心价值 | 差异化 |
|------|---------|---------|--------|
| **个人版** | 个人开发者 | 效率提升 | 本地优先 + 记忆 |
| **团队版** | 小团队 (5-20人) | 协作增强 | 多 Agent 协作 |
| **企业版** | 中大型企业 | 安全合规 | 私有部署 + 审计 |
| **个人版** | 个人开发者 | 效率提升 | 本地优先 + 记忆 + 78+ 技能 |
| **团队版** | 小团队 (5-20人) | 协作增强 | 多 Agent 协作 + Pipeline DSL |
| **企业版** | 中大型企业 | 安全合规 | 私有部署 + 审计 + A2A |
### 4.2 技术演进
| 阶段 | 重点 | 关键里程碑 |
|------|------|-----------|
| Q2 | 体验优化 | 记忆图谱、技能市场 |
| Q3 | 能力扩展 | 主动学习、云同步 |
| Q4 | 生态建设 | 社区、插件市场 |
| Q2 | 稳定性 | 测试覆盖 80%，Approval 完善，A2A 完整 |
| Q3 | 能力扩展 | WASM 技能，云同步，主动学习 |
| Q4 | 生态建设 | 社区，插件市场，企业部署 |
### 4.3 商业化路径
```
阶段 1: 开源建设 (Q2)
阶段 1: 产品完善 (Q2)
│
├── 完善核心功能
├── 提升测试覆盖
└── 完善文档
│
▼
阶段 2: 开源建设 (Q3)
│
├── 完善开源版本
├── 建立社区
└── 收集反馈
│
▼
阶段 2: 增值服务 (Q3)
阶段 3: 增值服务 (Q4)
│
├── 云同步服务 (订阅)
├── 高级技能包 (付费)
└── 技术支持 (企业)
│
▼
阶段 3: 企业产品 (Q4)
│
├── 私有部署版本
├── 企业级功能
└── 专业服务
```
### 4.4 待实现功能
| 功能 | 优先级 | 预计完成 |
|------|--------|---------|
| WASM/Native 技能模式 | P1 | Q3 |
| 向量搜索集成 | P2 | Q3 |
| 云同步服务 | P2 | Q4 |
| 技能共享社区 | P3 | Q4 |
| 企业部署版本 | P3 | Q4 |
---
## 五、关键决策
@@ -287,6 +323,7 @@
| 日期 | 版本 | 变更内容 |
|------|------|---------|
| 2026-03-25 | v0.4.0 | 基于代码深度分析更新：8 Crates 评估，78+ 技能确认，测试覆盖现状 |
| 2026-03-16 | v1.0 | 初始版本 |
---