笔记同步助手 Obsidian 插件安装教程

欢迎！ 这个教程将一步步指导您安装笔记同步助手插件。

不用担心！ 即使您对电脑操作不太熟悉，只要按照步骤操作，就能成功安装。整个过程大约需要 10-15 分钟。

开始前的准备

请确保您已经：

• ✅ 在电脑上安装了 Obsidian 软件
• ✅ 创建了至少一个 Obsidian 笔记库（保管库）
• ✅ 关注了”笔记同步助手”微信公众号

基础概念说明

什么是插件？ 插件是为 Obsidian 添加新功能的小程序，就像手机应用一样，可以让软件做更多事情。

什么是 API 密钥？ API 密钥就像一把钥匙，让插件能够安全地连接到笔记同步助手的服务器获取您的数据。

什么是保管库（库）？ 保管库是您在 Obsidian 中存储所有笔记的文件夹，相当于您的”笔记本”。

安装步骤

笔记同步助手提供 两种安装方式，根据网络情况选一种即可：

• 方法一：从 Obsidian 官方插件市场一键安装（推荐） —— 不用手动下载、不用管文件夹层级，几次点击就装好
• 方法二：手动下载安装（备选） —— 适合海外网络访问不畅、插件市场加载慢的用户

方法一：从 Obsidian 插件市场一键安装（推荐）

⚠️ 海外网络访问 Obsidian 插件市场不畅？ Obsidian 插件市场服务部署在海外。如果点「浏览」加载很慢、搜索框搜不出插件、或者点「安装」一直转圈，直接跳到下面的「方法二：手动下载安装」——本地化下载链路，不依赖海外网络。

1. 进入第三方插件 → 关闭安全模式 → 浏览社区插件市场

打开 Obsidian → 点击左下角 ⚙️ 设置 → 在左侧菜单往下滚动找到 第三方插件，点击进入：

首次使用第三方插件时，Obsidian 会显示”安全模式”提示框（“你想要退出安全模式来启用第三方插件吗？”），点紫色按钮 关闭安全模式：

💡 已经装过别的第三方插件的用户不会再次看到这个提示，直接跳到下一步即可。

关闭安全模式后，第三方插件设置页里会出现 社区插件市场 区域，点紫色 浏览 按钮进入官方插件市场。

2. 搜索 bijitongbu，找到 Biji Tongbu

在插件市场顶部搜索框输入 bijitongbu，下方会出现 Biji Tongbu 插件卡片（作者：beijing-bijitongbu），点击进入详情页。

💡 为什么不是中文「笔记同步助手」而是拼音 Biji Tongbu？ Obsidian 官方插件市场要求插件名必须用英文字母，所以中文产品名「笔记同步助手」在市场里登记的是拼音 Biji Tongbu（搜 bijitongbu 可找到）。这只是市场展示名 / 搜索名，不影响实际功能——装上之后插件设置页里的标题仍然是中文「笔记同步助手」。

3. 点「安装」→ 等几秒 → 点「启用」

在详情页右侧点紫色 安装 按钮，等右上角弹出”成功安装插件 Biji Tongbu”提示后，原来的「安装」按钮位置会变成 启用 按钮，再点一下把插件启用。

4. 在「已安装插件」列表里看到 Biji Tongbu

关闭详情页回到第三方插件设置页，向下滚到 已安装插件 区域，能看到 Biji Tongbu 已经出现、右侧开关是紫色（已启用）；左侧菜单底部「第三方插件」分组下方也会出现 Biji Tongbu 入口。

装好之后，直接跳到下面的「配置 API 密钥」 一节填密钥就能用了。

💡 想看完整图文步骤（含每个按钮的截图、安装失败排查、自动更新说明）请看 在 Obsidian 插件市场安装笔记同步助手教程。

方法二：手动下载安装（默认折叠 · 海外网络不佳时推荐）

plugins/
└── 任意文件夹名/        ← 这层叫什么都行
    ├── main.js          ← 但这几个文件必须直接在这层下面
    ├── manifest.json    ← 不能再多套一层
    ├── styles.css
    └── 其他文件...

plugins/
├── main.js          ❌ 错：这三个文件不能直接放在 plugins 下
├── manifest.json    ❌ 错：Obsidian 不识别，看不到插件
└── styles.css       ❌ 错

配置 API 密钥

1. 在左侧菜单底部「第三方插件」分组下找到并点击插件入口，进入插件设置页面
   • 方法二 手动下载安装的用户：入口显示为 「笔记同步助手」
   • 方法一 从插件市场安装的用户：入口显示为 「Biji Tongbu」（拼音是 Obsidian 市场要求英文字母导致的展示名，不影响功能 —— 进去后内部界面仍是中文「笔记同步助手」）

