Nexus/docs/changelog/2026-06-07-push-staging-file-manager.md

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/

验证

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

行为

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