37 lines
1.1 KiB
Markdown
37 lines
1.1 KiB
Markdown
|
# 文件管理：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 提示无法编辑/查看
|