Remotely-Save插件Dropbox同步中的大小写敏感问题解析

问题背景

在Remotely-Save插件4.11版本中，部分Dropbox用户遇到了同步中断问题，错误信息显示为"unexpectedly keptFolder no decisions: ink/"。这个问题主要出现在macOS和iOS系统上，表现为当用户尝试同步包含特定大小写命名的文件夹时，同步过程会意外终止。

问题根源分析

经过深入调查，发现这个问题源于Dropbox API的一个特殊行为特性：

1. 大小写保留机制：Dropbox的文件系统是大小写不敏感的，但会保留创建时的大小写格式
2. 路径组件不一致性：当用户重命名文件夹时，API返回的响应中可能出现大小写不一致的情况
3. 持久化特性：即使删除后重建同名文件夹，这种大小写不一致性仍然会保留

具体表现为：

• 创建大写文件夹"Ink/"后重命名为小写"ink/"
• API返回的响应中文件夹名为小写"ink/"，但子文件路径仍保持大写"Ink/1.md"
• 这种不一致性会导致Remotely-Save插件在生成同步计划时出现错误

技术解决方案

针对这个问题，开发团队采取了以下解决方案：

1. 路径组件规范化：对API返回的路径进行逐组件的大小写规范化处理
2. 大小写一致性检查：在同步前验证文件夹和子文件路径的大小写一致性
3. 错误恢复机制：当检测到大小写不一致时，自动进行路径修正

用户应对建议

对于遇到此问题的用户，可以采取以下临时解决方案：

1. 完全删除并重新创建受影响的文件夹结构
2. 暂时使用增量同步模式
3. 等待0.4.12版本的发布，该版本已包含针对此问题的修复

总结

这个案例展示了云存储API在实际使用中可能遇到的边界情况。Dropbox的大小写保留机制虽然有其设计考量，但在跨平台同步场景下可能引发意料之外的问题。Remotely-Save团队通过深入分析API行为，实现了健壮的路径处理逻辑，确保了在各种大小写场景下的稳定同步。

对于开发者而言，这个案例也提醒我们在处理云存储服务时，需要特别注意不同平台和服务的命名规范差异，构建更加鲁棒的同步机制。