feat(upload): add multipart uploader with resumable chunked transfer#577
Open
thetapilla wants to merge 3 commits into
Open
feat(upload): add multipart uploader with resumable chunked transfer#577thetapilla wants to merge 3 commits into
thetapilla wants to merge 3 commits into
Conversation
- Add a chunked resumable uploader driving /api/fs/multipart with three concurrent ascending chunk requests - Resume interrupted sessions transparently from init's received ranges and fall back to Stream for single-chunk files - Treat flow control (429/409) and transient network errors as retryable, probing session status before declaring failure - Stop sending remaining chunks once the server reports the session completed (rapid upload) - Register the uploader gated by the multipart_enabled public setting
- Add a Retry button on failed rows that reuses the kept File handle, resuming multipart uploads from the breakpoint - Disable "add as task" while the multipart uploader is selected, since sessions are synchronous pipelines
25 tasks
- Report progress and speed from a high-water mark: a chunk rejected by flow control or a network hiccup drops its in-flight bytes from the running sum until it is resent, which made the displayed speed go negative and the progress bar jump backwards - Rejected chunks now show as a progress plateau with speed falling to zero
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary / 摘要
为上传界面新增 Multipart 上传方式（配套后端分块上传 API），解决经 CDN 反代（如 Cloudflare 免费计划 100MB 请求体上限）时网页端无法上传大文件的问题。
用户可感知的变化：
Multipart选项（由后端multipart_enabled公共设置门控，后端未启用或版本过旧时不显示，自动向后兼容）实现要点：
src/pages/home/uploads/multipart.ts：3 并发升序分片调度；init 返回的已收区间直接驱动续传；秒传完成信号使剩余分片停发兼容性说明：不改变既有 Stream / Form / HTTP Direct 上传方式的任何行为（对现有代码的修改均以"选中 Multipart"为条件门控）；重试按钮对所有上传方式的失败行生效（非 multipart 方式点击重试等效于重新上传该文件）。
/ 此 PR 包含破坏性变更。
/ 此 PR 修改了公开 API、配置、存储格式或迁移行为。
/ 此 PR 需要关联仓库同步修改。
Related repository PRs / 关联仓库 PR:
Related Issues / 关联 Issue
Relates to OpenListTeam/OpenList#460
Testing / 测试
测试平台：macOS arm64，Node 26 / pnpm 11。
go test ./...不适用前端仓
自动化检查：
pnpm build构建通过pnpm lint（tsc）：本 PR 未引入任何新类型错误（仓库现存 4 个与本 PR 无关的既有错误，干净分支上同样存在）浏览器手动验证（对接本地后端配套分支联调）：
multipart_enabled后下拉框不再显示 Multipart 选项Checklist / 检查清单
/ 我已阅读 CONTRIBUTING。
/ 我确认此贡献符合仓库许可证、贡献规范和行为准则。
gofmt,go fmt, orprettierwhere applicable./ 我已按适用情况使用
gofmt、go fmt或prettier格式化变更代码。/ 我已在适用情况下请求相关维护者或代码所有者审查。
AI Disclosure / AI 使用声明
/ 此 PR 包含 AI 辅助内容。
Tools used / 使用工具:
Usage scope / 使用范围:
Code generation / 代码生成
Refactoring / 重构
Documentation / 文档
Tests / 测试
Translation / 翻译
Review assistance / 审查辅助
I have reviewed and validated all AI-assisted content included in this PR.
/ 我已审核并验证此 PR 中的所有 AI 辅助内容。
I have ensured that all AI-assisted commits include
Co-Authored-Byattribution./ 我已确保所有 AI 辅助提交都包含
Co-Authored-By归属信息。I can reproduce all AI-assisted content included in this PR without any AI tools.
/ 我可以在没有任何 AI 工具的情况下重现此 PR 中包含的所有 AI 辅助内容。