手机端安装笔记同步助手插件

✅ 笔记同步助手已重新上架 Obsidian 官方社区插件市场（2026-08）。手机端现在最省事的装法就是直接在插件市场里搜中文「笔记同步助手」，两下装好，不用再折腾 BRAT。

下面的手机截图为安卓机实拍，iOS 端界面基本一致。装不上市场版时，可以退回文末折叠的 BRAT 安装方式。

第一部分：从插件市场安装（推荐）

步骤 1：设置 → 第三方插件 → 退出受限模式

打开 Obsidian，点左上角侧边栏图标 → 右下角 ⚙️ 设置 → 在设置列表里向下滑动，点最下方的 第三方插件。

首次使用第三方插件时会先看到一段插件安全说明，读完点底部紫色按钮 退出受限模式（老版本里叫「关闭安全模式」）。已经开过的用户不会看到这一步。

步骤 2：点「浏览」进入插件市场

退出受限模式后，页面上会出现 社区插件市场 一栏，点 浏览 按钮。

步骤 3：搜索「笔记同步助手」

在顶部搜索框里输入中文 笔记同步助手，下面会只出现一个插件 —— Bi Ji Tong Bu（作者：笔记同步助手）。点这张卡片进入详情页。

💡 市场里的名字是逐字拼音 Bi Ji Tong Bu（字与字之间有空格）——Obsidian 官方市场要求插件名用英文字母且不能重名。作者一栏才是中文「笔记同步助手」，所以搜中文能搜到；写成 bijitongbu 反而搜不到。

步骤 4：点「安装」

在详情页点紫色 安装 按钮，等待几秒。

步骤 5：点「启用」

安装完成后，插件名后面会出现「已安装」标记，按钮变成 启用，点一下启用插件。

步骤 6：确认已启用

启用成功后，按钮区会变成 快捷键 / 禁用 / 卸载，说明插件已经在运行了。

步骤 7：回到第三方插件页

关掉市场页面回到 第三方插件 设置页，「插件安装情况」会显示 你目前已经安装了 1 个插件。

步骤 8：在设置里找到 Bi Ji Tong Bu 入口

返回设置首页，滑到最下方的「第三方插件」分组，能看到 Bi Ji Tong Bu 入口——点它进入笔记同步助手的设置页。

步骤 9：填入密钥

设置页最上方就是 密钥 一栏，把公众号发给你的密钥粘贴进「输入您的密钥」输入框，然后直接退出设置即可（自动保存）。

密钥获取方式：微信关注《笔记同步助手》公众号 → 发送消息 Obsidian → 公众号会回复你的专属密钥。

装好并填完密钥后，直接跳到下面的「执行同步」 一节即可。

备选方式：用 BRAT 安装（市场装不上时用）

如果你所在的网络打不开 Obsidian 插件市场、或市场里装不上，可以用 BRAT（Obsidian 社区广泛使用的插件安装工具，作者：TfTHacker）从 GitHub 装，装出来的插件功能完全一致。

https://github.com/notesynchelper/obsidian-notehelper

执行同步（两种装法通用）

步骤 1：打开底部菜单

回到笔记页面，点击底部菜单栏最右侧的三根横线（≡）按钮（下图紫色方框处），打开更多菜单。

步骤 2：运行同步命令

在弹出的菜单中向下滑动，找到底部的 tongbuzhushou（同步助手） 命令并点击。

步骤 3：等待同步完成

点击同步命令后，会显示 正在获取数据… 的提示，请耐心等待。

同步完成后，会显示成功提示，例如：

同步完成！成功处理 2 篇文章

同步的文章会保存到你的 Obsidian 仓库中，你可以在文件列表中看到新增的笔记文件。

常见问题

市场里搜不到？

• 搜索词用中文 「笔记同步助手」（它是插件在市场里的作者名）；也可以搜拼音 bi ji tong bu
• 拼音四段之间有空格，写成 bijitongbu 搜不到
• 点搜索框右侧的 🔄 按钮重新加载插件列表；网络实在打不开市场就用下面的 BRAT 方式

GitHub API 限流错误

如果 BRAT 安装时遇到如下错误提示，说明 GitHub API 请求次数超出限制：

解决方法： 等待一段时间后重试，或者切换网络环境（GitHub 按来源网络限流）；也可以在 BRAT 设置里配置 GitHub Token 以提高 API 调用限额。

关键信息汇总

恭喜你完成安装！现在可以开始把内容同步整理到 Obsidian 了。