From 502c7838fbec4f2e67279cef5ef9071654ae94e3 Mon Sep 17 00:00:00 2001
From: KiriAky 107 <KiriAky107@qq.com>
Date: Thu, 27 Aug 2026 23:38:54 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20Knowledge=20Core?=
 =?UTF-8?q?=20=E4=B8=8E=20Retrieval=20Core=20PR=20=E5=AE=A1=E9=98=85?=
 =?UTF-8?q?=E9=97=AE=E9=A2=98=E4=B8=8E=E4=BF=AE=E5=A4=8D=E5=A4=8D=E7=9B=98?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

> 本文记录 `feat/knowledge-retrieval-core` 合并前后的两轮代码审阅、问题复现、修复过程与工程经验。
> 它既是团队内部的问题档案，也可作为后续技术文档、课程报告和博客文章的素材底稿。

详细记录了 10 个关键问题的分析与解决方案：
- P-01：folder 路径逃逸问题及安全校验
- P-02 与 P-03：伪 upsert 和索引部分提交问题
- P-04：失效向量残留清理机制
- P-05：PATCH tags 语义错误修复
- P-06：候选池、Metadata Filter 与分页优化
- P-07：rebuild 请求语义与失败恢复
- P-08：index_meta 事务一致性保证
- P-09：POST 同路径静默覆盖防护
- P-10：删除操作部分提交问题

包含完整的测试策略和可复用的工程经验总结。