Repository navigation
ZBridge 10.0
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 |
自检,返回版本信息,不需要令牌 |
安装
- 下载
zbridge-10.0.xpi - Zotero → 工具 → 插件 → 右上角齿轮 → Install Plugin From File…
- 首次请求时用
/zbridge/ping确认端点已注册
令牌在第 N 次… 见 README;插件首次加载会生成 32 位随机令牌并打印到 帮助 → 调试输出日志。
与 debug-bridge 的关系
路径不同(/zbridge/* vs /debug-bridge/*),可以并存,互不干扰。
许可证
MIT