断点续传依赖服务端提供/upload/status接口返回已传切片索引，前端用file.slice(start, math.min(file.size, start + shardsize))正确切片，以md5计算fileid并校验合并完整性。
断点续传不是靠浏览器自动恢复连接，而是前端主动跳过已传切片——前提是服务端提供 /upload/status 接口返回已传索引，且你用对了 File.slice() 边界。
File.slice() 切片必须用 end = file.size，不能写 start + shardSize
末尾切片最容易丢数据：如果文件大小是 10.3MB，按 2MB 分片，Math.ceil(10.3 * 1024 * 1024 / (2 * 1024 * 1024)) 得到 6 片；但若第 5 片用 file.slice(10 * 1024 * 1024, 12 * 1024 * 1024)，就会越界、漏掉最后 300KB。
-
file.slice(start, end)的end是「不包含」的，所以最后一片必须显式设为file.size - 错误写法：
file.slice(lastStart, lastStart + shardSize)—— 可能lastStart + shardSize > file.size - 正确写法：
const end = Math.min(file.size, start + shardSize)或直接file.slice(start, file.size) - 切片数必须用
Math.ceil(file.size / shardSize)，不是Math.floor，否则少算一片
文件唯一 ID 必须基于内容计算 MD5，不能拼接文件名+大小
用户反复保存同名文件、不同设备导出相同尺寸截图，都会导致 fileName + size 冲突。服务端一旦把两个不同文件当成同一个上传任务，就会覆盖或合并错乱。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 前端用
spark-md5（非逐片拼接）计算整个文件的 hash，作为fileId - 上传前先发 GET 请求：
/upload/status?fileId=xxx，服务端返回类似{uploadedChunks: [0,1,3]} -
localStorage存键也必须是这个fileId，不是fileName + size - 隐私模式下
localStorage可能不可写，需加 try/catch 并降级为内存缓存
FormData 分片上传不能塞整块大 Blob，2–5MB/片是安全上限
单片超过 10MB，Chrome 构造 FormData 时可能触发 RangeError: Maximum call stack size exceeded，Firefox 也会明显卡顿；更大的风险是 JS 引擎把整个 Blob 加载进内存，导致页面假死。
- 推荐分片大小：
2 * 1024 * 1024（2MB）到5 * 1024 * 1024（5MB） - 每片必须带字段：
chunkIndex、totalChunks、fileId（服务端靠这三者定位和幂等写入） - 不要用
URL.createObjectURL()，它不自动释放内存；保持对原始File对象的弱引用即可 - 服务端必须支持任意顺序接收、按
chunkIndex写临时文件、合并前校验完整性和顺序
断点能力本质在服务端，前端只负责重试和跳过
前端看到 HTTP 200 不代表切片真落盘成功——Nginx 可能缓存了响应，后端写磁盘失败却没暴露错误。真正决定能否续传的，是服务端是否提供幂等的切片接收、可查询的状态接口、以及健壮的合并校验逻辑。
- 必须确认服务端有
/upload/status?fileId=xxx接口，且返回已传chunkIndex列表 - 服务端写切片时，应先检查
uploadId/chunkIndex是否已存在，避免重复写入 - 合并完成后，必须用
md5或sha256校验最终文件与原始文件一致 - 前端
XMLHttpRequest.upload.onprogress只反映浏览器发出速度，不是服务端接收完成时间，别拿它当最终进度依据
最常被忽略的一点：服务端没实现状态查询和幂等写入，前端切片逻辑再严密也没用。上线前务必用网络中断+刷新页面+重复上传同一文件验证服务端行为。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
