# 小文件云

在 uTools 中管理并同步配置文件、脚本、密钥等轻量小文件。以记录为单位精准控制同步方向，不受文件夹路径限制。

## 快速开始

1. 安装插件后点击「存储设置」，填写 WebDAV 地址、用户名和密码
2. 点击「添加」或拖入文件，选择需要同步的本地文件
3. 点击「上传」完成首次同步，其他设备上点击「下载」即可拉取

## 核心功能

- **以记录为单位，不受路径约束** — 每个文件独立管理同步状态，同一文件在不同设备上可放在不同目录
- **精确控制同步方向** — 逐个文件选择上传或下载，冲突时由你决定覆盖方向，不会自动静默覆盖
- **状态一目了然** — 列表中清晰显示：已同步、待上传、待下载、冲突、本地缺失，每种状态都有操作指引
- **可选自动同步** — 开启后每 60 秒自动检查，有实时进度提示
- **完整性校验** — 上传后自动读回并校验 MD5，确保数据到达无误
- **跨后端迁移** — 切换后端不影响设备本地目录映射，只需更新连接信息

## 与网盘的区别

网盘以**文件夹镜像**为模型，指定一个文件夹后所有内容自动同步到云端。这对文档、照片等批量文件很合适，但对配置文件同步场景存在几个问题：

| 场景 | 网盘的问题 | 本工具的做法 |
|---|---|---|
| 同一文件不同路径 | 网盘强制固定路径 | 每台设备可独立设置本地目录 |
| 选择性同步 | 要么同步整个文件夹，要么手动排除 | 逐个添加需要同步的文件，列表清晰 |
| 同步方向控制 | 自动合并，无法选择覆盖方向 | 逐文件控制上传/下载，冲突时由你决定 |
| 配置历史追踪 | 自动同步，没有明确的版本锚点 | 每次同步有记录，可追踪最后同步时间和用户 |
| 存储后端切换 | 绑定一个服务，切换成本高 | 切换后端不影响设备映射，只需改连接信息 |

简单说：网盘是文件级的批量镜像，本工具是记录级的精准同步。

## 适用场景

- 同步 SSH 配置（`~/.ssh/config`）到多台机器
- 同步开发工具配置（`.vimrc`、`.zshrc`、`settings.json`、`keybindings.json`）
- 同步应用配置文件（nginx 配置、Docker Compose、CI 配置文件）
- 同步脚本和工具集（分布在各个目录下的 shell 脚本、小工具）
- 同步终端主题和配色（Alacritty、iTerm2、终端主题文件）

这些文件的共同特点：分布在各目录下、体积小、不常变更、变更时需要精确控制同步方向。

## 使用说明

### 添加文件
1. 点击「添加」或将文件拖入窗口，选择本地文件（单文件 ≤ 10 MB）
2. 可选填写备注，便于识别
3. 添加后点击「上传」完成首次同步

### 设置本地目录
状态为「未关联目录」时，点击「目录」选择文件夹。同一文件在不同设备上可以指向不同的本地路径，例如 A 设备在 `~/.config/app/settings.json`，B 设备可以在 `D:\config\settings.json`。

### 同步操作

| 操作 | 说明 |
|---|---|
| 上传 | 用本地内容覆盖共享后端 |
| 下载 | 从共享后端拉取覆盖本地 |
| 同步全部 | 一键检查所有文件，按修改时间自动判断方向 |
| 自动同步 | 开启后每 60 秒自动执行 |

### 删除
删除同步记录会清理远端内容，本地文件不受影响。

## 存储后端

### WebDAV
支持任何标准 WebDAV 服务（如坚果云）。配置信息仅保存在本地 uTools 数据库中。

## 限制

- 单文件上限：10 MB
- 文件数量上限：30 个
- 自动同步间隔：60 秒