教程

如何配对加入同步

手机电脑同步插件 · ·使用教程

开始之前

这篇教程讲的是:你已经在一台设备上装好并登录了「手机电脑同步」(如果一台都还没有,先看介绍与安装使用入门),现在想把另一台设备也加进来,让两台设备的笔记保持一致。

按你要加入的是哪种设备,直接看对应章节:

  • 📱 手机加入同步 —— 从零安装 Obsidian、装插件、登录、加入,全程图文。
  • 💻 电脑加入同步 —— 已经会装插件的话,从登录开始三分钟搞定。

支持哪些系统

设备支持的系统
📱 手机 / 平板iOS(iPhone、iPad)、Android、鸿蒙 HarmonyOS
💻 电脑Windows、macOS、统信 UOS(以及其他常见 Linux 发行版)

这些系统上的 Obsidian 和「手机电脑同步」插件功能完全一致,同一个账号下可以任意混搭——比如鸿蒙手机 + 统信 UOS 电脑 + 一台 Mac,三台一起同步没有任何区别。

动手前先准备

  • 把另一台已经登录好的设备放在手边,并让它保持开着、联网——新设备上会显示一个 6 位配对码,你要在那台已登录的设备上把这个码输进去,它才会把这台新设备加进来。
  • 两台设备的插件都更新到最新版。 新的配对方式要两边都是新版才能用;旧版设备收不到输码窗口,新设备的等待页会提示你先去那台设备上更新插件。
  • 准备好微信,并提前关注「笔记同步助手」公众号(登录要用它收发一个 6 位验证码)。

放心,加入同步不会弄丢这台设备上原有的笔记。新设备加入后,本机已经有的笔记会和云端库里的内容双向合并、一并保留下来——本机笔记不会被删除或清空,只有同名但内容不同的笔记才会自动合并、或各留一份副本。加入前的等待页也会写明「本机 N 个文件将与云端双向同步」,你看一眼再继续就更踏实了。

配对码输在哪?

配对码显示在要加入的新设备上,输在另一台已经加入的设备上(有人也叫它「连接码」):

  • 已加入的设备开着时,会自动弹出「新设备请求加入同步」的窗口,码就输在这个窗口里;
  • 没弹出窗口、或者你把它关掉了,就打开那台设备的插件设置,最上面的「等待加入的设备」里输。

旧版插件是反过来的:在老设备的「设备配对」里点「生成配对码」,再到新设备上输入、两边核对安全码。两台设备都更新到最新版后,就统一改成上面这种「新设备出码、老设备输码」,也不用再核对安全码。另外,登录用的 6 位验证码是发给「笔记同步助手」公众号的,和配对码不是一回事。

手机加入同步

适用于 iOS(iPhone / iPad)、Android、鸿蒙 HarmonyOS。下面的截图取自安卓机,iOS 与鸿蒙的界面、步骤完全一样。

如果手机上还没有 Obsidian,先到 App Store / 应用商店 / 应用市场搜索 Obsidian 安装好。安卓 / 安卓平板在应用商店搜不到或下载很慢,用国内镜像 https://obsidian.bijitongbu.site/ 点 Android 下载 APK;iPhone / iPad 只能用 App Store。本节从打开 Obsidian 后的第一个界面讲起。

📱 手机上已经装了 Obsidian、而且里面已经有笔记内容了? 那就不用再新建笔记库——直接打开你那个已经有笔记的库,跳过下面的「一、切换语言」和「二、创建笔记库」,从 三、安装并启用插件(BRAT 方式) 开始即可(要是插件也早装好了,就直接看 四、打开插件,用微信登录)。

一、把界面语言切成中文

第一次打开 Obsidian,界面通常是英文的「Your thoughts are yours.」。点屏幕最下方那个带地球图标的 English。

Obsidian 首次打开,点最下方的 English 切换语言

在弹出的语言列表里选「简体中文」,整个界面就会变成中文。

界面已切换为简体中文

二、创建一个笔记库

点紫色的 「创建仓库」 按钮。

接着 Obsidian 会问你要不要设置它自带的同步。我们用的是「手机电脑同步」插件,不需要它自带的同步,点紫色的 「Skip for now」(暂时跳过)。

Obsidian 自带同步的引导页,点 Skip for now 跳过

然后给笔记库起个名字,比如「手机电脑同步」,点 「创建仓库」。

给笔记库起名并创建

笔记库创建好后,会进入一个空白的「新标签页」。

新建好的空笔记库

