# 制造业算法开发与模型管理平台 V1.0 功能清单

> 文档定位：定义 V1.0 应提供的页面、区域、字段、操作、结果和业务限制。
>
> 本文件按用户任务组织，不使用工作簿功能编号，也不按按钮数量衡量完成度。一个功能只有在入口、字段、规则、结果、异常和权限均成立时才算完成。
>
> 阅读建议：产品和设计人员可先看第 1 节的页面共性，再按左侧模块直接定位第 2-7 节；第 8-9 节用于原型验收和定稿核对，不必顺序通读。全流程入口见 [00-V1.0快速阅读指南](00-V1.0快速阅读指南.md)。

## 1. 全局页面能力

### 1.1 导航与身份

- 一级导航只展示数据管理、模型训练、模型评测、模型管理、模型广场和系统管理。
- 当前用户只能看到已授权模块。
- 页面顶部显示当前用户、当前角色职责、消息提示和退出入口。
- 不展示工作台、算法开发、数据加工标注、资源中心等非 V1.0 入口。

### 1.2 列表页

所有业务列表应统一支持：

- 关键词和业务条件组合筛选。
- 查询、重置、刷新、分页和排序。
- 加载中、空结果、无权限、加载失败四类状态。
- 点击名称或编号进入详情，返回后保留原筛选、分页和排序。
- 展示对象编号、名称、版本、负责人、状态、创建时间和更新时间中的适用字段。
- 状态未知或获取失败时不得展示为正常。

### 1.3 详情页

所有对象详情应按适用情况提供：

- 基本信息。
- 当前状态与状态更新时间。
- 文件、版本或配置快照。
- 上游来源和下游引用。
- 执行结果、失败原因和处理建议。
- 业务操作记录和关键审计记录。
- 有权限的关联对象跳转。

### 1.4 表单

- 必填项、格式、唯一性、对象权限、版本状态和兼容性均由后端校验。
- 保存草稿和提交执行必须是两个明确动作。
- 校验失败定位到具体字段或关联对象，并保留用户输入。
- 重复提交不得生成多个等价业务对象。
- 已提交或冻结对象不可原地修改。

### 1.5 长任务

- 提交成功后展示任务编号、当前阶段、进度、开始时间和最近更新时间。
- 支持查看日志、失败阶段、错误代码、错误原因和处理建议。
- 刷新或离开后重新进入，仍可恢复任务状态。
- 重试创建新任务并关联原任务，不覆盖原日志和结果。

## 2. 数据管理

### 2.1 数据集管理

#### 查询区

可按名称、数据类型、工业场景、制造对象、负责人、用途、状态和更新时间筛选。

#### 列表区

展示数据集名称、数据类型、业务分类、负责人、当前基线版本、版本数量、质量状态、启停状态和更新时间。

#### 新建与编辑

| 类别 | 内容 |
|---|---|
| 字段 | 名称、数据类型、业务用途、来源说明、工业场景、工厂、产线、设备、负责人、保留说明 |
| 新建结果 | 生成数据集草稿和唯一数据集编号 |
| 可编辑 | 草稿名称和说明；正式数据集的用途、负责人、分类和保留说明 |
| 不可编辑 | 已有正式版本的数据类型；冻结版本内容 |
| 删除 | 仅允许删除没有版本和下游引用的草稿 |
| 停用 | 停止新任务选择，展示影响对象，保留历史引用 |
| 恢复 | 重新检查来源、版本和权限后恢复 |

#### 详情

展示基本信息、模板绑定、数据版本、来源批次、质量结论、切分结果、训练基线、下游任务和变更记录。

### 2.2 上传后字段模板

V1.0 暂不提供独立的数据模板维护入口。模板必须以实际上传数据为依据，在解析完成后由用户确认生成；生成后作为本批次和后续质检、冻结的不可变模板快照。

