SuperAPI AI 工具集

local-knowledge

办公与效率

查看项目

更新于 10-15 21:41

技能介绍

用途:将本地文件夹或单个文件指向智能体,建立私有本地知识库,支持按自然语言查询检索相关上下文,让智能体基于本地文件作答。默认文本模式;多模态检索为高级可选模式,仅在显式传入 --mode multimodal 时启用。

主要能力:使用 sentence-transformers 本地嵌入模型,索引与数据存于本地 Chroma;源文档保留在用户本地文件夹,chunks、embeddings、索引与 manifest 均本地存储;index、search 及默认 ask 不调用远程模型提供方。首次安装/索引可能下载 Python 包与嵌入模型。ask 默认 provider=none,只返回检索到的上下文,由调用方智能体据此写最终答案。

使用方式:需 bash、python3 及本地路径。常用命令:bash <skill-path>/scripts/local_knowledge.sh doctor;doctor --install 安装依赖;index --path /path/to/knowledge 建立索引;search --path ... --query "..." --top-k 5 检索;ask --path ... --question "..." 提问;status 查看状态;delete --path ... --yes 删除索引。可加 --auto-index 自动创建或刷新索引。默认模型 sentence-transformers/all-MiniLM-L6-v2,支持别名 zh-small、bge-m3 等,也可用 --model 指定。

适用场景:本地文档检索、私有知识库问答、按自然语言查找目录内具体信息。

限制:不安装或调用 Ollama,不运行本地 LLM;多模态依赖与模型不会自动安装,模型可能达数 GB 且普通机器上较慢;.doc 依赖本地解析器,缺失时跳过并给出原因;不支持或不可读文件会被跳过并在输出中报告。所有命令输出 JSON 到 stdout。