用途:在已索引的本地知识库中检索相关文档,适合用户需要从自己的语料库中查找文档,或某些问题可通过检索现有资料来回答的场景。该技能基于 qmd 索引执行搜索。
前置条件:需先安装 qmd,命令为 bun install -g @tobilu/qmd;并先完成集合设置(使用 /setup)。可通过 qmd status 校验配置是否就绪。
使用方式:先用 qmd status 确认集合与文档数量,再运行搜索,如 qmd query "<query>" --json。技能会解析 JSON 输出,展示文档路径、相关性分数与相关摘录;必要时可读取完整文档获取更多上下文。
主要参数:query(字符串,必填,搜索查询);mode(字符串,默认 query,模式有 query、vsearch、search);limit(整数,默认 5,结果数量);collection(字符串,默认 all,限定特定集合)。
搜索模式:query 为语义搜索(默认);vsearch 为带分数的向量搜索;search 为混合搜索。示例包括按关键词搜索、限制结果数、限定集合以及向量搜索。输出为 JSON,含 results 数组,每项包含 path、score、content。
集成方式:运行搜索查询后解析 JSON 结果,展示带分数的靠前结果,可选读取全文。
故障排查:若无结果,可用 qmd status 检查集合是否存在、用 qmd embed 确认已生成嵌入,或尝试更宽泛的查询词。
提供方说明:当前使用 qmd,存储为本地 SQLite 加 sqlite-vec 扩展,使用本地模型生成嵌入,无需 API key,适合中小型语料库与离线使用;pinecone 与 weaviate 为计划中的提供方,相关存储、嵌入与适用场景信息已在资料中列出。限制方面,资料未提供其他未列明内容。