| 功能 | 说明 |
|---|---|
| 上传后识别 | 解析文件头、实际字段、样本数量和基础类型，生成待确认字段清单 |
| 字段确认 | 用户选择纳入模板的字段，并确认字段类型、必填/可选和字段用途（主键、时间、特征、标签、主文件等） |
| 生成模板快照 | 确认后生成模板编号、版本和字段快照，绑定当前导入批次 |
| 质量校验 | 后续字段完整性、类型和必填校验均使用该批次模板快照 |
| 历史引用 | 已被质检或数据版本引用的模板快照保持不变；字段变化需在新批次重新上传并生成新快照 |

业务分类由数据集维护，不重复存放在模板中。

### 2.3 数据接入

#### 本地文件接入

| 阶段 | 配置或结果 | V1.0 行为 |
|---|---|---|
| 选择文件 | 目标数据集、CSV/JSON文件列表、批次说明 | 仅从用户本机选择文件，不创建数据源连接 |
| 上传校验 | 文件数、单文件大小、批次总量、格式、完整性 | 单文件不超过2GB；单批次不超过20GB或10000个文件 |
| 大文件上传 | 分片号、上传进度、续传位置 | 超过10MB按16MB分片，支持断点续传 |
| 字段识别 | 文件头、前2MB且最多200条样本 | 只用于识别候选字段，不代表全量解析或质检完成 |
| 模板确认 | 纳入字段、类型、必填性、用途 | 生成本批次不可变模板快照 |
| 后台处理 | 全量解析、全量模板校验、问题明细 | 完成后生成待处理快照并开放质量检查 |

V1.0不提供数据库、SQL、REST API、MQTT、远程连接测试、凭证管理、定时采集或持续同步。

#### 导入批次

表单先填写目标数据集、批次名称和说明，再选择本地文件；上传完成后进入“抽样识别 → 字段确认 → 生成模板快照 → 后台全量解析与模板校验”步骤，不要求提前选择模板。

支持：

- 保存和编辑未提交批次草稿。
- 复制批次配置，但不复制文件或执行结果。
- 提交本地文件上传。
- 查看文件分片上传、字段识别、全量解析和模板校验进度。
- 查看处理中、成功、部分失败、失败和空批次结果。
- 查看文件清单、校验和、问题明细和待处理数据快照。
- 在解析结果中选择字段、字段类型、必填性和字段用途，确认后生成模板快照。

导入成功不直接生成冻结数据版本。

### 2.4 外部已标注媒体导入

| 数据类型 | 必备材料 | 预览 | 阻断条件 |
|---|---|---|---|
| 图片 | 图片、标签文件或样本清单 | 缩略图、尺寸、格式、标签 | 文件与标签无法对应、格式不支持、文件损坏 |
| 音频 | 音频、标签文件或样本清单 | 时长、采样信息、格式、标签 | 文件与标签无法对应、格式不支持、文件损坏 |
| 视频 | 视频、标签文件或样本清单 | 时长、基础信息、缩略信息、标签 | 文件与标签无法对应、格式不支持、文件损坏 |

一次批次只导入一种数据类型。V1.0 不提供标注编辑器，标签问题应在外部修正后重新导入。

### 2.5 数据质量

#### 质量规则

字段包括规则名称、适用数据类型、完整性、唯一性、范围、格式、时间连续性、标签覆盖、问题级别和适用范围。

支持保存草稿、校验、发布规则版本、复制和查看变更记录。被任务引用的规则版本只读。

#### 质量任务

配置待处理数据快照、模板版本、质量规则快照和执行环境。结果展示：

- 执行状态和进度。
- 检查范围和样本数量。
- 通过项、阻断项、警告项。
- 问题样本和定位信息。
- 质量结论和报告下载。
- 数据快照指纹、模板版本和规则版本。

只有规则明确允许的风险才能成为警告。警告放行需填写原因，记录确认人和时间。

### 2.6 数据版本

#### 冻结

冻结页面展示来源批次、待处理快照、模板、样本清单、数据指纹、解析结果、质量报告和警告确认记录。

只有以下条件全部满足时可冻结：

- 解析完成。
- 模板校验无阻断。
- 质量检查无阻断。
- 警告处理完整。
- 样本清单和指纹完整。

冻结成功生成版本号和不可变快照。失败不生成正式版本。

#### 版本列表与详情

支持按版本号、状态、模板、质量结论和时间筛选。详情展示：

