4.3 KiB
4.3 KiB
文件上传(选择器 / 拖拽 / 粘贴)
前端上传只有一个落点: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()的失败分支),内容不丢。