# 制造业算法开发与模型管理平台 V2.0 完整产品需求文档

> 版本：V2.0-R5 | 更新日期：2026-09-24 | 文档状态：开发级产品基线
>
> 本文件由 `tools/generate_v2_docs.py` 自动生成。V2.0 是在 V1.0-R5 上的增量升级：继承 511 条 V1.0 能力，并新增 660 条 V2.0 能力，生效范围共 1171 条；一期 V1.0 文档和清单不在本目录中被修改。

## 0. 文档信息

| 项目 | 内容 |
|---|---|
| 产品名称 | 制造业算法开发与模型管理平台 |
| 产品版本 | V2.0 |
| 产品规则基线 | V2.0-R5 |
| V1.0 继承功能 | 511 条，基线 `V1.0-R5` |
| V2.0 新增功能 | 660 条唯一新增功能 |
| V2.0 生效范围 | 1171 条 |
| 业务域 | 工作台、数据管理、算法开发、模型训练、模型评测、模型管理、模型广场、系统管理 |
| 权威功能源 | V1.0：`../../docs/11-V1.0文档追踪与配置基线.md`；V2.0 增量：`../source/V2.0-功能清单-只读副本.xlsx` 的 V2.0 行 |
| 详细分册 | 00-19 号文档及 review 材料 |

## 1. 产品定义

V2.0 是面向制造业持续算法研发与模型运营的平台版本。它继承 V1.0 的版本、状态、权限、审批、审计和真实状态边界，新增从数据生产到算法开发、业务确认、模型迭代和高级发布运营的完整能力。

## 2. V2.0新增功能分布

| 模块 | 功能数 |
|---|---:|
| 工作台 | 44 |
| 数据管理 | 144 |
| 算法开发 | 224 |
| 模型训练 | 57 |
| 模型评测 | 33 |
| 模型管理 | 125 |
| 模型广场 | 23 |
| 系统管理 | 10 |

## 3. 产品原则

1. 工作台聚合，不复制业务处理。
2. 数据、代码、环境、模型、服务和反馈均以版本或状态对象管理。
3. 技术评测、业务确认、发布审批、部署健康和流量切换分别表达。
4. 反馈、回流、重试、回滚和重新训练均保留历史并建立来源关系。
5. 任何未知状态不得沿用旧成功状态，任何静态模拟不得替代真实环境证据。

## 4. V2.0核心闭环

### 4.1 数据生产

数据源或文件进入同步/导入任务，经数据加工、字段映射、标注作业、复核验收、质量巡检、元数据和标准治理后，生成有血缘、有质量结论、可供训练和评测引用的数据版本。

### 4.2 算法研发

算法资产、组件、代码、环境、参数和数据绑定进入开发工作区。算法工程师可通过文件树创建和切换文件，在代码编辑器中修改并保存代码修订，选择环境与样本运行当前文件、执行测试并查看终端输出；运行尝试、测试报告和环境快照分别留痕。完成调试、流程编排、回归测试、版本冻结和训练交接完整性检查后，生成可供训练直接引用的算法版本与交接包。

### 4.3 模型迭代

训练和评测形成技术证据，业务确认形成使用证据；反馈和回流样本可进入新的迭代计划、数据版本、算法版本和训练实验。新模型版本不得覆盖历史版本。

### 4.4 算法资产与模型管理边界

算法开发负责源码、组件、输入输出与参数契约、依赖、环境、工作区、流程、算法版本和训练交接包；模型管理负责模型资产容器、平台训练产物登记、外部权重导入、模型版本追溯、适配量化、评测引用和发布。模型库不再上传或冻结算法包，也不直接发起训练。平台训练模型版本必须回溯到算法版本、交接包、训练任务和产物；外部权重版本必须保存来源证明、校验和与运行材料。

### 4.5 高级发布

发布申请绑定模型、评测、业务确认、产物和策略快照，经审批后执行下载、API、多实例、灰度或蓝绿发布。部署、健康、实例、流量和业务服务状态独立维护，失败时可按有效历史发布执行回滚。

