MerchantOps-KBQA 实践（十）：知识库状态页与文档版本冲突提示

文档向量化后常被当成“看不见的黑盒”。MerchantOps-KBQA 增加只读 GET /api/knowledge-documents，扫描 Runbook 目录并返回文档标题、版本、生效日期、相对路径和更新时间。

一、为什么做成只读接口

知识库状态的目标是帮助运营人员确认资料是否可用，不是让页面自动替换或删除文档。缺少 Metadata 或同一领域出现多个版本时，接口标记 needs_review，由人工确认后再更新知识。

二、前端展示什么

侧边栏的“知识库状态”显示每份 Runbook 的版本与生效日期，让用户在提问前就能看到是否存在待核对资料。这个页面不读取密码、Key 或绝对路径。

三、工程价值

RAG 的质量不仅取决于模型，也取决于文档是否可追溯。把版本冲突暴露出来，比让模型在多个版本之间猜测更可靠。