| name | zotero |
| description | 当流程需要 Zotero 本地状态、Zotero Web API key 检查、BibTeX 导出、DOI/标题查重，或为已归档文献创建/更新 index-only Zotero 条目时使用。触发词包括 Zotero、参考文献、citation library、BibTeX、DOI 去重、标签、collection、归档文献同步。 |
Zotero 组件
本 skill 是文献整理流程中的 Zotero 组件。
配置
- 凭证来自环境变量，或来自按
config/env.example 准备的本地私有 .env。
- 必填变量：
ZOTERO_API_KEY、ZOTERO_USER_ID。
- 可选变量：
ZOTERO_API_BASE_URL、ZOTERO_LOCAL_BASE_URL、ZOTERO_SYNC_MODE。
- 不要提交
.env，不要打印完整 API key。
MCP
随仓库提供的 MCP 服务位于：
integrations/zotero-mcp/mcp/zotero_mcp_server.py
离线 smoke test：
python integrations/zotero-mcp/scripts/smoke_mcp.py --server zotero --list-tools
规则
- Zotero 只作为索引库，不上传或附加 PDF。
- 含中文、日文等非 ASCII 元数据时，优先串行写入，避免并发批量写。
- 去重优先级：DOI、
extra 中的 SHA256、标准化标题加年份。
- 写入前必须运行
skills/literature-organizer/harness/zotero_guard.cjs，拒绝明显乱码或缺字段数据。
- 写入后必须验证条目没有 PDF/file attachment 子条目。
预期工具
zotero_web_key_info：验证 Web API 身份和权限。zotero_local_status：检查本地 Zotero Desktop API。zotero_local_search：搜索本地条目。zotero_local_tags：列出本地标签。zotero_local_collections：列出本地 collection。zotero_local_export_bibtex：导出 BibTeX。zotero_web_get_or_create_collection：解析或创建 collection path。zotero_web_create_or_update_index_item：创建或更新 index-only 文献条目。
输出要求
Zotero 写入后报告：
- created、updated 或 skipped 状态；
- 使用的去重依据；
- Zotero item key；
- 标签和 collection path；
- 缺失 DOI、IMA 待上传或校验失败等警告。