## 5. 核心链路详细设计

# 制造业算法开发与模型管理平台 V2.0 核心链路详细设计

> 版本：V2.0-R5；核心链路 8 条；本文件覆盖 660 条 V2.0 新增功能，并继承 511 条 V1.0-R5 能力。
> 本文定义跨模块执行语义；功能字段、逐条规则、逻辑接口和对象关系分别见 06、07、08、10、12、15、16 号文档。物理服务地址、数据库实现和厂商适配由研发设计并在联调后回填证据。

## 1. 通用执行契约

- 写操作必须携带请求编号、幂等键、对象编号、修订号、当前账号和原因（适用时）。
- 同一对象的业务状态、任务状态、资源状态、健康状态、审批状态和流量状态分开持久化。
- 任何跨模块引用都绑定固定版本和摘要；输入变化使检查、确认或审批失效。
- 任务、事件和回调均需幂等；迟到或乱序事件只能留痕，不得覆盖更新状态。

## 2. 链路总览

| 链路 | 名称 | 主要模块 | 结果 |
|---|---|---|---|
| V2-CL-01 | 工作台聚合与来源处理 | 工作台 | 待办、消息、异常、个人资产和生命周期只聚合并跳转，不复制源模块动作。 |
| V2-CL-02 | 数据生产与治理 | 数据管理 | 数据接入/加工 → 标注 → 复核/验收 → 质检 → 数据版本和治理。 |
| V2-CL-03 | 算法研发与训练交接 | 算法开发 | 算法资产 → 工作区 → 代码编写/运行/测试 → 流程编排 → 调试 → 冻结 → 训练交接。 |
| V2-CL-04 | 训练监控与实验分析 | 模型训练 | 训练实验 → 资源与执行 → 日志指标 → 诊断 → 产物确认 → 实验比较。 |
| V2-CL-05 | 技术评测与业务确认 | 模型评测 | 独立性检查 → 技术评测与报告 → 业务样例确认 → 独立结论 → 发布准入。 |
| V2-CL-06 | 反馈回流与模型迭代 | 模型管理 | 使用反馈 → 调用样本提取 → 脱敏/去重/确认 → 标注质检 → 新版本与模型迭代。 |
| V2-CL-07 | 高级发布与服务治理 | 模型管理 | 审批快照 → 多实例部署 → 灰度/蓝绿 → 健康与流量 → 全量、暂停、回滚或下线。 |
| V2-CL-08 | 模型广场使用与运营 | 模型广场 | 检索/收藏 → 下载或调用 → 用量和反馈 → 业务确认与回流。 |

<a id="v2-cl-01"></a>
## V2-CL-01 工作台聚合与来源处理

**范围：** 待办、消息、异常、个人资产和生命周期只聚合并跳转，不复制源模块动作。

### 输入与门禁

- 用户必须拥有 工作台 模块权限和目标对象范围。
- 每条记录同时通过来源模块权限与来源对象范围过滤。
- 来源事项提供稳定编号、来源状态、更新时间和目标页面。
- 所有写操作重新校验状态版本、固定快照、职责和幂等键。

### 处理步骤

1. 读取各来源模块的待办、消息、异常和资产投影。
2. 逐条执行权限过滤，以来源事项编号去重并保留最后更新时间。
3. 点击事项携带来源编号和筛选上下文跳转，由来源模块重新鉴权。
4. 来源状态变化后刷新投影，工作台不反向写入来源状态。

### 异常与补偿

- 单一来源超时只标记该来源不可用，不沿用旧状态冒充最新结果。
- 来源对象失效或权限撤销时移除操作入口并保留必要审计。
- 重试、重新确认、回流和回滚均创建关联新记录，不覆盖历史事实。
- 关键动作记录操作者、前后状态、固定快照、原因、结果和证据。

### 验收重点

