feat(rag): chunk evidence identity, dedup, and search port

Preserve same-document multi-chunk evidence with evidenceKey identity, per-document caps, retrieve-k/return-n split, and a dense KnowledgeSearchPort. Archives Delivery 1 OpenSpec change as the foundation for hybrid retrieval.
2026-07-27 18:26:15 +08:00
parent 99d4f6f216
commit ac1f831903
34 changed files with 2880 additions and 298 deletions
@@ -0,0 +1,44 @@
+# Acceptance: rag-chunk-evidence-identity-dedup
+
+## 实现结果
+
+Delivery 1 completed:
+
+- chunk identity fields on candidates/evidence blocks
+- `KnowledgeSearchPort` + dense adapter
+- evidenceKey dedup + maxChunksPerDocument + return-n
+- retrieve-k on lookup tool
+- projector keeps same-source distinct chunks; `document_id` is chunk-scoped
+
+## 验证
+
+### 脚本验证
+
+```text
+mvn -q "-Dtest=LookupKnowledgeToolTest,KnowledgeEvidencePostProcessorTest,RagResultProjectorTest" test
+```
+
+结果：通过（exit 0）
+
+### 静态验证
+
+- Search/port wiring reviewed against OpenSpec tasks
+- No new legacy SDK dependency added
+
+### 浏览器/人工验证
+
+未运行（纯检索契约变更，无 UI）
+
+### 未验证
+
+- 全量 harness E2E / 真实 Milvus 联调（Delivery 2 前可补）
+- 生产配置默认 retrieve-k/return-n 调优
+
+## 归档状态
+
+- OpenSpec change ready to archive
+- User pre-authorized archive for sm-flow staged delivery
+
+## 后续
+
+- Delivery 2: milvus hybrid search (separate change)