2. 进入插件设置页面后，找到 「密钥」 一栏的输入框（旧版本可能叫「API Key」）
3. 将从公众号收到的 API 密钥粘贴到这个框中
   • 💡 没拿到密钥？在微信关注「笔记同步助手」公众号 → 发送消息 Obsidian → 公众号会回复完整开通消息（含密钥和好友二维码）
4. 直接关闭设置页面即可（会自动保存）

添加微信“Obsidian”好友

公众号给您的开通消息（含下载链接和 API 密钥）最下方还有一张图片——这张图片就是用来添加微信“Obsidian”好友的入口。用方法一从市场装的用户没收到这条消息也没关系：在微信关注「笔记同步助手」公众号 → 发送消息 Obsidian 即可触发，会回复完整开通消息（含密钥和这张二维码图）。

1. 回到微信「笔记同步助手」公众号的对话界面，找到那条开通消息（没收到的话发送 Obsidian 重新触发）
2. 点开消息底部的图片（图片下方有”点开这个图片 添加 Obsidian 好友”提示）
3. 在弹出的页面里按提示添加好友（备注通常是”笔记同步科技”）

💡 公众号只负责推送处理通知，真正接收您发送内容的是微信“Obsidian”好友。两个一起用，缺一不可。

成功确认

如果看到以下情况，说明插件安装到位：

• ✅ 插件在”已安装插件”列表中显示为”已启用”
• ✅ Obsidian 左侧工具栏出现笔记同步助手图标（“同”字图标）
• ✅ API 密钥已填写并保存

第一次同步：跑一遍完整流程

插件装好之后，建议立刻按下面 3 步走一遍——发送内容 → 看通知 → 在 Obsidian 点同步，确认整条链路通了。

1. 给微信“Obsidian”好友发送一条内容

打开微信，进入和微信“Obsidian”好友（您在前面流程里添加的、备注通常是”笔记同步科技”）的聊天窗口，把任意一条想保存的链接、文章或文字直接发到对话框里。

💡 内容发给微信“Obsidian”好友；处理通知则由「笔记同步助手」公众号推送。两个一起用，缺一不可。

2. 等待两条同步通知

发送后稍等几秒，「笔记同步助手」公众号会按顺序推送 2 条通知：

• 📬 工单已开始处理通知 —— 表示已经收到您的内容，开始处理
• ✅ 工单完成通知 —— 处理结果显示「笔记已同步」，就代表云端已就绪

💡 看到「笔记已同步」就说明云端已经把这条内容存好了，剩下的只是把它拉到本地 Obsidian。

3. 回到 Obsidian，点击左侧「同」图标

看到「工单完成通知」后，回到 Obsidian，点击左侧工具栏顶部的 「同」字图标 —— 这是笔记同步助手的同步按钮。

点击后，刚才发送的内容就会作为一篇笔记出现在您的 Obsidian 库里。之后凡是发给微信“Obsidian”好友的内容，都按这个流程走：发送 → 收到完成通知 → 回 Obsidian 点「同」拉到本地。

不想每次手动点同步？开启自动同步

如果觉得每次都要去点「同」字图标麻烦，可以在插件设置里让 Obsidian 自动同步：

1. 在 Obsidian 左下角 ⚙️ 设置 → 第三方插件 → 点击「笔记同步助手」进入插件设置页面
2. 找到「同步」分组，里面有两个常用选项：
   • 启动时同步（本设备） —— 勾选后，每次打开 Obsidian 自动跑一次同步，再不用手点
   • 频率（本设备） —— 填入秒数即可定时同步（0 表示关闭定时；最低 15 秒）。常用值：60（1 分钟）/ 300（5 分钟）/ 1800（30 分钟）

💡 这两个选项是按设备独立保存的 —— 每台电脑/手机可以设不同的策略。比如桌面端设 300 秒定时拉、手机端只勾”启动时同步”，互不打架。

最常见的搭配：“启动时同步”+“频率 = 300 秒”，开 Obsidian 立刻拉一次，之后每 5 分钟自动收新笔记，全程零手动。

让 AI 帮你改插件设置？先把这页发给 AI

如果你打算请 Claude / ChatGPT / Gemini / 豆包 / DeepSeek 等 AI 助手帮你改笔记同步助手的插件设置（例如改文件路径、模板、合并模式等），请务必先把下面这条 URL 复制粘贴给 AI，让它先读完里面的字段表和约束，再动手：

https://www.bijitongbu.site/tutorials/ai-settings-guide/

里面对每个可改字段、可选值、默认值、危险红线都做了完整说明，能避免 AI 凭”听起来合理”自创字段（实测过去出现过 AI 写出 after:{{{lastSyncTime}}} 这种插件不认识的查询，导致点同步看着成功但 0 篇文章落盘）。