三、安装并启用插件(BRAT 方式)

📢 本插件已上架 Obsidian 插件市场(市场里搜 Shouji-Diannao),但市场要从 GitHub 下载,国内网络下常常很慢或装不上。手机上推荐用 BRAT 安装——BRAT 是 Obsidian 社区广泛使用的插件安装工具(本身就在插件市场里、随时可装),装出来的插件功能完全一致,之后也会自动更新。步骤是先装 BRAT,再用它装「手机电脑同步」,全程在 Obsidian 里点几下就完成。也可以改用快速安装插件(China BRAT)方式(市场搜「快速安装插件」,装好后点一下内置示例即可,不用填地址)。两种手机安装方式各有独立图文教程:BRAT 方式、快速安装插件方式。

第 1 步:打开第三方插件设置

点左上角的图标展开侧边栏,能看到刚建的「手机电脑同步」笔记库(此时是 0 个文件)。点右下角的齿轮图标打开设置。

展开侧边栏,点齿轮图标打开设置

在设置页里找到「选项」分组,点 「第三方插件」。

设置页,点「第三方插件」

第一次使用第三方插件,Obsidian 会提示安全模式。点最下方紫色的 「关闭安全模式」。

关闭安全模式

回到「第三方插件」页,点「社区插件市场」下面紫色的 「浏览」 按钮。

点「浏览」打开社区插件市场

第 2 步:安装并启用 BRAT

在搜索框里输入 brat,第一个结果就是 BRAT(作者 tfthacker)。点这张卡片。

在插件市场搜索 brat,第一个结果就是 BRAT

进入 BRAT 详情页,点紫色的 「安装」 按钮,然后稍等它下载。

BRAT 详情页,点「安装」

安装完成后,标题旁会出现「已安装」标记,原来的安装按钮变成紫色的 「启用」。点它。

BRAT 安装完成,点「启用」

启用后,按钮会变成 「选项 / 快捷键 / 禁用…」。点 「选项」 进入 BRAT 的设置页。

BRAT 已启用,点「选项」

第 3 步:用 BRAT 安装「手机电脑同步」

在 BRAT 设置页往下滑,找到「Beta 插件列表」一栏,点紫色的 「添加 Beta 插件」 按钮。

BRAT 设置页里点「添加 Beta 插件」

在弹出的对话框最上面的「仓库」输入框里,填入手机电脑同步插件的 GitHub 仓库地址:

https://github.com/notesynchelper/shoujidiannao

确认下方 「安装后启用此插件」 已勾选(默认勾选),然后点最下面紫色的 「添加插件」。

对话框里填入仓库地址,点「添加插件」

稍等几秒,屏幕顶部会弹出提示:

BRAT notesynchelper/shoujidiannao The plugin has been registered with BRAT.

这表示「手机电脑同步」已经装好并启用了。

注册成功提示

回到「第三方插件」页,「已安装插件」列表里能看到 BRAT 和 Shouji Diannao(手机电脑同步插件) 两个插件,开关都是开着的(紫色)。

已安装插件列表里出现 BRAT 和 Shouji Diannao

💡 装好后插件会在联网时自动更新到最新版本。如果添加时报 GitHub 限流错误(rate limit),等几分钟或换个网络重试即可。

第 4 步:进入插件设置页

返回「第三方插件」页(或点左上角 ← 回设置主页),往下滑到「第三方插件」分组,点 Shouji Diannao 就能进入插件自己的设置页,接着看下面的第四节。

回到设置主页,在「第三方插件」分组里看到 Shouji Diannao

设置页里点 Shouji Diannao

四、打开插件,用微信登录

进入插件设置页后,「设置同步」界面只有一个入口。点紫色的 「获取登录验证码」——登录后插件会自动判断你该新建库还是加入已有库,你不用自己选「是第一次使用」还是「新增设备」。

设置同步界面,点「获取登录验证码」

插件会显示一个 6 位验证码(下图是 482913),并提示「等待服务号收到验证码……」,验证码 300 秒内有效。手机没法扫自己屏幕上的二维码,所以按页面上的三步来:

  1. 先截屏保存这个页面(下方二维码会一起存进相册)。
  2. 打开微信 →「扫一扫」→ 点右下角 「相册」→ 选刚才那张截图,识别二维码并关注 「笔记同步助手」 服务号。
  3. 回到服务号对话,把上面那 6 位验证码发给它(可以先点 「复制验证码」)。

