# 文档导航

项目完整文档索引，便于快速查找。

---

## 📖 必读文档（按阅读顺序）

### 1. 新用户入门

1. [README.md](../README.md) - **项目总览，先看这个**
2. [INSTALL.md](../INSTALL.md) - 安装指南
3. [docs/TUTORIAL.md](TUTORIAL.md) - 使用教程

### 2. 开发者必读

1. [docs/DEVELOPMENT.md](DEVELOPMENT.md) - 开发指南
2. [docs/ARCHITECTURE.md](ARCHITECTURE.md) - 架构设计
3. [CONTRIBUTING.md](../CONTRIBUTING.md) - 贡献指南

### 3. 用户必读

1. [FAQ.md](../FAQ.md) - 常见问题
2. [LICENSE.md](../LICENSE.md) - 许可证/免责声明

---

## 📚 完整文档列表

### 🎯 项目文档（根目录）

| 文档                                  | 用途               | 优先级 |
| ------------------------------------- | ------------------ | ------ |
| [README.md](../README.md)             | 项目总览、快速开始 | ⭐⭐⭐ |
| [CHANGELOG.md](../CHANGELOG.md)       | 版本变更历史       | ⭐⭐   |
| [INSTALL.md](../INSTALL.md)           | 安装指南           | ⭐⭐⭐ |
| [CONTRIBUTING.md](../CONTRIBUTING.md) | 贡献指南           | ⭐⭐   |
| [FAQ.md](../FAQ.md)                   | 常见问题解答       | ⭐⭐   |
| [LICENSE.md](../LICENSE.md)           | 许可证与免责声明   | ⭐⭐   |
| [.gitignore](../.gitignore)           | Git忽略规则        | ⭐     |

### 📘 核心文档（docs/）

| 文档                                                                               | 用途                           |
| ---------------------------------------------------------------------------------- | ------------------------------ |
| [TUTORIAL.md](TUTORIAL.md)                                                         | 使用教程、API参考              |
| [DEVELOPMENT.md](DEVELOPMENT.md)                                                   | 开发规范、贡献流程             |
| [ARCHITECTURE.md](ARCHITECTURE.md)                                                 | 系统架构、设计原则             |
| [API.md](API.md)                                                                   | API接口文档                    |
| [RELEASE.md](RELEASE.md)                                                           | 版本发布说明                   |
| [AUTHORS.md](AUTHORS.md)                                                           | 作者与贡献者                   |
| [NAVIGATION.md](NAVIGATION.md)                                                     | 文档导航索引                   |
| [UX_DESIGN.md](UX_DESIGN.md)                                                       | 用户体验设计                   |
| [SHARING_DESIGN.md](SHARING_DESIGN.md)                                             | 分享功能设计                   |
| [ADMIN_DESIGN.md](ADMIN_DESIGN.md)                                                 | 管理后台设计                   |
| [BUSINESS_SCENE.md](BUSINESS_SCENE.md)                                             | 业务场景与推广                 |
| [COMPETITIVE_ANALYSIS.md](COMPETITIVE_ANALYSIS.md)                                 | 竞品分析(大厂AI)               |
| [TECH_ARCHITECTURE.md](TECH_ARCHITECTURE.md)                                       | 技术架构设计 🆕                |
| [CURRENT_STATE.md](CURRENT_STATE.md)                                               | 当前真相源 🆕                  |
| [ACTIVE_REMEDIATION_2026-06-13.md](ACTIVE_REMEDIATION_2026-06-13.md)               | 当前仍有效问题清单 🆕          |
| [ACTIVE_EXECUTION_BOARD_2026-06-13.md](ACTIVE_EXECUTION_BOARD_2026-06-13.md)       | 当前执行板 🆕                  |
| [P0_P1_P2_REMEDIATION_PLAN_2026-06-14.md](P0_P1_P2_REMEDIATION_PLAN_2026-06-14.md) | 2026-06-14 严格复审整改计划 🆕 |
| [IMPLEMENTATION_PLAN.md](IMPLEMENTATION_PLAN.md)                                   | v2.1实施计划 v1.0              |
| [IMPLEMENTATION_PLAN_v2.md](IMPLEMENTATION_PLAN_v2.md)                             | v2.1实施计划 v2.0（修订版）🆕  |
| [AUDIT_REPORT_2026-06-11.md](AUDIT_REPORT_2026-06-11.md)                           | 审核报告 🆕                    |
| [REMEDIATION_TASK_BOARD_2026-06-11.md](REMEDIATION_TASK_BOARD_2026-06-11.md)       | 修复任务板 🆕                  |
| [plans/](plans/)                                                                   | 详细任务计划 🆕                |

