BoxPlayer v5.0.21

BoxPlayer v5.0.21 Release Notes

发布日期 / Release date: 2026-08-18

中文

启动更快、更稳定

• 主窗口会优先显示；账号资料、传输任务、缓存统计、WebDAV 与更新检查改在后台恢复，避免慢速网盘阻塞进入文件列表。
• 上传与下载 Worker 改为按需启动，并会补发 Worker 就绪前积压的消息。
• 非首屏页面和预览组件按需加载，降低启动阶段的渲染与内存开销。
• 百度网盘用户信息与文件列表加入超时保护，异常账号不会长期卡住启动。

网盘浏览与扫描

• 文件列表触底续页、视频扫描、音乐扫描和书籍刮削共享同一套分页状态机：统一 cursor、结束条件和跨页去重。
• 重复 cursor 会安全停止，防止无限请求；续页失败可再次触发重试。
• Box、Dropbox 后台扫描不再额外补全缩略图，减少大目录扫描的 API 压力。
• 阿里云盘目录扫描统一限速，降低 TooManyRequests 风险。
• 修复 123 云盘根目录及分页目录加载，文件与子文件夹不会只显示首页或被误报为不存在。

搜索与能力边界

• 阿里云盘全盘搜索会正确携带备份盘、资源盘和相册的所选范围。
• 不支持全盘搜索的网盘会隐藏对应入口；直接调用时也会给出明确提示。
• 后台媒体获取任务延后启动，避免与账号、网盘首次加载争用网络和 CPU。

文件关联

• 系统“打开方式”仅注册应用实际支持的电子书和漫画格式。

验证

CI=true pnpm exec vue-tsc --noEmit
pnpm exec vitest run src/utils/__tests__/providerPagination.test.ts src/cloud123/__tests__/dirfilelist.test.ts

类型检查与 17 个相关回归测试均已通过。受限运行环境可能输出 Vite WebSocket EPERM 警告，不影响测试结果。

---

English

Faster, more reliable startup

• The main window appears first. Account refresh, transfers, storage statistics, WebDAV, and update checks now recover in the background so a slow provider cannot block file browsing.
• Upload and download workers start on demand and replay messages queued before the worker is ready.
• Non-critical pages and preview components are lazy-loaded to reduce startup rendering and memory cost.
• Baidu Pan account and directory calls have timeout protection, preventing a stalled account from holding up startup.

Drive browsing and scanning

• File-list infinite scroll, video scanning, music scanning, and book scraping share one pagination state machine: the same cursor handling, completion rule, and cross-page deduplication.
• Repeated cursors stop safely to prevent infinite requests, and failed continuation requests can be retried.
• Background Box and Dropbox scans skip thumbnail hydration to reduce API pressure in large folders.
• Aliyun directory scans use shared throttling to reduce TooManyRequests errors.
• Fixed 123 Pan root and paginated directory loading so files and subfolders are not limited to the first page or falsely reported as missing.

Search and capability boundaries

• Aliyun global search correctly carries selected backup, resource, and album drive scopes.
• Providers without global search hide the entry point and return a clear message when called directly.
• Media-acquisition background work starts later to avoid competing with initial account and drive loading.

File associations

• System “Open with” registration now includes only e-book and comic formats supported by the app.

Verification

CI=true pnpm exec vue-tsc --noEmit
pnpm exec vitest run src/utils/__tests__/providerPagination.test.ts src/cloud123/__tests__/dirfilelist.test.ts

Type checking and 17 related regression tests passed. A Vite WebSocket EPERM warning can appear in restricted environments and does not affect the result.