Refs 1.2.7

修复与改进

• 更谨慎地核验标题、作者、年份和标识符，避免同名论文及带有 +/− 等语义差别的标题被误绑定 DOI。
• 同一文库的并发导入去重；双向关联统一事务保存，失败时恢复数据库和内存索引。
• 强制刷新贯穿来源与 HTTP 缓存；临时失败可重试，请求有总期限，分页不完整时保留已有结果并明确标记。
• API 结果可先于 PDF 显示；PDF 解析支持取消和期限，修正首次分屏导航竞争及最后一条长引用被静默截断的问题。
• 关闭或切换面板时释放旧视图与订阅；同条目重绘不会打断刷新，取消初次加载后可继续加载。
• 新增“详情”按钮与 Alt+Enter，Esc 关闭卡片并返回焦点；完善中英文状态提示。
• 新编辑记录原引用证据，刷新时只向唯一且无冲突的引用套用；无法匹配时保留编辑列表。

升级说明

旧版未记录来源的编辑无法可靠自动迁移。首次替换前的完整列表保存在参考文献缓存的 FUSED_BEFORE_REFRESH 槽，便于恢复；显式清空缓存或容量淘汰也会删除该备份。

验证

生产构建、TypeScript、Lint、28 个离线 Node 回归脚本和 10 项 Python 检查通过。已在隔离 macOS Zotero 10.0.2 验证四面板、详情焦点、刷新与取消、原生事务回滚和 PDF reader；其他版本未逐一原生复测，合成 PDF 测试不代表真实论文解析准确率。

---

Stricter citation identity checks; deduplicated imports and atomic relations; bounded network/PDF work; explicit partial results; refresh-safe edits; pane cleanup; and keyboard-accessible details. Install refs.xpi below or check for updates in Zotero.

Refs 1.2.6

修复引文提取边界，并改善中英文参考文献的显示。

• 整理英文引文中的多余空格、全角标点及 [C]//、[S.l.] 等常见标记；保护 DOI、URL、未知括号和原始复制文本。列表与悬浮卡片使用一致的显示规则。
• 修复已选目录在同页续排后接另一套参考目录时的漏抓或混入。结合页面位置、连续编号和引文证据识别边界，保留跨页续行，并正确衔接多页编号；复杂多栏或证据不足时保守处理。
• 手动从当前页解析遇到无效页码时，不再猜测起始页；无标题目录可以从无效的大块候选回退到有引文证据的候选。

通过完整构建、静态检查及 226 项解析回归；711 份既有 PDF 的完整输出对比无新增差异，原有 42 个空结果和 3 份无效文件保持不变。另验证了六种 PDF 绘制顺序和 Zotero 实机菜单操作。上述结果是回归验证，不代表所有 PDF 版面都能准确识别。

更新后若某篇论文仍显示旧的异常结果，请在参考文献面板选择“更多 → 重新获取 · 跳过缓存”。

Refs 1.2.5

中文

• 修复参考文献、被引用、相关文献和引文图谱折叠后留白过大的问题，使行高与 Zotero 原生区块一致。
• 展开布局、图标和数据处理保持不变。

English

• Fixed excess spacing in collapsed References, Cited By, Related Papers, and Citation Graph sections, aligning their row heights with Zotero's native sections.
• Expanded layouts, icons, and data handling are unchanged.

Upgrade / 升级

Install the 1.2.5 update through Zotero's normal add-on update flow, then restart Zotero if prompted.

请通过 Zotero 的常规插件更新流程安装 1.2.5；如 Zotero 提示，请重启 Zotero。

Refs 1.2.4

Refs 1.2.4 改善本地参考文献解析与中文引文显示。

• 改善左对齐、无编号作者—年份列表的拆分，减少一条引文被切成多条的问题。
• 支持部分按研究分组的参考目录，区分研究标签与实际出版物，减少误合并和标题混入。
• 增加条目边界、跨页位置及输入预算检查，保留来源文本和合法连字符；不适用的样式继续使用原有解析路径。
• 收紧续接和尾部识别规则，并增加印刷编号、来源位置和异常状态的开发诊断。
• 优化中文引文的多余空格及标点显示，保留原始引文供复制、编辑和匹配使用。

已完成完整离线回归、711 个 PDF 文件的开发回归，以及隔离 Zotero 的实际菜单和四面板检查。交替预热解析测速整体耗时基本持平，未增加读页次数。实验性全文核心仍未替换默认解析器。

升级后，如当前列表来自旧缓存，请长按“刷新”重新解析 PDF。复杂多目录归属、扫描件和部分特殊版式仍有已知限制。

Refs 1.2.3

修复特殊跨页文献在升级后仍显示旧错误抓取结果的问题。

• 识别混入“上接／下接／下转第…页”提示的旧 PDF 参考文献缓存，避免普通刷新继续命中错误列表。
• 同时处理旧合并列表和原始 PDF 缓存；保留正常缓存及 API 信息，重新解析成功后保存修复结果。
• 对 issue #6 的样例，正确衔接第 1–14 条与第 15–20 条，保留原始序号和 PDF 跳转位置。

