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