同步不成功排查

整体流程

如果在Obsidian 中没有看到想同步的内容，可以按照以下流程进行排查：

• 第一步，看看是否收到了《笔记同步助手》服务号推送的完成通知

• 第二步，在Obsidian 中同步笔记到本地

• 第三步，检查高级权益是否在有效期

先看下消息写入/文章提取是否已经完成

只收到了开始处理通知代表还在处理中

如果是视频链接处理时间会比较长，请耐心等待

收到完成通知后代表已经处理完成，可以在Obsidian中使用插件同步到本地

在Obsidian中同步

第一步，确认插件已经装好，并且能在设置里看到；点击插件完成密钥配置

密钥从笔记同步助手服务号中获取，注意复制的时候不要有换行或者空格

怎么打开插件设置：先点 Obsidian 左下角齿轮 ⚙️ 进入 Obsidian 设置，再在左侧菜单向下滚动到「第三方插件」区域，点开「笔记同步助手」。

第二步，在Obsidian 左侧插件栏点击“同” 进行同步

第三步，等待右上角笔记同步完成+图片下载完成

第四步，可以查看同步的笔记了

消息、图片、文件附件默认是合并到一篇中，可以在设置里进行设置

文章会一篇篇的单独展示

💡 找不到刚同步的笔记？记得在 Obsidian 左侧文件列表里把”笔记同步助手”相关文件夹一层层展开看看——文章和消息默认会落在不同的子目录下（比如消息常常合并到 笔记同步助手/微信消息/同步助手_2026-04-29.md，文章则一篇一个文件放在另一个子目录里），整个文件夹折叠着看会以为没同步成功，展开后基本都能找到。具体路径以你在插件设置里配的为准。

同步完成后没有怎么办

可以尝试在设置里手动调整最后同步时间，重新处理笔记

检查云空间

修改设置后同步完成找不到笔记怎么办？可以打开云空间查看器 https://obsidian.notebooksyncer.com/settings ，在”设置”页输入 API Key（与 Obsidian 插件里配置的同一把密钥）验证登录，然后切换到顶部的”云空间”标签查看笔记是否已经到达云端。如果云空间里有但 Obsidian 中没有，可以尝试调整本地设置后重新同步。

没收到「完成通知」怎么办

只收到”开始处理”通知、迟迟没有”已完成”通知，按以下顺序排查：

1. 先确认是不是被微信通知折叠。微信对服务号默认会折叠通知，到「订阅号消息」一栏点开《笔记同步助手》查看是否其实早就推过完成通知。也可以把《笔记同步助手》服务号设为「置顶」，避免后续被折叠。

1. 再确认是不是关掉了服务号通知。微信里长按服务号 → 消息免打扰 / 接收消息提醒，确认接收通知是开启的。

1. 看是否是长内容还在处理。视频转录、长文 AI 整理通常需要 1–5 分钟；如果开始处理后 10 分钟内还没完成通知，多半就不是”在处理”了。

1. 直接打开云空间查看器看处理结果（地址见上一节）。如果云空间里能看到这条笔记，说明只是通知没推到 / 被折叠，内容本身已经处理好了，直接到 Obsidian 同步即可。

1. 如果云空间里也找不到，发起时间和大致内容截图发给客服，我们从后台帮你看一下卡在哪个环节。

云空间有，但 Obsidian 里没拉到

按以下顺序尝试（每做一步就回到 Obsidian 点一次左侧”同”按钮）：

1. 手动调整「最后同步时间」。在插件设置里把”最后同步时间”往前调（比如调到今天 0 点），保存后再点同步，插件会重新拉取这段时间内的所有笔记。

1. 重新加载仓库。Obsidian 命令面板（Ctrl/Cmd + P）→ 输入 Reload app without saving 执行，相当于把仓库重新打开一次，能解决插件状态卡死的情况。这是排查到最后一步的”兜底大招”，多人反馈用了它就好。

1. 检查保存路径是否被改过。如果近期改过仓库位置 / 文章文件夹路径，新笔记会落在新路径下，旧的还留在旧路径，按 保存路径设置教程 检查一遍。

1. 以上都试过仍找不到 → 联系人工客服，把密钥、缺失笔记的发起时间报给客服。

