| 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 待上传或校验失败等警告。