用途：在 Zotero 文献库中执行安全、高效、全面的检索。它不直接调用 MCP 工具（避免把所有结果载入上下文导致崩溃），而是编写 Python 代码拉取大批数据、在代码执行环境中过滤排序，仅返回前 N 条结果。
主要能力：SearchOrchestrator.comprehensive_search 自动执行语义搜索、关键词搜索（qmode="everything" 与 "titleCreatorYear"）和标签搜索，合并约 250 条结果、按条目 key 去重并按相关度排序，默认返回前 20 条。ZoteroLibrary 提供 search_items、semantic_search、search_by_tag、get_recent、get_tags 等接口；filter_by_criteria 可按条目类型、年份区间、必需或排除标签过滤；format_results 将条目格式化为 markdown。大型数据集保留在代码中，因此可使用 100 以上限制。
使用方式：设置 sys.path 并 import setup_paths，从 zotero_lib 导入相关类，构造 SearchOrchestrator 调用 comprehensive_search，再用 format_results 输出。多词查询在 Zotero 中按 AND 处理，如需 OR（不同拼写或语言）应分别搜索各词再按键去重合并；多主题 AND 可分别搜索后取 key 交集。可通过 max_results 和 search_limit_per_strategy 调整搜索深度，并用 try/except 处理异常。
适用场景：查找某个主题、作者、标签的文献，筛选近年来特定期刊文章，查看最近新增条目，以及需要多角度、多策略合并检索的复杂需求。
限制：依赖本机 Zotero MCP 配置与特定路径（如 /Users/niyaro/Documents/Code/zotero-code-execution），路径需按实际环境调整。语义搜索可能不可用时会回退到关键词；语义搜索引擎自身可能输出 404 错误信息，包装层会处理。资料未提供收费、价格或平台范围等信息。