Nexus/docs/changelog/2026-06-01-files-300k-preload.md

文件管理：300KB 预加载与编辑上限

日期：2026-06-01

摘要

进入目录后，对 ≤300KB 的普通文件在后台并发预读；双击编辑/查看时优先使用内存缓存。超过 300KB 的文件在客户端直接提示，不再发起 read-file。

动机

用户要求「文件要预加载 300K」，减少双击打开编辑器时的等待，并统一浏览器内可读文件大小上限。

涉及文件

• frontend/src/utils/filePreload.ts（新建）
• frontend/src/pages/FilesPage.vue

行为说明

项	值
预加载/编辑上限	300 × 1024 字节
每目录最多预加载文件数	40
并发预读	4
read-file 请求	显式传 max_size: 307200

迁移 / 重启

• 仅前端构建部署，无需数据库迁移
• 后端 read-file 仍支持至 5MB（schema 未改），由前端限制传参

验证

1. 进入含小文件的目录，状态栏显示「N 个 ≤300KB 可预加载」
2. 稍等后双击小文件，编辑器应更快打开（Network 无重复 read-file）
3. 双击 >300KB 文件应 toast 提示无法编辑/查看