做研究、写论文的人，很多好料并不来自数据库，而是躺在微信里：一篇讲清了某个方法的公众号长文、同门转发的行业报告、导师甩过来的政策解读。想把它们和文献放在一起管理，却发现微信文章根本存不进 Zotero。
本文讲清楚两件事：为什么 Zotero Connector 抓不了公众号文章，以及怎样用《笔记同步助手》Zotero 版插件，把公众号文章、知乎回答、小红书笔记这些内容，连同正文、插图和附件一起永久保存进 Zotero 的指定分类里，变成可检索、可引用、可批注的条目。
全文用真机截图讲完安装、配置和实际效果。
一、为什么「收藏」不算保存
先说清楚痛点，因为它决定了后面所有设计。
微信收藏会失效。 公众号文章被作者删除、被平台下架、账号迁移或注销，收藏夹里那条就变成一句「该内容已被发布者删除」。你收藏的从来不是内容本身，只是一个随时会断的链接。
收藏夹搜不动。 攒到几百上千条之后，微信收藏既没有分类树，也没法按作者、时间、标签做组合筛选——想找「去年看过的那篇讲结构方程模型的推文」，基本只能靠一路翻。
它和你的文献库是两个世界。 文献在 Zotero 里分好了类、打好了标签、能一键生成参考文献；微信文章却漂在另一个 App 里，写作时根本调不动。
截图和转发到电脑也不解决问题。 截长图搜不了全文；转发给「文件传输助手」再手动复制粘贴，一篇要花好几分钟，图片还会掉。微信文章太多怎么保存？手工方案在量大之后一定会被放弃。
真正要的是：内容本体（正文文字 + 插图 + 附件）落进你自己的库，可全文检索、可分类、可标注，且不依赖原文还在不在。
二、Zotero Connector 抓取不了公众号文章？这正是插件补位的地方
很多人第一反应是找 zotero插件 来解决——装上 Zotero Connector 浏览器扩展，在电脑上打开公众号文章页面，点一下抓取。结果通常是这三种：
- 抓不到，或者只存下一个网页快照壳子，正文是空的；
- 抓下来标题、作者、日期全是错的或空的；
- 正文抓到一部分，插图全部丢失。
原因不复杂：Zotero Connector 依赖页面里规范的元数据和正文结构去识别「这是一篇什么文献」。公众号文章页的正文是延迟加载的，图片地址带防盗链，元数据也不按学术页面的规范来——Connector 的解析器面对它基本使不上劲。这不是你操作错了，而是这类页面本来就不在它的适配范围内。
《笔记同步助手》走的是另一条路：不在浏览器里抓，而是让你把内容「发」过来。
💡 它的工作方式：你在手机微信里把文章转发给《笔记同步助手》公众号 → 助手把链接交给 DeepSeek、豆包、千问 等 AI 处理，整理成干净的图文内容存进你的云空间 → 电脑上的 Zotero 插件把它取回来，写成条目和笔记。
这样绕开了浏览器抓取的所有难点：转发这个动作在手机上只要两秒，剩下的解析、清洗、配图处理都在云端完成，你在 Zotero 里拿到的直接是整理好的正文。
而且同一把密钥、同一个云空间，也同时支持 Obsidian、思源笔记、Joplin、Logseq、Notion、OneNote——你在哪一端保存，都能同步到 Zotero。
三、安装插件（3 步）
ℹ️ 环境要求：Zotero 7 及以上，插件的开发与验证在 Zotero 10 上完成。目前只写入 「我的文库」，暂不支持群组文库。Windows、macOS、Linux 版 Zotero 都可以用。
安装入口和之后的同步入口都在 Zotero 的 工具 菜单里。第一次安装先点 工具 → 插件；装好后，这里会多出「笔记同步助手：拉取文章」和「笔记同步助手：设置」两项。
第 1 步：下载插件文件。 到官网教程页下载 note-sync-helper-zotero.xpi（地址在文末）。下载下来是一个 .xpi 文件，不用解压。
第 2 步：打开插件管理页。 点 工具 → 插件，再点这个页面右上角的 齿轮，选择 Install Plugin From File…。这个页面由 Zotero 提供，所以这一项可能显示为英文。
第 3 步：选中刚下载的 .xpi。 装好后「笔记同步助手」会出现在已启用列表里，不用重启 Zotero。
装好之后回到 工具 菜单，就能看到「笔记同步助手：拉取文章」和「笔记同步助手：设置」了。
四、填写密钥
打开 Zotero 的 编辑 → 设置（macOS 在 Zotero → 设置），左侧选择 「笔记同步助手」；也可以直接走 工具 →「笔记同步助手：设置」。
在 账号 区域：
- 密钥 — 粘贴从《笔记同步助手》公众号获取的密钥。关注公众号即可获取；已经在用 Obsidian / 思源 / Joplin / Logseq 版的用户直接沿用同一把。
- 同步服务地址 — 一般不用修改。连接失败时会自动尝试备用地址。
- 立即同步 — 填好密钥后可以直接同步一次，按钮旁边会显示上次同步结果。
🔒 密钥只保存在你自己的电脑上，不会写进笔记，也不会出现在日志里。
五、保存位置：文章落进哪个分类
- 文章分类路径 — 决定文章落到 Zotero 的哪个分类。用
/分隔多级分类，不存在时会自动创建。⚠️ 这里填的是 Zotero 里的分类，不是电脑上的文件夹。 - 条目标题模板 — 决定同步后每个条目的标题。
- 两个 日期格式 — 分别决定分类路径和条目标题中日期变量的显示方式。
文章分类路径可用 {{{title}}}、{{{dateSaved}}}、{{{yearSaved}}}、{{{monthSaved}}}。例如按月归档，可以形成「笔记同步助手 / 2026-08」这样的分类层级；也可以固定写「网络来源」把它们和期刊文献隔开。
条目标题模板可用 {{{title}}}、{{{author}}}、{{{dateSaved}}}。只想保留原题就写 {{{title}}}；想带上保存日期，写 {{{dateSaved}}}-{{{title}}}。
六、内容与模板：文章保存成什么样
前置元数据模式决定作者、来源、标签和时间存在哪里：
- 保存为 Zotero 自带信息（推荐） — 写进 Zotero 自带字段，笔记正文更干净，也能被 Zotero 的筛选和引用功能用上。
- 写进笔记正文 — 这些信息显示在子笔记开头。
- 两者都保留。
已有条目处理策略决定再次同步同一篇文章时怎么对待已有正文：
- 保留你的修改（默认） — 发现正文被你改过就不覆盖，最稳妥。
- 用最新内容替换正文。
- 不处理已有条目。
下方的 文章内容模板决定子笔记正文写什么，其中 {{{content}}} 代表 AI 整理后的文章内容；前置元数据模板决定写进笔记开头的信息格式。改 文章内容模板 时**请保留 {{{content}}}**，否则正文不会出现在子笔记里。
七、保存文章里的图片和附件
这一节决定「断网还能不能看」。
- 图片处理 — 可选 下载并保存到本地、保留原始链接 或 不加载图片。选「下载并保存到本地」后，正文插图会存进 Zotero，断网也能看，原文删了也还在。
- 下载正文里的附件（文档、表格、压缩包、音视频等） — 打开后，正文中的这些文件会保存为 Zotero 条目的附件。
- 单个图片或附件大小上限（MB） — 限制单个文件的下载大小。
某张图片或某个附件下载失败时，插件会保留原始链接并继续处理，不会影响这篇文章和后续文章的同步。
💡 不想占空间就把 图片处理 改成「保留原始链接」——笔记里只留链接，打开时联网加载。追求「永久保存」就用「下载并保存到本地」。
八、自动同步：批量保存不用手动点
还是上面那张设置图，自动同步 区域：
- 频率（本设备） — 单位是秒；
0表示只手动同步，非0时最低 60 秒。 - 启动 Zotero 时自动同步（本设备） — 每次打开 Zotero 后自动同步一次。
这两项只对当前设备生效，换一台电脑需要重新设置。
攒着一次性入库的用法：平时在手机上看到什么就转发给公众号，不用管电脑；周末打开 Zotero，插件自动把这段时间攒下的全部拉回来，一次性归到设定好的分类里。内容再多也是一次同步的事，这就是手工方案和自动方案的根本差别。
高级设置里还有 每次拉取数量（一般保持默认）、连接等待时间（网络慢时调大）、调试日志（排查问题时再开，密钥和正文不会进日志）。
九、同步效果实拍
设置完成后，走 工具 →「笔记同步助手：拉取文章」，或点设置页里的 立即同步。
同步完成后，Zotero 右下角会弹出原生提示，写明本次共处理几篇，以及新建、更新、未改动、保留你的修改各有多少；有图片或附件没下载成功也会一并显示数量。
每篇文章会成为一个类型为 「网页」 的条目，标题按模板生成；网址、网站标题、日期、访问时间、摘要和标签会自动填好，条目落在按模板生成的分类里。
文章正文会成为这个条目的 子笔记，标题层级、列表、引用和代码段都保留——是可编辑、可全文检索的文字，不是截图。
选择「下载并保存到本地」后，多张正文插图也保存进 Zotero，之后断网仍能查看。
打开「下载正文里的附件」后，下载好的文件会出现在条目的附件区里。
到这一步，这篇文章就和你的期刊文献一样：能被 Zotero 全文搜索、能打标签、能拖进分类、能在写作时当作一条来源引用。
十、重复同步会不会变成两份？
不会。条目的 「其他」 栏里会有两行同步标记，形如 笔记同步助手: … 和 笔记同步助手笔记: …。请不要删除——插件靠它认出「这条是我同步过来的」；删掉后，同一篇内容可能会被当成新文章再同步一份。
插件在数据安全上的几条行为：
- 默认 保留你的修改：你在 Zotero 里改过的笔记正文，重新同步时不会被覆盖，结果里会记成「保留你的修改」。
- 换一台电脑后，即使本机没有以前的同步记录，也不会覆盖已有笔记，更不会重复新建条目。
- 把条目放进 回收站 后再同步，它不会被恢复，也不会另外新建一份。
- 图片或附件下载失败时，只保留原始链接并提示，不会卡住整篇或后面的文章。
十一、手机上怎么保存？
分工是这样的：手机负责「发」，电脑负责「入库」。
手机上你只做一个动作——在微信里把文章转发给《笔记同步助手》公众号。内容随即被整理好存进你的云空间，这一步和电脑开没开机无关。等你下次打开电脑上的 Zotero，插件同步一次，这段时间攒的内容就全进来了。
所以 iPhone、安卓（Android）手机、iPad、鸿蒙平板都不需要装任何东西，微信本身就是入口。插件运行在电脑版 Zotero 上（Windows / macOS / Linux）。
如果你同时在用 Zotero 自己的账号同步：插件写的条目、笔记和同步标记都放在 Zotero 自带的字段里，会跟着 Zotero 自己的同步一起走。不过「两台电脑 + Zotero 账号同步」的完整链路还在验证，实验室阶段建议先在一台电脑上用；真要换机，装上插件填同一把密钥即可，已有条目不会被重复新建，你改过的正文也不会被覆盖。
常见问题
Q：不止公众号文章吧？还支持哪些来源？ A：知乎、小红书、微博、B 站、抖音、YouTube、小宇宙播客、腾讯文档等都支持；视频和播客会转成图文笔记。发 PDF / Word / PPT / Excel 文件过去，会额外转成 Markdown 内容。
Q：找不到「Install Plugin From File…」？ A：先打开 工具 → 插件，再点插件管理页右上角的 齿轮。这一项是 Zotero 自带界面，可能显示为英文。
Q：安装后没看到设置和同步入口？ A：先在插件管理页确认「笔记同步助手」已启用，再重新打开 工具 菜单。设置入口也可以从 编辑 → 设置 → 笔记同步助手 进入。
Q：会不会覆盖我自己改过的笔记？ A：默认不会。「保留你的修改（默认）」会保护你改过的正文；换电脑后没有本机同步记录时，同样不会覆盖，也不会重复新建。
Q：可以同步到群组文库吗？ A：暂时不可以，目前只写入 「我的文库」。
Q：和 Obsidian 版是同一个云空间吗？ A：是。Zotero、Obsidian、思源笔记、Joplin、Logseq 版共用同一个云空间、同一把密钥。你可以让同一篇文章既进 Obsidian 又进 Zotero。
Q：Zotero 本身要钱吗？ A：Zotero 软件本身免费，其存储空间另有官方套餐。本插件把图片和附件下载到本地时，占用的是 Zotero 的存储目录。
Q：为什么叫「实验室」功能？ A：Zotero 版暂未上架 Zotero 官方插件目录，需要通过「从文件安装」使用，功能与稳定性还在持续打磨。欢迎试用反馈。
下载与完整教程：Zotero 版安装与使用教程（含 .xpi 下载）