Zotero Attanger 附件管理完整指南自动重命名、匹配与移动文献 PDF【免费下载链接】zotero-attangerAttanger (Attachment Manager) organizes Zotero attachments: attach recent downloads, match files to items, rename them with Zoteros 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 数据目录走推荐这样配配置项推荐取值理由附加类型副本importing文件直接导入 Zotero 存储目录同步时一并带走源路径根目录你的下载/接收目录「附加新文件」从这里抓最近的文件靶路径可留空副本模式下不依赖靶路径面板会自动变灰子目录留空文件按 Zotero 自身结构存放即可坚果云 / OneDrive 等第三方云盘「链接」 靶路径云盘同步的是文件本身而不是 Zotero 数据库时选「链接」模式文件会被移动到靶路径下然后以链接附件形式导入 Zotero云盘负责在多设备间同步文件。附加类型链接linking靶路径放在云盘同步目录内建议独立一个Attanger根目录和 Zotero 数据目录分开方便单独备份子目录默认{{collection}}按集合名建文件夹想更结构化可以写多级如{{itemType}}/{{year}}层级之间用/隔开从 PDF 读取标题默认「仅限外文」。处理英文文献时建议保持默认甚至改「始终」因为 PDF 内嵌标题比文件名更可靠批量整理存量 PDF匹配 自动移动手里已有几百个没管过的 PDF 时流程是源路径指向存放这些 PDF 的目录目录越小匹配越快建议先按年份/课题分子目录「重命名/移动的附件类型」确认包含pdf默认值已含 pdf、doc、docx、txt、rtf、djvu、epub勾选「自动重命名添加的附件」和「自动移动添加的附件」在主界面多选文献右键「匹配附件」插件会按标题相似度把文件逐一挂上命中后源目录里的原文件会被删除开发模式下保留见避坑一节匹配是逐个文件算相似度取最优的所以先小批量比如 10 条试跑看看命中率再放大规模比一次梭哈几百个稳。高频操作与快捷键两个核心操作带默认快捷键都可以在设置面板里改勾选启用后直接在输入框里按键即可操作默认快捷键适用场景附加新文件Ctrl I刚下载完一个文件快速挂到当前条目/集合匹配附件Ctrl M选中一批条目批量认领源目录里的文件其余操作走右键菜单选中条目后就能看到附件管理 重命名并移动附件一步完成改名 归档存量文件最常用附件管理 撤销移动附件把链接文件重新收编为存储副本匹配 Attanger 附件按插件生成的文件名精确找回附件和模糊匹配互补打开方式记住一个默认阅读器右键直接打开 PDF避坑疑难问题与性能调优匹配结果不对先看源路径是否指向了对目录英文文献确认「从 PDF 读取标题」不是「永不」多个条目标题高度相似时相似度容易错配——把文件名先改成带区分度的样子或逐条匹配检查。目标目录已有同名文件插件会先比对两个文件的 MD5。内容相同则跳过内容不同会自动加数字后缀弹窗里也可以点链接手填自定义后缀不会覆盖已有文件。移动后附件变成链接这是链接模式的正常行为文件在靶路径Zotero 只存指向。想收回来就右键「撤销移动附件」。源目录越来越卡匹配会遍历整个源目录并解析 PDF 文本目录越大越慢。建议源目录只放待整理文件整理完就清走重归档操作放 SSD 上执行。️子目录层级和预期不符检查「将变量中的正斜杠解析为子文件夹分隔符」是否勾选以及变量展开后是否混入了? * : |等非法字符插件会自动过滤这类字符。⏳重命名没生效文件被阅读器占用时重命名会失败插件内置了间隔 3 秒、最多 5 次的重试先关掉占用文件的程序再试。另外开发环境npm start起的调试实例出于安全不会真的删除源目录文件这是预期行为。️移动后留一堆空文件夹勾选「自动删除移动后为空的文件夹」默认关闭且它只清理源路径、靶路径和 Zotero 存储目录这三类根目录下的空目录不会误删别处。二次开发与扩展点项目基于 Zotero 插件模板构建TypeScript zotero-plugin-toolkit常用命令npm start起本地开发服务npm run build产出 .xpi。扩展点位置说明菜单注册与匹配/移动核心逻辑src/modules/menu.ts右键菜单、matchAttachment、moveFile都在此改匹配算法从这入手设置面板绑定src/modules/preferenceScript.ts目录选择器、快捷键监听的事件绑定偏好读写src/utils/prefs.ts所有配置统一走extensions.zotero.zoteroattanger.前缀加新配置只需新增一个 key快捷键src/utils/shortcut.ts注册自定义快捷键多语言文案addon/locale/en-US、zh-CN、de、it-IT 四套 FTL 文件改文案不用碰代码默认配置addon/prefs.js各选项出厂值例如attachType默认linking、子目录默认{{collection}}想加新的操作比如新的匹配策略或文件类型处理参考 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 Zoteros native templates, and move or copy them into a predictable folder structure.项目地址: https://gitcode.com/gh_mirrors/zo/zotero-attanger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Zotero Attanger 附件管理完整指南自动重命名、匹配与移动文献 PDF【免费下载链接】zotero-attangerAttanger (Attachment Manager) organizes Zotero attachments: attach recent downloads, match files to items, rename them with Zoteros 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 数据目录走推荐这样配配置项推荐取值理由附加类型副本importing文件直接导入 Zotero 存储目录同步时一并带走源路径根目录你的下载/接收目录「附加新文件」从这里抓最近的文件靶路径可留空副本模式下不依赖靶路径面板会自动变灰子目录留空文件按 Zotero 自身结构存放即可坚果云 / OneDrive 等第三方云盘「链接」 靶路径云盘同步的是文件本身而不是 Zotero 数据库时选「链接」模式文件会被移动到靶路径下然后以链接附件形式导入 Zotero云盘负责在多设备间同步文件。附加类型链接linking靶路径放在云盘同步目录内建议独立一个Attanger根目录和 Zotero 数据目录分开方便单独备份子目录默认{{collection}}按集合名建文件夹想更结构化可以写多级如{{itemType}}/{{year}}层级之间用/隔开从 PDF 读取标题默认「仅限外文」。处理英文文献时建议保持默认甚至改「始终」因为 PDF 内嵌标题比文件名更可靠批量整理存量 PDF匹配 自动移动手里已有几百个没管过的 PDF 时流程是源路径指向存放这些 PDF 的目录目录越小匹配越快建议先按年份/课题分子目录「重命名/移动的附件类型」确认包含pdf默认值已含 pdf、doc、docx、txt、rtf、djvu、epub勾选「自动重命名添加的附件」和「自动移动添加的附件」在主界面多选文献右键「匹配附件」插件会按标题相似度把文件逐一挂上命中后源目录里的原文件会被删除开发模式下保留见避坑一节匹配是逐个文件算相似度取最优的所以先小批量比如 10 条试跑看看命中率再放大规模比一次梭哈几百个稳。高频操作与快捷键两个核心操作带默认快捷键都可以在设置面板里改勾选启用后直接在输入框里按键即可操作默认快捷键适用场景附加新文件Ctrl I刚下载完一个文件快速挂到当前条目/集合匹配附件Ctrl M选中一批条目批量认领源目录里的文件其余操作走右键菜单选中条目后就能看到附件管理 重命名并移动附件一步完成改名 归档存量文件最常用附件管理 撤销移动附件把链接文件重新收编为存储副本匹配 Attanger 附件按插件生成的文件名精确找回附件和模糊匹配互补打开方式记住一个默认阅读器右键直接打开 PDF避坑疑难问题与性能调优匹配结果不对先看源路径是否指向了对目录英文文献确认「从 PDF 读取标题」不是「永不」多个条目标题高度相似时相似度容易错配——把文件名先改成带区分度的样子或逐条匹配检查。目标目录已有同名文件插件会先比对两个文件的 MD5。内容相同则跳过内容不同会自动加数字后缀弹窗里也可以点链接手填自定义后缀不会覆盖已有文件。移动后附件变成链接这是链接模式的正常行为文件在靶路径Zotero 只存指向。想收回来就右键「撤销移动附件」。源目录越来越卡匹配会遍历整个源目录并解析 PDF 文本目录越大越慢。建议源目录只放待整理文件整理完就清走重归档操作放 SSD 上执行。️子目录层级和预期不符检查「将变量中的正斜杠解析为子文件夹分隔符」是否勾选以及变量展开后是否混入了? * : |等非法字符插件会自动过滤这类字符。⏳重命名没生效文件被阅读器占用时重命名会失败插件内置了间隔 3 秒、最多 5 次的重试先关掉占用文件的程序再试。另外开发环境npm start起的调试实例出于安全不会真的删除源目录文件这是预期行为。️移动后留一堆空文件夹勾选「自动删除移动后为空的文件夹」默认关闭且它只清理源路径、靶路径和 Zotero 存储目录这三类根目录下的空目录不会误删别处。二次开发与扩展点项目基于 Zotero 插件模板构建TypeScript zotero-plugin-toolkit常用命令npm start起本地开发服务npm run build产出 .xpi。扩展点位置说明菜单注册与匹配/移动核心逻辑src/modules/menu.ts右键菜单、matchAttachment、moveFile都在此改匹配算法从这入手设置面板绑定src/modules/preferenceScript.ts目录选择器、快捷键监听的事件绑定偏好读写src/utils/prefs.ts所有配置统一走extensions.zotero.zoteroattanger.前缀加新配置只需新增一个 key快捷键src/utils/shortcut.ts注册自定义快捷键多语言文案addon/locale/en-US、zh-CN、de、it-IT 四套 FTL 文件改文案不用碰代码默认配置addon/prefs.js各选项出厂值例如attachType默认linking、子目录默认{{collection}}想加新的操作比如新的匹配策略或文件类型处理参考 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 Zoteros native templates, and move or copy them into a predictable folder structure.项目地址: https://gitcode.com/gh_mirrors/zo/zotero-attanger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
)