- 验证 跨模块权限过滤、来源去重、更新时间、跳转上下文和无业务写入。
- 逐条验收键见 [09-V2.0验收用例](09-V2.0验收用例.md)，功能逻辑见 [10-V2.0逻辑文档](10-V2.0逻辑文档.md)。

<a id="v2-cl-02"></a>
## V2-CL-02 数据生产与治理

**范围：** 数据接入/加工 → 标注 → 复核/验收 → 质检 → 数据版本和治理。

### 输入与门禁

- 用户必须拥有 数据管理 模块权限和目标对象范围。
- 候选样本批次、标签体系、标注模板、人员职责和质量规则固定版本。
- 标注人与复核人普通账号不得相同；样本按数据和字段权限展示。
- 所有写操作重新校验状态版本、固定快照、职责和幂等键。

### 处理步骤

1. 数据接入或加工形成不可变候选样本批次，记录来源与内容指纹。
2. 创建标注任务并固定样本清单，按样本分配给有效标注人。
3. 标注人领取样本锁并提交；复核人通过或退回，退回项进入重标。
4. 任务满足终态完整、抽检率、通过率和一致性阈值后签署验收。
5. 仅将标注验收和质检通过样本生成新数据版本并登记血缘。

### 异常与补偿

- 样本锁冲突或过期时拒绝提交；部分处理保留逐样本结果。
- 标签体系变化或质检阻断时不得冻结版本，整改必须新建修订。
- 重试、重新确认、回流和回滚均创建关联新记录，不覆盖历史事实。
- 关键动作记录操作者、前后状态、固定快照、原因、结果和证据。

### 验收重点

- 验证 任务与样本双状态机、锁冲突、职责分离、退回重标、质量门禁和版本来源。
- 逐条验收键见 [09-V2.0验收用例](09-V2.0验收用例.md)，功能逻辑见 [10-V2.0逻辑文档](10-V2.0逻辑文档.md)。

<a id="v2-cl-03"></a>
## V2-CL-03 算法研发与训练交接

**范围：** 算法资产 → 工作区 → 代码编写/运行/测试 → 流程编排 → 调试 → 冻结 → 训练交接。

### 输入与门禁

- 用户必须拥有 算法开发 模块权限和目标对象范围。
- 代码文件已保存为代码修订，运行和测试绑定环境快照、样本、入口和资源配置。
- 代码、组件、环境、参数、数据、节点端口和脚本规则均有固定版本。
- 执行前通过DAG无环、端口兼容、参数完整、资源和环境检查。
- 所有写操作重新校验状态版本、固定快照、职责和幂等键。

### 处理步骤

1. 在开发工作区通过文件树创建或打开文件，编辑代码并保存为不可覆盖的代码修订。
2. 选择环境快照、样本和运行入口执行当前文件与测试集，分别保存运行尝试、测试报告、日志和失败原因。
3. 编辑流程草稿，节点引用固定组件，连线校验方向、类型和结构版本。
4. 保存新修订；冻结时固化DAG、节点、端口、参数、环境和缓存摘要。
5. 按依赖调度节点，每个节点建立尝试并记录日志、指标和中间产物。
6. 缓存仅在输入、组件、参数和环境摘要一致且条目有效时命中。
7. 节点重试确认旧尝试结束，只重跑目标和受影响下游；通过后在算法开发内冻结算法版本并生成训练交接包。

### 异常与补偿

- 未保存修改、越权路径、非白名单终端命令、环境未就绪或测试失败时保留编辑内容和执行证据，不伪造成功。
- 环路、悬空端口或类型不兼容时定位到节点和连线并保留画布。
- 缓存污染、节点超时和迟到回调不得覆盖新尝试或流程终态。
- 重试、重新确认、回流和回滚均创建关联新记录，不覆盖历史事实。
- 关键动作记录操作者、前后状态、固定快照、原因、结果和证据。

### 验收重点