- 版本号、样本数、字段或媒体信息。
- 模板快照、质量报告和数据指纹。
- 来源批次和文件清单。
- 样本预览和标签分布。
- 训练基线状态。
- 切片和下游引用。

#### 修订版（冻结后修正）

冻结版本内容与指纹不可修改。冻结后发现错标、坏样本或缺失数据时，通过"修订版"承接修正需求，原地修改一律禁止。

入口与流程：

- 已冻结版本的详情和版本列表提供"创建修订版"入口。
- 系统以源版本为基础生成派生批次，自动带入模板快照和样本清单。
- 用户在派生批次中执行剔除样本、替换文件、补充增量数据操作，并填写修订原因。
- 修订版必须重新执行质量检查和冻结门禁，通过后生成新版本号（建议采用修订号，如 v1.2 的修订记为 v1.2.1）和新指纹。

规则：

- 源版本保持已冻结状态不变，下游引用和切片不迁移、不自动更新。
- 修订版详情展示来源版本、修订原因、变更明细（剔除、替换、新增的样本清单）和血缘关系。
- 修订原因、操作人和时间写入业务操作记录和操作审计。
- 修订版生成后同样不可修改；再次修正须创建新的修订版。
- 已被下游引用的源版本不得删除；仅当某版本无任何下游引用时才允许归档隐藏。
- 修订版若需成为训练基线，按训练基线规则单独设置并填写原因，不自动更换。

### 2.7 训练基线

- 展示可设为基线的冻结、可用且无质量阻断的数据版本。
- 设置时填写原因。
- 新基线只影响后续新建任务，不改写历史任务。
- 展示历次基线、操作人、时间和原因。

### 2.8 数据切分

#### 配置

选择冻结数据版本，选择时间、比例或同源分组方式，填写适用的边界、比例、随机种子和分组键。

#### 结果

展示来源版本、训练集、验证集、测试集的切片标识、样本数、比例、边界、样本清单和互斥检查结果。

#### 规则

- 比例必须合法且集合互斥。
- 同一原始样本及其派生样本不得跨训练集合和独立测试集合。
- 按时间切分要求选择模板中的时间字段；允许同一设备跨时间段出现，但不允许原始样本、派生样本或内容指纹跨集合。
- 按同源分组切分要求选择模板中声明的设备、批次或工件分组键，同一分组只能进入一个集合。
- 按时间、比例、同源分组三种方式互斥；历史摘要切分只保留旧任务查看，不进入新训练选择器。
- 切片生成后不可修改。
- 训练内部测试切片不自动视为正式独立评测数据。
- 正式评测仍需执行训练数据与测试数据的独立性检查。

### 2.9 训练前数据可用性检查

选择冻结数据版本、切片和冻结算法包版本，检查：

- 数据类型和算法输入类型。
- 字段、媒体和标签结构。
- 样本数量和切片完整性。
- 算法包输入声明和运行环境。

结果绑定本次数据版本、切片和算法包组合。任一版本变化后需重新检查。

## 3. 模型训练

### 3.1 训练实验列表

按实验名称、算法包版本、数据版本、负责人、状态、创建时间和训练结果筛选。

列表展示实验编号、名称、输入版本、当前任务版本、资源状态、执行状态、结果和更新时间。

详情展示实验说明、固定输入、任务版本、参数差异、资源申请、执行记录、结果和关联权重。

### 3.2 创建训练实验

| 区域 | 字段或功能 |
|---|---|
| 基本信息 | 实验名称、说明、负责人 |
| 输入 | 冻结算法包版本、冻结数据版本、训练和验证切片 |
| 环境 | 标准运行环境、框架和依赖检查结果 |
| 参数 | 算法包声明的参数、类型、范围、随机种子 |
| 资源 | 单机 CPU/GPU 标准规格、预计使用时长、申请原因 |
| 提交检查 | 权限、版本、输入契约、参数、环境、资源和输出目录 |

保存只形成草稿。提交成功生成不可变任务快照；调整参数时复制为新任务版本。

资源申请先绑定实验草稿及配置修订号。自动审批通过后执行最终提交检查，提交时创建训练任务并绑定申请；任务创建后才关联实际资源。评测和部署沿用同一时序。

