diff --git a/docs/superpowers/specs/2026-07-10-dataset-preview-header-actions-removal-design.md b/docs/superpowers/specs/2026-07-10-dataset-preview-header-actions-removal-design.md new file mode 100644 index 0000000..154a8c8 --- /dev/null +++ b/docs/superpowers/specs/2026-07-10-dataset-preview-header-actions-removal-design.md @@ -0,0 +1,35 @@ +# 数据预览详情页头部操作移除设计 + +## 目标 + +移除数据预览详情页右上角的“打包下载”“删除”“返回”三个按钮, +让该页面仅承担数据集文件与内容预览职责。 + +## 范围 + +- 删除 `DatasetPreviewView.vue` 的页头额外操作区域及其三个按钮。 +- 删除仅被这三个按钮使用的整包下载、删除和路由返回逻辑及依赖。 +- 保留文件列表中的单文件“预览”和“下载”操作。 +- 保留数据集信息、文件列表与内容预览区域。 + +## 方案比较 + +1. 直接删除页面头部按钮和失效逻辑(采用):无隐藏交互与无用依赖,页面职责清晰。 +2. 使用 CSS 隐藏按钮:按钮逻辑仍留在页面中,键盘和后续维护可能误暴露功能。 +3. 增加运行时开关:为固定的展示要求引入无必要状态和分支。 + +## 实现设计 + +- 移除 `PageCard` 的 `extra` 插槽。 +- 从组件中移除 `useRouter`、`ElMessage`、`ElMessageBox`、`deleteDataset`、 + `downloadDatasetUrl` 及对应处理函数。 +- 保留 `handleDownloadFile` 与 `downloadFileUrl`,确保文件级下载仍可用。 +- 新增回归检查,断言详情页不再含这三个页头按钮或其对应处理函数, + 并断言文件级预览、下载操作仍存在。 + +## 验收标准 + +1. 数据预览详情页不显示“打包下载”“删除”“返回”按钮。 +2. 文件列表中的“预览”和“下载”按钮继续显示并可用。 +3. 页面不保留已删除头部操作的事件处理函数与未使用依赖。 +4. 针对性回归检查和生产构建通过。