# Changelog — 推送页暂存文件管理

**日期**：2026-06-07

## 摘要

推送页在上传 ZIP/普通文件后展示**暂存文件列表**，支持浏览子目录、预览、重命名、删除；复用已有 `/api/sync/browse-local`、`local-file-ops`、`local-file-preview`。

## 动机

上传后仅显示摘要，无法查看/调整暂存目录内容；后端 Round2 已实现 staging API，SPA 未接入。

## 涉及文件

- `frontend/src/composables/push/usePushStaging.ts` — 浏览/预览/重命名/删除
- `frontend/src/components/push/PushStagingPanel.vue` — 文件列表与操作对话框
- `frontend/src/components/push/PushStagingPreviewDialog.vue` — 文本/二进制预览
- `frontend/src/composables/push/usePushPage.ts` — 编排
- `frontend/src/pages/PushPage.vue` — 上传后展示管理面板
- `frontend/src/components/push/PushZipUpload.vue` — 提示文案

## 迁移 / 重启

- 仅前端；`vite build` 后部署 `web/app/`

## 验证

```bash
cd frontend && npm run build
# 推送页上传文件 → 出现「暂存文件」表格 → 预览/重命名/删除/进入子目录
```

## 行为

- 仅 **上传暂存**（`/tmp/nexus_upload_*`）显示管理面板；「验证路径」的主机目录不在此管理（安全沙箱限制）
- **普通文件上传**（`/sync/upload-files`）不限制后缀，`.zip` 等按原文件写入暂存；需解压时用「ZIP 解压上传」
- 预览：≤1MB 文件，最多 4KB 内容
- 删除/重命名后刷新列表并更新顶部文件数/大小
- **批量删除**：勾选多项 →「删除选中」；表头全选当前目录