### 3.3 算力申请

#### 页面展示

- 当前部署环境可申请的单机 CPU/GPU 标准规格。
- 规格名称、CPU、内存、GPU 类型与显存等已配置属性。
- 关联训练实验和任务。
- 预计使用时长与申请原因。
- 自动审批结果和时间。
- 执行资源状态、最近更新时间和未就绪原因。

#### 禁止项

- 不展示服务器、节点或资源池供申请人选择。
- 不提供人工审批人、审批意见、驳回、退回、续期或释放。
- 不提供资源管理员处理入口。
- 不将自动审批通过显示为已分配或已就绪。

#### 状态

`实验草稿 → 申请已绑定 → 系统自动审批通过 → 任务已创建/待资源 → 已就绪`

异常分支为校验失败、提交失败、资源不足、环境异常、状态未知或资源失效。校验失败不生成“审批通过”记录。

### 3.4 训练执行

#### 状态与操作

| 状态 | 可用操作 |
|---|---|
| 待资源 | 查看申请和未就绪原因 |
| 排队中 | 查看排队信息、取消排队 |
| 运行中 | 查看日志和指标、请求停止 |
| 停止中 | 查看停止进度，不重复提交停止 |
| 成功 | 查看结果、确认产物 |
| 失败 | 查看失败原因、复制后重新发起 |
| 已停止 | 查看日志和已有产物、复制后重新发起 |

V1.0 不提供暂停和恢复。

#### 详情

展示提交、排队、启动、停止、失败、完成和产物登记事件；支持日志级别、时间和关键词筛选。

### 3.5 训练监控

- 指标卡展示当前值、最佳值、训练轮次和更新时间。
- 曲线支持选择指标、时间或轮次范围。
- 同一实验的不同任务版本可进行指标对比。
- 指标可以导出，导出记录操作人和时间。
- 日志与指标读取失败时保留现有视图并显示数据可能过期。

### 3.6 训练结果

列表按结论、权重状态、负责人和时间筛选。详情展示：

- 训练执行结论。
- 配置快照。
- 指标和曲线。
- 日志和报告。
- 权重、依赖和其他产物。
- 产物完整性状态。
- 结果确认和保留状态。

操作包括确认结果、保留产物、删除未保留且未引用的临时产物、对登记失败或历史缺失执行补偿登记，以及从已登记权重进入评测。训练成功且产物完整时由系统自动登记，人工确认不应延迟自动登记。

训练成功、产物完整、权重登记成功分别显示。

## 4. 模型评测

### 4.1 评测任务列表

按权重版本、评测类型、负责人、状态、结论和时间筛选。

列表展示任务编号、权重、测试数据、规则、资源、执行状态、技术结论和更新时间。

### 4.2 创建评测任务

| 区域 | 字段或功能 |
|---|---|
| 评测对象 | 冻结权重版本、来源类型、产物完整性 |
| 测试数据 | 冻结测试数据版本或切片、样本范围 |
| 评测规则 | 适用规则快照、指标、阈值、方向、有效期 |
| 环境 | 隔离环境、框架和依赖 |
| 资源 | 单机 CPU/GPU 标准规格、自动审批和就绪状态 |
| 提交检查 | 权限、版本、独立性、规则、环境和资源 |

### 4.3 测试数据独立性

展示：

- 权重来源训练任务及实际训练样本范围。
- 本次测试数据范围。
- 原始样本、内容指纹、派生样本和同源分组检查。
- 重叠数量、泄漏类型和问题明细。
- 通过或阻断结论。

检查不通过时禁止提交评测任务。外部权重无法提供训练样本清单时，展示外部来源证明和风险，不生成虚构平台训练信息。

### 4.4 评测规则

规则列表支持按名称、适用任务、状态和有效期筛选。

规则详情展示指标、计算口径、方向、阈值、适用范围、报告有效期和版本记录。

创建或编辑规则先形成草稿；被任务引用后形成固定快照，历史任务不受后续修改影响。

### 4.5 技术评测

#### 技术指标

