docs(rag): add comments on knowledge retrieval pipeline

Document the lookup_knowledge flow from L0 hints through L1 retrieval,
post-processing, packing, and Agent projection so the boundaries and
current limitations are easier to follow.

src/main/java/com/superbiz/agent/dto/EvidencePostprocessResult.java

@@ -6,26 +6,37 @@ import lombok.Data;
 import java.util.List;
 
 /**
- * Output of post-retrieval processing before context packing.
+ * 检索后处理输出（打包 / 组装前的中间结果）。
+ *
+ * <p>由 {@code KnowledgeEvidencePostProcessor} 生成，再交给 context packer 与 result assembler。</p>
  */
 @Data
 @Builder
 public class EvidencePostprocessResult {
 
+    /** 后处理前候选数。 */
     private Integer candidateCount;
 
+    /** 去重后 evidence 条数。 */
     private Integer evidenceBlockCount;
 
     private List<EvidenceBlock> evidenceBlocks;
 
+    /** PRECISE / HIGHLY_RELEVANT / REFERENCE；不可用时 null。 */
     private String relevanceLevel;
 
+    /** 给模型的完整性/天花板提示。 */
     private String completenessHint;
 
     private RerankTrace rerankTrace;
 
+    /**
+     * 排序第一名的 baseScore（0~1 相似度，不含规则 boost）。
+     * 用于 isLowQuality 与 attempt.topSimilarity。
+     */
     private Double topSimilarity;
 
+    /** 当前定义：evidenceBlocks 非空即视为有可用证据。 */
     public boolean hasUsableEvidence() {
         return evidenceBlocks != null && !evidenceBlocks.isEmpty();
     }