跨端体检表

三分钟，看看你的同步是不是真的在工作。

适用：WorkBuddy跨端工作 v4.6.0 及以后｜有巢数智 www.youchaoyun.com

为什么需要这张表

这类工具最危险的不是报错，是不报错。

它会对你说”同步完成”，而实际上一个产物都没上云；你换了设备，打开是空的，才想起来上一次成功同步是三周前。

更麻烦的是，出问题的那些状态，界面看起来全都正常。

这张表只查一件事：你以为在同步的东西，是不是真的在同步。

怎么用

10 道题，分三组。每道题都写了怎么查，别凭印象答。

三组有顺序：A 组不过，B、C 组的答案没有意义。

A 组｜范围：到底同步了没有

A1　你的项目目录，在不在某个 Git 仓库里面？

怎么查：往上翻它的上级目录，看有没有 .git。或者在该目录说一句「状态」，看它报出的判定依据。

答案记下来，进 A2。

A2　那个仓库的根，就是这个目录本身吗？

怎么查：仓库根和项目目录是同一个文件夹 → 是。仓库根在更上层（比如家目录、盘根）→ 不是。

★ 这两题决定它是「普通空间」（整份带走）还是「Git 空间」（只同步记忆，产物归 Git）。

A3　上次收工后，去资料库网页端，能看到产物文件吗？

怎么查：打开资料库，进到那个空间的镜像目录，看有没有 .md、表格、图片这些。只看到 .workbuddy/ 不算。

看得到 → 绿
只看到 .workbuddy/ → 红灯
没去看过 → 现在去看，这是最重要的一题

B 组｜稳定性：有没有悄悄坏掉

B1　最近换过资料库的根目录，或者迁移过空间吗？

换过一次 → 记下来，去 B2。

B2　出现过「推了 3 个就报完成」吗？

明明改了一堆文件，结果只报推了 2–3 个就结束，也没有任何报错。

出现过 → 红灯。

B3　经常提示冲突，但打开两份内容一样？

报冲突，点开看本地和云端内容其实一模一样。

经常 → 红灯。

B4　有没有文件一直显示「仍受阻（第 N 次）」？

每次同步都提同一个文件，说被拒收，次数一直涨。

有 → 红灯。

C 组｜可恢复性：换台机器真能接上吗

C1　新设备拉取后，侧栏里能看到那个空间吗？

文件回来了但侧栏没有 → 红灯。这一步工具做不到，只能你手工点一次。

C2　拉回来的记忆文件里，路径是本机的，还是旧电脑的？

打开记忆文件看一眼，里面写的路径如果还是上一台机器的盘符 → 红灯。

C3　你在 A 机删掉的文件，在 B 机复活了吗？

删了又回来，反复几次 → 红灯。

判读：只看有没有红灯，不打分

结果	含义	该做什么
有任一红灯	同步正在失效，而且不报错	先停用同步，按下表修完再继续
有黄灯、无红灯	有隐患，还没坏	本周内处理掉
全绿	正常	可以放心「收工」「开工」

为什么红灯要停，而不是”先对付着用”：在错误的基线上继续同步，会把错的东西越写越深。等到你发现时，要修的不是一个开关，是一整套已上传的错误数据。

六个红灯怎么修

A3 · 看不到产物

原因：整片空间被判成了 Git 空间，产物不再上云。

怎么修：回到 A1 / A2。如果那个仓库本来就该管这个目录，这是正常行为，产物本就该由 Git 管；如果只是「碰巧在仓库下面」，把它排除出仓库，或强制按全量同步。

B2 · 推了 3 个就完成

原因：换过云端根目录，但首轮没做全量重推。

怎么修：跑一次根目录迁移，首轮必须全量重推。否则基线仍认为「云端还有」，存量文件会全部漏推。

B3 · 冲突但内容一样

原因：记忆里的本机路径没做设备转换，两台机器把同一个路径认成了两个。

怎么修：检查本机的路径映射表是否还在、是否被误改或误删。

B4 · 一直「仍受阻」

原因：通道拒收。常见三类——文件超限、网页里残留第三方图片外链、云端权限不足。

怎么修：去网页端处理那一项。这三类跟重试无关，重试一百次也一样。

C1 · 侧栏没有

原因：侧栏按「会话」分组，不读工作空间记录表。

怎么修：在客户端对那个目录点一次「打开文件夹」。这一步只能手工做。

C3 · 删了又回来

原因：删除没有留下跨设备标记。

怎么修：用工具自己的删除流程。在文件管理器里硬删，另一台机器不知道你删了。

一件容易忽略的事

体检只查”同步有没有在工作”，不查”该不该同步”。

判断标准很简单：这份东西，我换台电脑还想接着干吗？

不想的话，就别让它进同步范围。同步的东西越多，出错的面越大，体检也越复杂。

卡住了，直接问我

修不动的，把**报错原文（方括号里的错误码）**发我，不用截图，不用描述。