zimoliao 文献搜索
在本地论文库中搜索文献。默认使用融合检索（关键词 + 语义向量合并排序），也支持单独使用某一种模式。
执行逻辑
解析用户输入，判断搜索模式：
- 如果用户明确要求"语义搜索"、"向量搜索"或"vsearch"，使用
vsearch - 如果用户明确要求"关键词搜索"、"全文搜索"或"FTS"，使用
search - 如果用户明确要找“证据片段”、“原文片段”、“行号定位”、“在哪一节/哪几行提到”，使用
search --chunk；若 chunk 索引尚未建立，先运行index --chunks - 如果用户明确按作者搜索（如"找某某的论文"、"某某发表的"），使用
search-author - 如果用户要求按引用量排序（如"引用最高的"、"最经典的"、"top cited"），转交
/citationsskill - 默认使用
usearch（融合检索）——同时执行 FTS5 关键词搜索和 FAISS 语义搜索，合并去重排序。两路都命中的论文排名靠前。向量索引不可用时自动降级为纯关键词。 - 如果用户要求跨库搜索（如"也搜一下 arXiv"、"在 explore 库里也找找"、"也搜 proceedings"、"全部来源"、"联邦搜索"），使用
fsearch
- 如果用户明确要求"语义搜索"、"向量搜索"或"vsearch"，使用
从用户输入中提取：
- 查询词：用户想搜索的内容
- 返回数量：使用规范参数
--limit N；未指定则使用默认值 - 年份过滤：
--year 2023（单年）、--year 2020-2024（范围）、--year 2020-（起始年至今） - 期刊过滤：
--journal "Fluid Mechanics"（模糊匹配） - 类型过滤：
--type review（模糊匹配，常见值：review、journal-article、book-chapter）
查询词拆分原则：不要把“作者 + 年份 + 关键词/题名词”全部拼进同一个 query。这条规则同时适用于
search、vsearch和usearch：search会把整串文本交给 FTS5MATCH；作者缩写、全名、标点或年份 token 只要和索引不一致，就可能让原本可命中的论文搜不出来。vsearch通常不会因此空结果，但作者/年份/期刊等限定词会作为噪声进入 query embedding，可能拉低相关论文分数或引入相近但不精确的结果。usearch同时跑 FTS 和向量；脏 query 可能让 FTS leg 失效，只剩语义命中，结果不再获得both加分。- 年份必须优先放到
--year，不要放进 query。 - 明确按作者找时用
search-author "<作者姓或姓名>"，不要把作者混进主题 query。 - 已知题名或主题时，query 保持为最稳定的题名/主题关键词；需要作者/年份约束时分步过滤或二次确认。
- 如果第一次无结果，先去掉作者缩写、年份、机构、期刊等限定词，只保留题名核心词或主题词再搜。
执行搜索命令：
融合检索（默认）：
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>]
引用量排序：使用
/citationsskill 中的scholaraio top-cited命令。
联邦搜索（跨库 + arXiv）：
# 同时搜主库和 arXiv
scholaraio fsearch "<查询词>" --scope main,arxiv --limit <N>
# 同时搜主库和 proceedings
scholaraio fsearch "<查询词>" --scope main,proceedings
# 同时搜主库和所有 explore 库
scholaraio fsearch "<查询词>" --scope main,explore:*
# 搜指定 explore 库
scholaraio fsearch "<查询词>" --scope explore:my-survey
# 仅搜 arXiv（在线查询，不需要本地数据）
scholaraio fsearch "<查询词>" --scope arxiv
# 全部来源
scholaraio fsearch "<查询词>" --scope main,proceedings,explore:*,arxiv
--scope 支持逗号分隔组合：main（主库融合搜索）、proceedings（论文集子论文）、explore:<名称> 或 explore:*（explore 库）、arxiv（在线 arXiv API）。默认 scope 为 main。arXiv 结果会标注 [已入库] 表示该论文已在本地库中。
将搜索结果整理后呈现给用户。融合检索结果中每项标注了匹配来源：
both：关键词和语义都命中（最相关）fts：仅关键词命中vec：仅语义命中
复杂查询：当 CLI 参数组合无法满足需求时（如按一作姓氏首字母筛选、多条件交叉、自定义排序等），直接写 Python 读 configured papers library 下的
*/meta.json做查询。JSON 关键字段：
title, authors, first_author, first_author_lastname, year, doi, journal,
abstract, paper_type, citation_count (dict: crossref/semantic_scholar/openalex),
ids, toc, l3_conclusion
示例
用户说："帮我搜一下 turbulent boundary layer 相关的论文"
→ 执行 usearch "turbulent boundary layer"
用户说："用语义搜索找 drag reduction 的文献，给我前5篇"
→ 执行 vsearch "drag reduction" --limit 5
用户说："找 Liao Z-M 的论文"
→ 执行 search-author "Liao"
用户说："我库里引用最高的论文有哪些"
→ 转交 /citations skill（使用 top-cited 命令）
用户说："2020年以后关于 drag reduction 的论文"
→ 执行 usearch "drag reduction" --year 2020-
用户说："找 subgrid scale model 的原文证据片段，最好有行号"
→ 若未建 chunk 索引先执行 index --chunks，再执行 search --chunk "subgrid scale model"
用户说："找 Moin 1982 numerical investigation turbulent channel flow"
→ 执行 usearch "numerical investigation turbulent channel flow" --year 1982；必要时再用 search-author "Moin" --year 1982 交叉确认，不要执行 search "P Moin 1982 numerical investigation turbulent channel flow"
用户说："JFM 上发的湍流论文"
→ 执行 usearch "turbulence" --journal "Fluid Mechanics"
用户说："库里引用最高的 review 文章"
→ 转交 /citations skill（使用 top-cited --type review 命令）
用户说："帮我在 arXiv 上也搜一下 physics-informed neural network"
→ 执行 fsearch "physics-informed neural network" --scope main,arxiv
用户说："所有来源都搜一下 drag reduction，包括 explore 库"
→ 执行 fsearch "drag reduction" --scope main,proceedings,explore:*,arxiv
用户说："在我之前建的 wall-bounded-turbulence explore 库里搜 channel flow"
→ 执行 fsearch "channel flow" --scope explore:wall-bounded-turbulence
用户说："连 proceedings 一起搜 granular damping"
→ 执行 fsearch "granular damping" --scope main,proceedings