全文助手 v1.0.0

1.0.0 更新说明

1.0.0 的发布前验收已完成，以下记录最终候选的功能和验证边界。实际公开安装包以正式 Release 为准；公开旧版升级在发行后独立核验，并把结果追加至 Release 说明，不替换已公开资产。

1.0.0 改进批量获取的等待方式和大列表操作：一个来源返回候选后即开始下载与核对，任务和消息按页显示、在完整记录集合中搜索；同时区分发现渠道与实际 PDF 主机。保留既有任务格式、插件 ID、更新入口、批次/历史与积分授权规则。

新增与改进

• 启用的 OpenAlex、PMC / Europe PMC、Semantic Scholar 和带 key 的 CORE 并行发现候选。共享队列逐个处理候选，每次开始下一项前重新排序，优先 PMC 数据集，其次其他 PDF，再处理网页；CORE 托管内容在普通来源候选之后尝试。文件匹配并保存成功后停止不必要的后续请求；匿名 CORE 和自定义模板保留为后续补充。
• 认证限制、限流及临时服务错误进入有上限的退避，并隔离来源、主机和凭据范围，避免整批文献重复请求同一受限端点。其他来源、浏览器下载和已授权的科研通兜底继续保留。
• CORE 普通链接不可用时，可通过已核实的 output 关联使用官方 API 托管 PDF 备用路径。独立开关默认关闭，须有 key 和明确内容授权；本机每日默认 20 次，可设为 1–1000 次。下载前持久化计次，失败、取消和超时也计入。OpenAlex 既有独立预算继续保留。
• 获取记录区分 discoveryProvider 和实际 PDF 响应 pdfHost。发现服务不再等同于文件托管方；旧数据缺失时回退原来源，不推测主机。科研通已核实积分仍随来源显示。
• 修复 Zotero 原生 302 响应读取缺失可选头时误报失败；修复暂停后迟到进度覆盖和重新获取沿用旧来源。再次手选同一已保存的科研通 PDF 时保留原采纳/已读凭证，避免重复处理。
• 任务与消息默认每页 25 项，可选 50 项；搜索当前筛选下的完整集合。消息可按全部、未读、已读筛选，筛选不会将消息标为已读。
• 隐藏任务/消息页不重复构建列表，未变化的可见行复用；保持输入和详情展开，分页不删除历史、不缩减总数或改变批次范围。
• 设置页更新区改为刷新按钮、状态与当前版本、更新日志展开入口；明确安装、版本说明与原生自动更新选项保留在详情中。
• README 增加繁体中文与英文，三语首页顶部互相切换；补充 API 下载实际发生在本机、来源诊断和社区目录同步说明。

更新与使用

实际安装包以 最新正式 Release 为准；1.0.0 的文件名为 zotero-fulltext-assistant-1.0.0.xpi。

已有公开更新入口的 0.8.0/0.9.0 沿用 Zotero 原生更新链路；原始 0.7.x 仍需手动安装一次 0.8.0 或之后的版本。检查更新本身不安装，自动更新时机由 Zotero 决定。第三方市场可晚于 GitHub 显示新版；普通版本一般由采集器发现，不代表每次都等待人工审核。

分页仅改变显示方式。当前批次四个视图、跨批次未完成与倒序完成历史规则保持不变。已有附件、求助关联与设置在隔离原生生命周期中已核对保留；公开更新和跨进程登录保留在发行后单独核验。

验收状态

已完成的项目与仍需完成的项目分别记录，不把旧版基线或合成界面结果当作新版真实获取通过：