配置本次执行环境和资源，提交后展示进度、日志、原始指标、阈值、方向和逐项达标结果。

#### 样例推理与边界验证

展示输入样例、预期说明、实际输出、可视化结果、错误和边界结论。样例结果绑定权重和环境。

#### 稳定性、性能和资源

展示运行条件、运行次数、成功率、耗时统计、资源观测和异常。具体指标不写死，由规则和执行环境确定。

三类评测均支持查看失败原因、下载结果和基于原配置创建重试任务。

### 4.6 评测报告与结论

报告包含：

- 权重版本及来源。
- 测试数据版本、切片和独立性结果。
- 规则快照。
- 环境和资源。
- 技术指标、样例、稳定性和资源结果。
- 技术通过或不通过结论。
- 报告生成时间和有效期。

不通过时展示具体原因和返回优化入口。重新评测生成新任务和新报告，不覆盖历史。

## 5. 模型管理

### 5.1 模型库

#### 查询与列表

按名称、工业场景、算法类型、业务问题、负责人、来源类型、评测状态和发布状态筛选。

列表展示模型名称、用途、负责人、最新算法包版本、最新权重版本、评测状态、发布方式和更新时间。

#### 模型基本信息

维护名称、用途、业务问题、工业场景、适用范围、已知限制、负责人和使用说明。

模型资产可以在算法包完整校验通过时创建，也可以在导入外部权重时创建。评测通过不是创建模型资产的前置条件。

### 5.2 算法包上传与校验

| 阶段 | 页面内容 | 成功结果 | 失败结果 |
|---|---|---|---|
| 上传草稿 | 包文件、名称、版本说明 | 草稿和文件标识 | 保留输入和上传失败原因 |
| 基础校验 | 格式、大小、压缩、目录、入口、校验和 | 允许维护运行声明 | 报告缺失项，阻断完整校验 |
| 运行声明 | 训练和推理入口、输入输出、语言框架、依赖、最小样例 | 完整声明快照 | 定位缺失字段 |
| 完整校验 | 依赖解析、入口加载、契约、兼容性、安全、最小执行 | 创建或关联模型资产，登记冻结算法包版本 | 保留报告，允许上传新草稿 |

算法包源代码不进入模型广场公开下载范围。

### 5.3 模型版本

#### 平台训练权重

从训练结果登记，自动带入数据版本、切片、算法包、训练任务、参数、环境、权重文件和校验和。

#### 外部权重

填写外部来源、提供者、原始标识、说明、权重、推理入口、输入输出、框架、依赖、环境和最小加载样例。

外部权重显示“外部来源”，不要求也不生成平台训练编号。

#### 详情

展示版本、来源、文件、依赖、完整性、训练或外部来源链、评测报告、准入状态、发布记录和下载记录。

### 5.4 产物完整性和来源追溯

- 校验文件存在、校验和、格式、依赖、入口和运行材料。
- 平台训练权重展示数据、算法包、训练任务和权重链。
- 外部权重展示提供者、原始标识、来源证明、文件和运行材料。
- 来源材料缺失时明确标记并阻断发布，不伪造完整链。

### 5.5 推理冒烟

选择冻结权重、发布方式、运行产物、环境和输入样例。

结果展示加载、初始化、最小推理、接口契约、输出结构、耗时和错误。文件摘要或发布方式变化后原结果失效。

### 5.6 发布管理

#### 准入复核

逐项展示权重冻结、产物完整、技术评测、报告有效性、数据独立性、推理冒烟、模型说明和文件摘要一致性。

#### 发布申请

只有全部阻断项通过后才可提交。申请固定：

- 权重版本。
- 发布方式。
- 文件和产物摘要。
- 评测报告。
- 冒烟结果。
- 适用范围、限制和展示材料。
- 申请人和申请时间。

#### 发布审批

审批页展示全部固定证据，支持通过或拒绝。拒绝必须填写原因。普通账号的申请、审批、执行三主体两两不同；有效 Admin 可兼任，但不得绕过账号有效性、准入、冒烟、固定快照和审计。

#### 发布执行

审批通过后才显示执行入口。执行前重新校验快照；任何关键内容变化都应阻断并要求重新申请。

