SuperAPI AI 工具集

zotero-dev-rules

写作与研究

查看项目

更新于 10-15 16:42

技能介绍

用途:这是围绕 Zotero 开发的参考资料集合,镜像 zotero.org/support/dev,用于回答 Zotero 开发问题、构建集成,避免反复抓取官方文档。Zotero 是开源文献管理器,扩展方式有三类:面向在线文库的 Web API(https://api.zotero.org)、桌面客户端的插件与内部 JavaScript API、以及翻译器(JS 抓取/转换器)。引用格式由 citeproc-js 按 CSL 样式生成。

适用场景:通过 Web API 读写文库(条目、集合、标签、搜索);附件上传、全库或部分同步、流式(WebSocket)更新、OAuth;构建或调试 Zotero 插件;通过内部 JavaScript API / Run JavaScript 脚本化客户端;在开发新插件前查找类似开源插件研读代码;编写或修复翻译器(web/import/export/search);创建或编辑 CSL 引用样式,使用 citeproc-js / citeproc-node。

资料文件索引:references/web-api.md(基址、认证/API 密钥、版本、读写请求、批量、文件上传、条目类型/字段、同步算法、流式 API、OAuth);references/client-and-plugins.md(内部 JS API、Run JavaScript、插件开发与 Zotero 10 迁移说明);references/translators.md(翻译器元数据块、detectWeb/doWeb/doImport/doExport/doSearch、抓取辅助、Scaffold 测试);references/citation-styles.md(CSL、citeproc-js/node、样式库与编辑、类型映射);references/plugin-gallery.md(zotero-chinese 插件仓库快照,137 个插件按标签分类及废弃列表)。

Web API 要点:仅 HTTPS,始终固定版本 Zotero-API-Version: 3;密钥用 Zotero-API-Key 头(或 Authorization: Bearer),勿用 key= 查询参数。库前缀为 /users/<userID> 或 /groups/<groupID>;常用参数 format、include、q、itemType、tag、sort、direction、limit(1..100,默认25)、start、since。响应头含 Last-Modified-Version、Total-Results、Link、Backoff。每次写入必须携带版本(If-Unmodified-Since-Version 或对象 version),缺失返回 428、不匹配返回 412(需重新获取、合并、重试);批量最多 50 个对象,POST 新建、PUT 替换、PATCH 合并。遵守 Backoff,遇 429 按 Retry-After 等待。mtime 为毫秒;文件上传为三步(授权→S3→注册)。

客户端:内部 JS API 多为异步,单条保存用 await saveTx(),批量包在一个事务里,通过 chrome://zotero/content/include.js 获取 Zotero 对象。

限制:资料为开发文档索引与规则说明,具体接口细节需按需加载对应文件;未提供收费、平台或效果信息。