upload-sdk

一个基于 Web Worker 和 RPC (远程过程调用) 架构的高性能大文件切片上传 SDK。

它将繁重的计算（Hash 计算）和 I/O 操作（并发请求）完全隔离在 Worker 线程中，确保主线程 UI 零卡顿。同时，独创的 RPC 机制让开发者能在 React 组件中通过 Hooks 完全接管上传的每一个生命周期。

✨ 特性

- 🚀 极致性能：采用 Off-Main-Thread 架构，Hash 计算、切片处理、网络请求全量移交 Web Worker，彻底告别页面假死。
- 🔗 RPC 驱动：逻辑定义在主线程（可无缝访问组件 State/Store/Router），具体执行在 Worker 线程，兼顾灵活性与性能。
- 💾 内存友好：基于流式处理（Stream）和零拷贝引用机制，稳定支持 10GB+ 超大文件上传，拒绝浏览器崩溃。
- ⚡️ 高效并发：内置智能并发控制队列，自动管理切片上传顺序与重试机制，最大化利用网络带宽。
- 🛡️ 业务级风控：新增 validateResponse 钩子，支持细粒度的业务逻辑校验（如拦截 Token 过期、权限不足），将 HTTP 200 中的业务错误通过标准 Error 抛出。
- 🎨 全链路 Hooks：提供完善的生命周期钩子，执行流为 Hash -> Init -> Check -> Upload -> Merge，支持异步 await 阻塞控制。

📦 安装

``bash [npm]
npm i @ql-frontend/upload-sdk@latest
``

使用参考内外文档