### 5.7 下载型发布

在发布申请前配置模型名称、用途、适用场景、运行环境、依赖、限制、使用示例和下载产物；以上内容纳入审批快照，审批后只读，修改须重新申请。

发布成功展示发布记录、版本和下载状态。支持下线和基于当前材料重新申请发布。

下线后关闭新增下载，不删除历史发布和下载记录。

### 5.8 API 服务资源申请

配置服务场景、单实例标准 CPU/GPU 规格、预计期限和原因。

提交后系统自动审批，分别展示：

- 申请快照。
- 自动审批方式和时间。
- 执行资源关联结果。
- 就绪、等待、异常、失效或未知状态。

不提供人工资源审批和分配页面。

### 5.9 服务部署

| 区域 | 内容 |
|---|---|
| 基本信息 | 服务名称、说明、负责人 |
| 模型 | 获批的冻结权重版本和产物摘要 |
| 资源 | 一种单机标准规格；部署启动前由执行端确认实际资源就绪 |
| 接口 | 同步/异步 REST JSON 路径、请求标识、查询路径、输入输出与幂等规则 |
| 健康检查 | 检查路径、成功条件、超时配置 |
| 执行 | 保存配置、校验、启动、取消待执行、查看进度日志、失败重试 |

部署成功后执行健康验证。只有健康通过并复核审批快照后才能发布服务。

### 5.10 API 服务

#### 服务详情

展示服务地址、当前权重版本、资源状态、部署状态、健康状态、发布状态、负责人和更新时间。

#### 生命周期

| 动作 | 条件 | 结果 |
|---|---|---|
| 发布 | 审批、部署、健康和资源均有效 | 开放调用入口 |
| 停止 | 当前服务已发布且有权限 | 拒绝新调用，保留实例和历史 |
| 恢复 | 原权重、资源和健康仍有效 | 恢复调用 |
| 下线 | 确认影响后执行 | 关闭入口、停止实例、撤下广场使用方式 |

V1.0 下线不触发资源释放。

### 5.11 API 输入输出和在线测试

- 接口文档展示参数名、类型、必填、限制、示例和错误。
- 结构化输入直接使用 JSON。
- 媒体先上传形成受控文件标识，再在推理请求中引用。
- 文件标识校验调用方、服务、有效期和文件状态。
- 在线测试使用当前用户的有效授权或受控测试权限。
- 展示请求摘要、响应、耗时、错误和请求编号。
- 不接受任意路径或外部网址。

### 5.12 调用授权和 API Key

模型广场只负责提交和查看申请，在线服务详情负责审批、授权、Key 和调用日志，二者共用同一组申请、授权和服务对象，不维护重复数据。

申请包含应用名称、应用标识、负责人、申请人、工厂、产线/设备、用途、服务及模型版本、授权期限、提交时间和申请状态。申请人可查看本人申请、审批结果和拒绝原因。

审批列表展示申请编号、申请人、应用/负责人、服务版本、工厂/产线、用途、授权期限、提交时间和状态。模型运营人员或 Admin 可通过或拒绝；拒绝原因必填。重复或并发审批只允许首个合法决定生效。

审批通过后在同一一致性操作中创建调用授权，但不自动签发 Key。授权包含授权编号、来源申请、应用、负责人、工厂、产线/设备、用途、服务及模型版本、生效日、到期日、运行保护、审批人、审批时间和授权状态。

授权期限支持1至3650天、1至120个月或1至10年，审批当天生效并由系统计算到期日。扩大范围或延长期限必须重新审批；缩小范围、缩短期限或调整运行保护按权限维护并留痕。

Key 规则：

- 仅对有效授权单独生成，不在审批通过时自动生成。
- 创建成功后明文只显示一次。
- 页面关闭后不可再次查看。
- 仅存不可逆摘要。
- 停用可恢复。
- 重生成使旧 Key 立即失效，不延长授权期限，也不清空累计调用统计。
- 吊销不可逆。

每次进入网关的调用均生成日志。调用列表按应用、服务、权重版本、时间和结果筛选，展示授权范围、Key脱敏标识、耗时、错误和请求编号，敏感输入脱敏；最终成功只计入一次成功调用统计。

