用途：在本地知识库中定位具体事实、定义或操作流程，并给出可追溯的引用位置，适合审计、合规、复核、原文措辞校验，以及比较多个本地文档对同一主题的表述差异，或为报告、FAQ、内部知识答复收集支撑片段。
主要能力：支持直接文件搜索、基于索引的搜索和 PageIndex 式位置映射；提供查询策略指导，包括关键词拆分、同义词扩展和可选过滤（时间范围、文件类型、标签）；对结果做相关性排序与过滤，优先保留最有支撑力的证据；输出可核验的命中片段及精确引用位置（文件加页码、段落或章节）；仅限本地授权目录，不修改源内容。
依赖：glob（>= 10.0.0）用于文件路径模式匹配；grep（>= 3.11）用于文件内文本搜索；本地知识库索引文件（文件名索引、内容索引、向量索引、PageIndex 映射中的一种或多种）；assets/hit_list_template.csv 标准化命中清单模板；可选参考 references/guide.md。
使用方式：先确认索引与范围，限定在授权路径（如 ./kb/）；识别可用索引；构建查询，拆分核心实体、动作与约束，扩展同义词并应用过滤；执行本地搜索，例如 glob("./kb//*.md")、glob("./kb//*.pdf")、grep -RIn "API key|key rotation|rotate" ./kb/；过滤并排序结果，按词项邻近度、章节相关性和覆盖度排序；最后输出引用与命中清单，每条包含 file_path、location、snippet、notes，并按模板列保存为 hit_list.csv。
限制：仅在用户授权的本地目录内搜索；不修改源文档；不执行脚本或任意代码；不访问网络资源或外部 API；若索引缺失或损坏，回退到直接文件扫描，若无法扫描则报告限制并说明需要重新索引。具体评分权重与模板字段以资料所述为准，其他细节暂未提供。