Skip to content

1.4.8: Linked Attachment Rename Automation & Reliability Fixes

Latest

Choose a tag to compare

@MuiseDestiny MuiseDestiny released this 14 Jul 21:38

中文

新功能

  • 新增“条目信息变更时自动重命名已链接附件”,整合并完善了 PR #278 的功能。
  • 支持独立启用防抖和额外延迟,适配 Zotero 与 Better BibTeX 异步更新标题、作者、年份和 citation key 的场景。
  • 设置页增加分层选项、多语言说明和建议数值;该功能默认关闭,不改变现有用户的重命名行为。

修复与可靠性

  • 修复 Issue #302 相关竞态:删除或移入回收站时会取消等待中和执行中的自动处理,避免附件被重新创建。
  • 自动复制/移动期间发生删除时会保留源文件并清理未完成的目标文件,避免数据丢失和残留副本。
  • 合并 Zotero Connector 分批发送的新增通知,避免同一附件被重复移动或重命名。
  • 仅对导入附件执行自动移动;已有链接附件不会再次进入自动移动流程。
  • 防止同一路径并发移动、失败后递归重试和重复创建同路径链接附件。
  • “匹配 Attanger 附件”现在直接创建链接附件,不再导入存储副本。
  • 停止在新增附件流程中自动调用 Zotero.RecognizeDocument.recognizeItems,避免文档识别相关异常。
  • 插件窗口关闭或退出时正确注销 Notifier 并清理定时器。

文档与测试

  • 重写 README,完整介绍功能、安装、配置、常用工作流和贡献方式。
  • 新增简体中文、德语和意大利语文档;欢迎使用 AI 辅助贡献,但提交者仍需审查和测试结果。
  • 新增 22 项自动化测试,覆盖自动重命名、删除竞态、并发移动、失败恢复、链接匹配和本地化界面。

支持 Zotero 7–10。安装前建议备份附件目录;链接附件仍需由第三方同步工具或其他方式单独备份。

English

New Features

  • Adds automatic renaming of linked attachments after item metadata changes, integrating and hardening the work from PR #278.
  • Debounce and extra-delay controls can be enabled independently for asynchronous Zotero and Better BibTeX title, author, year, and citation-key updates.
  • The preferences UI now provides nested controls, localized explanations, and recommended timing values. The feature is disabled by default, preserving existing behavior.

Fixes and Reliability

  • Fixes the delete/trash race reported in Issue #302: pending and in-flight automatic work is cancelled so deleted attachments are not recreated.
  • If deletion occurs during an automatic copy or move, Attanger keeps the source and removes the incomplete destination.
  • Batches separate Zotero Connector add notifications to avoid processing the same attachment more than once.
  • Automatic moves now apply only to imported attachments; existing linked files are not moved again.
  • Guards against concurrent moves of the same path, recursive retries after move failures, and duplicate linked attachments at an existing destination.
  • “Match Attanger Attachment” now creates linked attachments instead of stored copies.
  • Stops automatically calling Zotero.RecognizeDocument.recognizeItems for newly added attachments.
  • Properly unregisters Notifier observers and clears timers when windows close or the plugin shuts down.

Documentation and Tests

  • Rewrites the README with installation, configuration, workflow, safety, and contribution guidance.
  • Adds Simplified Chinese, German, and Italian documentation. AI-assisted contributions are welcome, with contributor review and testing still required.
  • Adds 22 automated tests covering rename automation, delete races, concurrent moves, failure recovery, linked matching, and localized preference controls.

Supports Zotero 7–10. Back up attachment directories before upgrading; linked files still require separate backup or third-party synchronization.

XPI checksum

SHA-256: e326dfe65001b96cd655f562405c87e095f662887496fd2da2a0efccb14cb967