SuperAPI AI 工具集

wiki-query

写作与研究

查看项目

更新于 10-16 01:06

技能介绍

用途:对由 wiki-builder 建立索引的 wiki 页面执行 FTS5 BM25 检索,返回 top-K 带引用的段落。适合在新建 wiki 页面前检查覆盖情况、回答可能已收录的领域问题、引用前核对出处,以及由 SessionStart 钩子按提示自动加载相关页面。

用法: node $SKILL_ROOT/scripts/query.js search "<query>" [--wiki <slug>] [--limit 10] [--json] node $SKILL_ROOT/scripts/query.js related <slug> <rel-path> [--limit 5] node $SKILL_ROOT/scripts/query.js show <slug> <rel-path> search 不带 --wiki 时跨所有 wiki 排序;related 用页面标题与摘要作为查询找相邻页。

输出为便于 JSON 处理的结构,命中含 page_id、wiki_slug、rel_path、title、snippet、rank,rank 越低(越负)表示 BM25 匹配越好。引用格式为 [wiki:<slug>] <title> — <rel_path>,不得省略来源。SessionStart 集成会在提示命中已知 wiki 主题时执行 query.js search "<prompt>" --limit 3 并注入前三条。

限制(Phase 3.3.0):仅 BM25;向量检索计划于 3.3.2 随 sqlite-vec 提供;无重排序,MMR 多样性计划随 3.3.1 的研究循环提供;片段窗口默认为匹配处 16 token,可用 --snippet-len 调整。