zhuyongxin
584639fa2a
Relocate RAG and diagnosis decision/E2E writeups from docs/ root into mvp/engineering so architecture, issues, and engineering narrative stay together. Update indexes and cross-links; leave docs/learning as legacy.
2.2 KiB
2.2 KiB
MVP 架构文档
更新日期：2026-07-29
状态：当前单 Diagnosis Agent + Harness 架构
当前文档入口：
| 文档 | 内容 |
|---|---|
| current-mvp-architecture.md | 系统分层、请求主链、Trace/Reasoning 边界与 API surface |
| agent-orchestration.md | 单 Diagnosis ReAct Agent 的职责、执行方式和 reasoning 采集边界 |
| harness-quality-gates.md | Run、Tool、Evidence、Semantic、Release 与 Trace Recorder 门禁 |
| session-trace-lifecycle.md | sessionId/runId、SSE、统一 Timeline 和 reasoning audit 生命周期 |
| diagnosis-information-gain-stop-architecture.md | 已实施的信息增益评价、Harness 饱和检测、Draft 合同失败降级与证据不足停止设计 |
| RAG知识检索架构.md | 当前 lookup_knowledge 检索：MilvusClientV2 dense+BM25 hybrid、chunk 证据身份、重建运维 |
| RAG检索可观测性与审计.md | RAG Trace / 审计：请求内 retrievalTrace、tool_invocation 富字段、Trace API 读法 |
工程纪要（问题 / 决策 / E2E，非架构规范正文）见 ../engineering/README.md。
2026-07-22 前的多角色编排、双入口和旧证据链文档已移动到 archive/2026-07-22-legacy/，仅用于历史决策追溯，不代表当前运行时。其中旧 RAG 描述（Spring AI VectorStore 主路径 + Milvus SDK fallback）已被当前 hybrid 实现取代，请以 RAG知识检索架构.md 为准。检索可观测与 Trace 以 RAG检索可观测性与审计.md 为准（勿再依赖 archive 内旧 retrieval-observability）。
当前普通 Trace 与 LLM 步骤审计（agent_reasoning_audit：reasoning_content + assistant_text）使用独立存储和独立接口。
DeepSeek thinking 捕获路径与 V015–V017 字段已 live 验证（2026-07-28）。Reasoning 访问控制、保留期限、加密要求仍由 ISS-015 跟踪，不能把“数据已分表 + 能抓到 thinking”理解为“治理已经完成”。