# 🩺 CyberHuaTuo / 赛博华佗

> **望闻问切，药到病除。**
> **Diagnose. Prescribe. Cure.**

## 项目定位

CyberHuaTuo 是一个**开源的 AI 技术问题诊断知识库**。它汇聚全球开发者在使用各类 AI 技术（AI Agent 框架、LLM SDK、深度学习框架、ML 工具、自研 Agent、平台型 Agent、MLOps 工具等）过程中遇到的所有问题——从简单配置错误到复杂疑难杂症——以结构化的「病例 + 药方」格式存储在 GitHub 仓库中，任何人都可以贡献、任何人都可以使用。本质上，它是一个 **AI 医生**。

**它是一个开源共享知识库，类似 OpenClaw 之于 Agent 能力共享，CyberHuaTuo 做的是 AI 技术问题与解决方案的共享。不限框架，不限形态——只要是 AI，华佗都看。**

## 核心模式

```
开源共享知识库（GitHub Repository）
  ├── 社区通过 Pull Request 贡献「病例 + 药方」
  ├── 结构化数据格式：YAML 元数据 + Markdown 正文
  ├── 按框架 / 问题类别 / 复杂度分级组织
  ├── CI 自动校验数据格式
  └── 任何人都可以 Fork、搜索、使用
```

## 核心差异

| 维度 | Stack Overflow / GitHub Issues | CyberHuaTuo |
|------|-------------------------------|-------------|
| 数据格式 | 非结构化（纯文本帖子） | 结构化（YAML + Markdown，可程序化解析） |
| 组织方式 | 扁平列表 | 按框架/类别/复杂度分级的目录树 |
| 所有权 | 平台所有 | 开源共享，人人可用 |
| 维护方式 | 回答质量参差不齐 | PR 审核 + 社区验证 |
| 数据维度 | 纯文本描述 | 绑定框架版本、环境信息、复杂度分级 |
| 跨框架 | 无 | 同一问题在不同框架的对应解法关联 |
| 可扩展性 | 无法程序化使用 | JSON Schema 校验，可接入自动化工具 |

## 产品语言体系（医疗隐喻）

| 用户动作 | 产品术语 | 英文 |
|---------|---------|------|
| 贡献问题 | 🏥 **挂号** | Check-in |
| 提供解决方案 | 💊 **开药方** | Prescribe |
| 问题被验证解决 | ✅ **痊愈** | Cured |
| 社区贡献者 | 👨‍⚕️ **坐堂医师** | Resident Doctor |
| 贡献榜与行业标准 | 🏆 **全球AI医师排行榜** | Global AI Physician Ranking |
| 高频问题榜 | 📊 **疫情通报** | Epidemic Report |
| 框架问题热力图 | 🧬 **病理图谱** | Pathology Atlas |
| 深度疑难杂症 | 🦴 **刮骨疗毒** | Deep Surgery |
| 跨框架解法映射 | 🔗 **会诊** | Cross-Consultation |

## GitHub 仓库

- **仓库名**: `CyberHuaTuo`
- **地址**: https://github.com/[owner]/CyberHuaTuo
- **License**: Apache License 2.0
- **Slogan**: 🩺 An open-source AI doctor — diagnosing and curing issues across all AI systems.

## 项目灵感

2025-2026 年是 AI 从玩具到生产的关键过渡期。开发者遇到的 AI 问题密度极高，但解决方案极度分散在 GitHub Issues、Discord、Reddit、个人博客之间。**CyberHuaTuo 要做的就是成为「AI 技术问题的 OpenClaw」**——一个结构化的、开源共享的、社区驱动的问题与解决方案知识库。

就像 OpenClaw 让每个人都能共享 Agent 的能力，CyberHuaTuo 让每个人都能共享解决 AI 问题的经验。

## 文档索引

- [数据格式规范](./数据格式规范.md) ⭐ **核心文档**
- [本地 AI 搜索界面](./本地AI搜索界面.md) 🩺 **诊断引擎**
- [技术架构](./技术架构.md)
- [MVP 功能设计](./MVP功能设计.md)
- [品牌与视觉设计](./品牌与视觉设计.md)
- [路线图与里程碑](./路线图.md)
- [GitHub README 草稿](./README_draft.md)

---

*创建日期: 2026-03-10*
*项目状态: 规划阶段*
