搜索文件时，能搜到 PDF 正文里的关键词吗？

可以搜到 PDF 正文中的关键词，但前提是已经为这个附件提供了「可搜索文本」。直接上传 PDF 不会自动提取正文，扫描件也不会自动做文字识别；单纯等待一段时间不会完成这一步。

Busabase 已有「可搜索文本」功能：让已连接的 Agent 提取 PDF 正文，扫描件先做文字识别，再把结果写入同一个附件的可搜索文本中，就可以用全文搜索查找其中的内容，原 PDF 不会被修改。

这些文字也能让 AI Agent 使用 Busabase 的 grep 文件内容检索：按关键词或匹配规则查找相关段落，并返回命中位置与上下文。所以它不只是方便你搜索，也能帮助 Agent 定位和引用资料里的内容。

Busabase Skill 已有对应操作说明。为了让 Agent 明确完成这一步，你可以直接给它下面这段提示词：

请按照 Busabase Skill，把这份 PDF 上传到我的工作空间；如果已经上传，就使用现有附件，不要重复上传。

提取 PDF 的正文，扫描件先做文字识别。将提取结果写入这个附件的「可搜索文本」，不要只保存到元数据、另一个文档或聊天回复里。

写入后读回检查，再选一个只出现在正文里的关键词，用全文搜索或 Busabase 的 grep 文件内容检索确认能找到这个附件。最后给我附件链接和验证结果。如果无法提取或写入，请说明具体卡在哪一步，不要跳过或声称已经完成。

写入成功后，请用全文搜索测试，快捷搜索不会扫描正文。文件之后如果被替换，也需要重新提取并写入文字。

可以搜到 PDF 正文里的关键词，但上传文件后不会立刻就能搜到。

可以把 PDF 想成一本资料，把它的「可搜索文本」想成配套的文字版。你搜索一句话时，Busabase 查的是这份文字版；找到后，再告诉你这句话属于哪份 PDF。所以，能打开 PDF 和 能搜到 PDF 里的话 是两回事。

如果 PDF 里的字可以选中、复制，就可以先提取文字，再交给 Busabase 保存为这份文件的可搜索文本。如果 PDF 是扫描件，它更像一张张照片，得先通过文字识别把图片里的字变成文字。Busabase 不会在上传 PDF 时自动完成这些步骤。

处理好后，试着搜索一句只出现在正文、不在文件名里的话。如果结果能找到这份 PDF，就说明正文已经可以搜索了。需要查看这句话在文档中的位置时，也可以用文件内容检索功能查看匹配的文字及附近内容。