一、系统版本
- NAS 架构与系统版本:X86 / fnOS 1.1.26
- 飞牛同步服务端版本:0.19.0
二、设备环境
- NAS:物理机,局域网直连
- Windows 客户端:系统版本 Windows 11,飞牛同步客户端版本 V0.1.8(3c89dec)
- Mac 客户端:macOS 版本 Tahoe 26.3.1 (25D2128),飞牛同步客户端版本 V0.1.8(a30bab7)
- 同步方式:双向同步
- 两端同步的是同一个 NAS 端目录
三、Bug 现象
问题描述:当仅使用 Windows 客户端单独同步某目录时,一切正常,不会出现文件丢失。但只要在 Mac 客户端上同时挂载同步同一个 NAS 目录,NAS 端、Mac端以及 Windows 端中所有以 "." 开头的隐藏文件夹(例如 .git、.vscode、.claude等)会被莫名其妙地删除。
重点:我已在两端客户端的同步设置中确认,均没有配置任何排除以 "." 开头的隐藏文件/文件夹的规则,属于默认配置下就会发生数据删除。
复现路径:
- 在 NAS 上创建一个同步目录,内含若干以 "." 开头的文件夹(如
.git)
- Windows 客户端连接该目录进行同步 —— 正常,
. 开头目录保留
- 在 Mac 客户端上同时连接同一个 NAS 目录进行同步
- 等待同步完成后观察:NAS 端、Windows 端、Mac 端中所有以 "." 开头的文件夹均被删除
- 由于是同步删除,Windows 本地和 NAS 端的原始数据也一并丢失
影响:
- 对开发者用户(工程项目中的
.git、.vscode、.idea、.claude 等关键配置与版本控制数据)、以及任何使用点号开头目录作为配置/缓存的场景,属于严重的数据丢失型 Bug
- 用户无任何提示、无任何排除配置,默认状态下即触发删除,风险极高

四、出现频率
必现。只要 Windows + Mac 双端同时同步同一目录,且目录中存在以 "." 开头的文件夹,即 100% 触发删除。