用途
zotero-report 用于从 Zotero 文献集合生成综合研究报告，并支持与 Obsidian 集成。它适用于需要对某一研究主题进行文献综述、整理集合内容并形成结构化报告的场景。
前置条件
- 配置 config/config.json，包含 Zotero 与 Obsidian 设置
- 设置环境变量 ZOTERO_API_KEY
三种模式
模式检测依据用户请求区分：
- “이 컬렉션 보고서 만들어줘” → 模式 1（集合）
- “관련 논문 더 찾아서 보고서” → 模式 2（扩展）
- “X 주제로 논문 찾아서 보고서” → 模式 3（主题）
格式检测：识别“PDF로”“워드로”“hwpx로”等关键词，默认 Markdown。
语言检测：识别“영어로”“in English”“English report” → --language en；识别“한글로”“한국어로”或默认 → --language ko。默认 ko。
模式 1：仅集合
阶段 1 数据收集：调用脚本 generate_report.py，参数 --mode collection --collection "COLLECTION_NAME" --language {ko|en}。如需全文深入分析，可加 --include-full-text --max-chars-per-paper 10000。
阶段 2 分析：读取 JSON 输出，为每篇论文基于摘要与 pdf_text_preview 生成 3-5 行总结，识别交叉主题、方法论模式与研究空白。
阶段 3 报告撰写：参考 templates/report_template_{language}.md，用检测到的语言撰写完整报告，保存为 {collection_name}-report.md。
阶段 4 Obsidian 笔记：为 JSON 中每篇论文调用 create_summary.py 创建摘要笔记（参数含 --arxiv-id、--title、--authors、--abstract、--zotero-key、--subfolder、--summary、--key-findings、--force）。
阶段 5 导出（如需要）：调用 export_report.py，参数 --input {name}-report.md --format {docx|pdf|hwpx} --output {name}-report.{ext} --language {ko|en}。
模式 2：集合 + 扩展
阶段 1a 收集现有数据与搜索查询：调用 generate_report.py，参数 --mode extend --collection "COLLECTION_NAME" --language {ko|en}。
阶段 1b 使用建议查询检索 arXiv：读取 JSON 中的 suggested_search_queries，对每个查询调用 search_arxiv.py（--query、--max-results 10、--output json）。
阶段 1c 将相关论文加入 Zotero：对不在集合中的论文调用 add_to_zotero.py（--arxiv-id、--title、--authors、--abstract、--published、--collection）。
阶段 1d 重新收集更新后的集合：调用 generate_report.py，参数 --mode collection。
阶段 2-5 同模式 1。
模式 3：从零开始主题搜索
阶段 1a 检索 arXiv：调用 search_arxiv.py（--query "TOPIC_KEYWORDS" --max-results 20 --output json --sort-by relevance）。
阶段 1b 加入 Zotero：对每条结果调用 add_to_zotero.py，collection 取主题名。
阶段 1c 收集数据：调用 generate_report.py，参数 --mode collection --collection "TOPIC_AS_COLLECTION_NAME"。
阶段 2-5 同模式 1。
错误处理
- 找不到集合：请用户确认集合名称
- arXiv 检索 0 条结果：建议更换关键词
- Zotero 添加失败：跳过该论文、继续执行、报告失败项
- PDF 提取失败：仅用摘要生成总结
- 导出失败：MD 文件已保存，检查工具安装
Obsidian 笔记规则
- 子文件夹名 = Zotero 集合名（完全匹配）
- 使用 --force 无需提示直接覆盖
- 无 arxiv_id 的论文：以 zotero key 作为标识
- 无摘要的论文：使用 pdf_text_preview
已知限制
- 链接式附件：本地路径必须可访问
- 扫描版 PDF（纯图片）：不支持 OCR，改用摘要
- HWPX 导出：使用 --no-preprocess（无政府格式）
- 非 arXiv 论文：以 zotero_key 作为标识
智能体编排（OMC）
针对大型集合（50+ 论文）：
/team 2:executor "batch 1: papers 1-25" "batch 2: papers 26-50"
随后使用 analyst agent 进行综合。
说明
关于收费、价格、具体平台支持范围等信息，资料中暂未提供。