文件同步
文件同步功能允许管理员将 HandyCafe Server 上的文件分发到网络中的客户端 PC。它采用基于清单的方法，确保只传输已更改或新增的文件，最大限度减少带宽使用和同步时间。
同步资源管理器
同步资源管理器提供文件浏览器界面，用于选择要同步到客户端的目录和文件。管理员浏览服务端的文件系统，选择所需内容，然后启动同步操作。
同步工作原理
基于清单的比对
同步操作开始时，服务端生成一份文件清单 -- 包含所有待同步文件及其校验和的列表。每个客户端将此清单与本地文件进行比对：
- 客户端上不存在的文件标记为待下载。
- 校验和不同的文件（表明已被修改）标记为待下载。
- 匹配的文件完全跳过。
这种方法确保只传输服务端与客户端之间的差异部分，使重复同步快速高效。
分块传输
大文件被分割为较小的块通过 TCP 传输。这带来以下好处：
- 可靠性 -- 如果某个块传输失败，只需重试该块而非整个文件。
- 进度追踪 -- 可在块级别报告传输进度。
- 网络效率 -- 块大小经过调优，适合典型局域网环境。
触发同步
管理员可以通过两种方式触发文件同步：
- 同步到所有客户端 -- 将选定的文件同时推送到每台已连接的客户端。
- 同步到指定客户端 -- 针对一台或多台特定客户端执行同步操作。
需要分发新内容时，可从同步资源管理器界面手动触发同步。
同步报告
同步操作完成后，每个客户端向服务端报告状态：
- 成功 -- 所有文件同步完成，无错误。
- 失败 -- 一个或多个文件传输失败，附带失败文件和原因的详情。
- 已同步文件数 -- 实际下载的文件数量（不包括已是最新版本的跳过文件）。
这些报告在同步资源管理器中可见，允许管理员验证操作是否按预期完成。
使用场景
- 部署游戏更新 -- 一次性将游戏补丁或更新推送到所有游戏 PC，确保每台机器运行相同版本。
- 推送配置文件 -- 将更新的配置文件（如网络设置或应用偏好）分发到所有客户端。
- 分发软件 -- 通过同步安装包或绿色版应用在客户端 PC 上安装新软件。
- 更新客户端菜单素材 -- 同步客户端菜单界面使用的新图标、海报或媒体文件。