v0.8.2

设置页重新组织为连接与运行、阅读上下文、其他客户端及连接诊断，统一圆角分组、按钮与间距，适配浅色/深色主题和窄窗口。高级选项默认折叠，刷新反馈保持在按钮右侧。

安装操作按「准备组件 → 连接 Codex」排列。未准备时突出准备按钮、禁用连接；失败时显示「重试」；就绪后显示「重新检查组件」并突出连接。准备和连接期间锁定两项操作，自动刷新不会提前解锁。

修复关闭自动准备时仍显示正在检查 Node.js 的状态提示。下载、帮助及自动更新链接指向迁移后的仓库 haohaomin/zotero-codex。

验证：53 项测试通过；隔离 Zotero 设置页完成 35 项检查，覆盖配置导出、准备/连接状态、重复点击防护、失败恢复及窄窗口布局。运行包由 GitHub Actions 构建并自检。

更新后插件自动准备对应版本的服务组件；已有托管 Codex 连接随之更新，请重启 Codex。其他客户端此前复制的配置需要重新复制并更新。

本版本不包含远程访问功能；相关设计文档仍处于规划阶段。

v0.8.1

高级设置现在默认展示只读连接信息，并说明运行环境、服务脚本、配置复制与连接文件的用途。连接其他客户端无需手填路径；复制配置后需在目标客户端添加并重新加载 MCP。

自定义路径移入默认关闭的「开发者模式」。路径仅用于本次导出的配置，不再写入自动组件设置或修改已有 Codex 连接；关闭模式或重新打开设置后恢复自动路径。导出错误显示在复制按钮附近。

继续支持本机 Node.js 复用和专用环境回退。更新后插件自动准备对应版本服务，已托管的 Codex 连接自动迁移；请重启 Codex。

v0.8.0

0.8.0 — 优先复用已有 Node.js

• 自动检测 PATH、Homebrew、标准安装目录与常见版本管理器中的 Node；不执行 shell 配置，不修改系统 Node 或 PATH。
• 本机 Node 满足版本、架构及服务/PDF 依赖检查后，只下载更小的服务包，避免重复下载 Node。
• 找不到兼容 Node 或实际服务检查失败时，自动复用已安装的专用 Node，或下载完整运行包。
• 设置显示 Node 来源和版本，可关闭“优先复用本机 Node.js”改用专用环境。
• 系统 Node 与专用 Node 切换时，托管 Codex 配置自动更新，其他配置与工具权限保持不变。

支持 Node 22.13+（22.x）或 24 及以上稳定版本。系统 Node 后续发生变化时，在 Zotero 启动、手动准备或连接时重新检查并回退；配置变化后重启 Codex。

普通用户仍只需安装 XPI，等待准备完成，再点击连接 Codex。

v0.7.0 — 安装 XPI，一键连接 Codex

0.7.0 — 安装 XPI，一键连接 Codex

普通用户不再需要安装 Node.js、下载源码、执行 npm 或手动填写路径。

• Zotero 插件启动后自动检测、下载与系统匹配的完整运行组件，显示下载、校验、安装进度。
• 设置中的「连接 Codex」自动备份并更新 Zotero MCP 配置，同时开启 Zotero 本地 API。完成后重启 Codex 即可使用。
• 升级时自动准备匹配版本；校验或试运行失败保留原有安装；下载失败可重试。
• 保留其他 MCP、模型配置及工具权限；不同服务占用同名连接时提示冲突，不覆盖。
• 手动部署路径折叠到高级设置，继续支持其他 MCP 客户端。
• 提供 macOS arm64/x64、Windows x64、Linux x64/arm64 运行包，内含 Node、编译后的服务和 PDF 原生依赖。

只需下载 XPI；runtime ZIP 和清单由插件自动使用。Better Notes 仍需单独安装。

首次安装指南：https://github.com/renhao12356578/zotero-codex/blob/main/docs/local-setup.md

真实 Zotero 图形宿主流程验证于 macOS；其他平台验证范围为 CI 运行包与服务检查。

Zotero Codex MCP v0.6.1 — Better Notes 风格设置页

Zotero Codex MCP v0.6.1

调整 Zotero MCP 设置页的视觉样式，使其与 Better Notes 的原生设置页一致。

• 使用 Zotero 原生 groupbox 分区、标题、按钮和间距；移除横跨整页的状态白块。
• “状态已刷新”现在紧跟在“刷新状态”按钮右侧显示。
• 保留连接状态、自动捕获开关、清除上下文、复制配置、脱敏诊断等功能。

