PaperBridge 1.0.3 · 双语界面与自动 Skills

中文

PaperBridge 1.0.3 让安装、阅读与分类更顺手：

• 默认中文的 README，加入横幅、方形徽章、功能卡片与流程图，并提供完整英文使用、构建、隐私与源码文档。
• 设置页支持简体中文 / English，覆盖标签、颜色、无障碍说明、默认规则、配置状态与提示。切换界面语言不会翻译已有个人内容。
• 新增论文自动标签接口；PDF 自动定位到论文父条目，追加缺失标签，保留原标签与类型。
• “配置 Codex”会安装 zotero-paper-annotator 和 zotero-literature-notes。后续版本会自动发现新随附 skill，更新未修改的托管副本，保留并提示本地编辑。配置前选择语言，可安装对应语言的 skill 入口。

使用： 安装 XPI，打开 PaperBridge 设置并点击“配置 Codex”，然后完全退出并重新打开 Codex。已有有效连接在插件升级时自动更新；被删除、禁用或自定义的连接不会覆盖。1.0.2 起开启 Zotero 插件自动更新的用户可通过“检查更新”获取本版。

已通过标签、迁移/幂等、升级、双语覆盖、skill 安装、打包程序和发布附件校验。Zotero 7–11 是清单兼容范围，并非逐个版本完成实机验证；当前运行程序适用于 Windows x64。

English

PaperBridge 1.0.3 improves setup, paper reading and organization:

• A Chinese-default README with a banner, square badges, feature cards and workflow diagram, plus English setup, build, privacy and corresponding-source documentation.
• Chinese/English settings, including labels, colors, accessibility text, default rules and setup status. Existing user content is not translated.
• Paper-level automatic tags: PDF IDs resolve to the regular parent item; missing tags are appended while preserving existing tags and types.
• Configure Codex installs zotero-paper-annotator and zotero-literature-notes. Later releases discover new bundled skills and update unchanged managed copies while preserving local edits. Select a language before setup to choose the skill entrypoints.

Setup: Install the XPI, click Configure Codex in PaperBridge settings, then fully quit and reopen Codex. Valid existing connections upgrade automatically at plugin startup; removed, disabled and customized connections are preserved. Users with Zotero automatic updates enabled from 1.0.2 can use Check for Updates.

Tag, migration/idempotency, upgrade, translation, skill-installation, frozen-runtime and release-artifact checks passed. Zotero 7–11 is the declared manifest range, not exhaustive real-device validation. The bundled companion supports Windows x64.

Downloads / 下载

• paperbridge-1.0.3.xpi: installable plugin / 安装包
• paperbridge-1.0.3-source.zip: complete corresponding source with dependency archives / 完整对应源码及依赖源归档
• SHA256SUMS.txt: artifact checksums / 校验值
• updates.json: native Zotero update feed / Zotero 更新清单

AGPL-3.0-or-later. The XPI, complete source and checksums are provided together. Personal connection files, papers, notes and Zotero profiles are not included.

PaperBridge 1.0.2 — 自动更新与 MCP 配套升级

接入 Zotero 原生自动更新：更新源为本仓库最新正式 Release 的 updates.json，包含兼容范围、固定版本 XPI 下载链接和 SHA-256。启动时不再强制关闭自动更新，尊重 Default / On / Off。

已配置且仍启用的 zotero_local 会在插件升级后自动部署并切换新版 MCP 程序，修改配置前备份，保留其他 MCP、附加设置和注释。已删除、禁用或自定义程序路径/参数的连接不会被自动重新启用或覆盖；失败不阻止 Zotero 启动，可在文献桥设置中重试配置。

旧用户如何开启

1. 1.0.1 和早期版本没有有效的在线更新地址，先下载 paperbridge-1.0.2.xpi，使用 Zotero“工具 → 插件 → 齿轮 → 从文件安装插件”覆盖安装一次。
2. 在文献桥的插件详情中，将 Allow automatic updates 设为 On；Default 跟随全局设置，Off 停止后台更新。旧版曾强制关闭这个开关，升级后需要主动选 On。
3. 点击 Check for Updates 可立即检查，以后由 Zotero 下载安装新版，不必每次手动下载 XPI。网络不可达时仍可手动安装。
4. 首次连接仍需点“配置 Codex”；已有有效连接会自动配套升级。升级后完全退出并重新打开 Codex。

验证与附件

5 项插件生命周期及配套升级测试、15 项标注迁移及失败重试测试通过；临时配置测试覆盖设置保留、禁用/移除/自定义跳过、并发编辑保护。打包后的程序通过 PDF、MCP、Obsidian 分类导入及真实临时配置升级测试，Zotero 10.0.3 实机安装和已有 MCP 自动升级通过。

普通用户只需 XPI。完整对应源码及第三方依赖源码位于单个 paperbridge-1.0.2-source.zip；SHA256SUMS.txt 供校验；updates.json 由最终 XPI 自动生成，供 Zotero 读取，用户无需安装。更新请求不携带个人文献、标注或本地连接密钥。

PaperBridge 1.0.1 — 修复 Zotero 同步与一键配置

旧版把插件内部回执和图片分类写入 Zotero 标注的 relations，导致云端上传返回 400。本版改用本地元数据保存，启动时先备份再迁移旧数据，保留标注内容和有效条目关联。

同时修复 Zotero 10 中“配置 Codex”读取 XPI 内置资源时的 nsIURI.username 错误。重试记录持久保存；程序重启、图片缓存失败或提交后写盘失败时复用原标注，已删除的标注不会因重试被重新创建。

升级步骤

1. 下载 paperbridge-1.0.1.xpi，在 Zotero 的“工具 → 插件 → 齿轮 → 从文件安装插件”覆盖安装，并按提示重启。
2. 启动后自动备份和清理旧版内部关联，备份位于 Zotero 数据目录的 paperbridge/ 文件夹。
3. 打开“设置 → 文献桥”，再点击“配置 Codex”，然后完全退出并重新打开 Codex。
4. 在 Zotero 中重新同步，检查结果。

验证与下载

15 项关联迁移、失败重试及资源读取测试通过；内置程序的 PDF 提取、完整句边界、渲染、MCP 协议和 Obsidian 分类导入检查通过。Zotero 10.0.3 实机迁移及标注内容完整性核对通过，个人库同步成功。

普通用户只需 XPI；完整源码和第三方依赖源码在单个 paperbridge-1.0.1-source.zip 中，SHA256SUMS.txt 提供下载校验值。

PaperBridge 1.0.0

首个正式公开版：连接 Zotero、Codex 和 Obsidian，支持论文阅读、原生 PDF 标注及按 Zotero 分类层级导入文献笔记。

下载与安装

• paperbridge-1.0.0.xpi：普通用户下载此文件，在 Zotero「工具 → 插件 → 齿轮 → 从文件安装插件」中安装。
• paperbridge-1.0.0-source.zip：单个完整对应源码包，包含第三方依赖源码；安装插件不需要下载。
• SHA256SUMS.txt：上述文件的 SHA-256 校验值。

重启 Zotero 后，在设置侧栏「文献桥」启用本地连接并点击「配置 Codex」，然后完全退出并重新打开 Codex。完整的标注、Obsidian 导入与常见问题流程请看 README。

目前内置程序支持 Windows x64；可能需要从微软官方页面安装兼容的 Visual C++ x64 运行库。源码按 AGPL-3.0-or-later 发布。