手机验证码页:截屏 → 微信扫一扫 → 相册识别二维码

服务号收到验证码后会回复「已收到,请前往插件查看」,插件里的登录会自动完成,无需手动操作。

已经关注过「笔记同步助手」公众号的话,第 1、2 步可以跳过,直接在公众号对话里发送验证码即可。

五、在电脑上输入配对码,把手机加入同步

微信验证通过后,插件会自动找到你在其他设备(电脑)上已有的同步库。只有一个库时会直接给出推荐,卡片上写着最近同步时间和最近在线的设备名,方便你认出正确的库。点 「将这台设备加入「我的笔记」」。

手机上找到已有同步库,点「将这台设备加入」

点了之后直接进入等待页,手机上会显示一个大号的 6 位配对码(下图是 717 800),并提示「已通知 1 台在线设备,请在那台设备弹出的窗口里输入配对码」。配对码几分钟后会自动换一个新的,页面上有倒计时。

手机等待页:显示 6 位配对码

这时拿起电脑——它会自动弹出 「新设备请求加入同步」 的窗口,上面写着是「我的手机」在请求加入。确认是你本人在操作后,把手机屏幕上的 6 位配对码输进去,点 「确认加入」。

电脑弹出「新设备请求加入同步」,输入手机上的配对码

码对上之后,电脑会提示 「已把恢复密钥安全发送给新设备」——恢复密钥是加密后传过去的,云端看不到它。

电脑提示已把恢复密钥安全发送给新设备

🔒 只输入你自己手机上显示的码,不要把码告诉任何人,也不要输入别人发给你的码。

输错了也没关系:电脑会提示「配对码不对」,手机会自动换一个新码,电脑上随即弹出新的窗口、顶部写着「上一个配对码不对」,照着手机上的新码再输一次就行。

回到手机,它会提示 「已加入同步库」。点 「立即开始全库同步」,就会开始把电脑上的笔记下载到这台手机。

手机提示已加入同步库,点「立即开始全库同步」

备选:电脑没弹出输码窗口时,在电脑的插件设置里输码

如果电脑当时没开着、或者你关掉了那个窗口,也不用重来:到电脑上打开「手机电脑同步」的设置页,最上面就是 「等待加入的设备」,手机的加入请求就在这里。

电脑设置页最上方的「等待加入的设备」:输入手机上的配对码

在请求卡片里输入手机上的 6 位配对码,点 「确认加入」,看到「已把恢复密钥安全发送给新设备」就完成了,后面的步骤和上面一样。

电脑设置页里:已把恢复密钥安全发送给新设备

「等待加入的设备」默认是展开的。不需要时可以点标题把它收起,这台设备会记住你的选择;收起时如果有新设备在等,标题旁会显示「1 个请求」,点开就能输码。

收起时标题旁显示「1 个请求」

六、等笔记下载完成

点「立即开始全库同步」后,插件会切到「同步控制」界面,显示 「下载中」 和进度(下图是 7% · 63/952)——它正在把电脑上的笔记下载到这台手机。

手机正在下载笔记

进度走完后,手机上就能看到和电脑一致的全部笔记。之后无论在手机还是电脑上改动,都会自动同步到另一台——手机加入到这里就全部完成了。

电脑加入同步

适用于 Windows、macOS、统信 UOS(以及其他常见 Linux 发行版)。这三种系统上的 Obsidian 界面一致,下面的步骤通用;截图取自 Linux 桌面版。

这一节讲的是把一台新电脑加入你已有的同步——比如你已经在手机(或另一台电脑)上用起来了,现在想让办公室这台 Windows、家里这台 Mac 或者单位配的统信 UOS 也看到同一份笔记。

一、装好插件,进入「设置同步」

先在这台电脑的 Obsidian 里把插件装好并启用:推荐用 China BRAT 方式——在插件市场搜「快速安装插件」装好 China BRAT,再点一下它示例里的「手机电脑同步」即可,详细图文见介绍与安装使用入门 §二、安装插件;无法访问插件市场时,也可以从官网下载插件安装包手动安装。(插件市场里也能搜 Shouji-Diannao 直接安装,但市场要从 GitHub 下载、国内网络下可能装不上;同一个笔记库里只装一份。)

启用后点 「选项」 进入插件自己的设置页。「开始同步」界面只有一个入口,点紫色的 「获取登录验证码」——登录后插件会自动判断你该新建库还是加入已有库,你不用自己选。

电脑上的「开始同步」界面,点「获取登录验证码」

