# 2026-06-07 — 文件页上传 FormData 字段名修复

## 摘要

修复文件管理页 `POST /api/sync/upload`：前端发 `files`，后端只读 `file`，导致「请选择要上传的文件」。

## 变更

| 文件 | 说明 |
|------|------|
| `server/api/sync_v2.py` | 接受 `file` / `files`；支持多文件；抽取 `_sftp_upload_one` |
| `frontend/src/composables/files/useFilesActions.ts` | FormData 字段改为 `file` |
| `tests/test_sync_upload_form.py` | 字段解析单测 |

## 迁移 / 重启

需重启 API；前端需 vite build 后部署（仅后端修复亦可兼容旧前端）。

## 验证

```bash
pytest tests/test_sync_upload_form.py -q
# 文件页 server_id=1 → 上传小文件 → 列表刷新可见
```