- 验证 代码编辑/保存/运行/测试、环境快照、受控终端、节点端口契约、DAG无环、缓存键、节点尝试、中间产物和最小范围重试。
- 逐条验收键见 [09-V2.0验收用例](09-V2.0验收用例.md)，功能逻辑见 [10-V2.0逻辑文档](10-V2.0逻辑文档.md)。

<a id="v2-cl-04"></a>
## V2-CL-04 训练监控与实验分析

**范围：** 训练实验 → 资源与执行 → 日志指标 → 诊断 → 产物确认 → 实验比较。

### 输入与门禁

- 用户必须拥有 模型训练 模块权限和目标对象范围。
- 训练引用冻结数据、算法交接包、环境、参数和资源申请快照。
- 资源真实就绪，旧尝试确认结束后才允许关联重试。
- 所有写操作重新校验状态版本、固定快照、职责和幂等键。

### 处理步骤

1. 实验草稿通过检查后创建训练任务并等待资源。
2. 任务进入排队、准备和运行，记录执行端心跳与资源状态。
3. 采集日志、指标、检查点和资源用量，缺失范围单独标记。
4. 执行终态与产物完整性分别确认，完整后从训练结果登记到模型资产下形成模型版本。
5. 实验比较固定指标口径和基线，不改写原训练事实。

### 异常与补偿

- 执行端失联保留最后确认状态并标记观测未知，禁止直接重跑。
- 停止与完成竞态按执行证据裁决，迟到事件不能复活终态。
- 重试、重新确认、回流和回滚均创建关联新记录，不覆盖历史事实。
- 关键动作记录操作者、前后状态、固定快照、原因、结果和证据。

### 验收重点

- 验证 资源、执行、观测、产物和分析结论分离，以及停止、失联和重试边界。
- 逐条验收键见 [09-V2.0验收用例](09-V2.0验收用例.md)，功能逻辑见 [10-V2.0逻辑文档](10-V2.0逻辑文档.md)。

<a id="v2-cl-05"></a>
## V2-CL-05 技术评测与业务确认

**范围：** 独立性检查 → 技术评测与报告 → 业务样例确认 → 独立结论 → 发布准入。

### 输入与门禁

- 用户必须拥有 模型评测 模块权限和目标对象范围。
- 冻结模型、独立测试数据、技术规则、隔离环境和资源固定且独立性通过。
- 业务确认引用有效技术报告、固定样例集和达标规则，由业务职责签署。
- 所有写操作重新校验状态版本、固定快照、职责和幂等键。

### 处理步骤

1. 执行技术评测子任务，分别保存执行结果、原始指标和规则判定。
2. 必需证据完整后生成技术通过、不通过或未知结论及只读报告。
3. 基于同一模型快照创建业务确认，逐样例记录预期、实际结果和问题。
4. 业务确认人签署通过、退回或阻断，不修改技术结论。
5. 技术与业务均通过且证据有效时满足发布准入；摘要变化使准入失效。

### 异常与补偿

- 执行成功但指标不达标时记录技术不通过，不能写成执行失败。
- 样例不足、职责冲突或报告失效时业务确认不得通过，重确认另建记录。
- 重试、重新确认、回流和回滚均创建关联新记录，不覆盖历史事实。
- 关键动作记录操作者、前后状态、固定快照、原因、结果和证据。

### 验收重点

- 验证 技术执行、技术结论、业务确认和发布准入四层独立，以及失效传播。
- 逐条验收键见 [09-V2.0验收用例](09-V2.0验收用例.md)，功能逻辑见 [10-V2.0逻辑文档](10-V2.0逻辑文档.md)。

<a id="v2-cl-06"></a>
## V2-CL-06 反馈回流与模型迭代

**范围：** 使用反馈 → 调用样本提取 → 脱敏/去重/确认 → 标注质检 → 新版本与模型迭代。

### 输入与门禁

- 用户必须拥有 模型管理 模块权限和目标对象范围。
- 反馈关联真实调用和模型版本，样本授权、保留期及脱敏策略有效。
- 业务主键、内容指纹、人工确认、标签和质量门禁已配置。
- 所有写操作重新校验状态版本、固定快照、职责和幂等键。