二、用微信扫码登录

页面会显示一个大号 6 位验证码、倒计时(剩余 04:59)和一张二维码。电脑上比手机省事——可以直接拿手机扫电脑屏幕:

  1. 用微信扫一扫扫描屏幕上的二维码,关注 「笔记同步助手」 服务号(已关注过可跳过)。
  2. 在服务号对话里,把那 6 位验证码作为一条普通文字消息发出去(也可以先点 「复制验证码」),不用加任何别的字。

电脑上的验证码页:6 位验证码 + 扫码引导

服务号回复 「已收到,请前往插件查看」 后,插件里的登录会自动完成,你不用回来点任何按钮。

验证码 300 秒内有效,过期了就再点一次「获取登录验证码」重新拿一个。

这个 6 位登录验证码是用来登录的,和第四步里可能用到的 6 位配对码不是一回事,别搞混。

三、选中要加入的同步库

登录通过后,插件会自动找到你在其他设备上已有的同步库。只有一个库时会直接给出推荐——卡片上写着最近同步时间、最近在线的设备名、文件数和创建日期,方便你认出正确的库。点右边的 「将这台设备加入「我的笔记」」。

电脑上找到已有同步库,点「将这台设备加入」

如果你名下有多个同步库,这里会把它们全部列出来(按最近同步时间排序,最上面那个通常就是你正在用的),每张卡片右边的按钮会变成短短的 「加入」。认准你在其他设备上正在用的那个再点。

四、在另一台设备上输入配对码

点了之后直接进入等待页,这台电脑会显示一个大号的 6 位配对码和倒计时,并自动通知你其他在线的设备。等待页同时写明了加入后云端已有多少文件、本机多少文件会双向同步,以及本机笔记不会被删除。

电脑等待页:显示 6 位配对码

这时拿起另一台已经登录好的设备(手机或另一台电脑),它会自动弹出 「新设备请求加入同步」 的窗口,上面写着是哪台设备在请求加入哪个库。

已登录的设备上弹出「新设备请求加入同步」

确认是你本人在操作后,把这台电脑屏幕上的 6 位配对码输进去,点 「确认加入」:

输入新电脑上显示的配对码,点「确认加入」

码对上之后,那台设备会提示 「已把恢复密钥安全发送给新设备」。

已把恢复密钥安全发送给新设备

🔒 只输入你自己设备上显示的码,不要把码告诉任何人,也不要输入别人发给你的码。配对码只在你的两台设备之间核对,不会经过云端,这也是端到端加密的一道防线。

输错了也没关系:那台设备会提示「配对码不对」,这台电脑会自动换一个新码,那台设备上随即弹出新的窗口、顶部写着「上一个配对码不对」,照着新码再输一次就行。

五、开始全库同步

配对完成后,这台电脑会提示 「已加入同步库」,并让你选怎么开始:

  • 点 「立即开始全库同步」 —— 马上双向同步整个 Obsidian 库(首次会传输全部内容)。多数人选这个。
  • 点 「暂停同步,先去设置」 —— 先在设置里指定「只同步特定文件夹」或「排除的文件夹」,设完再点「恢复同步」。库很大、只想同步其中一部分时选它。

电脑加入完成,点「立即开始全库同步」

开始后插件会切到「同步控制」界面显示下载进度,右下角的同步球也会转起来——怎么看进度、还剩多少,见《同步进度看这里:右下角那颗「同步球」》。

进度走完后,这台电脑上就有和其他设备一致的全部笔记了。之后在任意一台设备上改动,都会自动同步到其余设备——电脑加入到这里就全部完成了。

备选:没有设备弹出输码窗口时,在那台设备的插件设置里输码

如果另一台设备当时不在线、或者你关掉了那个窗口,等它打开后进入「手机电脑同步」的设置页,最上面就是 「等待加入的设备」,这台电脑的加入请求就在这里(下图是手机上的样子)。

手机设置页最上方的「等待加入的设备」:输入新电脑上的配对码

在请求卡片里输入这台电脑上的 6 位配对码,点 「确认加入」,看到「已把恢复密钥安全发送给新设备」就完成了,后面的步骤和上面一样。

手机设置页里:已把恢复密钥安全发送给新设备

「等待加入的设备」默认是展开的。不需要时可以点标题把它收起,这台设备会记住你的选择;收起时如果有新设备在等,标题旁会显示「1 个请求」,点开就能输码。

等太久配对码会自动换新,以新设备屏幕上当前显示的码为准。