第一次提交

docs/superpowers/specs/2026-07-10-dataset-task-mock-data-design.md

@@ -0,0 +1,58 @@
+# 数据集管理“数据任务”Mock 数据设计
+
+## 目标
+
+让数据集管理页的“数据任务”页签展示可用于界面演示的任务产出数据，
+同时保持“本地上传”页签、数据集预览和下载入口的现有行为。
+
+## 现状
+
+- 数据集列表统一从 `mockDatasets` 获取。
+- “本地上传”页签当前展示全部数据集。
+- “数据任务”页签固定返回空数组，因此始终为空。
+- 数据集详情、预览和下载均基于同一套 Mock 数据接口。
+
+## 方案比较
+
+1. 为数据集增加来源字段并统一过滤（采用）。单一数据源，页签语义清晰，
+   新增的任务数据可继续复用详情、预览和下载接口。
+2. 在列表页内单独维护任务数据。改动较少，但会形成第二份数据源，详情接口
+   无法自然找到这些记录。
+3. 从数据处理任务动态生成数据集。数据关联更强，但需要重构任务 Mock 数据，
+   超出本次只增加演示数据的范围。
+
+## 数据设计
+
+- 在 `DatasetItem` 中增加可选来源字段 `source`，取值为 `upload` 或 `task`。
+- 现有 6 条 Mock 数据明确标记为 `upload`。
+- 新增 4 条来源为 `task` 的 Mock 数据，覆盖训练集、评测集等类型，包含名称、
+  存储位置、大小、条数、描述和创建时间。
+- 新记录使用不重复的 ID，并保留现有 Mock 适配器的统一查询路径。
+
+## 页面行为
+
+- “本地上传”仅展示 `source !== 'task'` 的数据，兼容后端暂未返回来源字段的情况。
+- “数据任务”仅展示 `source === 'task'` 的数据。
+- 搜索、分页、预览、下载和删除按钮保持现有行为。
+- 切换页签后，公共列表组件会在数据变化时回到第一页并清空选中状态。
+
+## 异常与边界
+
+- 未携带 `source` 的真实接口数据默认归入“本地上传”，避免升级期间数据消失。
+- 任务数据 ID 不与现有数据冲突，详情查询仍能返回对应记录。
+- 本次不新增依赖，不修改后端接口，不实现真实的数据任务关联。
+
+## 验证
+
+- 先添加一个能验证来源字段和页签过滤规则的回归检查，再实现变更。
+- 运行项目类型检查与生产构建；若存在仓库原有错误，需确认本次改动文件没有
+  引入新的错误。
+- 启动页面后检查两个页签：本地上传显示 6 条，数据任务显示 4 条，任务数据可被
+  搜索且表格字段完整。
+
+## 验收标准
+
+1. “数据任务”页签展示 4 条假数据。
+2. “本地上传”页签不混入任务生成的数据。
+3. 两个页签的搜索、分页和操作列正常显示。
+4. 新增类型定义与 Mock 数据通过针对性回归检查。