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

数据集管理“数据任务”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 数据通过针对性回归检查。