• 自动化回归：2026-11-09 的最终修复后 npm test 中 687 项 JavaScript、偏好设置 DOM 回归和 32 项 Python 测试通过。
• 合成界面：相同 1,000 条任务/200 条消息下，初始元素由 23,481 个变为 913 个；无变化快照不新建列表元素，一条可见消息变化只重建一行。该 LinkeDOM 观察不表示原生 Zotero 或真实下载的提速倍数。
• 真实来源：最终候选以四个 API 联合检查 50 篇，19 篇核对保存、4 篇待核对、27 篇未完成；在隔离空临时条目强制联网，保存后清理，不计正式文库新增。成功即停时最终渠道为 OpenAlex 10 篇、PMC 9 篇，不是各服务独立覆盖率。
• 独立抽样：8 个自定义端点 × 5 篇有 2 次保存、1 次待核对；OpenAlex 最终缓存抽样 5 篇有 2 篇保存，跨修复尝试累计 5 次预留均成功。CORE 最终托管抽样 5 篇仍无保存：302 正确跟随后出现 403 人工验证，本轮预留 3 次、跨修复尝试累计 8 次；本机次数不代表服务 token 成本或余额。
• Windows / Zotero 10.0.8 候选 XPI 的七组原生验收全部通过，共 250 项，包含菜单/设置生命周期、批次/下载/完成、原生更新、真实 PMC 下载保存、原生分页/搜索和三语交互；合成界面数据不写入文库。
• 计时：最终完整来源检查（50 篇联合、10 篇缓存抽样、40 次自定义端点）为 5 分 15 秒；50 篇端到端中位数 2,218 毫秒，含发现/下载/身份/保存。旧版按单服务独立尝试，模式和预算不同，不据此宣传下载加速倍数。原始文库、DOI、文件路径及逐篇明细不随公开源码发行。
• 最终原生及真实来源候选 SHA-256 为 7abb23fc6030357cfcb6225a9a616db2a87a585e150770ec32762abd2cea36cc。正式发行流程独立核对源码、安装包、更新清单和五份资产。
• 旧版至本版公开更新、任务/附件/设置及会话保留：正式更新入口可用后独立验证，并在 Release 说明追加结果；候选检查旧 latest 不算升级通过。

安装范围仍为 Zotero 10.0.7–10.0.*；本版实际原生验收环境为 Windows / Zotero 10.0.8，旧版已有 10.0.7 记录，不扩大宣称到其他平台或主版本。本次具体完成范围以以上记录为准。

详细方法、旧版独立基线、去隐私汇总与未覆盖项见 1.0.0 验收记录。

保留的边界

API 返回链接并不代表取得全文。文件需通过有效性和身份核对，冲突拒绝，证据不足仍要求预览确认。CORE 与 Semantic Scholar 不保证覆盖全部文献，key 不授予出版社订阅；API 和自定义下载不继承机构或科研通 Cookie。

CORE API 托管下载消耗服务 tokens allowance，官方没有固定每篇 PDF 单价承诺。本机次数上限不是 token 计量器或账户余额，和 OpenAlex 本机上限一样，不保证不消耗付费额度。插件不自动购买或扩大套餐；正式 API 也受 403、429、额度、许可和文件可用性限制，可能跳转到需要人工验证的网页，配置 key 不保证直供 PDF。

批量普通获取不自动发布付积分求助；人工验证由用户在网站完成。有效会话仍可能过期，插件没有自动解验证码、购买订阅或购买高速权益。新增诊断与退避不保证每个提供方在线，也不保证单篇或全批固定完成时间。

详细配置见 全文来源与 API，本机数据和网络请求见 隐私说明，维护规则见 UPDATING.md。

发行提交：16e2e58275655631497df653a91bcf6d13265787。

发行后公开更新验收（2026-11-09）

• GitHub 正式发布、精确提交 CI、候选准备与稳定版发布工作流均已完成。匿名下载五份发行资产逐字节匹配本地已验收文件，latest/download/updates.json 指向 1.0.0。
• Windows / Zotero 10.0.8 使用未经修改的公开 0.9.0 XPI，通过真实 AddonManager.findUpdates 发现公开 1.0.0，下载后先核对实际文件 SHA-256，再继续同一个原生安装过程；本轮 46 项检查全部通过。
• 升级保留 21 条任务及历史顺序、16 个原有附件的关联和完整文件字节、当前批次、来源与用户设置、非零 schema-1 本机额度文件和辅助状态。原生替换前后的已有 OpenAlex 密钥仅在内存中比对，相同值保留；没有把密钥写入报告。
• 关闭并重新启动同一个隔离配置后，另一个进程的 16 项检查全部通过：实际运行的 1.0.0 安装包哈希、任务/批次、设置、附件及额度文件继续匹配，科研通原有登录刷新后仍有效且账号绑定一致。
• 全部检查后正常退出隔离进程，恢复并核对 4821 个原始文件/存在性记录；临时测试批次与合成额度记录已随精确恢复撤销，正式文库没有被替换。
• 边界：这个升级配置含 OpenAlex 密钥，但没有 CORE / Semantic Scholar 密钥、待确认 PDF 或机构会话，因此这些实际值的迁移/机构重新访问未在本轮公开升级中验证。三服务真实联网测试是前述独立基准。初次升级尝试在原生安装完成后遇到验收脚本文本摘要接口兼容问题，原始失败报告保留；只修复测试脚本，并从公开 0.9.0 完整重跑以上成功验收，发布资产与标签均未更改。

