TUTORIALS · 教程中心
把手机电脑同步插件用到极致
共 15 篇教程，覆盖手机电脑同步插件的安装、配置与日常使用。 左侧目录按类目分组；点进任意一篇都能一眼看到其它教程。
使用教程
15 篇- 01 介绍与安装使用入门 手机电脑同步插件是什么，以及如何在 Obsidian 里安装、启用并完成第一次同步。
- 02 如何配对加入同步 把一台新设备加进你已有的同步。手机（iOS / Android / 鸿蒙）从零安装 Obsidian 到加入同步，电脑（Windows / macOS / 统信 UOS）登录后一键加入，两个章节各自图文到底。
- 03 手机用快速安装插件装插件 手机（iOS / Android / 鸿蒙）上通过「快速安装插件」（China BRAT）安装「手机电脑同步」的完整图文：插件市场搜「快速安装插件」装好 China BRAT，点一下内置示例就装上了，全程不用填地址、不经过 GitHub。
- 04 手机用 BRAT 安装插件 手机（iOS / Android / 鸿蒙）上通过 BRAT 安装「手机电脑同步」插件的完整图文：从插件市场装好 BRAT，再用它添加本插件，装好后自动更新。适合插件市场里搜不到本插件时使用。
- 05 网页版：在浏览器里直接用 Obsidian 装不了软件的电脑也能用——打开网页就是一个完整的 Obsidian，配对后与你的手机、电脑自动同步。本篇讲清网页版怎么配对、数据存在哪、怎么查看和删除云端内容。
- 06 在服务器 / NAS 上用命令行同步（obsync-cli） 用无界面的命令行客户端 obsync-cli，在服务器、NAS、群晖、cron、CI 上同步你的 Obsidian 笔记库，不用打开带图形界面的 Obsidian。
- 07 同步控制：让某台设备只上传、只下载或暂停同步 在网页管理页面里按设备控制同步方向——双向同步、仅上传、仅下载、停止同步四档随时切换；暂停期间的改动不会丢，恢复双向后自动补齐。本篇讲清每种模式的含义、设置方法和常见疑问。
- 08 同步进度看这里：右下角那颗「同步球」 2.5.0 起，同步进度直接画在同步球上——转了半圈就是 50%，四分之三圈就是 75%，一眼看出还要传多久。本篇说明电脑端和手机端的同步球各在哪、怎么读、点开怎么看到精确的百分比和文件数，以及为什么有时候只转圈不给百分比。
- 09 怎么把这台设备换到另一个云端同步库 手机端和电脑端分别怎么退出当前的云端同步库、加入另一个库或新建一个独立的库。含「本机 Obsidian 库」和「云端同步库」的区别、两个库同名时怎么认、库数量满了怎么办，以及换绑会不会动到笔记。
- 10 提示「N 个文件无法同步」怎么办 插件设置页出现「N 个文件无法同步」时，如何一步步查出是哪个文件、为什么同步不了，并用「重试」「排除此文件」自助解决。含两类失败原因的处理方法、排除后如何撤销，以及旧版本用户的临时办法。
- 11 排除不想同步的内容：文件夹、单个文件和「.」开头的隐藏内容 怎么让某个文件夹、某个文件不参与同步？2.8.1 版本起，排除功能升级：除了整个文件夹，还能排除单个文件，以及任意路径下「.」开头的隐藏文件夹（如 .git）和隐藏文件（如 .env）。本篇讲入口、选择方法、「只本机 / 所有设备」两种范围的区别，以及排除后如何撤销。
- 12 你的笔记是怎么加密的 数据安全说明 — 笔记在你的设备上就先被加密，密钥从不上传，云端和服务方都解不开你的内容。
- 13 常见问题 用户在使用「手机电脑同步」过程中最常问到的问题与官方解答，持续更新。
- 14 笔记库里多出来的 .obsync-anchors 是什么 插件会在笔记库根目录放一个 .obsync-anchors 文件夹，用来记住"这个笔记库配的是哪个云端库"。里面没有密钥，不会同步，也不用管它。
- 15 安装预览版插件：抢先体验最新功能 想在正式推送前就用上新功能？本篇教你安装「手机电脑同步」的预览版：先在插件市场搜「快速安装插件」装好 China BRAT，再粘贴预览版地址一键安装。已装正式版的可以直接原地升级，登录和同步库都保留；等正式版追上版本号后还会自动切回正式通道。