Skip to content

ZBridge 10.0

Choose a tag to compare

@taotaochen86 taotaochen86 released this 06 Nov 13:45
· 5 commits to main since this release

ZBridge 10.0

让本机网页(file:// 加载项、WPS/Office 加载项、本地网页应用)直连 Zotero,无需任何中继进程。

为什么需要它

Zotero 10 的 HTTP 服务器对任何带 Origin 头的请求在进入端点前就断开连接,除非端点声明
allowRequestsFromUnsafeWebContent;而 CORS 响应头只在来源是 zotero.org 时才自动加。
浏览器里的页面无法自行去掉 Origin,因此原版 debug-bridge 只能靠一个本机中继转发。

ZBridge 把这三件事做在自己的端点里:

  • 声明 allowRequestsFromUnsafeWebContent = true
  • 自行返回 Access-Control-Allow-Origin: *(含 401/500 分支)
  • 令牌走 query 而非 Authorization 头 —— 避免触发 CORS 预检(Zotero 的 OPTIONS 会在进入端点前短路且不带 CORS 头)

端点

端点 说明
POST /zbridge/execute?token=<32位> 请求体为裸 JS,返回 JSON
GET /zbridge/ping 自检,返回版本信息,不需要令牌

安装

  1. 下载 zbridge-10.0.xpi
  2. Zotero → 工具 → 插件 → 右上角齿轮 → Install Plugin From File…
  3. 首次请求时用 /zbridge/ping 确认端点已注册

令牌在第 N 次… 见 README;插件首次加载会生成 32 位随机令牌并打印到 帮助 → 调试输出日志。

与 debug-bridge 的关系

路径不同(/zbridge/* vs /debug-bridge/*),可以并存,互不干扰。

许可证

MIT