验收的公开 XPI SHA-256：7abb23fc6030357cfcb6225a9a616db2a87a585e150770ec32762abd2cea36cc。源码提交仍为 16e2e58275655631497df653a91bcf6d13265787。

全文助手 v0.9.0

全文助手 v0.9.0

本版优先尝试开放全文与 API 来源，再尝试出版社网页；设置页新增来源配置、三个独立 API key 输入和右上角版本/更新入口。

新增与修复

• OpenAlex 开放位置和可选缓存 PDF、PMC / Europe PMC、CORE、Semantic Scholar 候选发现与下载。文件必须实际下载、核验身份并保存后才记为已获取。
• OpenAlex、CORE、Semantic Scholar 密钥独立保存在 Zotero 登录管理器。CORE 与 Semantic Scholar 可以先不填 key，受限时在来源检查详情中说明；无需为了安装插件先购买服务。
• OpenAlex 缓存下载默认关闭，单独启用后按 UTC 日期持久化本机次数上限；失败也计次。本机次数不等于提供方余额，不能保证不消耗账户付费额度。
• 最多 8 个自定义 {doi} HTTPS 网址，分号或换行分隔。模板默认关闭、列表为空，不预置或保证镜像可用；只把 DOI 放在 # 后面的无效模板会被拒绝。
• 版本偏好筛选已标注的出版版、作者接受稿或预印本；未知版本明确显示未核实。
• 自动下载的 PDF 统一核验 DOI/标题。冲突拒绝入库；证据不足保留一个候选，支持跨重启预览与确认。修复真实 Nature 首页 DOI 侧栏被提取到正文后面时漏判的情形。
• 设置页右上角检查更新、安装已发现版本、查看更新说明和控制 Zotero 原生自动更新；检查更新不立即安装。
• 修复队列读取失败后被空数据覆盖的风险，以及 PDF 已提交时暂停/关闭导致丢失附件结果和来源记录的问题。
• 保留已有跳过全文、队列追加、批次/历史、浏览器下载、科研通积分授权与完成收尾逻辑；简体中文、繁体中文、英文同步更新。

安装与适用范围

下载下方 zotero-fulltext-assistant-0.9.0.xpi，在 Zotero 插件管理器中“从文件安装”。官方 0.8.0 使用公开更新入口；原始 0.7.x 需要手动安装一次 0.8.0 或更新版。从本版起也能在全文助手设置页检查后续版本。

原生实测环境 Windows / Zotero 10.0.7，安装范围 10.0.7–10.0.*。没有扩大未经验证的系统/版本兼容范围。本版不加入出版社专用订阅 API，不自动解验证码，也不承诺取得全部文献。

验收

• 649 项 Node 测试、设置页 DOM 测试、32 项 Python 发布测试通过。
• 同一 XPI 的 218 项原生检查通过，覆盖生命周期、批次/队列、浏览器文件、科研通收尾、原生更新控制和真实 PMC 文件。
• 真实公共 PMC PDF（DOI 10.1038/s41586-020-2649-2）匿名下载 1,218,474 字节，通过原生 PDFWorker 身份核验，自动入库后再次核验通过；测试临时数据已清理。
• OpenAlex 缓存真实扣额、CORE/Semantic Scholar 付费权限未经实测；元数据或外链返回不当作真实全文入库证据。
• 最终 XPI SHA-256：4d643aff395b367b22b62c1b64eb02d6ccfb2a0d4d062ad2a0b11b5e3e8241e0。

详细说明：来源与配置 · 验收记录 · 隐私说明 · 维护更新注意事项

