0.1.10 — 修复下载地址变更与重复提交后任务卡死

修复两个导致任务无法完成的问题：网站改用明文 IP 下载地址后全部下载失败，以及重新提交被网站拒绝后任务永久停在「处理中」。

下载地址（0.1.9）

• 网站不再通过 https://npc1.worldlib.site/... 提供文件，改为在其下载落地页给出 http://<公网 IP>:<端口>/UPLOAD/...?token=... 的明文链接。0.1.7 起的主机白名单要求「HTTPS + 白名单域名 + 默认端口」，把这类链接全部过滤，任务因此报「所有下载地址均失败或返回的文件不是完整 PDF」。
• 现在由世图下载落地页提取的链接额外允许明文 HTTP 的公网 IPv4 地址；仍拒绝环回、私有、链路本地与运营商级 NAT 网段，仍拒绝带凭据的 URL，仍只接受该落地页中「文件下载」锚点给出的地址。
• 文献管理接口直接返回的链接判断标准不变，仍是 HTTPS 白名单域名。文件依旧要求 PDF 头与 %%EOF 结束标记，下载链接仍不写入任务快照。

任务匹配（0.1.10）

• 网站对重复提交返回的记录没有任务号（id 为 0），旧逻辑把它当成远程任务标识存下来。此后同一 DOI 的真实结果被判定为「历史中的同 DOI 结果属于其他任务」，任务既不报错也不推进，永远停在「处理中」。
• matchRecord() 现在忽略非正整数标识；提交响应没有有效任务号时不再写入 remoteIDs，并撤销重新提交时为屏蔽旧结果而设置的忽略列表，直接回退按 DOI 匹配已有结果；磁盘上已有的零任务号在加载时自动清理。

升级说明

• 从 0.1.8 或 0.1.9 覆盖安装即可，任务数据无需删除。
• 升级后「处理中」的任务会自动恢复并按 DOI 匹配已有结果；已显示「需处理」的任务点一次「重试查询 / 下载」即可，不需要「重新提交所选需求」。

测试

node --test tests/site.test.js 共 32 项通过，覆盖空列表、账号无法确认、身份 Cookie 缺失回退、落地页公网 http 地址、私有网段拒绝、零任务号不遮蔽已有结果等场景。

安装包 SHA-256 见同目录 .sha256 文件。

本插件不提供账号、订阅或网站权限，不保证每篇文献都能获取。PDF 文件头检查不等于内容安全扫描。

0.1.8 — 修复空列表导致整队列「需处理」与 Zotero 10 安装失败

修复 0.1.7 在网站「文献列表」为空时把整条队列打成「需处理」的问题，并修掉 Zotero 10 上无法安装的清单字段缺失。

主要修复

• 空列表不再被当成协议错误：网站对空的文献管理列表返回 HTTP 200 空响应体（其自身页面渲染为「暂无数据」）。0.1.7 把空响应体当解析失败，抛「文献管理结果不是有效 JSON，已暂停处理」，并把全部在办任务置为「需处理」且不再自动重试。现在空响应体会先向账号信息接口确认账号仍然有效：确认有效则按「暂无记录」处理；无法确认账号时仍按协议错误暂停，不会因为一个空响应就放行新的提交。
• 重启后不再误报无权限：网站只在自身页面脚本里以会话 Cookie 写入 usertype、remainday，Zotero 重启后这两个值会丢失。0.1.7 因此把有效账号误判为「未开通文献咨询或正在审核」并暂停新提交。现在缺少这两个 Cookie 时会回退查询账号信息接口。
• 安装包可正常安装：Zotero 10 的清单校验要求 applications.zotero.update_url 存在，0.1.7 删掉该字段后，仓库构建的安装包会以「无法安装插件，可能无法与该版本的 Zotero 兼容」失败。该字段已恢复，指向不可解析的 updates.invalid，只用于满足校验并明确表示不提供自动更新。

兼容与升级

• 需要 Zotero 9–10；已在 Zotero 10.0.7 上验证清单可被接受。
• 从 0.1.7 覆盖安装即可，任务数据无需删除。此前显示「需处理」的任务并未提交过，安装后点「重试查询 / 下载」即可继续，不会产生重复需求。

测试

node --test tests/site.test.js 共 28 项通过，新增用例覆盖空列表、账号无法确认、空列表下核对历史、Cookie 缺失回退、身份到期与未开通。

校验

安装包 SHA-256 见同目录 .sha256 文件。

本插件不提供账号、订阅或网站权限，不保证每篇文献都能获取。PDF 文件头检查不等于内容安全扫描。

世图 PDF 助手 0.1.7

世图 PDF 助手 0.1.7

下载 worldlib-pdf-0.1.7.xpi，在 Zotero 的“工具 → 插件 → 从文件安装插件”中安装。不要将 Source code 压缩包作为插件安装。

本次发布

• 优先复用网站近期求助结果，减少重复提交。
• 下载链接不再写入任务快照及新备份；不使用无法验证有效期的缓存链接。
• 限制下载入口与页面提取链接的 HTTPS 主机及端口，校验结果日期。
• 重写安装与使用文档，补充可重复打包脚本和 SHA-256 文件。
• 移除无效更新地址；后续版本需要手动安装。

版本与验证说明

这是由当前修复后源码重新打包的 0.1.7，不是此前的旧包；安装过旧 0.1.7 的用户请手动安装此附件。插件清单声明支持 Zotero 9–10。

23 项本地测试通过，包内文件与源码一致，重复构建校验通过。修复后的 Zotero 实机端到端验证和底层下载重定向防护仍未完成，本版本仍属于测试版本，不保证所有文献均可获取。

旧任务备份可能仍含账号参数，请勿公开。原始插件来源及再分发授权尚未核实，本项目未声明开源许可证。