62 lines
4.3 KiB
Markdown
62 lines
4.3 KiB
Markdown
# 文件上传(选择器 / 拖拽 / 粘贴)
|
||
|
||
前端上传只有一个落点:`app/server/public/js/files.js` 的 `uploadFilesNow(files)`。
|
||
文件选择器和拖拽 drop 都只负责凑出 `File[]`,之后的大图压缩询问、大文件确认、
|
||
自动建档、逐卡进度、上传与刷新文件面板全部共用同一条链路。
|
||
|
||
## 入口
|
||
|
||
| 入口 | 位置 | 说明 |
|
||
|---|---|---|
|
||
| 回形针按钮 / 面板上传图标 | `#file-input` 的 `change` | 选中后快照 `input.files` → `uploadFilesNow` |
|
||
| 拖拽文件到页面任意位置 | `window` 的 `drop` | 从 `dataTransfer` 同步取 `File[]` → `uploadFilesNow` |
|
||
| 粘贴超长文本 | `#msg-input` 的 `paste` | 包成 `File` 放进 `state.attachments`,发送时随消息上传 |
|
||
|
||
发布时 `send()` 会把已成功卡片的 `dataset.name` 拼成「用户上传了文件:…」告知行;
|
||
卡片名以服务端返回的 `uploaded[].filename` 为准(重名时后端会加 `-1`/`-2`)。
|
||
|
||
## 拖拽实现要点
|
||
|
||
- **监听在 `window` 上**,不是某个 dropZone。文件落到输入框、文件面板、抽屉上时,
|
||
没有处理的 `drop` 会让浏览器导航去打开该文件,当前草稿和正在流式的回合都会丢。
|
||
- **只认带 `Files` 的拖拽**:拖动页面内选中的文字同样触发 `dragenter`,不判断会误弹遮罩。
|
||
- `dragover` 必须 `preventDefault()`,否则 `drop` 不触发;同时设 `dropEffect = 'copy'`。
|
||
- 遮罩 `#drop-overlay` 是 `pointer-events: none` 的固定层,不参与命中测试,drop 仍由 window 接管。
|
||
- `dragenter` / `dragleave` 在子元素间移动会成对冒泡到 window,用 150ms 兜底定时器收尾;
|
||
`relatedTarget === null`(拖出窗口)直接收干净。
|
||
- **不支持拖入目录**:目录在 `dataTransfer.files` 里是 0 字节条目,直接传会落一个空文件。
|
||
实现用 `webkitGetAsEntry().isDirectory` 识别并跳过,有文件时提示「暂不支持拖入文件夹,已忽略」。
|
||
- 触屏设备没有 drag 事件,遮罩只在真实拖拽时出现,不影响移动端布局。
|
||
- 并发批次(上一次还在传又拖入一批)共用一个总进度条:各批登记 `{loaded,total}`,
|
||
绘制时求和,最后一批结束后才收起。
|
||
|
||
## 后端约束(前端已对齐)
|
||
|
||
- 单文件硬限 50MB(`routes/files.js` 的 `multer.limits.filesize`),超限在预处理阶段直接拒掉。
|
||
- 大于 `upload.confirm_size_mb`(默认 10MB)先二次确认;大图大于
|
||
`upload.image_compress_threshold_kb`(默认 1536KB)走本地 canvas 压缩询问。
|
||
- 每个文件一个 XHR 请求,所以即时上传路径不会撞上 `upload.array('files', 10)` 的上限;
|
||
发送时随消息上传的附件是「一个请求带多个文件」,`uploadFiles()` 会按 10 个一批切分。
|
||
- 落盘名经 `sanitizeName` 清洗,重名自动追加序号;前端把响应里的真实文件名回写到卡片,
|
||
避免告知行指向同名的旧文件。
|
||
|
||
## 已知限制
|
||
|
||
- 一次拖入多张大图时,`prepareUploadFile` 会逐张弹压缩确认(串行,不做批量合并)。
|
||
- 拖拽期间会立刻 `ensureSession()` 建档(与回形针一致),即使用户随后放弃上传;
|
||
全部文件被放弃时不会建档。
|
||
|
||
## 长文本粘贴转文件
|
||
|
||
在 `#msg-input` 上监听 `paste`(不挂 `document`,避免劫持搜索框等输入):
|
||
|
||
- 剪贴板文本 trim 后超过 `upload.paste_to_file_threshold_chars`(默认 2000 字符,`0` 关闭)时
|
||
`preventDefault()`,用 `new File([原始文本], 'pasted-text-<时间戳>.txt')` 构造附件。
|
||
阈值判断用 trim 后的长度,写入必须用原始文本(保留首尾空白与行尾)。
|
||
- 附件进入 `state.attachments`,**不提前建档、不落盘**,chip 可随时撤掉;发送时才随消息上传。
|
||
- 剪贴板同时有文件时:文本超阈值则文本转 txt(保住内容),另外只补非图片文件;
|
||
文本很短时保持默认粘贴,剪贴板里的截图/文件另行挂成附件;纯文件则拦掉文件名插入。
|
||
- 发送约束:`send()` 允许「只有附件」的消息,告知行合并已上传卡片与本条附件(用服务端返回的
|
||
真实文件名);纯附件发送时标题退回粘贴文本的前 24 字。
|
||
- 上传/发送失败时附件会被还原回 chip(`send()` 的失败分支),内容不丢。
|