Persist provider reasoning and assistant text separately on agent_reasoning_audit (DeepSeekAssistantMessage path), extract diagnosis_run.conclusion, enrich RAG tool audit (step_id/query/qualityScore), gate empty mysql tools, drop devtools, and align MVP docs after live E2E verification.
4.8 KiB
4.8 KiB
文档索引
📂 目录结构
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 架构、数据库设计、实施计划等。
🚀 快速导航
我是新人/学习者
- 项目学习路径 - 从这里开始
- learning/README.md - 学习笔记索引
- 按编号顺序阅读
learning/目录下的文档
我是开发者
👉 MVP 架构设计文档已移至 ../mvp/
请查看 mvp/README.md 了解:
- MVP 架构设计
- 数据库设计和表结构
- 实施规划(Phase 1/2/3)
- 会话管理设计
我要查看分析报告
RAG 设计讨论(docs 根目录)
- RAG 排序:多路召回与 RRF - K、融合、L0 边界
- Hybrid 之后的 qualityScore 与后处理 - 上一代问题、L2 伪装、统一归一化
- Agent 如何读 relevance_level - 粗相关度标签的含义与误读
- RAG 离线评测:讨论、设计与落地 - Golden/Fixture、流程图、hybrid 对齐与闸门修复
- Milvus hybrid 接入清单
- RAG Trace / 审计(架构) - 请求内 trace、tool_invocation、Trace API
诊断全流程(E2E 导读)
- 一次诊断到底发生了什么 - SUCCESS 全流程:阶段拆解、token、timeline、字段词典
- RAG 审计补丁 E2E:step_id + query - 审计字段 live 验收(含业务 FALLBACK 样本)
📚 学习笔记 (learning/)
按学习顺序编号,建议按顺序阅读:
- 00-项目学习路径
- 01-AI-Ops-核心设计-Essence报告
- 02-outputKey-深度解析
- 03-核心疑问解答
- 04-RAG-分块策略-Essence报告
- 05-文件上传自动索引-Essence报告
- 06-RAG查询流程-Essence报告
- 07-Tool定义方式对比与优化
- 08-MethodToolCallback-vs-ToolCallingManager深度分析
🔍 分析笔记 (analysis/)
代码分析和问题分析文档:
- essence-report-rag.md
- essence-report-rag-chunking.md
- explore-report.md
- chunking-issues-analysis.md
- 功能分析报告.md
📝 临时报告 (reports/)
修复报告和验证报告:
📖 指南文档 (guides/)
🔄 文档维护
- 学习笔记 放在
learning/目录,按编号顺序命名 - 分析笔记 放在
analysis/目录 - 临时报告 放在
reports/目录 - 指南文档 放在
guides/目录 - MVP 架构设计 已移至项目根目录
../mvp/(包含架构、数据库、实施计划)