本次为 1.2.3 小版本修复，保持现有界面和图标。整体抓取规则升级另行验证，不包含在本次发布中。

Refs 1.2.2

更新内容

• 修复带“下转第 × 页／上接第 × 页”的跨页参考文献目录混入其他文章引文、或手动解析不完整的问题（#6）。
• 根据双向续页标记和印刷页码核对归属，按页内区域拼接目录，保留跨栏条目的完整文字和原始跳转位置。
• 收紧正文续页提示、后续独立章节和页码冲突的判断；无法确认续页归属时保留已核实的目录部分。

已有缓存结果可通过“重新获取 · 跳过缓存”或“从 PDF 当前页向前解析”重新提取。原有图标和界面设计保持不变。

Changes

• Fix mixed-article reference lists with paired printed-page continuation notices, including incomplete extraction when starting from either bibliography page (#6).
• Verify both continuation markers and printed page numbers, join only the matching bibliography regions, and preserve wrapped text and original PDF navigation positions.
• Guard against body-text notices, later independent chapters, ambiguous page numbers and unavailable continuation pages.

Refresh without cache to re-extract previously cached lists. This patch preserves the existing icons and UI. Supports Zotero 7–10; verified in Zotero 10.0.1.

Refs 1.2.1

更新内容

• 改善引文图谱的拖动、平移和缩放响应，合并同一帧内的重复更新，减少主线程阻塞。
• 优化窄侧栏的节点标签显示，以及拖动结束后的摘要卡响应；保留现有图标、箭头和引用方向。
• 修复插件更新后，已经打开的 PDF 标签页可能保留旧面板回调、导致引文图谱一直显示“正在构建”的问题。

Changes

• Improve citation-graph dragging, panning and zooming by coalescing frame updates and reducing synchronous main-thread work.
• Improve label bounds in narrow sidebars and hover-card behavior after dragging, while preserving existing icons, arrowheads and citation direction.
• Fix stale item-pane callbacks after plugin updates, which could leave the graph stuck loading in PDF tabs that were already open.

Supports Zotero 7–10. Update through Zotero’s built-in plugin updater, or install refs.xpi from this release.

Refs 1.2.0

中文

• 相关文献同时整合 Semantic Scholar 和 OpenAlex，按来源列表位次综合排序，并标明推荐来源；手工关联始终保留在前。
• 更稳妥地区分同名论文，保留不同 DOI 的文献；一方暂不可用时仍能显示另一方的结果。
• 引文图谱用箭头表示真实引用方向，区分来源推荐与共享参考文献，保留论文的多重关系。
• 保留原有侧栏图标设计，与 Zest 统一线条粗细，并优化窄侧栏的推荐列表和加载反馈。

English

• Related papers now combine Semantic Scholar and OpenAlex lists with source-rank fusion and visible provenance; manual links remain first.
• Safer identity matching preserves distinct papers with different DOIs, while partial results remain useful when one provider is unavailable.
• Citation-graph arrows now show citing-to-cited direction, separately identify provider recommendations and shared references, and retain overlapping paper roles.
• Original sidebar icon motifs are preserved with consistent line weights alongside Zest, plus clearer compact recommendation layouts and loading feedback.

Refs 1.1.2

修复 PDF 引文普通点击意外打开分栏的问题。普通点击恢复 Zotero 原生跳转；按住 Alt / Option 点击才会在分栏中打开目标，原生悬停预览保持不变。

• 摘要缺失时增加 Europe PMC / PubMed 补抓，改善旧文献及历史 DOI 的识别。
• 翻译期间移开后返回可接续同一请求；完成后重新打开卡片保留译文或原文选择，减少重复等待。留存适用于当前插件会话。
• 首位、末位及明确角色的作者优先显示来源提供的全名，避免缩写覆盖或截断名单误认末位作者。
• 改善缓存、导入和图谱定位的稳定性，防止修改文献信息后沿用旧结果或建立错误关联。

升级后，部分旧缓存需要重新获取；若没有自动加载，点击“刷新”即可。

Normal PDF citation clicks now use Zotero’s native navigation. Alt / Option+click opens a split view when enabled. This release also adds missing-abstract retrieval, retains requested translations and view choices within the current plugin session, improves full author names, and fixes stale-cache, import and graph-location issues. Some older cached lists may need a refresh after upgrading.

Refs 1.1.1

摘要现在按原文中的背景、方法、结果、结论等标题分段，小标题独立成行，并改善字号、行距与段间距。兼容中英文和常见期刊摘要格式；没有明确标题时保留原有段落。

• 原文、译文和复制内容均保留摘要结构。
• 改善 Crossref、ReadPaper、Connected Papers 摘要中的 HTML/JATS 段落与上下标显示。
• 修复翻译期间补充作者等元数据时，翻译结果可能丢失的问题，并避免重复发送同一请求。

Abstracts now use separate paragraphs and clear section headings, with more readable type and spacing. Original text, translations and copied content retain their structure. This update also improves HTML/JATS abstract formatting and preserves pending translations when additional metadata arrives.