教程

同步进度看这里:右下角那颗「同步球」

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

一、2.5.0 起:进度直接画在球上

以前那颗同步图标只会匀速转圈,只能告诉你「在同步」,说不清还剩多少。 从 2.5.0 版本开始,只要插件能算出可靠的进度,它就会画成一段长度 = 已完成比例的圆弧, 边转边走:

0%25%50%75%100%
刚开始,只有一圈灰色底槽四分之一圈半个圈四分之三圈整圈
  • 灰色的整圈是”这次要传的全部”,彩色的弧是”已经传好的那部分”。
  • 弧的前端有个小箭头,跟着圆圈匀速转——在转 = 还在传,一眼就能区分「正在同步」和「卡住不动」。
  • 传完会变成绿色对勾,表示已经是最新。

弧从哪个角度开始不重要(图标一直在转,起点是随机的),要看的是它占了整圈的几分之几

二、电脑上:窗口右下角的状态栏

同步球在 Obsidian 窗口最右下角的状态栏里,一直挂在那儿,不用去设置页翻:

电脑端同步球在窗口右下角状态栏,橙框标出位置

放大看就是它:

电脑端同步球放大

鼠标放上去(不用点),会浮出这一刻的完整状态,包含精确百分比和文件数:

鼠标悬停在同步球上,浮出「下载解密 50% · 60/120」

点一下,会展开同步菜单——第一行同样是当前进度,下面是常用操作(暂停同步 / 立即同步 / 查看历史版本 / 找回已删除文件 / 打开同步设置):

点开同步球后的菜单

传完之后,球会变成绿色对勾常驻,不会弹任何提示打扰你:

同步完成后的绿色对勾

三、手机上:右侧边栏里的右下角

手机屏幕小,Obsidian 不显示底部状态栏,所以同步球挂在右侧边栏上(官方 Sync 插件也是挂在这里)。

右侧边栏收起的时候,看不到这颗球——这不是插件出问题了:

右侧边栏收起时,界面上没有同步球

从屏幕右边缘往左划,把右侧边栏拉出来,球就固定在右下角

划出右侧边栏后,同步球在右下角,橙框标出位置

放大看:

手机端同步球放大

点一下这颗球,屏幕底部会弹出同步菜单,第一行就是当前进度:

手机点开同步球后弹出的菜单

手机屏幕窄,这一行的文字可能显示不全。想看完整的「百分比 · 已完成/总数」, 到 Obsidian 设置 → 第三方插件「手机电脑同步」 的「同步控制」那一行,是同一份数据。

传完同样变成绿色对勾:

手机端同步完成后的绿色对勾

四、这颗球的几种样子

样子含义要不要处理
彩色圆弧 + 箭头在转正在传,弧长就是已完成比例不用,等它转完
只转圈、没有比例弧正在传,但这一轮算不出可靠的进度(见第五节)不用
绿色对勾已是最新不用
暂停符号你(或网页管理页面)把这台设备的同步暂停了想继续就点球 →「继续同步」
断线图标当前连不上同步服务检查网络,一般会自动重连
红色有文件再重试也传不上去见教程《提示「N 个文件无法同步」怎么办》

网络闪断、临时超时这类问题,插件会自己一直重试,只会显示成”还在同步”,不会显示成红色失败。 看到红色才需要你介入。

五、为什么有时候只转圈、不给百分比

插件有一条硬规矩:宁可不报,绝不误报。百分比只在能拿到可靠分母的时候才显示—— 也就是这次连接完整取回了云端清单,知道”总共该有多少个文件”、也知道”本机已经落好了多少个”。

这两种常见情况下,它会退回”只转圈”,并在文字里点出正在传的文件名:

  • 弱网频繁断连:断线重连后往往只取增量清单,这一轮就没有”总数”可用;
  • 上传:本机要传的东西是每轮重新算的,没有一个稳定的总数可以当分母。

这时球照样在转,代表同步在正常进行,只是这一刻给不出一个诚实的百分比—— 比给你一个会跳来跳去、甚至倒退的假进度要好。

六、版本要求

进度环是 2.5.0 版本开始才有的。如果你的同步球只会匀速转圈、从来不出现比例弧:

  1. 等插件自动更新:插件会自行检查新版本并下载,重启 Obsidian 后生效
  2. 也可以到教程站首页重新下载安装包,手动覆盖安装。

怎么看当前版本:Obsidian 设置 → 第三方插件 → 「手机电脑同步」,插件名旁边就是版本号。

七、常见问题

Q:球一直是半圈,好久不动,是卡住了吗? 先看它还在不在转。在转说明连接是通的,多半是正在下载一个大附件(一个大文件传完才会让弧前进一格)。 完全不转、或图标变成断线样子,才是连接出了问题。

Q:为什么手机上的百分比和电脑上不一样? 进度是每台设备各算各的:它表示”这台设备本地还差多少”。新加入的设备要下载全部内容, 老设备可能只差几个文件,两边数字不同是正常的。

Q:进度到 100% 了,为什么还没变成绿色对勾? 100% 表示要下载的正文都落盘了,插件还会做最后的收尾(校验、写索引)。稍等一下就会变成对勾。

Q:能不能显示”还剩几分钟”? 暂时不做。剩余时间要靠网速估算,弱网下极容易给出离谱的数字——这违反上面那条”宁可不报,绝不误报”。 现在用「已完成比例 + 已完成/总数」来表达同一件事。

Q:手机上划不出右侧边栏? 从屏幕最右边缘开始往左划(不是从屏幕中间划)。如果笔记正处在编辑状态,先点一下正文以外的空白处再划。