知识库文件检索原理¶
知识资料以原件、Markdown正文和分块文件保存。库名映射到独立目录，目录元数据和会话沿用SQLite；问答检索通过zvec-grep的lexical模块执行文字匹配，不使用向量存储或嵌入模型。
模型先生成关键词，系统在选定库和当前会话附件中检索，再让模型判断证据是否足够；缺少证据时生成新关键词补搜。轮数是上限，默认3轮，达到上限或没有新词时停止。普通生成结果用json_repair解析，模型输出不会被当作命令执行。
检索按连续文字匹配，中英文同义词须分成两个关键词，不能拼为“回撤/drawdown”。追问会使用同库历史识别主题，再重新检索原文；历史回答不能单独满足本轮证据要求。
标题优先切分保留文档结构，5000字符是单块默认上限。检索只访问当前清单列出的分块，因此历史遗留文件不影响当前答案。引用记录文档、分块和命中行，点击后在左侧阅读器核对原件；Markdown可定位引用文字，PDF可按文字查找。
会话附件仅对所属库和会话可见。下载有大小和时间预算，扫描PDF不执行OCR。关键词匹配依赖原文用词，模型规划或生成失败会明确展示状态；有引用也仍需检查其是否支持回答。