RAG 检索意图覆盖契约

大理论

设计知识常有多套语言：用户说“页面不能滚”，工程说 overflow hidden，设计师说“滚动容器归属”，可访问性说 WCAG Reflow，案例分析说 scrolling interaction。若知识条目只写一个标题，RAG 很容易漏召回。健康条目需要 retrieval query coverage：把同一原则映射到用户表达、理论概念、组件名称、实现症状、案例来源和中英文同义词。

小知识点

1. 用户话术：例如“知识库不能滚”“筛选丢了”“卡片太像营销页”。
2. 理论词：information scent、faceted navigation、progressive disclosure、visual hierarchy。
3. 组件/状态词：active filter chips、empty state、scroll container、batch action bar。
4. 实现风险词：overflow hidden、URL query state、focus trap、contrast regression。
5. 案例/来源词：Awwwards SOTD、Carbon pattern、NN/g、W3C、MDN、Polaris。
6. 双语检索：中文任务词和英文行业词都要写入，避免中文 brief 召不回英文理论。

设计判断

如果一个真实任务用 5 种不同说法搜索都能召回同一知识条目，并且条目能告诉 agent 何时适用、何时避免、如何验证，检索意图覆盖成立。

实现建议

条目 schema 至少包含 titleZh/En、summaryZh/En、category、tags、applyWhen、avoidWhen、agentDirective、retrievalQueriesZh/En、sourceLinks、caseStudy。新增条目前先写 8-12 个真实查询句，覆盖 user symptom、designer term、frontend term、accessibility term、source/case term。定期从失败任务和搜索日志补 query，而不是只补正文。

反例/风险

知识写得很长但 retrievalQueries 只有标题；中文条目没有英文专业词；素材只写品牌名没有 license/use case；案例只写审美描述没有来源词；agent 搜“移动端筛选抽屉”却只召回“搜索系统”泛条目。

案例分析

Awwwards 的 Sites of the Day、case study 和 collections 页面分别提供奖项/评分、项目叙事和模式标签；Carbon、MDN、W3C、NN/g 则提供模式、实现和可访问性术语。把这些来源转为 RAG 条目时，不能只存文章摘要，而要把来源语言拆成可检索 query，让未来 agent 能从“我要做素材库筛选”“overflow 页面不能滚”“找 Awwwards 案例证明动效叙事”这些不同入口命中正确知识。

来源链接

Awwwards Sites of the Day: https://www.awwwards.com/websites/sites_of_the_day/ Awwwards Case Study Blog: https://www.awwwards.com/blog/case-study/ Awwwards Storytelling Collection: https://www.awwwards.com/awwwards/collections/storytelling/ Carbon Patterns: https://carbondesignsystem.com/patterns/ NN/g Articles: https://www.nngroup.com/articles/