SuperAPI AI 工具集

kb-retriever

写作与研究

查看项目

更新于 10-15 20:27

技能介绍

用途:在本地知识库目录中检索信息并回答用户问题。知识库默认位于项目根目录下的 knowledge/,用户可在对话中指定其他路径;默认路径不存在时应向用户确认,不得猜测。

主要能力:采用分层目录索引,根目录及各领域、子目录可放置 data_structure.md 说明用途,形成多级索引树;据此挑选相关目录与文件,再按类型检索。支持 Markdown/文本、PDF、Excel 等文件类型。

使用方式:先理解需求并提取关键词,确定知识库根目录(用 test -d knowledge 或 ls -d knowledge 检查,禁止用 Glob 判断目录存在性),逐层读取 data_structure.md 定位候选文件。文本类用 Grep 限定 include 与 path,再用 Read 局部读取匹配附近内容。处理 PDF 前必须先读 references/pdf_reading.md,优先用 pdftotext input.pdf output.txt 提取到文件而非 stdout,表格用 pdfplumber。处理 Excel 前必须先读 references/excel_reading.md 与 references/excel_analysis.md,用 pandas 配合 nrows 预览、列筛选与过滤。所有类型统一采用最多 5 次的多轮迭代检索,每轮更新关键词、选择未充分检索的文件、分析上下文并判断是否足够。

适用场景:本地文档、报表、接口文档、设计资料等知识库的问答与定位。

限制:查询知识库时禁止使用网络搜索等其他工具;不得跳过 PDF/Excel 的处理步骤直接检索原始文件;不得整文件读取大文件;信息不足时须明确说明缺失与不确定性,并提示用户缩小范围。