### 5.13 模型安全

- 展示文件传输、存储和访问限制状态。
- 算法包和模型文件执行安全扫描。
- 拒绝路径穿越、超限解压和不支持类型。
- 扫描未完成或失败时不得进入执行或发布。
- 文件访问和下载写入审计。
- 正式或被引用文件不得按未经确认的到期策略自动清理。

## 6. 模型广场

### 6.1 搜索与列表

按名称、工业场景、算法类型、业务问题和发布方式筛选，只返回当前有效发布记录。

列表展示模型名称、用途摘要、适用场景、限制、发布版本、发布方式和评测结论。

### 6.2 模型详情

展示：

- 模型介绍、适用范围和已知限制。
- 当前发布版本和发布时间。
- 评测结论、报告来源、时间和有效状态。
- 下载或 API 使用方式。
- 运行环境、依赖、输入输出和使用示例。

评测事实必须与当前发布权重一致。

### 6.3 下载

下载前校验用户模块权限、发布状态和文件状态。成功后记录下载人、模型版本、文件和时间。

### 6.4 API 使用入口

展示服务状态、接口说明和调用授权申请入口。授权处理和 Key 管理在模型管理中完成，广场不维护第二套授权数据。

## 7. 系统管理

### 7.1 登录

- 账号密码登录。
- 会话保持和主动登出。
- 失败原因使用安全文案，不泄露账号是否存在等敏感信息。
- 达到配置的连续失败阈值后临时锁定。
- 停用、过期和锁定账号禁止登录。

### 7.2 用户管理

查询条件包括账号、姓名、联系方式、状态和有效期。

支持创建、编辑、批量导入、启用、停用、密码重置、解除临时锁定和查看变更记录。

密码重置只处理认证凭证，不展示或校验模型版本、资源占用等无关信息。

### 7.3 角色与权限

角色字段包括名称、职责说明、关联用户、一级模块权限和有效状态。

支持新建、编辑、复制和查看变更记录。复制角色不自动复制用户绑定。

不出现租户、组织、部门、数据范围、对象或按钮级权限配置。

### 7.4 日志

#### 登录日志

按用户、时间、来源地址、客户端、登录方式和结果查询，支持详情和导出。

#### 操作审计

按用户、角色、模块、对象、动作、结果和时间查询，详情展示请求编号、操作上下文、前后状态摘要和失败原因。

日志只读。导出需权限且导出行为写入审计。

## 8. 原型验收清单

每个页面交付原型时必须检查：

- 页面属于 V1.0 范围，没有未来能力入口。
- 角色和模块权限与业务职责一致。
- 字段、按钮、状态和提示与本清单一致。
- 主链路可以通过相对链接连续完成。
- 保存、提交、确认、审批、发布和下线有真实交互反馈。
- 资源申请没有人工审批或节点分配入口。
- 发布申请位于评测和冒烟之后。
- 列表、详情、表单、空态、失败态和阻断态均有展示。
- 自动带入的版本和快照字段明确只读。
- 原型示例数据不被写成固定产品规则。

## 9. 定稿补充与验收口径

- 跨模块选择器仅返回有权只读引用且状态有效的对象，引用不继承写入、下载或导出权限。
- 数据版本必须由用户明确选择批次或快照组成；新增批次不自动追加，补传材料按样本标识和文件指纹去重，冲突阻断。
- 待资源任务支持取消；资源等待超时、停止确认超时和状态未知必须有明确出口。
- 外部权重独立性检查区分通过、重叠/泄漏、证据不足；证据不足默认阻断正式评测和发布。
- 评测、冒烟或安全证据过期后，发布记录关闭新增下载、调用授权和服务恢复。
- API 页面必须区分运行保护与调用统计：展示速率、并发、输入大小和时长等保护规则，持续记录每次调用及累计成功次数，不展示商业套餐额度，也不按调用次数扣减授权。

## 10. 算法项目、外部权重与训练版本补充规则

### 10.1 对象边界