验证：40 项自动化测试、14 项真实 Zotero 设置页检查、4 项真实 MCP stdio 检查通过；800 × 600 隔离 Zotero 窗口无横向溢出，并检查了设置页上下滚动区域的实际渲染。

Zotero Codex MCP v0.6.0 — 原生设置页

Zotero Codex MCP v0.6.0

新增 Zotero 原生设置页，在「设置 → Zotero MCP」统一管理连接和阅读上下文。阅读侧栏也有快捷入口。

• 查看桥接服务、Zotero 本地 API、Better Notes、最近访问插件的时间和 MCP 服务版本；不把服务启动显示成 Codex 在线。
• 文字选区、区域截图分别设置自动捕获，默认开启、立即生效、持久保存。关闭会清除对应的自动快照；手动添加和拖入批注仍可用。
• 一键清除所有阅读器的 MCP 快照及待生成截图，不删除批注或笔记。
• 识别 Node 服务路径、复制通用 MCP JSON 配置、打开连接文件所在目录，以及查看安装说明和版本。
• 本机连接诊断可报告 API 被关闭等问题；复制报告不含令牌、绝对路径或文献笔记内容。自检不会被计作客户端访问。

验证：40 项自动化测试、14 项真实 Zotero 10.0.3 设置页检查、4 项真实 MCP stdio 检查通过；800 × 600 原生窗口排版已检查。测试使用隔离文库，程序触发真实 DOM 控件与 Reader 事件。

安装新 XPI，并更新同版本源码后重新加载 MCP。工具数量仍为 43 个。配置页不会自动改写 Codex 配置，复制的 JSON 用于支持 mcpServers 格式的客户端；Codex CLI 设置方法见安装指南。

Zotero Codex MCP v0.5.1 — 自动捕获区域截图

Zotero Codex MCP v0.5.1

用 Zotero 的区域批注工具框选 PDF 后，MCP 自动获取区域截图、页码和来源，无需再拖入侧栏。截图准备好后，可以直接让 Codex 解释刚框选的图。

• 监听 Reader 新建区域批注，等待实际截图缓存，最多等待约 10 秒；不阻塞 Zotero 的批注保存通知。
• 按 Reader 分开保存快照；新区域或文字选择覆盖旧快照，异步读取也不会返回被替换的区域。
• 后台同步和导入的批注不覆盖上下文。已有批注仍可手动拖入。
• 不自动发送消息或触发 AI 回答。

验证：37 项自动化测试通过；Zotero 10.0.3 的真实 Reader 批注创建、保存、PDF 区域渲染、自动捕获 5 项检查通过；标准 MCP stdio 返回实际 PNG 图片和来源的 3 项检查通过。宿主使用隔离文库与公开 PDF 样本，由程序调用 Reader 批注创建接口，未做实际鼠标手势验收。

同时更新 XPI 与 Node 服务到 0.5.1。原有 MCP 配置及工具数量不变；安装步骤见 docs/local-setup.md。

Zotero Codex MCP v0.5.0

Zotero Codex MCP v0.5.0

首次公开发布。通过 MCP 将 Zotero 文库、PDF 阅读上下文和 Better Notes 笔记接入 Codex 等支持 stdio MCP 的客户端。

• 43 个工具：文献搜索、分类/标签、附件、批注、PDF 按页读取及页面图像。
• Better Notes：富文本直接编辑、Markdown 源码编辑与模式切换、大纲/链接读取、HTML/Markdown 转换、外部 Markdown 双向同步。
• 写入支持内容版本校验和请求去重；文件同步拒绝冲突和覆盖已有目标文件。
• MIT 开源，保留复用的 zotero-native-mcp 上游版权、源码、补丁和来源记录。

安装需要 Zotero 10、Node.js 22.13+ 和 Better Notes（已验证 3.3.3）。下载 XPI 并在 Zotero 插件管理器中安装；同时下载本 Release 源码并运行 npm ci、npm run build，配置 MCP 服务。XPI 本身不包含 Node 服务及依赖。完整步骤见仓库的 docs/local-setup.md。

验证：本项目 32 项、上游 60 项自动化测试通过；macOS + Zotero 10.0.3 + Better Notes 3.3.3 的 118 项宿主/stdio 检查及 4 项持久化/包检查通过，43 个工具均实际调用。开源发布阶段再次运行 92 项自动化测试并构建正式包。发布包新增 LICENSE/第三方说明，manifest 更新地址指向本仓库，功能代码与全流程验收版一致。

已知边界：Windows/Linux 图形宿主和真实鼠标拖拽尚未验收；Markdown 写入使用 Better Notes 自动保存。使用相同版本的 Node 服务和 XPI。文件校验见 SHA256SUMS。