同步不成功排查教程
第一步：确认消息发出去了
在渠道侧确认助手已接收（通常有自动回执）。没有回执说明绑定或密钥有问题，先看《重置密钥教程》重新绑定。
第二步：看插件拉取状态
打开插件面板点「立即同步」，观察状态提示：鉴权失败是密钥不对；一直「无新消息」则检查是否绑定了别的库。
第三步：检查落库位置
按《路径配置教程》核对目标目录，用 Obsidian 全局搜索笔记标题，排除「其实同步成功了只是没看到」。
第四步：看日志
设置页打开「调试日志」，重复一次同步，日志会给出具体失败环节（网络 / 解析 / 写入权限）。库目录被只读盘或同步盘锁定时会出现写入失败。
常见对照表
| 现象 | 多半原因 |
|---|---|
| 提示密钥错误 | 密钥重置后没换绑 / 复制带了空格 |
| 同步完成但没文件 | 路径配置指向了别的目录 |
| 卡在处理图片 | 见《同步卡在处理图片》专篇 |
| 偶发成功偶发失败 | 本地网络不稳或自动同步间隔过短 |
遇到问题怎么办
先看本分类的《常见使用问题》，再按《同步不成功排查教程》逐项检查。仍未解决的，可在关于页找到反馈邮箱，附上插件版本、笔记端类型与操作时间，便于快速定位。
隐私说明
正文仅在网络抓取与整理阶段被服务端处理，成功写入笔记库后即从服务端删除；图片本地化后原图缓存在你的云空间，可随时一键清空。详见《隐私说明》教程。