给 AI 本地搜索工具一段含引号的原话，怎样按字面短语搜索而不触发查询语法

SQL绑定参数之后，还需要把用户原话编码为FTS5短语：外层加双引号，内部双引号加倍。绑定参数解决SQL层的问题，不能阻止MATCH参数被全文检索器继续当作OR等查询语法解释。

用三个文档看见查询扩展

小语料包含“alpha OR beta”“alpha only”和“beta alone”。用户希望查找第一句原话时，若直接把alpha OR beta作为MATCH参数，OR会被当作运算符，三篇都可能命中。literal模式把它整体包成短语，结果只保留含连续词序的第一篇。附件数据库在内存创建，不改用户已有SQLite文件，运行完不会留下需要管理的服务。

SQL参数与FTS短语各守一层

脚本执行SELECT时始终使用问号占位和参数元组，避免把输入拼进SQL。随后对原话的引号做加倍处理，再用外层引号建立短语，保证词OR进入短语而不是运算符位置。第二条含内部引号的示例也使用相同编码，不靠删除引号“修好”输入，因为删除会悄悄改变用户说过的话。真实工具还应把原始输入与编码后的检索表达式分开记录，方便解释命中差异。

返回文档编号和可读片段

queries.json并列保存literal、wide和quote_literal三种结果，每条都包括doc_id与高亮片段。读者可以手工核对窄查询的一条结果与宽查询的三条结果，而不是只看“没有报错”。如果搜索工具继续把片段交给模型，文档编号要跟着片段走，防止模型引用时失去来源。检索未命中也应原样反馈，不能自动改成宽查询却仍告诉用户按原话找到。

短语不保证标点逐字相同

FTS5会先经过tokenizer，短语规则关乎词元序列；内部引号、大小写或某些标点的结果取决于分词器，不等于字符级完全一致。中文语料若需要逐字匹配，应另外选定分词方案并实际测例，不能把英文小语料结论外推。失败命令故意输入未闭合的FTS引号，产生查询错误，用来证明边界确实被执行。本例不涉及服务端数据库运维，也不改变任何现有在线搜索功能。

接入客户端工具时，可把字面短语作为独立模式，另外提供明确标注的高级查询模式。用户有意写布尔条件与用户引用一段含OR的原话是两种需求，界面或参数必须能区分，不能依据内容猜测后静默切换模式。

下载与复现

下载完整样例包，解压到一个新文件夹；也可查看全部文件清单和主脚本。使用Python 3.10或更新版本，在解压目录运行。此脚本只使用标准库，无需安装额外包。

python -B run.py
python -B run.py --negative

先查看主要结果，再修改输入重跑；已有输入会保留，结果写回同目录。边界命令可能故意非零退出，也可能输出明确的不适用状态，按正文说明判断，不把所有非零退出都当成安装故障。

依据与延伸阅读

资料核对日期为2026年10月24日。一手资料1：FTS5双引号短语和内部引号转义与SQL参数绑定是不同解析层。

继续阅读：TencentDB Agent Memory 的检索实现：FTS5 加 bm25 再做图扩展；不调模型也能先测检索：怎样给中文小语料做一个字符 TF-IDF 基线；向量值没变但最近结果变了，怎样用小样本选清楚余弦与欧氏距离。