💡 把这条 URL 当成”给 AI 的入门 Skill”。先发 URL，再说需求，比如：“请先读 https://www.bijitongbu.site/tutorials/ai-settings-guide/ ，然后帮我把笔记按年月分文件夹”。

遇到问题怎么办？

常见问题解决

Q: 找不到”打开插件文件夹”的图标（仅手动安装方式）

A: 必须先把”安全模式”关掉才会出现”已安装插件”这一行（以及右侧的文件夹/刷新图标）。如果还是看不到，关掉设置页面再重新打开一次。

Q: 插件没有出现在列表中（仅手动安装方式）

A: 99% 是文件层级放错了，和文件夹叫什么名字没关系。请按下面的顺序检查：

1. 回到刚才打开的插件文件夹（如果关掉了，重新走一遍方法二的「第二步」），里面必须有一个您拖进去的文件夹（名字随便）
2. 进到这个文件夹里，要能直接看到 main.js、manifest.json、styles.css 这几个文件
3. ❌ 零层错误（最常见）：如果 plugins/ 下直接就是 main.js/manifest.json/styles.css，没有外层文件夹包着，Obsidian 也找不到插件。在 plugins/ 下新建一个文件夹（叫什么都行，例如 notehelper），把这三个文件剪切进去
4. ❌ 双层套娃：如果点开后里面又是一个文件夹（比如 2.1.0/2.1.0/main.js），Obsidian 同样找不到。把最里面那一层文件夹拖出来到外层，再把空壳删掉
5. 检查完层级，回 Obsidian 设置页面点”已安装插件”右侧的刷新图标（或重启 Obsidian）就能看到插件了

Q: 同步不成功 / 没反应 / 想全量重新拉一次

A: 同步类问题（网络、配置、清空 Sync At 重新拉历史等）请看 同步不成功排查教程，里面有完整的排查步骤。

接下来：进阶配置和功能

插件装好之后，下面这些教程会带您把它用得更顺手：

配置常用选项

• 路径配置教程 —— 改默认存储路径、按日期 / 分类拆文件夹
• 二级目录设置教程 —— 把不同来源（公众号、内容平台、日记…）放进不同子文件夹
• Frontmatter / 笔记属性模板配置 —— 自定义每篇笔记最上面的属性区
• 模板变量完全指南 —— 所有可用变量（title、author、date_saved…）一览
• 备注及标签功能 —— 给保存的内容加备注和标签
• 合并消息模式 —— 一天一个文件 vs 一篇一个文件

用得更高级

• 跳过 AI 整理功能 —— 哪些链接只存原始消息、不走 AI 整理
• 仅保存链接的网站配置 —— 长期把某些站点设为只存链接
• 邮件收藏功能 —— 用邮箱也能保存内容
• 日记链接功能 —— 自动把当天保存的内容链到日记里
• 图床接力功能 —— 让外链图片在 Obsidian 里也能稳定显示

遇到问题

• 同步不成功排查教程 —— 同步失败 / 没反应 / 想清空重拉
• 重置密钥教程 —— API Key 失效或想换一把
• 手机端 BRAT 安装教程 —— 在 iOS / Android 上装这个插件
• 常见使用问题汇总 —— 综合 FAQ

技术支持

如需技术支持，请：

1. 关注微信公众号”笔记同步助手”
2. 点击底部菜单 「客服」→「联系客服」

3. 向客服详细描述您遇到的问题

安全说明 / 隐私说明

📖 想看完整的隐私政策、数据流向、第三方依赖、合规承诺等详细内容，请看 隐私说明（Privacy Explained）。

笔记同步助手只处理你主动发送给助手的内容（图文 / 视频 / 链接 等），且整条链路单向——只把这些内容写入你本地的 Obsidian 库，不会主动抓取任何平台数据，也不会读取或上传你本地已有的笔记内容。数据流向如下：

你主动发送给助手的内容（图文 / 视频 / 链接 / …）
        │
        ▼
   笔记同步助手
        │
        ▼
   你的本地 Obsidian 库   ← 数据只在这一端落地

插件代码完全开源：github.com/notesynchelper/obsidian-notehelper。

如果你对数据安全还有顾虑，可以直接把 main.js 下载下来丢给任何 AI（豆包 / 千问 / Claude / ChatGPT / Gemini 等）做安全审查，让 AI 帮你检查有没有可疑的上传请求或读取本地文件的逻辑。事实上插件代码已经被无数用户、安全研究者和 AI 反复审查过——欢迎你自行验证。

感谢使用笔记同步助手！如果您觉得插件有用，欢迎推荐给更多朋友使用。