Zotero Attanger 附件管理完整指南：自动重命名、匹配与移动文献 PDF

Zotero Attanger 附件管理完整指南：自动重命名、匹配与移动文献 PDF

【免费下载链接】zotero-attangerAttanger (Attachment Manager) organizes Zotero attachments: attach recent downloads, match files to items, rename them with Zotero's native templates, and move or copy them into a predictable folder structure.项目地址: https://gitcode.com/gh_mirrors/zo/zotero-attanger

刚下载的一批文献 PDF，文件名清一色是2023_0412_final_v2.pdf，想归进 Zotero 还得逐个改名、搬运、挂载，重复劳动不少。Zotero Attanger 是一个 Zotero 附件管理插件，把「从指定目录抓取文件、按标题匹配到条目、用原生模板重命名、移动/复制到固定目录」这一整套动作自动化了。

安装 .xpi 包后（Zotero 中「工具 > 插件 > 安装插件文件」），打开「设置 > Attanger」即可看到全部配置项。

30 秒看懂 Attanger 能做什么

• 📥附加新文件：从源目录里挑最近修改的那个文件，自动挂到你选中的条目或集合下
• 🎯匹配附件：扫描源目录里的 PDF/CAJ 文件，按标题相似度批量匹配到选中的文献条目（可选读 PDF 内部文字来提标题，识别更准）
• ✂️重命名附件：套用 Zotero 原生重命名模板（如{{authors}} - {{year}} - {{title}}）直接改磁盘上的文件名
• 📦移动/复制附件：把文件按「靶路径 + 子目录」规则归档，支持撤销移动（把链接文件还原为存储副本）
• 🤖自动化开关：新附件进来可自动重命名、自动移动、自动清理空文件夹

分场景配置指南

配置面板一共 5 块：源路径、附加类型、靶路径、其他设置、关于。不同的同步方式，关键选项取值不一样。

个人独立研究：用「副本」模式最省心

如果你用 Zotero 官方同步或 WebDAV 同步（即文件跟着 Zotero 数据目录走），推荐这样配：

坚果云 / OneDrive 等第三方云盘：「链接」+ 靶路径

云盘同步的是文件本身而不是 Zotero 数据库时，选「链接」模式：文件会被移动到靶路径下，然后以链接附件形式导入 Zotero，云盘负责在多设备间同步文件。

• 附加类型：链接（linking）
• 靶路径：放在云盘同步目录内，建议独立一个Attanger根目录，和 Zotero 数据目录分开，方便单独备份
• 子目录：默认{{collection}}（按集合名建文件夹）；想更结构化可以写多级，如{{itemType}}/{{year}}，层级之间用/隔开
• 从 PDF 读取标题：默认「仅限外文」。处理英文文献时建议保持默认甚至改「始终」，因为 PDF 内嵌标题比文件名更可靠

批量整理存量 PDF：匹配 + 自动移动

手里已有几百个没管过的 PDF 时，流程是：

1. 源路径指向存放这些 PDF 的目录（目录越小匹配越快，建议先按年份/课题分子目录）
2. 「重命名/移动的附件类型」确认包含pdf（默认值已含 pdf、doc、docx、txt、rtf、djvu、epub）
3. 勾选「自动重命名添加的附件」和「自动移动添加的附件」
4. 在主界面多选文献，右键「匹配附件」，插件会按标题相似度把文件逐一挂上，命中后源目录里的原文件会被删除（开发模式下保留，见避坑一节）

匹配是逐个文件算相似度取最优的，所以先小批量（比如 10 条）试跑，看看命中率再放大规模，比一次梭哈几百个稳。

高频操作与快捷键

两个核心操作带默认快捷键，都可以在设置面板里改（勾选启用后直接在输入框里按键即可）：

其余操作走右键菜单，选中条目后就能看到：

• 附件管理 > 重命名并移动附件：一步完成改名 + 归档，存量文件最常用
• 附件管理 > 撤销移动附件：把链接文件重新收编为存储副本
• 匹配 Attanger 附件：按插件生成的文件名精确找回附件（和模糊匹配互补）
• 打开方式：记住一个默认阅读器，右键直接打开 PDF

避坑：疑难问题与性能调优

🔍匹配结果不对：先看源路径是否指向了对目录；英文文献确认「从 PDF 读取标题」不是「永不」；多个条目标题高度相似时，相似度容易错配——把文件名先改成带区分度的样子，或逐条匹配检查。

📁目标目录已有同名文件：插件会先比对两个文件的 MD5。内容相同则跳过；内容不同会自动加数字后缀，弹窗里也可以点链接手填自定义后缀，不会覆盖已有文件。

🔗移动后附件变成链接：这是链接模式的正常行为（文件在靶路径，Zotero 只存指向）。想收回来就右键「撤销移动附件」。

🧹源目录越来越卡：匹配会遍历整个源目录并解析 PDF 文本，目录越大越慢。建议源目录只放待整理文件，整理完就清走；重归档操作放 SSD 上执行。

🏷️子目录层级和预期不符：检查「将变量中的正斜杠解析为子文件夹分隔符」是否勾选，以及变量展开后是否混入了? * : |等非法字符（插件会自动过滤这类字符）。

⏳重命名没生效：文件被阅读器占用时重命名会失败，插件内置了间隔 3 秒、最多 5 次的重试，先关掉占用文件的程序再试。另外开发环境（npm start起的调试实例）出于安全不会真的删除源目录文件，这是预期行为。

🗑️移动后留一堆空文件夹：勾选「自动删除移动后为空的文件夹」（默认关闭），且它只清理源路径、靶路径和 Zotero 存储目录这三类根目录下的空目录，不会误删别处。

二次开发与扩展点

项目基于 Zotero 插件模板构建（TypeScript + zotero-plugin-toolkit），常用命令：npm start起本地开发服务，npm run build产出 .xpi。

想加新的操作（比如新的匹配策略或文件类型处理），参考 src/addon.ts 里的图标注册方式，在 menu.ts 里新增一个菜单项并挂上 commandListener，再补上 locale 文案就是完整的一套扩展路径。

Attanger 把「下载 → 改名 → 归档 → 挂载」这条手工流水线的每一步都留了自动化开关，配好一次源路径和靶路径，之后的文献附件基本不用再手动碰。

【免费下载链接】zotero-attangerAttanger (Attachment Manager) organizes Zotero attachments: attach recent downloads, match files to items, rename them with Zotero's native templates, and move or copy them into a predictable folder structure.项目地址: https://gitcode.com/gh_mirrors/zo/zotero-attanger