### 处理步骤

1. 从反馈关联调用中按获准范围提取候选样本并生成回流批次。
2. 生成不可逆脱敏副本，保存规则版本和前后摘要。
3. 按业务主键和内容指纹去重，冲突项人工裁决，可用样本人工确认。
4. 缺少标签的样本进入标注、复核和质检，合格样本生成新数据版本。
5. 迭代计划引用新数据形成训练、评测、确认和新模型版本，验证后关闭反馈。

### 异常与补偿

- 无授权、脱敏失败、重复冲突、人工拒绝或质检阻断样本不得入版。
- 部分成功保留逐样本结果；补偿只处理失败项，不重复生成版本。
- 重试、重新确认、回流和回滚均创建关联新记录，不覆盖历史事实。
- 关键动作记录操作者、前后状态、固定快照、原因、结果和证据。

### 验收重点

- 验证 调用来源、不可逆脱敏、双重去重、人工确认、版本生成和端到端来源链。
- 逐条验收键见 [09-V2.0验收用例](09-V2.0验收用例.md)，功能逻辑见 [10-V2.0逻辑文档](10-V2.0逻辑文档.md)。

<a id="v2-cl-07"></a>
## V2-CL-07 高级发布与服务治理

**范围：** 审批快照 → 多实例部署 → 灰度/蓝绿 → 健康与流量 → 全量、暂停、回滚或下线。

### 输入与门禁

- 用户必须拥有 模型管理 模块权限和目标对象范围。
- 批准快照、实例规格、健康规则、流量策略和回滚目标有效。
- 普通账号申请、审批、执行两两不同；切流和回滚时重新鉴权。
- 所有写操作重新校验状态版本、固定快照、职责和幂等键。

### 处理步骤

1. 创建发布执行并逐实例部署，实例状态和健康检查分别回写。
2. 灰度按批次调整流量，观察技术和业务指标后扩大或暂停。
3. 蓝绿先验证非活动环境，再以路由版本锁原子切换并核对网关实值。
4. 门禁失败时保持最后稳定版本；孤儿实例隔离并进入待清理。
5. 回滚新建执行，恢复目标实例集、路由和权重，再验证健康与业务可用性。

### 异常与补偿

- 实例部分失败不得汇总为成功；不健康或未知实例不得接流量。
- 网关失败、指标越界或回滚失败进入暂停/失败/未知并保留稳定路由。
- 重试、重新确认、回流和回滚均创建关联新记录，不覆盖历史事实。
- 关键动作记录操作者、前后状态、固定快照、原因、结果和证据。

### 验收重点

- 验证 多实例部分成功、灰度扩大与暂停、蓝绿原子切流、路由实值和完整回滚。
- 逐条验收键见 [09-V2.0验收用例](09-V2.0验收用例.md)，功能逻辑见 [10-V2.0逻辑文档](10-V2.0逻辑文档.md)。

<a id="v2-cl-08"></a>
## V2-CL-08 模型广场使用与运营

**范围：** 检索/收藏 → 下载或调用 → 用量和反馈 → 业务确认与回流。

### 输入与门禁

- 用户必须拥有 模型广场 模块权限和目标对象范围。
- 仅展示有效发布投影；用户具有模型、下载或API调用授权。
- 服务、Key、配额和输入有效，调用内容遵守留存与脱敏策略。
- 所有写操作重新校验状态版本、固定快照、职责和幂等键。

### 处理步骤

1. 按授权检索发布模型并查看版本、适用范围、限制和更新时间。
2. 下载固定摘要文件，或以请求编号提交API调用并按最终成功计量一次。
3. 保存调用状态、耗时、错误和受控结果摘要，轮询不重复计量。
4. 反馈绑定实际调用和模型版本，运营侧按权限查看统计。
5. 获采纳反馈进入V2-CL-06，模型广场不直接生成数据或模型版本。

### 异常与补偿

