# 🗺️ CyberHuaTuo 路线图

## 总体时间线

```
2026年3月                    2026年4月              2026年5月              2026年6月+
 ├──Phase 0─────────────────┤├──Phase 1────────────┤├──Phase 2────────────┤├──Phase 3──→
 │  种子数据 & 仓库基建      ││  开源发布 & 冷启动   ││  社区增长 & 工具扩展  ││  生态建设
 │  (3-4 weeks)             ││  (4 weeks)           ││  (4 weeks)           ││  持续迭代
```

## Phase 0: 种子数据 & 仓库基建（3-4 周）

### Week 1-2: 仓库骨架 & 工具

- [ ] 建立仓库目录结构（`cases/`、`schema/`、`tools/`、`docs/`）
- [ ] 编写 JSON Schema（`schema/case.schema.json`）
- [ ] 开发 `tools/validate.py` 格式校验脚本
- [ ] 开发 `tools/new-case.py` 病例生成脚手架
- [ ] 开发 `tools/search.py` 本地搜索工具
- [ ] 配置 GitHub Actions CI 校验
- [ ] 编写 `CONTRIBUTING.md` 贡献指南
- [ ] 创建 Issue 模板和 PR 模板

### Week 3-4: 种子数据

- [ ] 从 LangChain GitHub Issues 采集整理 20 个高频问题
- [ ] 从 MCP 生态采集整理 15 个常见问题
- [ ] 从 CrewAI GitHub Issues 采集整理 10 个问题
- [ ] 整理个人开发经验中的 15 个真实问题
- [ ] 所有病例通过 CI 校验
- [ ] 编写 README.md（中英双语）
- [ ] 每个框架目录的 `_index.md` 索引文件

## Phase 1: 开源发布 & 冷启动（4 周）

### 发布策略

- [ ] GitHub 首发，README 和文档完善
- [ ] 提交到 HackerNews (Show HN)
- [ ] 发布到 Reddit: r/LangChain, r/LocalLLaMA, r/MachineLearning
- [ ] Twitter/X 发布，@主流框架官方账号
- [ ] 提交到 Product Hunt
- [ ] 中文社区: V2EX, 掘金, 知乎

### 社区启动

- [ ] 在各框架 Discord/社区中宣传
- [ ] 标记 `good first issue` 降低贡献门槛
- [ ] 邀请 Agent 领域开发者贡献首批社区病例
- [ ] 建立贡献者 Hall of Fame

### 目标

| 指标 | 目标值 |
|------|-------|
| GitHub Stars | 500+ |
| 仓库病例数 | 100+ |
| 社区贡献者 | 10+ |
| Fork 数 | 50+ |

## Phase 2: 社区增长 & 工具扩展（4 周）

- [ ] 基于仓库数据搭建 GitHub Pages 文档站（可搜索）
- [ ] 实现 `EPIDEMIC_REPORT.md` 每日自动更新
- [ ] 扩展框架覆盖（LlamaIndex、OpenAI SDK、AutoGen、DSPy）
- [ ] 开发 CLI 工具，发布到 PyPI
- [ ] 建立跨框架关联映射（`related_cases`）
- [ ] 开始 VS Code 插件开发

### 目标

| 指标 | 目标值 |
|------|-------|
| GitHub Stars | 2,000+ |
| 仓库病例数 | 500+ |
| 社区贡献者 | 50+ |
| 社区贡献占比 | 30%+ |

## Phase 3: 生态建设（持续）

- [ ] VS Code 扩展插件（报错时自动搜索匹配病例）
- [ ] JetBrains 插件
- [x] GitHub Bot（@CyberHuaTuo 自动回复匹配药方）✅ 2026-03-11 完成
- [x] GitHub Action（cyberhuatuo-checkup-action — 嵌入用户 CI/CD 流程，L3 跃迁）✅ 2026-03-17 完成
- [ ] 与主流 Agent 框架官方建立合作
- [ ] 多语言支持（JavaScript/TypeScript Agent 框架）
- [ ] AI Agent 集成（将知识库作为 RAG 数据源）
- [ ] 企业镜像版（私有部署 + 自定义内部问题库）

### 长期愿景

```
CyberHuaTuo 的终极形态 =
  AI 生态的「问题解决基础设施」

每个 AI 框架的文档里都会写:
  "遇到问题？去 CyberHuaTuo 查一下"

每个 AI 开发者的工具链里都有:
  pip install cyberhuatuo

就像 OpenClaw 让每个人共享 Agent 能力,
CyberHuaTuo 让每个人共享 AI 避坑指南。
不限框架，不限形态——只要是 AI，华佗都看。
```

## 关键里程碑

| 里程碑 | 预计时间 | 标志 |
|-------|---------|------|
| 🏗️ 仓库骨架完成 | 2026-03-17 | 目录结构 + 工具链 + CI |
| 📦 种子数据就绪 | 2026-04-07 | 50+ 高质量病例入库 |
| 🚀 开源发布 | 2026-04-14 | GitHub 公开 + 多渠道推广 |
| 📣 冷启动完成 | 2026-05-12 | 500 Stars + 10 贡献者 |
| 🌱 社区自转 | 2026-06-09 | 社区贡献病例 > 维护者贡献 |

## 风险与应对

| 风险 | 概率 | 应对策略 |
|------|------|---------  |
| 冷启动无人贡献 | 中 | 先灌高质量种子数据 + 降低贡献门槛 |
| 数据质量不齐 | 中 | CI 自动校验 + PR Review 把关 |
| 竞品出现 | 低 | 先发优势 + 数据积累 + 社区粘性 |
| 框架更新过快 | 高 | 版本标注系统 + 社区持续更新 |

---

*创建日期: 2026-03-10*
*更新日期: 2026-03-10*
