# 2026-06-01 文件管理页迭代 v2

## 日期
2026-06-01

## 变更摘要
`#/files` 第二轮迭代：修复下载、预览对话框、URL 状态、筛选/拖拽上传、符号链接展示。

## 动机
- 下载 API 返回二进制流，原 `http.post` JSON 解析导致「下载已开始」但实际失败
- 预览用 snackbar 无法阅读；刷新丢失当前路径
- 对标历史 file-manager v2 规划中的状态栏、拖拽、筛选能力

## 涉及文件
- `frontend/src/api/index.ts` — `fetchAuthed` / `http.download`
- `frontend/src/utils/fileDownload.ts` — 浏览器保存 Blob
- `frontend/src/pages/FilesPage.vue` — UI/交互迭代
- `frontend/src/utils/remotePath.ts` — `validatePathSegment`
- `frontend/src/utils/fileBrowse.ts` / `types/api.ts` — symlink
- `server/api/sync_v2.py` — browse 返回 `symlink` + `link_target`
- `docs/design/plans/2026-06-01-files-page-iteration.md`

## 迁移 / 重启
- 前端构建部署至 `web/app/`
- 后端 `sync_v2.py` 需部署并 `supervisorctl restart nexus`（symlink 字段）

## 追加（默认路径）
- 文件管理器初始/切换服务器时默认打开 `/www/wwwroot`（`DEFAULT_FILES_ROOT`）

## 追加（交互）
- 进入目录/符号链接：单击行即可（不再要求双击）
- 普通文件：双击行打开 Monaco 编辑

## 验证方式
1. 选服务器进入子目录，URL 含 `?server_id=&path=`，刷新后位置保持
2. 双击目录进入；面包屑/上级可用
3. 下载文件可本地打开
4. 查看文本文件弹出预览对话框
5. 拖拽文件到列表区域触发上传
6. 筛选框过滤当前目录文件名