scholaraio: Skill for Claude Code

文献搜索

在本地论文库中搜索文献。默认使用融合检索（关键词 + 语义向量合并排序），也支持单独使用某一种模式。

执行逻辑

1. 解析用户输入，判断搜索模式：

   • 如果用户明确要求"语义搜索"、"向量搜索"或"vsearch"，使用 vsearch
   • 如果用户明确要求"关键词搜索"、"全文搜索"或"FTS"，使用 search
   • 如果用户明确要找“证据片段”、“原文片段”、“行号定位”、“在哪一节/哪几行提到”，使用 search --chunk；若 chunk 索引尚未建立，先运行 index --chunks
   • 如果用户明确按作者搜索（如"找某某的论文"、"某某发表的"），使用 search-author
   • 如果用户要求按引用量排序（如"引用最高的"、"最经典的"、"top cited"），转交 /citations skill
   • 默认使用 usearch（融合检索）——同时执行 FTS5 关键词搜索和 FAISS 语义搜索，合并去重排序。两路都命中的论文排名靠前。向量索引不可用时自动降级为纯关键词。
   • 如果用户要求跨库搜索（如"也搜一下 arXiv"、"在 explore 库里也找找"、"也搜 proceedings"、"全部来源"、"联邦搜索"），使用 fsearch

2. 从用户输入中提取：

   • 查询词：用户想搜索的内容
   • 返回数量：使用规范参数 --limit N；未指定则使用默认值
   • 年份过滤：--year 2023（单年）、--year 2020-2024（范围）、--year 2020-（起始年至今）
   • 期刊过滤：--journal "Fluid Mechanics"（模糊匹配）
   • 类型过滤：--type review（模糊匹配，常见值：review、journal-article、book-chapter）

   查询词拆分原则：不要把“作者 + 年份 + 关键词/题名词”全部拼进同一个 query。这条规则同时适用于 search、vsearch 和 usearch：

   • search 会把整串文本交给 FTS5 MATCH；作者缩写、全名、标点或年份 token 只要和索引不一致，就可能让原本可命中的论文搜不出来。
   • vsearch 通常不会因此空结果，但作者/年份/期刊等限定词会作为噪声进入 query embedding，可能拉低相关论文分数或引入相近但不精确的结果。
   • usearch 同时跑 FTS 和向量；脏 query 可能让 FTS leg 失效，只剩语义命中，结果不再获得 both 加分。
   • 年份必须优先放到 --year，不要放进 query。
   • 明确按作者找时用 search-author "<作者姓或姓名>"，不要把作者混进主题 query。
   • 已知题名或主题时，query 保持为最稳定的题名/主题关键词；需要作者/年份约束时分步过滤或二次确认。
   • 如果第一次无结果，先去掉作者缩写、年份、机构、期刊等限定词，只保留题名核心词或主题词再搜。

3. 执行搜索命令：

融合检索（默认）：

scholaraio usearch "<查询词>" --limit <N> [--year <Y>] [--journal <J>] [--type <T>]

关键词搜索：

scholaraio search "<查询词>" --limit <N> [--year <Y>] [--journal <J>] [--type <T>]

证据片段搜索（返回 paper、section、line range、snippet）：

scholaraio search --chunk "<查询词>" --limit <N> [--year <Y>] [--journal <J>] [--type <T>]

语义搜索：

scholaraio vsearch "<查询词>" --limit <N> [--year <Y>] [--journal <J>] [--type <T>]

作者搜索：

scholaraio search-author "<作者名>" --limit <N> [--year <Y>] [--journal <J>] [--type <T>]