怎么判断”全部内容是否同步完成”

• 服务号侧：每发一条都会有”开始处理 → 已完成”两条通知，最后一条”已完成”通知就代表那一条同步进了云空间。
• Obsidian 插件侧：点同步后，右上角会有进度条提示「同步中 N / M」，N == M 时即拉取完毕。
• 云空间查看器侧：用上面那个云空间查看器登录后，能直接看到全部已处理的笔记列表，做最终核对。

如果你一次性发了几十上百条，建议先在服务号里翻一遍看是否每条都有”已完成”通知，再回到 Obsidian 同步。

高级权益

如果发现文章同步到Obsidian 后出现在了消息中，或者是只有链接没有图片/正文等内容请检查是高级权益是否有效，有效期可以通过服务号菜单查询

首次购买会赠送7天高级权益，到期后请通过笔记同步助手服务号续费购买

菜单点击购买权益，或者扫描下方二维码

一定要用手机端扫码购买，电脑端不行；我们用的是腾讯微信安全支付通道，仅限在手机微信里进行支付购买

笔记同步助手支持Obsidian、OneNote、Notion、思源笔记四种笔记，高级权益通用，买一个就行

转发聊天记录同步不成功

聊天记录支持把一段微信对话整段保存为笔记，但有几条限制要先注意。详细教程见 《微信聊天记录怎么保存到笔记》。

试用期内可以正常转发聊天记录；试用到期后需要开通”头等舱”权益（49 元/年）才能继续使用，详见高级权益 FAQ。

操作步骤

1. 长按任意一条要保存的微信消息
2. 点”多选”，勾选要保存的全部消息
3. 点底部”合并转发”
4. 选择对应的助手发送：

- Obsidian → 微信“Obsidian”好友 - OneNote → 笔记同步助手服务号 - Notion → Notion助手好友 - 思源笔记 → 思源助手好友

微信侧的限制

• 聊天记录里不会显示发送者名字：这是微信的限制，转发过来的合并消息不带发送者标识，助手只能拿到消息正文。
• 聊天记录里的文件有微信有效期：微信原生文件过期后，转发过来的聊天记录里也读取不到那个文件。遇到这种情况，请在原始聊天里单独长按那个文件 → 多选 → 转发给助手重发一次（系统会有提醒）。

发了聊天记录但没收到完成通知

如果在《笔记同步助手》服务号只看到”工单已开始处理通知”，迟迟没有”工单完成通知”，可能是聊天记录里某些内容触发了微信侧的处理异常。可以联系客服处理：

点此联系笔记同步助手客服

把发起时间和大致内容告诉客服，我们会从后台看一下卡在哪个环节。

多端同步出现重复笔记

如果电脑、手机都装了笔记同步助手插件并都开了自动同步，再加上 iCloud / 坚果云这类文件级同步工具在背后复制 vault，可能会发现同一篇笔记多了一份带 1、-conflict 后缀的副本。

这种重复不是助手插件本身造成的：是两台设备的插件几乎同时拉取了同一篇新笔记、各写了一份到本地，再被 iCloud / 坚果云互相同步了一遍。

推荐处理：

• 只在一台设备（通常是电脑）开自动同步，其它设备改成手动点同步即可。由 iCloud / 坚果云负责把电脑上落盘的笔记复制到其它设备就够了。
• 必须多端都开自动同步：把每台设备的「定时同步间隔」错开，例如电脑 60 秒、手机 180 秒，让 iCloud / 坚果云有足够时间把一边的写入复制完，下一台再起同步。

如果已经出现了重复笔记，先关掉所有设备的自动同步，等 iCloud / 坚果云完成一次同步，再手动删掉带后缀的副本即可。

怎么往Obsidian中同步？

用 Obsidian 需要加微信“Obsidian”好友，然后把内容发给微信“Obsidian”好友（发给服务号或者其它助手对应的是 OneNote 等其它笔记本）

添加方法，

第一步，点击《笔记同步助手》服务号左侧开始使用菜单，选择”使用Obsidian”

第二步，点开服务号返回的二维码图，长按识别并添加微信“Obsidian”好友

原文：https://www.bijitongbu.site/tutorials/sync-troubleshooting/ · 笔记同步助手