docs(claude): restructure documentation management and add feedback system

- Restructure §8 from "文档沉淀规则" to "文档管理规则" with 4 subsections - Add docs/ structure with features/ and knowledge-base/ directories - Add feature documentation template with 7 sections (概述/设计初衷/技术设计/预期作用/实际效果/演化路线/头脑风暴) - Add feature update trigger matrix (新增/修改/完成/问题/反馈) - Add documentation quality checklist - Add §16
2026-03-16 13:54:03 +08:00
parent 8e630882c7
commit adfd7024df
44 changed files with 10491 additions and 248 deletions
--- a/docs/features/roadmap.md
+++ b/docs/features/roadmap.md
@@ -0,0 +1,294 @@
+# ZCLAW 后续工作计划
+
+> **版本**: v1.0
+> **创建日期**: 2026-03-16
+> **基于**: 功能全景分析和头脑风暴会议
+> **状态**: 待评审
+
+---
+
+## 一、执行摘要
+
+### 1.1 当前状态
+
+| 指标 | 状态 |
+|------|------|
+| 功能完成度 | 95%+ |
+| 测试覆盖 | 317 tests passing |
+| 文档覆盖 | 25+ 功能文档 |
+| 成熟度 | L4 (生产就绪) |
+
+### 1.2 核心结论
+
+**优势**:
+- Agent 记忆系统完善 (ICE: 630)
+- L4 自演化能力已实现
+- 多 Agent 协作框架成熟
+
+**待改进**:
+- 用户引导和体验优化
+- 商业化路径不清晰
+- 社区生态尚未建立
+
+---
+
+## 二、短期计划 (1-2 周)
+
+### 2.1 P0 - 必须完成
+
+| ID | 任务 | 负责人 | 预估 | 验收标准 |
+|----|------|--------|------|---------|
+| S1 | 完善功能文档覆盖 | AI | 2h | 所有模块有文档 |
+| S2 | 添加用户反馈入口 | AI | 3h | 反馈可收集和追踪 |
+| S3 | 优化记忆检索性能 | AI | 4h | 检索延迟 <50ms |
+
+### 2.2 P1 - 应该完成
+
+| ID | 任务 | 负责人 | 预估 | 验收标准 |
+|----|------|--------|------|---------|
+| S4 | 优化审批 UI | AI | 3h | 批量审批可用 |
+| S5 | 添加消息搜索功能 | AI | 4h | 支持关键词搜索 |
+| S6 | 优化错误提示 | AI | 2h | 错误有恢复建议 |
+
+### 2.3 本周执行清单
+
+```markdown
+- [ ] S1: 完善 00-architecture 剩余文档
+- [ ] S2: 在 RightPanel 添加反馈按钮
+- [ ] S3: 优化 agent-memory.ts 检索算法
+- [ ] S4: 实现批量审批组件
+- [ ] S5: 添加 ChatArea 搜索框
+- [ ] S6: 完善错误边界组件
+```
+
+---
+
+## 三、中期计划 (1-2 月)
+
+### 3.1 用户体验优化
+
+| ID | 任务 | 价值 | 风险 | 优先级 |
+|----|------|------|------|--------|
+| M1 | 记忆图谱可视化 | 高 | 中 | P1 |
+| M2 | 主题系统扩展 | 中 | 低 | P2 |
+| M3 | 快捷键系统 | 中 | 低 | P2 |
+| M4 | 多语言支持 | 中 | 中 | P2 |
+
+**M1 记忆图谱详细设计**:
+
+```
+技术方案:
+- D3.js / React Flow 可视化
+- 力导向图布局
+- 节点类型: fact, preference, lesson, context, task
+- 边类型: 引用, 关联, 派生
+
+交互设计:
+- 点击节点: 显示详情
+- 拖拽: 重新布局
+- 筛选: 按类型/时间/重要性
+- 搜索: 高亮匹配节点
+```
+
+### 3.2 能力扩展
+
+| ID | 任务 | 价值 | 风险 | 优先级 |
+|----|------|------|------|--------|
+| M5 | 技能市场 MVP | 高 | 中 | P1 |
+| M6 | 主动学习引擎 | 高 | 高 | P1 |
+| M7 | 更多 Hands (3+) | 中 | 低 | P2 |
+| M8 | 工作流编辑器 | 高 | 中 | P1 |
+
+**M5 技能市场 MVP 范围**:
+
+```
+功能范围:
+- 技能浏览和搜索
+- 技能详情展示
+- 一键安装/卸载
+- 技能评分和评论
+
+不包含 (后续版本):
+- 付费技能
+- 技能提交
+- 版本管理
+```
+
+### 3.3 性能优化
+
+| ID | 任务 | 目标 | 当前 | 改进 |
+|----|------|------|------|------|
+| M9 | 消息列表虚拟化 | 1000条流畅 | 100条流畅 | 10x |
+| M10 | 记忆索引优化 | <20ms | ~50ms | 2.5x |
+| M11 | 启动时间优化 | <2s | ~3s | 1.5x |
+
+---
+
+## 四、长期愿景 (3-6 月)
+
+### 4.1 产品方向
+
+| 方向 | 目标用户 | 核心价值 | 差异化 |
+|------|---------|---------|--------|
+| **个人版** | 个人开发者 | 效率提升 | 本地优先 + 记忆 |
+| **团队版** | 小团队 (5-20人) | 协作增强 | 多 Agent 协作 |
+| **企业版** | 中大型企业 | 安全合规 | 私有部署 + 审计 |
+
+### 4.2 技术演进
+
+| 阶段 | 重点 | 关键里程碑 |
+|------|------|-----------|
+| Q2 | 体验优化 | 记忆图谱、技能市场 |
+| Q3 | 能力扩展 | 主动学习、云同步 |
+| Q4 | 生态建设 | 社区、插件市场 |
+
+### 4.3 商业化路径
+
+```
+阶段 1: 开源建设 (Q2)
+    │
+    ├── 完善开源版本
+    ├── 建立社区
+    └── 收集反馈
+    │
+    ▼
+阶段 2: 增值服务 (Q3)
+    │
+    ├── 云同步服务 (订阅)
+    ├── 高级技能包 (付费)
+    └── 技术支持 (企业)
+    │
+    ▼
+阶段 3: 企业产品 (Q4)
+    │
+    ├── 私有部署版本
+    ├── 企业级功能
+    └── 专业服务
+```
+
+---
+
+## 五、关键决策
+
+### 5.1 待定决策
+
+| 决策项 | 选项 | 建议 | 截止日期 |
+|--------|------|------|---------|
+| 目标用户 | 个人/团队/企业 | 先个人，后团队 | Q2 结束 |
+| 记忆存储 | 纯本地/云同步 | 本地优先，可选云同步 | Q2 结束 |
+| 模型策略 | 单一/多模型 | 多模型切换 | 已确定 |
+| 开源策略 | 完全/部分 | 核心开源，增值闭源 | Q3 开始 |
+| 定价模式 | 免费/付费 | 基础免费，高级付费 | Q3 开始 |
+
+### 5.2 决策框架
+
+```text
+决策评估维度:
+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. 相关文档
+
+- [功能索引](README.md)
+- [头脑风暴记录](brainstorming-notes.md)
+- [CLAUDE.md 规则](../../CLAUDE.md)
+
+### B. 更新历史
+
+| 日期 | 版本 | 变更内容 |
+|------|------|---------|
+| 2026-03-16 | v1.0 | 初始版本 |
+
+---
+
+*文档结束*