看到一篇好文章、一条值得留下的视频，随手转发给「笔记同步助手」，AI 在云端整理成图文笔记，自动出现在你自己的 Obsidian 里——这就是笔记同步助手做的事。文章保留正文和图片；视频、播客、录音交给 AI 整理成图文笔记和速记；Word、PDF、PPT 文档、聊天记录、图片里的文字也都能一起整理。不用装新 App，不用换习惯，转发了就不用管，整理完会收到完成通知。付费内容、非公开页面除外。
整套上手流程只有两段：手机上关注服务号、加一个微信「Obsidian」好友，一分钟；电脑上给 Obsidian 装插件、填一次密钥，五分钟。本文按这个顺序，用真实截图把每一步讲清楚。
一、手机上：关注服务号，加「Obsidian」好友
先看一遍动图，整段流程 20 秒：
对照动图，一步步做：
- 找到「笔记同步助手」。 打开微信，在顶部搜索框输入「笔记同步助手」，结果里点那个紫色图标的服务号。
- 关注服务号。 进入服务号主页，点绿色的「关注服务号」按钮。
- 选「用 Obsidian」。 关注后服务号会立刻发来一条欢迎消息，让你选笔记软件；点「用 Obsidian（需安装插件）」。
- 收下开通消息。 服务号随即回复一条开通消息，里面有三样东西，后面都用得上：插件下载链接（手动安装时用，从插件市场装可以不管它）、你的密钥（一串字母数字，装好插件后要填进去，到时候回来复制即可）、以及消息底部挂着的一张图片——这就是加「Obsidian」好友的入口。
- 点开图片，长按识别二维码。 点开那张图片，按图上提示长按识别二维码，进入「Obsidian」的名片页。
- 添加到通讯录。 点底部「添加到通讯录」，通过后「Obsidian」会发来一句问候：把需要同步的文字、链接、视频、文档发给它就行。
开通消息长这样（密钥已打码）：
💡提示
服务号和「Obsidian」好友分工不同：内容发给「Obsidian」好友，服务号只负责给你推处理通知。两个都要有，缺一不可。没收到开通消息、或者以后想再看一次密钥，在服务号对话框里发一条 Obsidian，就会重新收到这条消息。
手机这边到此完成。接下来去电脑上装插件。
二、电脑上：给 Obsidian 装上插件
插件有两种装法，装出来的东西完全一样：
- 方法一：插件市场一键安装（推荐）——笔记同步助手已上架 Obsidian 官方社区插件市场，搜中文就能找到，点两下装好。
- 方法二：下载压缩包手动安装——不依赖插件市场，所在网络打不开市场时走这条。
方法一：从 Obsidian 插件市场安装
先看动图，7 步 20 秒：
对照动图，一步步做：
- 设置 → 第三方插件。 打开 Obsidian，点左下角的齿轮图标进入设置，在左侧菜单里点「第三方插件」。
- 退出受限模式（只有第一次需要）。 第一次用第三方插件时，Obsidian 会先展示一段安全说明，点右侧紫色按钮「退出受限模式」；老版本里叫「关闭安全模式」，作用一样。已经装过别的插件的用户看不到这一步，直接往下。
- 点「浏览」进入社区插件市场。
- 搜「笔记同步助手」。 在市场顶部搜索框输入中文「笔记同步助手」，结果里只会出现一个插件：Bi Ji Tong Bu（作者：笔记同步助手）。点这张卡片进详情页。
- 点「安装」。 确认作者是「笔记同步助手」后点紫色「安装」按钮，等几秒右上角会提示「成功安装插件 "Bi Ji Tong Bu"」。
- 点「启用」。 安装成功后还要手动启用一次：原来「安装」按钮的位置变成「启用」，点它。按钮区变成「快捷键 / 禁用 / 卸载」，就说明插件已经在运行了。
- 确认。 关掉详情页回到第三方插件页，往下看「已安装插件」区域，Bi Ji Tong Bu 已经在列表里、右侧开关是紫色，装好了。
💡提示
为什么市场里叫 Bi Ji Tong Bu？Obsidian 官方市场要求插件名只能用英文字母、且不能和已有插件重名，所以中文名在市场里登记成了逐字拼音（字与字之间有空格，写成 bijitongbu 反而搜不到）。这只是展示名，装好后设置页里全是中文，功能和手动安装版完全一致。
⚠️注意
「启用」点不动、或者一直卡在「正在安装」？这几乎都是网络问题：插件市场的服务器在海外，网络不稳时插件文件没下载完整，按钮就点不亮。先把插件删掉重装一遍（详情页点「卸载」，再重复第 4～6 步），多数人一次就好；换一条能稳定访问海外服务的网络再装，成功率更高。实在装不上就用下面的方法二，装出来的插件完全一样。
装好后直接跳到第三节填密钥。
方法二：下载压缩包手动安装
同样先看动图：
- 拿到插件文件。 回到手机上服务号的那条开通消息，点「插件下载」链接下载压缩包（文件名类似
notehelper-2.10.7.zip），传到电脑上解压，得到一个文件夹。 - 打开 Obsidian 的插件文件夹。 设置 → 第三方插件，先把「安全模式」关掉（关掉后 Obsidian 才允许加载第三方插件），然后找到「已安装插件」这一行，点它右侧的文件夹图标（鼠标悬停显示「打开插件文件夹」）——系统会自动弹出文件管理器，直接定位到插件文件夹，不用自己找路径。
- 把解压出的文件夹整个拖进去。 文件夹叫什么名字都行，关键是层级：
plugins/下正好一层文件夹，文件夹里直接是main.js、manifest.json、styles.css这几个文件。多一层（解压时套了娃，变成plugins/2.10.7/2.10.7/main.js）或少一层（三个文件直接扔在plugins/下）Obsidian 都认不出来。 - 刷新并启用。 回到第三方插件页，点「已安装插件」右侧的刷新图标，列表里出现「笔记同步助手」，右侧是灰色开关；点一下开关，变成紫色就是启用成功。
层级长这样：
plugins/
└── 任意文件夹名/
├── main.js
├── manifest.json
└── styles.css
⚠️注意
如果你从来没装过任何插件，第 2 步那一页可能长得不一样：只显示「你目前已经安装了 0 个插件」，右侧没有文件夹图标。这时在 Obsidian 左侧文件列表里随便找一篇笔记，右键「在系统资源管理器中显示」（Mac 是「在访达中显示」），在弹出的文件管理器里回到上一级（也就是笔记库根目录），进入 .obsidian 文件夹（Windows 看不到就勾选「查看 → 隐藏的项目」，Mac 按 Cmd+Shift+.），里面的 plugins 就是插件文件夹；没有就新建一个。
三、填密钥：把手机和电脑连起来
先看动图，5 步 14 秒：
在设置窗口左侧菜单滚到最底部，「第三方插件」分组下面会多出一个入口。从市场装的显示为「Bi Ji Tong Bu」，手动装的显示为「笔记同步助手」，点进去是同一个设置页。
设置页最上方就是「密钥」一栏。回到手机上服务号的开通消息，复制「你的密钥」后面那串字符，粘贴进「输入您的密钥」输入框，然后直接关掉设置页，会自动保存。
到这里安装全部完成。Obsidian 左侧工具栏顶部会多出一个「同」字图标，这就是笔记同步助手的同步按钮。
四、跑一遍第一次同步
装完建议立刻走一遍完整流程，确认链路是通的：
- 给「Obsidian」好友发一条内容。 打开微信，在「Obsidian」好友的聊天窗口里，随便发一篇文章的链接，或者一段文字。
- 等两条通知。 几秒后服务号会依次推「工单已开始处理通知」和「工单完成通知」，后者显示「笔记已同步」，就代表云端已经整理好了。
- 回电脑点「同」。 回到 Obsidian，点左侧工具栏顶部的「同」字图标，刚才发的内容就会作为一篇笔记出现在你的库里。
之后凡是发给「Obsidian」好友的内容都是这一套：发送 → 收到完成通知 → 回 Obsidian 点「同」。不想每次手动点？在插件设置页的「同步」分组里勾选「启动时同步（本设备）」，再把「频率（本设备）」填成 300——打开 Obsidian 立刻拉一次，之后每 5 分钟自动收新笔记，全程零手动。
五、常见问题
市场里搜不到？ 搜索词就是中文「笔记同步助手」；也可以搜拼音 bi ji tong bu（四段之间有空格）。网络不稳时点搜索框右侧的刷新按钮重新加载列表；Obsidian 版本太旧（低于 1.5）市场索引会滞后。
手动安装后列表里没有插件？ 99% 是层级放错了，和文件夹叫什么没关系：进到 plugins/ 下那个文件夹里，必须能直接看到 main.js。层级改对后点刷新图标，或重启 Obsidian。
「This plugin has not been manually reviewed by Obsidian staff」是什么意思？ 这是 Obsidian 对所有社区插件的标准提示，不代表插件有风险。插件已通过官方上架审核，源代码完全开源：https://github.com/notesynchelper/obsidian-notehelper-v2
同步没反应？ 网络、配置、想清空重拉历史等情况，看官网的同步不成功排查教程：https://www.bijitongbu.site/tutorials/sync-troubleshooting/
手机上也想装？ 手机端 Obsidian 的插件市场和电脑端是同一个，步骤一一对应；完整的手机端图文见：https://www.bijitongbu.site/tutorials/mobile-brat-tutorial/
装好之后，路径、模板、合并消息模式这些进阶配置的教程都在官网教程中心：https://www.bijitongbu.site/tutorials/