用途：对已提取的 Markdown 或纯文本文件做带排序的关键词检索，返回最相关的行区间。它读取本地文件，不解析 PDF，也不做 OCR。
何时用：已知确切词时先用有界搜索，例如 grep -n -i -C2 "term" file | head；不知道确切措辞或用普通搜索命中过多时改用 query。只有预计对同一文件多次提问时，才用 --emit-index 建索引。
主要能力：命令行用法为 $SKILL_DIR/bin/query text INPUT.md "your question" [-k N] [-e N]。INPUT.md 为提取出的 Markdown、文本或已保存的索引；引号内为要排序的词，可包含多个具体词。-k N 控制结果窗口数，默认 8，多数问题用 1–3；-e N 控制上下行数，默认 5，0 表示只返回匹配行。单个事实可用 -k 1 或 -k 2，加 --language <lang> 可匹配相关词形。每个结果以 1 起始的 Lines A-B 区间开头，可据此做聚焦的后续阅读。复用索引：先执行 $SKILL_DIR/bin/query text INPUT.md "first question" --emit-index INPUT.idx，随后对 INPUT.idx 执行后续查询；索引含源文本行，后续只需索引文件。
使用方式：首次使用会从 Nutrient CDN 下载 CLI，缓存于 ~/.local/share/nutrient/cli/，每六小时检查更新，因此首次运行较慢。建议流程：先用 pdf-to-markdown 或 pdf-to-text 转换一次；用较小 -k 做一次聚焦查询；依据返回段落作答，必要时再读更宽行范围；对同一文件的后续问题复用索引。技巧：使用文档中可能出现的具体词；把相关词放进同一查询；用 --language en 等 ISO 语言代码匹配屈折形式；需要更多上下文时增大 -e，仅在预期有多个独立答案时增大 -k。
适用场景：在已转换文档中定位事实、条款或措辞不确定的内容，替代大量低效的普通搜索。
限制：不解析 PDF、不做 OCR，文件无文本时输出为空。提示“No relevant matches found”并非文档内容，可换更具体词、同义词或 --mode lenient；匹配差时加更罕见词或用 --mode strict。非零退出需读 stderr 并报告具体错误，常见原因是输入文件缺失或首次下载失败。query 免费、本地运行、无需账号、不上报使用情况，也不使用 Vision 页面；使用受 Nutrient PDF to Markdown License 与 Nutrient 隐私政策约束，再分发、OEM、嵌入和白标需与 Nutrient 另行协议。