第一步：打开设置

打开 Obsidian，点击右下角菜单，进入 Settings（设置）。在设置页面中，向下滑动找到 Community plugins（社区插件） 选项并点击进入。

第二步：开启社区插件

首次使用社区插件时，Obsidian 会显示安全提示。点击底部紫色按钮 Turn on community plugins（开启社区插件） 以启用社区插件功能。

第三步：浏览社区插件

开启后，你会看到社区插件管理页面，点击 Browse（浏览） 按钮进入插件市场。

第四步：搜索 BRAT

在插件市场搜索框中输入 brat，找到 BRAT 插件（作者：TfTHacker），点击进入详情页。

第五步：安装 BRAT

在 BRAT 详情页，点击 Install（安装） 按钮。安装完成后，页面顶部会显示 “Successfully installed plugin BRAT” 提示，然后点击 Enable（启用） 按钮启用插件。

第六步：确认 BRAT 已启用

启用后，页面会显示 Options（选项） 按钮，说明 BRAT 已成功启用。点击 Options 进入 BRAT 设置页面。

第七步：进入 BRAT 设置

在 BRAT 设置页面中，向下滑动找到 Add beta plugin（添加测试版插件） 按钮。

第八步：添加插件地址

点击 Add beta plugin 按钮后，在弹出的对话框中输入笔记同步助手的 GitHub 仓库地址：

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

勾选 Enable after installing the plugin（安装后自动启用），然后点击紫色按钮开始安装。

第九步：确认安装成功

安装完成后，页面顶部会显示成功提示：

BRAT notesynchelper/obsidian-notehelper (version: latest) The plugin has been registered with BRAT.

这表示笔记同步助手插件已成功安装并注册。

第十步：查看已安装插件

返回社区插件列表，可以看到已安装的 BRAT 与 Wechat Note Helper（笔记同步助手） 两个插件，且开关都已开启（紫色）。

至此 BRAT 方式安装完成。后续配置密钥与执行同步的操作与上文第二、三部分完全相同（BRAT 装出来的插件在设置页中名为 Wechat Note Helper，点它进入设置填密钥即可）。

常见问题：GitHub API 限流错误

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

解决方法： 等待一段时间后重试，或者配置 GitHub Token 以提高 API 调用限额。