### 🔍 规则文档（rules/）

| 文档                                                | 用途         |
| --------------------------------------------------- | ------------ |
| [provinces/README.md](../rules/provinces/README.md) | 省份规则总览 |
| [provinces.md](../rules/provinces.md)               | 27省规则详情 |
| [errors/ERRORS.md](../rules/errors/ERRORS.md)       | 错误模式库   |

### 📖 案例文档（docs/case-studies/）

| 文档                                    | 用途         |
| --------------------------------------- | ------------ |
| [TEMPLATE.md](case-studies/TEMPLATE.md) | 案例编写模板 |
| （未来添加更多案例）                    | ...          |

### 📋 优化日志（docs/optimization-log/）

| 文档                                              | 用途         |
| ------------------------------------------------- | ------------ |
| [LOG.md](optimization-log/LOG.md)                 | 优化过程记录 |
| [future-plan.md](optimization-log/future-plan.md) | 未来规划     |

### 📄 Skill文档

| Skill                      | 文档位置                                                        |
| -------------------------- | --------------------------------------------------------------- |
| **gaokao-college-advisor** | [skills/../SKILL.md](../skills/gaokao-college-advisor/SKILL.md) |
| **gaokao-spec-checker**    | [skills/../SKILL.md](../skills/gaokao-spec-checker/SKILL.md)    |
| **zhangxuefeng-skillset**  | [skills/../SKILL.md](../skills/zhangxuefeng-skillset/SKILL.md)  |
| **gaokao-counselor-long**  | [skills/../SKILL.md](../skills/gaokao-counselor-long/SKILL.md)  |

---

## 🎯 按场景查找

### 场景1：我想快速上手

→ [README.md](../README.md) → [INSTALL.md](../INSTALL.md) → [TUTORIAL.md](TUTORIAL.md)

### 场景2：我想了解全貌

→ [README.md](../README.md) → [ARCHITECTURE.md](ARCHITECTURE.md) → [CHANGELOG.md](../CHANGELOG.md)

### 场景3：我想贡献代码

→ [CONTRIBUTING.md](../CONTRIBUTING.md) → [DEVELOPMENT.md](DEVELOPMENT.md) → [FAQ.md](../FAQ.md)

### 场景4：我遇到问题

→ [FAQ.md](../FAQ.md) → [TUTORIAL.md](TUTORIAL.md) → 各Skill文档

### 场景5：我想了解规则

→ [rules/provinces.md](../rules/provinces.md) → [rules/errors/ERRORS.md](../rules/errors/ERRORS.md)

### 场景6：我想查看案例

→ [docs/case-studies/](case-studies/) → [tests/cases/](../tests/cases/)

---

## 📊 文档统计

| 类别      | 数量    | 总字数     |
| --------- | ------- | ---------- |
| 项目文档  | 7       | ~50KB      |
| 核心文档  | 6       | ~40KB      |
| 规则文档  | 3       | ~15KB      |
| 案例文档  | 1+      | ~5KB       |
| 优化日志  | 2       | ~5KB       |
| Skill文档 | 4       | ~30KB      |
| **总计**  | **23+** | **~145KB** |

---

## 🔗 快速链接

### 开始使用

- [安装 →](../INSTALL.md)
- [教程 →](TUTORIAL.md)

### 开发贡献

- [贡献指南 →](../CONTRIBUTING.md)
- [API文档 →](API.md)

### 规则参考

- [省份规则 →](../rules/provinces.md)
- [错误模式 →](../rules/errors/ERRORS.md)

### 测试验证

- [测试目录 →](../tests/)
- [测试用例 →](../tests/cases/)

---

## 📝 文档更新

### 更新频率

- **重要文档**（README、TUTORIAL）：每次发布更新
- **技术文档**（API、ARCHITECTURE）：功能变更时更新
- **案例文档**：发现新案例时更新
- **优化日志**：每次优化时更新

### 更新记录

参见 [CHANGELOG.md](../CHANGELOG.md)

---

## 💡 文档建议

### 发现文档问题？

1. 查看现有文档是否已覆盖
2. 如未覆盖，请记录到 [docs/optimization-log/LOG.md](optimization-log/LOG.md)
3. 提交更新（见 [CONTRIBUTING.md](../CONTRIBUTING.md)）

### 想要补充文档？

1. 复制现有文档格式
2. 遵循命名规范
3. 更新本导航
4. 提交PR

---

**找不到？查看 [FAQ.md](../FAQ.md) 或直接询问。**

---

**版本**: v2.0  
**最后更新**: 2026-06-11