发布后复核（2026-11-09）

• 五份发行资产均已匿名下载，字节与验收文件完全一致；公开 latest 更新清单指向本版。
• 真实、未修改的官方 0.8.0 XPI 通过 Zotero 原生更新发现、下载并安装 0.9.0，33 项升级检查全部通过。实际下载文件在替换前再次核对 SHA-256，安装后的字节一致，新实例处于启用状态。
• 21 条隔离测试任务、非空当前批次、16 个已有 PDF 附件关联及文件字节、设置、原生更新选项和科研通登录均保留。临时批次仅为测试而创建，没有提交新求助或消费积分。
• 隔离配置没有已保存的机构 Cookie，因此没有把空状态保留当作真实机构登录跨升级验证。
• 原生替换通过后已关闭并重新启动隔离 Zotero：0.9.0 正常加载，任务文件与 XPI 字节不变，科研通登录保持有效。已公开标签和五份发行文件未修改。

全文助手 v0.8.0

全文助手 v0.8.0

首次公开发行：在 Zotero 中批量获取网页全文，核对日常浏览器下载的 PDF，并在明确授权后用科研通兜底。任务、设置、科研通设置与消息集中在原生设置页，支持简体中文、繁體中文和 English，无需浏览器扩展。

已有本地全文的条目直接跳过；新批次追加到队尾，任务和完成历史跨批次保留。未能自动识别的下载可查看诊断、预览候选并确认；已有科研通求助也能补查本地文件，核验来源后继续采纳与对应消息已读。悬赏默认 10 积分可调，可选择接受网站已核实的最低悬赏，实际金额会记录在任务中。

本版加入公开更新源、可复现的发行包与完整资产校验，重整首页和历史文档，并提供隐私说明、支持说明与 Issue 模板。

安装与更新

下载本页 .xpi，在 Zotero 插件管理器选择“从文件安装插件”。0.7.x 用户需手动安装一次本版以取得新的更新地址；插件 ID 保持一致，原有任务无需迁移到新文库。

支持范围为 Windows / Zotero 10.0.7；安装清单允许 10.0.7–10.0.*。其他操作系统、Zotero 7/8/9 和 10.1+ 尚未验证。科研通、出版社和机构登录有效性由网站决定，插件不绕过验证码或订阅限制，签到仍需本人在官网完成。

验证

实际 0.8.0 XPI 原生检查 180/180 通过。正式文库已从 0.7.2 手动升级到 0.8.0，8 项保存检查通过，既有任务与配置完整保留。原生检查包含模拟接口和受控数据，不代表真实网站新求助及付费结算已全部重测；旧版测试数字没有移入本版。

最终提交 65a24c19f20473c9b8963d0224b7e585b8b80d02 的 GitHub CI 通过：559 项 Node 测试、设置页 DOM 回归、32 项 Python 发布流程测试。发布包与源码均按固定排序、元数据和文本换行构建，并以完整 SHA-256 校验。

发布后已匿名下载并核对全部五项发行资产，公开 latest/download/updates.json 与本地清单完全一致。隔离 Zotero 使用原生更新机制，从仅供本机验证的 0.7.99 测试版本发现、下载并安装公开 0.8.0，11 项检查全部通过；升级后的设置、当前批次及既有任务保留，安装后 XPI 的 SHA-256 与发行包一致。该测试版包含公开更新地址，未对外发行，不能据此宣称原始 0.7.2 能自动发现本次更新。

完整说明与范围见仓库 docs/release-v0.8.0.md 和 docs/verification-v0.8.0.md。第三方插件目录申请与 GitHub Release 发布是独立流程，请以目录实际显示为准。收录申请已提交：Zotero Addons #301、Zotero 中文社区 #349，当前等待维护者审核。

文件

• zotero-fulltext-assistant-0.8.0.xpi：安装包。
• zotero-fulltext-assistant-0.8.0-source.zip：源码、测试与文档。
• updates.json：Zotero 更新清单。
• SHA256SUMS：安装包、源码包和更新清单的校验值。
• release-manifest.json：版本与资产大小、哈希清单。

安装包 SHA-256：279a4fa73b78833b7b11b6030dfc3a0d46971a4fc42f629e2e1f4241bfc170ec