前言¶
多台 Windows 机器共用一个 WorkBuddy 时，配置、记忆文件、自动化定义会各自漂移：换机要重新配一遍，重装后个人数据找不回来，云盘同步几天后又冒出一堆 .conflict 文件和”复活”的旧版本，不知道哪个才是对的。
下面介绍的 WorkBuddy跨设备同步 就是处理这件事的：它把 WorkBuddy 的个人数据同步交给任意可自动同步的云盘，并在同步机制上做了内容比对、删除传播和清理工具。由社区作者 user_8af66db7 发布，坐标 @user_8af66db7/workbuddy-data-sync，当前版本 2.0.2，分类 office-efficiency。
这是什么¶
一个面向多机用户的 WorkBuddy 数据同步技能。它不绑定单一云盘厂商，只要求你有一个能在多台机器之间自动同步文件的目录（OneDrive、Dropbox、百度网盘、坚果云、群晖 Drive 均可），然后在这个目录和本机 WorkBuddy 数据目录之间做双向同步。
需要说明的是，它不负责调度云盘本身，云盘的自动同步由厂商客户端完成；这个技能负责的是合并策略、冲突处理和垃圾文件清理。
同步范围与机制¶
同步覆盖四类数据：配置、身份与记忆文件（MEMORY.md / USER.md）、项目记忆、自动化定义（automations.json）。
合并机制上，它有几点设计，都是针对云盘同步的常见坑：
- 3-way 合并 + MD5 内容比对：以内容哈希判断是否变更，而不是看修改时间。云盘客户端经常会改写文件的 mtime，只看时间会产生大量假冲突。
- Push 护栏 + 首同步保护：防止用陈旧的本地数据覆盖云端的新内容，也防止旧文件覆盖新成果。
- 墓碑删除传播：删除操作可以跨机一致地传播；如果目标文件在另一台机器上已被独立修改，则保留该文件，即”删除 vs 修改”冲突不静默删。
- connectors 凭证目录强制排除：凭据不进入云盘，避免外泄。技能声明不调用任何外部接口，数据只写入你配置的本地云盘目录。
默认只读，确认后 -Apply¶
所有脚本默认是 dry-run，只做只读预览，不落盘。确认预览输出无误后，加上 -Apply 才会真正执行：
# 默认 dry-run：只预览，不写入
# 确认预览输出后，加 -Apply 才会真正执行写入
这是它强调的安全底线：先看一遍将要发生什么，再决定是否执行。
典型用法¶
在对话中让助手做这几件事：跑 -Check 自检、做 dry-run 预览、生成 PowerShell 命令、解释输出。真实同步的执行者必须是你自己：
# 1、让助手跑 -Check 自检
# 2、让它做 dry-run 预览，并解释将要发生什么
# 3、完全关闭 WorkBuddy：任务管理器确认没有 WB / CodeBuddy 进程
# 4、手动运行助手给出的 PowerShell 命令（push / pull / -Apply）
第 3、4 步不能省。-Apply 会读写 WorkBuddy 的本地数据，agent 不应代为执行，因此技能本身在对话中只负责检查、预览、给命令和解释输出，真正执行留给用户。
定期清理同步产生的垃圾文件，用配套清理脚本即可：
# 扫描并清理 .conflict 冲突文件
# 清理会话"复活"源头，如 modify_backup 等备份文件
这些文件是云盘同步在 WorkBuddy 目录里留下的残留，清理脚本按同样默认 dry-run、确认后 -Apply 的方式运行。
适用场景¶
适合：多台 Windows 电脑共用 WorkBuddy，想让配置、记忆、自动化保持一致；换机或重装系统后快速恢复个人数据；清理云盘同步产生的冲突与复活垃圾文件。
不适合：只用一台机器（没有同步需求）；没有可用的自动同步云盘；非 Windows 或没有 PowerShell 环境。
权限方面，技能声明需要文件系统的读取、写入和删除权限——它会删除文件（清理冲突、删除传播）并把个人数据写入你指定的本地云盘目录。作者按 MIT 协议开源，按”原样”提供，使用者需自行确认 dry-run 输出并承担执行后果。
收尾¶
这套方案的价值在于把同步的底层策略（内容比对、删除传播、凭证排除）固化进脚本，用户只需要选一个顺手的云盘。需要注意的取舍是：它解决的是 WorkBuddy 数据一致性，云盘本身的可靠性仍由厂商客户端负责，且真实同步必须由你关闭 WorkBuddy 后手动跑命令，不能指望 agent 代劳。
官方地址：https://api.skillhub.cn/user_8af66db7/workbuddy-data-sync （SkillHub 页面：https://www.skillhub.cn/skills/user_8af66db7/workbuddy-data-sync）
页面显示评分 100000、下载 3514 次、安装 0 次（资料抓取时间 2026-10-30，另一处线索记录下载 3447 次，以页面实时数据为准）。安装命令资料未给出，请到官方页面查看。
