Obsidian

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

笔记同步助手 · ·Obsidian 教程
Obsidian安装教程插件市场新手指南

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

笔记同步助手已经上架 Obsidian 官方社区插件市场，你可以直接在 Obsidian 内置的「社区插件市场」里搜索并一键安装，不用再下载压缩包、不用手动复制文件夹。

本教程面向 电脑端 Obsidian（Windows / Mac）。手机端请改看 手机端使用 BRAT 安装笔记同步助手插件教程。

💡 关于插件名为什么是拼音 Biji Tongbu

Obsidian 官方社区插件市场要求插件名必须用英文字母，所以我们的中文产品名「笔记同步助手」在市场里登记的是拼音 Biji Tongbu（搜索时输入 bijitongbu 即可找到）。

这只是市场里的展示名 / 搜索名，不影响实际功能——装上之后插件设置页里的标题仍然是中文的「笔记同步助手」，使用体验和手动安装版完全一致。

开始前的准备

  • ✅ 在电脑上安装并打开 Obsidian
  • ✅ 至少已经创建过一个 Obsidian 笔记库（保管库）
  • ✅ 电脑可以正常访问 Obsidian 官方社区插件市场

步骤 1：打开设置，进入第三方插件

打开 Obsidian，点击左下角的 设置 齿轮图标（⚙️），在弹出的设置面板左侧菜单里向下滚动，找到 第三方插件 并点击进入。

进入第三方插件

步骤 2：关闭安全模式（仅首次需要）

首次使用第三方插件时，Obsidian 会显示提示：

你想要退出安全模式来启用第三方插件吗？在启用插件前，我们建议你备份好笔记。

点击紫色按钮 关闭安全模式，允许 Obsidian 加载社区插件。已经装过别的第三方插件的用户可以跳过这一步。

关闭安全模式

步骤 3：进入社区插件市场

关闭安全模式后，页面会出现 社区插件市场 区域。点击紫色 浏览 按钮，进入 Obsidian 官方插件市场。

点击浏览进入社区插件市场

步骤 4：搜索 bijitongbu

在插件市场顶部的搜索框里输入：

bijitongbu

下方会出现 Biji Tongbu 插件（作者：beijing-bijitongbu）。点击该插件卡片进入详情页。

在搜索框输入 bijitongbu，下方出现 Biji Tongbu 插件卡片

💡 搜中文「笔记同步助手」搜不到——Obsidian 插件市场只支持英文搜索。请按拼音 bijitongbu 搜，搜到的 Biji Tongbu 就是笔记同步助手的官方插件。

同一作者下另一个 Wechat Messenger 是笔记同步助手的另一个发行包（同源代码、不同包名），安装任意一个都行。

步骤 5：点击「安装」

在插件详情页右侧，点击紫色的 安装 按钮。

插件详情页右侧的紫色「安装」按钮

步骤 6：等待安装

点击安装后，页面右上角会弹出黑色提示框：

正在安装插件 “Biji Tongbu”…

请耐心等待几秒，不要关闭设置面板。

右上角提示「正在安装插件 Biji Tongbu」

步骤 7：安装成功

安装完成后，右上角提示框会变成：

成功安装插件 “Biji Tongbu”

插件详情页右上角会出现 已安装 标记，并显示当前安装的版本号（例如 2.10.8）。

右上角提示「成功安装插件 Biji Tongbu」，并显示已安装标记

步骤 8：点击「启用」

安装成功后还需要手动启用一次——在插件详情页右侧，原来的「安装」按钮位置会变成 启用 按钮，点击它把插件启用。

点击紫色「启用」按钮启用插件

步骤 9：在「已安装插件」里看到 Biji Tongbu

启用之后，关闭插件详情页回到第三方插件设置页，向下滚动到「已安装插件」区域，能看到 Biji Tongbu 已经出现在列表里、右侧开关是紫色（已启用）。

同时，左侧菜单底部「第三方插件」分组下方也会出现一个名为 Biji Tongbu 的入口，点击它就能进入笔记同步助手的插件设置页面。

已安装插件列表里出现 Biji Tongbu，右侧开关紫色已启用；左侧菜单底部第三方插件分组下方出现 Biji Tongbu 入口

步骤 10：填入密钥开始使用

进入插件设置页面后，最上方会显示：

笔记同步助手版本：2.10.8 · ✅ 已是最新版本

往下能看到 密钥 一栏，下方有一个「输入您的密钥」输入框。

插件设置页面的「密钥」输入框，备注「请关注《笔记同步助手》公众号获取密钥」

怎么拿到密钥？

  1. 在微信关注「笔记同步助手」公众号
  2. 发送消息 Obsidian，公众号会回复你专属的密钥（API Key）
  3. 把收到的密钥粘贴到上面的「输入您的密钥」输入框
  4. 直接关闭设置面板即可（会自动保存）

下一步：触发首次同步

密钥填好之后，按下面 3 步走一遍完整同步流程：

  1. 加微信「Obsidian」好友：公众号回复的那条开通消息里附了一张二维码图片（提示文字「点开这个图片 添加 Obsidian 好友」），点开扫码添加好友
  2. 给「Obsidian」好友发一条内容：发条公众号文章链接或一段文字都行
  3. 回 Obsidian 点同步：等公众号推送「笔记已同步」通知后，点 Obsidian 左侧工具栏顶部的 「同」字图标，刚才发的内容就会作为一篇笔记落到本地

完整的首次同步流程（含截图）和自动同步设置，参见 Obsidian 插件安装教程（手动版） 的「第一次同步」和「不想每次手动点同步？开启自动同步」两节——配置方式和手动安装版完全一致。

常见问题

搜不到 bijitongbu？

  • 确认搜索关键词是英文拼音 bijitongbu，不是中文「笔记同步助手」——Obsidian 市场不支持中文搜索
  • 确认 Obsidian 版本不要过旧（建议 1.5 及以上），老版本社区插件市场索引会滞后
  • 网络不稳定时点击搜索框右上角的 🔄 刷新按钮重新加载插件列表

安装一直卡在「正在安装」

通常是网络问题。可以：

  1. 关闭设置面板再重新打开重试一次
  2. 切换网络环境后重试
  3. 实在搜不到 / 装不上，参考 Obsidian 插件安装教程（手动版） 用压缩包方式安装

「This plugin has not been manually reviewed by Obsidian staff」是什么意思？

这是 Obsidian 对所有社区插件的标准提示，含义是「该插件未经过 Obsidian 官方人工逐行代码审核」，不代表插件有风险。笔记同步助手已经通过 Obsidian 官方的自动化审核流程上架插件市场，源代码也完全开源（见 github.com/notesynchelper/obsidian-bijitongbu），欢迎自行审阅。

为什么市场里有两个名字（Biji Tongbu / Wechat Messenger）？

这两个是笔记同步助手的多个发行包：同一份核心代码，因为 Obsidian 市场要求每个插件 id / name 唯一，所以按不同名字上架了多份，方便不同来源的用户检索。装任意一个都行，功能完全一致。

关键信息汇总

项目内容
Obsidian 插件市场搜索关键词bijitongbu
插件官方展示名Biji Tongbu（拼音，Obsidian 市场要求英文字母）
作者beijing-bijitongbu
实际产品名笔记同步助手（插件设置页面里仍是中文）
密钥获取方式微信关注「笔记同步助手」公众号，发送 Obsidian
源代码仓库https://github.com/notesynchelper/obsidian-bijitongbu

恭喜你完成安装！现在可以把链接发到微信「Obsidian」好友，让助手把内容交给 DeepSeek、豆包、千问 等 AI 处理，并自动同步到 Obsidian 了。