- 算法项目是可执行代码及运行声明的版本化载体，至少保存项目编号、项目版本、代码包版本、框架、入口、依赖、校验结果和可训练标识；它不是模型版本。
- 模型版本是可推理或可评测的权重版本。训练成功后由平台根据训练快照自动登记新的模型版本；外部权重登记后形成外部来源模型版本候选。
- 项目、代码包、外部权重、训练实验、训练任务和模型版本均独立编号。任何历史版本不得被同名上传、训练完成或微调结果覆盖。

### 10.2 两条训练路径

| 路径 | 训练前必须固定的输入 | 产出与关系 | 禁止规则 |
|---|---|---|---|
| 从算法项目训练 | 已冻结且可训练的算法项目版本、代码包版本、冻结数据版本与同一切分任务的训练/验证切片、环境、参数、资源规格、新输出模型版本 | 训练成功后自动登记输出模型版本，并关联项目、任务、数据、参数和运行快照 | 不选择父模型或基础模型；不得覆盖已有模型版本 |
| 基于已有模型微调 | 上述项目和数据输入，以及已通过微调能力校验的外部权重版本 | 输出新模型版本，记录外部权重为父版本，形成不可变谱系 | 未通过校验、已失败或仅具推理能力的外部权重不得选择；输出版本不得等于父版本 |

### 10.3 外部权重登记与校验

- V1.0仅支持本地上传，常用框架限定为 `PyTorch`、`Transformers`、`TensorFlow`；权重文件限定为 `.pkl`、`.pth`、`.h5`，且文件后缀必须与选择的框架匹配。
- 单个外部权重文件的产品上限为20GB。浏览器仅负责文件选择与上传进度展示，不读取完整文件到浏览器内存；分片、留存、完整摘要与上传回执由文件服务实现。当前静态页面只保存候选元数据，没有上传文件。
- 登记候选时保存版本、来源、提供方、原始标识、来源证明、框架及版本、运行材料、基线评估、文件名和文件大小；完整文件校验和由文件服务生成，绑定文件标识与版本后才能登记正式能力。
- 本地登记只形成“待上传校验”的外部权重候选，不形成可推理模型版本。文件服务完成上传并生成摘要，安全扫描及隔离执行端推理入口试运行通过后，才可标为“可推理”；再完成格式、加载入口、运行依赖和基础权重契约校验后，才可标为“可用于微调”。任一校验失败时保留失败原因且不得进入微调选择器。
- 原型中的上传回执、能力校验和训练完成回执均为本地模拟，不构成真实文件服务、真实执行器或真实算力验收。

### 10.4 训练前分阶段参数配置

训练实验创建页采用“先确定输入，再配置训练”的分阶段流程，参考 LLaMA-Factory 将训练方式、模型/数据、预处理、训练参数、评估和输出分组的交互思想，但不引入语言模型专属字段、Token 计费或商业额度。

| 阶段 | 必填或关键内容 | 保存规则 |
|---|---|---|
| 1. 训练方式 | 项目训练或基于外部权重微调、实验名称、任务类型 | 项目训练不得携带父模型；微调必须选择已通过微调能力校验的外部权重 |
| 2. 模型与数据 | 冻结算法项目/代码包、框架、冻结数据版本、切分任务、训练/验证切片、数据模板快照、标签字段 | 项目、数据、模板和切片均以版本或快照引用，不允许提交后漂移 |
| 3. 预处理与参数 | 预处理方案、归一化、时序窗口/步长、参数预设、算法包声明的核心参数和扩展参数 | 参数控件由 `paramSchema` 动态生成；平台校验类型、必填、范围并生成参数哈希 |
| 4. 评估与输出 | 主评估指标、评估频率、最佳模型选择、早停策略、输出模型版本、产物目录 | 指标只能来自算法包声明；输出目录只读；训练成功后自动登记模型版本 |
| 5. 资源与检查 | 运行环境、标准 CPU/GPU 规格、申请原因、提交前检查 | 资源由系统自动审批，资源就绪与任务启动分开展示；任一阻断项保留草稿 |

保存草稿不会创建训练任务。提交时把上述字段、数据证据、父模型关系、环境和参数哈希全部写入不可变训练任务快照；后续修改只能复制为新草稿。