wileyyugioh/zotmoov · 上手攻略

  • 仓库：wileyyugioh/zotmoov
  • 链接：https://github.com/wileyyugioh/zotmoov
  • 分类：zotero-plugin
  • 作者：Tom
  • 更新：2026-08-13

是什么

ZotMoov 是 Zotero 7 的附件管理插件，核心功能是把 Zotero 内部存储的附件（stored attachments）自动迁移到自定义目录，并转换为链连附件（linked attachments），从而节省 Zotero 数据目录的存储空间，同时保持文献管理功能完整。

它的定位是 ZotFile（Zotero 5 时代最流行的附件管理插件）在 Zotero 7 的精神继承者，专攻"附件迁移 + 链连化"这一件事。

解决什么问题

Zotero 默认将所有附件（PDF、图片等）存放在 zotero storage 目录下，随着文献库增长，这个目录会变得庞大且难以管理。ZotMoov 解决的是：

  1. 空间整理：将附件移到指定数据目录（如 ~/ZoteroFiles/），不再占用 Zotero 数据目录
  2. 文件自主：附件是真实文件，不被 Zotero 数据库绑定，可被其他应用直接访问
  3. 多设备同步：配合 Zotero 的 Linked Attachment Base Directory 功能，可在不同设备间同步同一套文件
  4. Zotero 7 适配：ZotFile 尚未全面支持 Zotero 7，ZotMoov 是当前可用的迁移方案

快速安装

方式一：从 GitHub Releases 安装（推荐）

  1. 前往 https://github.com/wileyyugioh/zotmoov/releases/latest
  2. 下载最新的 .xpi 文件
  3. Firefox 用户：必须右键 → "另存为" 保存 .xpi 文件（Firefox 不支持直接点击安装）
  4. 打开 Zotero → 工具 → 附加组件 → 齿轮图标 → "Install Add-on From File" → 选择下载的 .xpi
  5. 安装完成后重启 Zotero

⚠️ 注意：Chrome/Edge 用户直接点击 .xpi 可能自动安装；Firefox 必须右键另存。

方式二：从源码安装（开发用途）

# 克隆仓库
git clone https://github.com/wileyyugioh/zotmoov.git
cd zotmoov

# Zotero 7 插件构建（需要 node.js）
npm install
npm run build

# 生成的 .xpi 在 dist/ 目录

核心用法

首次配置

  1. Zotero 菜单 → 编辑 → 首选项 → 附加组件
  2. 找到 ZotMoov → 右键 → Options 或点击齿轮图标
  3. 设置 ZotMoov Data Directory（例如 ~/ZoteroFiles/）
  4. 建议配合 Zotero 7 内置的自动重命名功能（设置 → 高级 → 文件命名）使用自定义命名模式

两个核心操作：Move vs Copy

操作 效果 使用场景
Move 将附件从 Zotero 内部存储转为链连附件，原文件移到数据目录 主要用法，将附件纳入自定义管理
Copy 复制附件到数据目录作为备份，Zotero 侧保持内部存储 备份场景，Zotero 不再追踪该文件

右键菜单操作

在 Zotero 文献条目上右键，可以手动： - Move/copy to ZotMoov directory：将附件移入/复制到 ZotMoov 数据目录 - Move/copy from ZotMoov directory：将附件从数据目录移回 Zotero 内部存储

自动规则（需在设置中开启）

开启后，导入 PDF 时自动执行 Move 逻辑，不需要手动操作。

典型适用场景

  1. 文献库附件整理：把历年积累的 PDF 从 storage/ 目录迁移到结构化的自定义目录
  2. 多设备同步：配合 OneDrive/Dropbox/百度网盘同步 ZotMoov Data Directory，在不同电脑上访问同一套 PDF
  3. 腾出 Zotero 云同步配额：Zotero 免费账号云同步空间有限，链连附件不占云同步配额（需关闭附件同步）
  4. 从 ZotFile 迁移：Zotero 5 时代用 ZotFile 的用户，升级到 Zotero 7 后继续用类似工作流

坑与注意

⚠️ 备份永远是第一步

Move 操作会修改 Zotero 数据库和文件系统，在操作前务必： 1. Zotero → 编辑 → 首选项 → 高级 → 数据目录 → 手动备份 2. 关闭 Zotero 同步中的"同步附件文件"选项，防止云端冲突

⚠️ Linked Attachment Base Directory 兼容性

如果之前在 Zotero 设置过"Linked Attachment Base Directory"（高级设置），迁移时需要将 Base Directory 调整为同时包含 ZotFile 旧文件和新 ZotMoov 文件的父目录。最简单的做法：直接把 ZotMoov 数据目录设为原来的 ZotFile 目录。

⚠️ 群组库（Group Library）不支持链连附件

Zotero 官方不支持群组库中的链连附件，ZotMoov 只能在个人库（My Library）中使用。群组库中的附件 Move 操作不会破坏文件，但 Copy 功能不受影响。

⚠️ Move 后文件不再受 Zotero 管理

Move 后的附件变成链连附件，Zotero 不再负责其存储管理。如果手动删除数据目录中的文件，Zotero 会报附件丢失。

与 ZotFile 的关系

ZotMoov ZotFile
Zotero 7 支持 ✅ 原生支持 ⚠️ 部分支持（Zotero 7 版仍在适配）
链连附件 ✅ 核心机制 ✅ 支持
自动重命名 依赖 Zotero 7 内置功能 内置自定义模式
平板电脑支持 ❌ 无 ✅（ZotFile 有专门平板提取功能）
数据恢复 依赖 ZotFile Recovery 插件 内置

一句话推荐结论

如果你是 Zotero 7 用户，需要把附件从数据库存储迁移到自定义目录管理，ZotMoov 是目前最直接、在维护的解决方案——专注做好一件事，安装配置都简单，但 Move 操作前务必先备份。