# 文档索引

## 📂 目录结构

```
docs/
├── README.md                              # 项目文档总览
├── INDEX.md                               # 本索引文件
│
├── learning/                              # 📚 学习笔记（个人学习理解）
│   ├── 00-项目学习路径.md
│   ├── 01~08-*.md                         # 按学习顺序编号
│   └── README.md
│
├── analysis/                              # 🔍 分析笔记（代码/问题分析）
│   ├── essence-report-*.md
│   ├── explore-report.md
│   ├── chunking-issues-analysis.md
│   └── 功能分析报告.md
│
├── reports/                               # 📝 临时报告（修复/验证报告）
│   ├── 修复报告-*.md
│   ├── 验证报告-*.md
│   └── 日志配置完成总结.md
│
└── guides/                                # 📖 指南文档
    └── 日志配置与分析指南.md
```

**⚠️ 注意：MVP 架构设计文档已移至项目根目录 `../mvp/`**

查看 [mvp/README.md](../mvp/README.md) 了解 MVP 架构、数据库设计、实施计划等。

---

## 🚀 快速导航

### 我是新人/学习者
1. [项目学习路径](learning/00-项目学习路径.md) - 从这里开始
2. [learning/README.md](learning/README.md) - 学习笔记索引
3. 按编号顺序阅读 `learning/` 目录下的文档

### 我是开发者
👉 **MVP 架构设计文档已移至 `../mvp/`**

请查看 [mvp/README.md](../mvp/README.md) 了解：
- MVP 架构设计
- 数据库设计和表结构
- 实施规划（Phase 1/2/3）
- 会话管理设计

### 我要查看分析报告
1. [分析笔记目录](analysis/) - 代码分析和问题分析
2. [临时报告目录](reports/) - 修复和验证报告

---

## 📚 学习笔记 (learning/)

按学习顺序编号，建议按顺序阅读：

1. [00-项目学习路径](learning/00-项目学习路径.md)
2. [01-AI-Ops-核心设计-Essence报告](learning/01-AI-Ops-核心设计-Essence报告.md)
3. [02-outputKey-深度解析](learning/02-outputKey-深度解析.md)
4. [03-核心疑问解答](learning/03-核心疑问解答.md)
5. [04-RAG-分块策略-Essence报告](learning/04-RAG-分块策略-Essence报告.md)
6. [05-文件上传自动索引-Essence报告](learning/05-文件上传自动索引-Essence报告.md)
7. [06-RAG查询流程-Essence报告](learning/06-RAG查询流程-Essence报告.md)
8. [07-Tool定义方式对比与优化](learning/07-Tool定义方式对比与优化.md)
9. [08-MethodToolCallback-vs-ToolCallingManager深度分析](learning/08-MethodToolCallback-vs-ToolCallingManager深度分析.md)

---

## 🔍 分析笔记 (analysis/)

代码分析和问题分析文档：

- [essence-report-rag.md](analysis/essence-report-rag.md)
- [essence-report-rag-chunking.md](analysis/essence-report-rag-chunking.md)
- [explore-report.md](analysis/explore-report.md)
- [chunking-issues-analysis.md](analysis/chunking-issues-analysis.md)
- [功能分析报告.md](analysis/功能分析报告.md)

---

## 📝 临时报告 (reports/)

修复报告和验证报告：

- [修复报告-多轮对话时间查询缓存问题](reports/修复报告-多轮对话时间查询缓存问题.md)
- [验证报告-时间查询问题](reports/验证报告-时间查询问题.md)
- [日志配置完成总结](reports/日志配置完成总结.md)

---

## 📖 指南文档 (guides/)

- [日志配置与分析指南](guides/日志配置与分析指南.md)

---

## 🔄 文档维护

- **学习笔记** 放在 `learning/` 目录，按编号顺序命名
- **分析笔记** 放在 `analysis/` 目录
- **临时报告** 放在 `reports/` 目录
- **指南文档** 放在 `guides/` 目录
- **MVP 架构设计** 已移至项目根目录 `../mvp/`（包含架构、数据库、实施计划）