SuperAPI AI 工具集

Zotero

写作与研究

查看项目

更新于 10-16 07:28

技能介绍

用途:通过 Codex 操作本地 Zotero Desktop 文献库,完成检索、导出与引用插入等任务。核心辅助脚本为 python3 <plugin-root>/skills/zotero/scripts/zotero.py <command>,其中 <plugin-root> 由 SKILL.md 所在目录向上两级解析;脚本仅依赖标准库。

主要能力:status/probe 检查就绪状态与路由;inventory、collections、tags 查看条目、分类与标签摘要;search 检索文献;export-bibtex、sync-bib 导出 .bib;citations 按样式输出引用;cite 将引用插入 .tex 或 .md 草稿并同步 .bib;children、fulltext、file-url 获取附件与全文(仅在用户要求时使用);import-bibtex、import-ris、connector 保存等写入操作需先确认。

使用方式:先运行 status --json;若 local_api_enabled_pref 为 false,在用户要求操作 Zotero 时运行 enable --restart,更新本地偏好并重启 Zotero 以启用端口 23119。常规工作使用只读本地 API 命令。示例:python3 <plugin-root>/skills/zotero/scripts/zotero.py search "transformer" --json;python3 <plugin-root>/skills/zotero/scripts/zotero.py export-bibtex --out references.bib;python3 <plugin-root>/skills/zotero/scripts/zotero.py cite --query "Attention Is All You Need" --tex paper.tex --bib references.bib --marker '<cite>'。

输出规范:检索结果返回标题、作者、年份、Zotero item key 与 BibTeX key;需区分 Zotero item key(如 PXW99EKT)与导出的 BibTeX key(如 vaswani_attention_2023)。.bib 导出需返回绝对路径与条目数;插入引用需报告被编辑文件、插入的引用键与更新的 .bib 路径。受阻时说明具体原因:Zotero 缺失、本地 API 未启用、端口关闭、connector 不可用、无匹配条目或写入未确认。

限制:写入 Zotero 属显式写操作,import-bibtex、import-ris 或 connector 保存前须确认记录/来源与目标,除非用户已明确要求添加或导入;附件 URL 与全文仅在用户要求 PDF、附件路径或全文内容时获取。