MVP 工程纪要（Engineering Notes）
更新日期：2026-07-29
定位：项目推进中真实遇到的问题、决策、解决思路与 E2E 验收叙事。
与其它目录分工：
| 目录 | 读什么 |
|---|---|
| architecture/ | 现行架构（系统现在怎么跑） |
| engineering/（本目录） | 为何这样定、踩坑、方案取舍、live 验收导读 |
| issues/ | 未完成事项与状态 |
| tables/ | 表结构说明 |
docs/learning/ 等 |
早期学习/分析（可能过时，不以之为现行口径） |
devflow/projects/ |
单次变更的 brief/decisions/evidence 切片 |
本文档不是 API 规范的唯一真理源；冲突时以 architecture/ 与代码为准。
RAG
| 文档 | 内容 |
|---|---|
| rag/RAG排序-多路召回与RRF.md | K、多路融合、RRF、L0 边界 |
| rag/RAG-Hybrid质量分与后处理.md | qualityScore 统一、L2 伪装废止、后处理 |
| rag/RAG-Agent如何读relevance_level.md | Agent 侧相关度标签含义与误读 |
| rag/RAG离线评测-基线设计.md | Golden/Fixture、hybrid 评测与闸门 |
| rag/Milvus-Hybrid接入清单.md | Hybrid 交付拆分与接入清单 |
| rag/RAG审计补丁-stepid-query-E2E验收.md | step_id / query 审计 live 验收 |
架构对照：
相关 Issue：
- ISS-017 L0 过滤收窄与 Fallback 加固（暂缓，保持现网）
Harness
| 文档 | 内容 |
|---|---|
| harness/README.md | 从这里开始：用一次诊断请求理解 Harness，不要求先掌握组件和状态 |
| harness/components/README.md | 组件渐进式导读：沿一次请求分四步理解运行控制、Agent 收敛、Tool 事实边界和验证发布 |
| harness/CONTEXT.md | Harness 统一术语、命名规则、状态维度与已知命名债务 |
| harness/Harness生命周期与状态.md | Run、Tool、Progress、Guard、Release、SSE 和持久化生命周期及状态映射 |
| harness/Harness设计-非确定性Agent的确定性控制边界.md | Harness 根问题、设计不变量、方案取舍、关键决策、代价与真实问题反推 |
| harness/Harness组件全景-职责-设计原因与边界.md | 当前 Harness 10 个职责域、全部生产类型、设计原因、作用与边界 |
| harness/Harness-Tool双视图-从原始结果到可验证证据.md | canonical truth、Control View、Agent Observation 与 metadata audit 的数据边界 |
| harness/Harness证据安全链-从引用真实到结论可发布.md | EvidenceGuard、EvidenceRepair、SemanticGuard 和唯一 Release Policy |
| harness/Harness信息增益停止-让无证据诊断正常收敛.md | GAINED/NO_GAIN、重复检测、协议停止、ProgressSnapshot 与过程型 Fallback |
诊断 / E2E
| 文档 | 内容 |
|---|---|
| diagnosis/一次诊断全流程-E2E导读.md | SUCCESS 全流程：阶段、token、timeline、字段 |
| diagnosis/Session-Run-Trace隔离-从串线到可回放.md | 多轮串线问题、身份拆分、协议迁移与 exact-run E2E |
架构对照：