搜索知识（RAG）

Subaya 保留一个可搜索的知识语料库——精选的参考资料加上你自己的项目内容。suya rag 命令让你和你的 agent 从中检索：在 pgvector + 词法索引之上的混合搜索，外加块阅读和状态。

搜索

用一个自由文本查询搜索语料库：

suya rag search "<query>"

默认情况下，这是一次混合搜索（语义向量相似度与词法匹配相结合）。有用的选项：

suya rag search "uart ring buffer" \
  --scope curated \
  --top-k 5 \
  --semantic-only

--scope <scope> — 将搜索限定到一个范围。对精选参考语料库使用 curated，或对某个特定项目的内容使用 project:<id>。该标志可重复，因此你可以一次跨多个范围搜索。
--top-k <N> — 返回排名靠前的 N 条结果。
--semantic-only — 限定为语义（向量）匹配，跳过混合搜索中的词法一侧。

搜索结果是块。按 id 阅读一个精选块的完整正文：

suya rag read <chunk-id>

检查已索引的内容——每个范围的块计数和最后一次摄取的时间戳：

suya rag status