Files
SuperBizAgent-java/docs/INDEX.md
T
zhuyongxin 7ae9707a3b feat(harness,rag): dual LLM audit fields, run conclusion, and hybrid quality
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.
2026-07-28 19:43:13 +08:00

4.8 KiB
Raw Blame History

文档索引

📂 目录结构

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 架构、数据库设计、实施计划等。


🚀 快速导航

我是新人/学习者

  1. 项目学习路径 - 从这里开始
  2. learning/README.md - 学习笔记索引
  3. 按编号顺序阅读 learning/ 目录下的文档

我是开发者

👉 MVP 架构设计文档已移至 ../mvp/

请查看 mvp/README.md 了解:

  • MVP 架构设计
  • 数据库设计和表结构
  • 实施规划(Phase 1/2/3)
  • 会话管理设计

我要查看分析报告

  1. 分析笔记目录 - 代码分析和问题分析
  2. 临时报告目录 - 修复和验证报告

RAG 设计讨论(docs 根目录)

  1. RAG 排序:多路召回与 RRF - K、融合、L0 边界
  2. Hybrid 之后的 qualityScore 与后处理 - 上一代问题、L2 伪装、统一归一化
  3. Agent 如何读 relevance_level - 粗相关度标签的含义与误读
  4. RAG 离线评测:讨论、设计与落地 - Golden/Fixture、流程图、hybrid 对齐与闸门修复
  5. Milvus hybrid 接入清单
  6. RAG Trace / 审计(架构) - 请求内 trace、tool_invocation、Trace API

诊断全流程(E2E 导读)

  1. 一次诊断到底发生了什么 - SUCCESS 全流程:阶段拆解、token、timeline、字段词典
  2. RAG 审计补丁 E2E:step_id + query - 审计字段 live 验收(含业务 FALLBACK 样本)

📚 学习笔记 (learning/)

按学习顺序编号,建议按顺序阅读:

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

🔍 分析笔记 (analysis/)

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


📝 临时报告 (reports/)

修复报告和验证报告:


📖 指南文档 (guides/)


🔄 文档维护

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