在 Obsidian 插件市场安装笔记同步助手教程
在 Obsidian 插件市场安装笔记同步助手教程
✅ 笔记同步助手已重新上架 Obsidian 官方社区插件市场（2026-08）。现在在市场搜索框里直接输入中文 「笔记同步助手」 就能找到它，一键安装即可，不用再下载压缩包、不用手动复制文件夹。
本教程电脑端、手机端各一套完整图文步骤。
💡 市场里的插件名叫
Bi Ji Tong Bu（拼音，字与字之间有空格）Obsidian 官方市场要求插件名只能用英文字母，而且不能和市场里已有的插件重名，所以中文产品名「笔记同步助手」在市场里登记为逐字拼音
Bi Ji Tong Bu。作者一栏显示的是中文「笔记同步助手」——这也是你能用中文搜到它的原因。
这只是市场里的展示名，不影响任何功能：装好后插件设置页里的内容仍然全是中文，用法与手动安装版完全一致。
开始前的准备
- ✅ 安装并打开 Obsidian（本文截图为当前版本 1.13）
- ✅ 至少已经创建过一个 Obsidian 笔记库（保管库）
- ✅ 设备可以正常访问 Obsidian 官方社区插件市场
一、电脑端安装（Windows / macOS）
步骤 1：打开设置 → 第三方插件
打开 Obsidian，点击左下角的 设置 齿轮图标（⚙️），在设置窗口左侧菜单里找到 第三方插件 并点击进入。
步骤 2：退出受限模式（仅首次需要）
首次使用第三方插件时，Obsidian 会先展示一段插件安全说明。读完点右侧紫色按钮 退出受限模式，允许 Obsidian 加载社区插件。
💡 老版本 Obsidian 里这个按钮叫「关闭安全模式」，位置和作用完全一样。已经装过别的第三方插件的用户不会看到这一步，直接跳到步骤 3。
步骤 3：进入社区插件市场
退出受限模式后，页面上会出现 社区插件市场 一栏，点右侧的 浏览 按钮，进入 Obsidian 官方插件市场。
步骤 4：搜索「笔记同步助手」
在插件市场顶部的搜索框里输入中文：
笔记同步助手搜索结果里会只出现一个插件 —— Bi Ji Tong Bu（作者：笔记同步助手）。点击这张卡片进入详情页。
💡 也可以搜英文名
bi ji tong bu。注意名字是四段拼音、字与字之间有空格，和以前的写法不一样；直接搜中文「笔记同步助手」最省事。
步骤 5：点击「安装」
在插件详情页里确认信息（版本、作者：笔记同步助手、Github 仓库地址 notesynchelper/obsidian-notehelper-v2），点击紫色的 安装 按钮。
步骤 6：等待安装完成
点击安装后等几秒，右上角会弹出提示：
成功安装插件 “Bi Ji Tong Bu”
步骤 7：点击「启用」
安装成功后还需要手动启用一次——插件名后面会出现「已安装」标记，原来「安装」按钮的位置变成 启用，点击它。
步骤 8：确认已启用
启用后按钮区会变成 快捷键 / 禁用 / 卸载，说明插件已经在运行了。
步骤 9：在「已安装插件」里看到 Bi Ji Tong Bu
关闭详情页回到第三方插件设置页，向下看「已安装插件」区域，能看到 Bi Ji Tong Bu 已经出现、右侧开关是紫色（已启用）。
步骤 10：进入插件设置页，填入密钥
设置窗口左侧菜单滚到最底部，「第三方插件」分组下方会出现一个名为 Bi Ji Tong Bu 的入口——点它就进入笔记同步助手的设置页面。
页面最上方是 密钥 一栏，右边有一个「输入您的密钥」输入框。
怎么拿到密钥？
- 在微信关注「笔记同步助手」公众号
- 发送消息
Obsidian，公众号会回复你专属的密钥（API Key） - 把收到的密钥粘贴到「输入您的密钥」输入框
- 直接关闭设置页面即可（会自动保存）
二、手机端安装（安卓 / iOS）
手机端 Obsidian 的插件市场和电脑端是同一个，步骤一一对应。下面是安卓机上的实拍，iOS 界面基本一致。
完整的手机端图文步骤（含开启社区插件、填密钥、首次同步）见 手机端安装笔记同步助手插件。
第一步：设置 → 第三方插件 → 退出受限模式
第二步：点「浏览」进入插件市场
第三步：搜索「笔记同步助手」，点唯一的结果 Bi Ji Tong Bu
第四步：点「安装」，装完点「启用」
第五步：回设置页，在「第三方插件」分组里点 Bi Ji Tong Bu 进设置填密钥
下一步：触发首次同步
密钥填好之后，按下面 3 步走一遍完整同步流程：
- 加微信「Obsidian」好友：公众号回复的那条开通消息里附了一张二维码图片（提示文字「点开这个图片 添加 Obsidian 好友」），点开扫码添加好友
- 给「Obsidian」好友发一条内容：发条公众号文章链接或一段文字都行
- 回 Obsidian 点同步：等公众号推送「笔记已同步」通知后，点 Obsidian 左侧工具栏顶部的 「同」字图标，刚才发的内容就会作为一篇笔记落到本地
完整的首次同步流程（含截图）和自动同步设置，参见 Obsidian 插件安装教程 的「第一次同步」和「不想每次手动点同步？开启自动同步」两节——配置方式和手动安装版完全一致。
常见问题
搜不到？
- 搜索词就是中文 「笔记同步助手」（它是插件在市场里的作者名，所以中文能搜到）；也可以搜拼音
bi ji tong bu - 拼音四段之间有空格，写成
bijitongbu反而搜不到 - 网络不稳定时点搜索框右侧的 🔄 按钮重新加载插件列表
- 确认 Obsidian 版本不要过旧（建议 1.5 及以上），老版本市场索引会滞后
安装一直卡在「正在安装」
通常是网络问题。可以：
- 关闭设置面板再重新打开重试一次
- 切换网络环境后重试
- 实在装不上，用 Obsidian 插件安装教程 里的压缩包手动安装方式，装出来的插件完全一样
「This plugin has not been manually reviewed by Obsidian staff」是什么意思？
这是 Obsidian 对所有社区插件的标准提示，含义是「该插件未经过 Obsidian 官方人工逐行代码审核」，不代表插件有风险。笔记同步助手已经通过 Obsidian 官方的上架审核流程，源代码完全开源（见 github.com/notesynchelper/obsidian-notehelper-v2），欢迎自行审阅。
以前装的老版本还能用吗？
能用，不影响。老版本（手动安装或以前从市场装的）功能一致；想换成市场版，直接按本文重新装一遍即可，密钥重新填一次就好。
关键信息汇总
| 项目 | 内容 |
|---|---|
| 插件市场搜索关键词 | 笔记同步助手（中文即可，也可搜 bi ji tong bu） |
| 插件在市场里的名字 | Bi Ji Tong Bu（拼音，字间有空格） |
| 作者 | 笔记同步助手 |
| 插件设置页入口显示为 | Bi Ji Tong Bu（在「第三方插件」分组下） |
| 密钥获取方式 | 微信关注「笔记同步助手」公众号，发送 Obsidian |
| 源代码仓库 | https://github.com/notesynchelper/obsidian-notehelper-v2 |
恭喜你完成安装！现在可以把链接发到微信「Obsidian」好友，让助手把内容交给 DeepSeek、豆包、千问 等 AI 处理，并自动同步到 Obsidian 了。