WorkBuddy大文件上传需分片与断点续传：一、CLI启用--enable-resume参数；二、前端切片+后端幂等校验；三、服务端暴露状态接口供前端精准续传；四、Workerman流式解析分片防溢出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy上传大文件时遭遇网络中断、进程崩溃或长时间传输失败，则可能是由于单次上传缺乏分片切分与断点状态追踪机制。以下是实现大文件分片上传与断点续传的多种可落地逻辑路径：
一、基于WorkBuddy内置断点续传参数的轻量级启用方式
WorkBuddy客户端支持通过命令行参数直接激活断点续传能力，适用于已部署标准安装包且具备本地缓存目录结构的场景。该方式不依赖额外服务端开发，仅需正确构造迁移/上传指令并确保临时日志可写。
1、确认WorkBuddy CLI工具已加入系统PATH，执行workbuddy --version验证可用性。
2、将待上传文件置于本地可读路径，例如D:\uploads\large_data.zip。
3、在终端中执行带断点续传标志的上传指令：workbuddy upload --file "D:\uploads\large_data.zip" --enable-resume --log-dir "D:\wb_logs"。
4、若中途中断，再次执行相同指令即可自动识别已上传块并跳过重复传输。
二、前端分片+后端幂等校验的完整闭环方案
该方法要求改造WorkBuddy Web界面或集成其SDK，通过前端JavaScript控制切片、携带元数据，并由后端按fileId隔离存储与校验，确保并发安全与数据完整性。
1、前端调用File.slice()对原始文件按2–5 MB固定大小切分，生成Blob数组。
2、为每个分片构造请求体，必须包含：filename、fileId（UUID或文件MD5前16位）、chunkIndex、totalChunks、md5（整个分片内容的MD5）。
3、后端接收请求时，先查询Redis中是否存在{fileId}:{chunkIndex}键，若存在则直接返回200跳过写入。
4、校验请求头Content-MD5与服务端流式计算结果是否一致，不一致则返回400并丢弃该分片。
5、将合法分片写入路径/upload/chunks/{fileId}/{chunkIndex}，使用Files.copy(inputStream, path, StandardCopyOption.REPLACE_EXISTING)保证原子写入。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、服务端驱动的状态感知型断点续传流程
此方法以服务端为主导，通过独立状态接口暴露已上传分片索引，使前端能精准定位缺失块，避免盲目重试，适合跨设备、多会话协同上传场景。
1、上传前，前端发起GET请求：GET /api/upload/status?uploadId=up_1715829341_abcd。
2、服务端从Redis或数据库中检索该uploadId对应记录，返回JSON格式状态：{"uploadedChunks": [0,1,3,4], "totalChunks": 12}。
3、前端比对全量索引[0,1,...,11]与uploadedChunks，得出缺失列表[2,5,6,7,8,9,10,11]。
4、从前端localStorage读取上次缓存的missingIndices，若为空则以本次计算结果为准；否则取交集缩小重传范围。
5、按序发起最多3个并发上传请求，每个请求携带对应chunkIndex及完整元数据。
四、WorkBuddy与Workerman混合架构下的流式分片接收策略
当WorkBuddy作为调度前端，后端采用Workerman构建高性能接收服务时，需绕过PHP传统上传限制，采用手动解析multipart边界的方式流式处理分片，防止内存溢出与超时中断。
1、Workerman监听HTTP端口，禁用$_FILES自动解析，改用php://input原始流读取。
2、从前端请求中提取boundary字符串，逐行扫描定位Content-Disposition字段，识别当前分片所属fileId与chunkIndex。
3、截取payload部分，直接写入临时文件/tmp/chunks/{fileId}/{chunkIndex}，不经过内存缓冲。
4、写入完成后立即计算该文件MD5并与请求中chunk-md5头比对，失败则删除临时文件并返回错误。
5、所有分片上传完成后，触发合并任务：按chunkIndex升序读取各块，用NIO流式拼接至目标路径，并执行最终SHA256校验。