- 发布失效、服务不健康、授权或配额不足时拒绝并记录原因。
- 同步等待超时返回原请求处理中，不重复执行或计量。
- 重试、重新确认、回流和回滚均创建关联新记录，不覆盖历史事实。
- 关键动作记录操作者、前后状态、固定快照、原因、结果和证据。

### 验收重点

- 验证 发布投影、授权、幂等调用、计量、反馈来源和回流边界。
- 逐条验收键见 [09-V2.0验收用例](09-V2.0验收用例.md)，功能逻辑见 [10-V2.0逻辑文档](10-V2.0逻辑文档.md)。


## 6. 专题文档索引

| 文档 | 职责 |
|---|---|
| [00-V2.0快速阅读指南](00-V2.0快速阅读指南.md) | 产品范围、模块分布和阅读导航 |
| [01-V2.0用户故事](01-V2.0用户故事.md) | 目标、角色、价值和用户结果 |
| [02-V2.0功能需求](02-V2.0功能需求.md) | 业务域能力和 660 条新增功能摘要 |
| [03-V2.0功能清单](03-V2.0功能清单.md) | V2.0 增量功能和页面范围 |
| [04-V2.0研发需求](04-V2.0研发需求.md) | 服务边界、对象、异步、文件和非功能约束 |
| [05-V2.0用户旅程](05-V2.0用户旅程.md) | 端到端流程和对象关系 |
| [06-V2.0页面展示字段字典](06-V2.0页面展示字段字典.md) | 通用与 V2.0 专用字段 |
| [07-V2.0状态与操作矩阵](07-V2.0状态与操作矩阵.md) | 状态、动作、门禁和高风险操作 |
| [08-V2.0角色权限与职责矩阵](08-V2.0角色权限与职责矩阵.md) | 角色、权限和职责分离 |
| [09-V2.0验收用例](09-V2.0验收用例.md) | 9 类核心场景、20 条专项用例和 660 条新增功能验收台账 |
| [10-V2.0逻辑文档](10-V2.0逻辑文档.md) | 每条 V2.0 新增 FR 的处理规则和证据要求 |
| [11-V2.0文档追踪与配置基线](11-V2.0文档追踪与配置基线.md) | 660 条新增功能的跨文档映射 |
| [12-V2.0配置与联调规则](12-V2.0配置与联调规则.md) | 配置分类、安全和真实环境联调边界 |
| [14-V2.0核心链路详细设计](14-V2.0核心链路详细设计.md) | 8 条跨模块开发级闭环 |
| [15-V2.0接口事件与错误码契约](15-V2.0接口事件与错误码契约.md) | 全域逻辑接口、请求响应、事件、错误码和事务边界 |
| [16-V2.0对象模型与数据关系](16-V2.0对象模型与数据关系.md) | 33 个页面对象域、主键、关系、基数和不可变规则 |
| [17-V2.0非功能与容量基线](17-V2.0非功能与容量基线.md) | 性能、容量、可用性、安全和上线验证目标 |
| [18-V2.0边界异常与恢复矩阵](18-V2.0边界异常与恢复矩阵.md) | 28 类并发、乱序、部分成功和二次失败恢复规则 |
| [19-V2.0增量升级与兼容方案](19-V2.0增量升级与兼容方案.md) | V1 继承、数据升级、兼容、分阶段启用、回滚和跨版本验收 |

## 7. 交付判定

- 文档层：511 条 V1.0 继承能力保持有效；660 条 V2.0 新增功能全部有稳定编号、对象字段、状态、权限、逻辑接口、事件、异常、验收和追踪入口，两个编号集合零重叠。
- 研发准入层：33 个页面对象域均已建立对象化规则和字段断言；八组重点专项、配置默认值、错误码、事务边界、容量目标和边界恢复已形成开发级产品基线。
- 联调验收层：必须完成 V1 全量回归、V2 增量验收和跨版本升级用例；真实数据源、执行器、代码/镜像环境、网关、监控、流量和安全证据未因文档生成而自动通过。