训练和管理设备模型

设备模型需要经过受控生命周期。训练只产生待审阅候选，不会自动替换当前保护设备的判据。

本指南说明预测性维护使用的两类模型、用户当前可以在界面中执行的操作，以及仍需要管理员 API 的生命周期动作。

先确认正在管理哪类模型

预测性维护将以下产物分开管理：

模型轨道	用途	当前训练入口	生产权限来源
设备基线分布 (PDM_BASELINE_DISTRIBUTION)	描述设备在运行工况下的观测分布，用于设备自身基线比较。	预测性维护 > 模型控制台	模型控制台中的基线晋升门
可执行异常模型 (PDM_ANOMALY_MODEL)	针对指定设备目标运行异常评分 artifact。	管理员 API	引用已验证不可变 artifact 的 ACTIVE assignment

不要把基线分布当作可执行异常模型。基线计算成功不能证明异常模型运行过，异常分数也不是故障概率。

入口和权限

任务	入口	所需权限
查看模型控制台	/pdm/model-console	mlops.model.read 或 system.config
查看模型使用详情	/ai-models/registry/:registryId	mlops.model.read 或 system.config
训练或晋升设备基线	模型控制台	pdm:write
训练可执行异常模型候选	管理员 API	pdm:write
晋升或回滚可执行 assignment	管理员 API	pdm:write
审阅设备 Finding	/pdm/anomalies 和 Finding 详情	pdm:read

标准模型使用详情页是只读页面。它展示 assignment 和运行证据，但当前不提供 assignment 晋升或回滚按钮。

生命周期概览

SHADOW 表示候选可以参与对比计算，但不改变告警、健康分、维护建议或 Finding。ACTIVE 给予 assignment 生产选模权限，但只有出现新鲜的成功运行证据后，才能确认生产链真实使用了该模型。

准备状态应解释未满足条件，而不是把证据缺失显示成健康结果。

训练统计设备基线

1. 打开 预测性维护 > 模型控制台。
2. 找到目标设备。
3. 审阅就绪结果和每个未满足条件。
4. 确认设备身份、目标信号、单位、运行态历史和训练窗口正确。
5. 当设备满足条件且当前角色具有 pdm:write 时，选择训练操作。
6. 等待控制台刷新，确认新版本和训练时间。

就绪结果具有不同含义：

结果	含义	下一步
满足训练条件	当前数据满足必要条件。	启动训练，然后审阅生成的 SHADOW 候选。
条件不足	一个或多个可量化要求未满足。	补充运行历史或修复必要信号。
无法判断	服务无法做出就绪判断。	处理页面给出的身份、数据或服务问题，不要把它写成历史不足。
注意事项	可以训练，但窗口存在已知限制。	记录限制，并在发布审阅中明确考虑。

训练设备基线只生成对比候选，现有生产判据继续生效。

训练可执行异常模型候选

可执行异常模型训练目前属于管理员 API 工作流，标准模型控制台没有对应自助按钮。

方法	Endpoint	结果
POST	/api/v1/pdm/model-console/{equipmentId}/train-anomaly-model	创建不可变可执行候选，不改变统计基线或当前 ACTIVE 路径。

请求成功后：

1. 打开模型注册表；
2. 选择准确的 registry 记录，不要只依赖 model type 名称；
3. 确认绑定设备和目标；
4. 确认 artifact 已登记并通过验证；
5. 确认 assignment 为 SHADOW；
6. 在发布决策前审阅 SHADOW 运行证据。

API 操作必须在目标租户内执行。不要复用从其他租户或环境复制的 assignment 或 registry 标识。

审阅 SHADOW 行为

在模型使用详情页检查候选：

• 准确的设备和目标绑定；
• assignment 状态；
• artifact 类型、runtime、format 和验证状态；
• 训练窗口和样本数量；
• 最近的 SHADOW 执行窗口；
• executed、refused、timed-out 和 failed 数量；
• SHADOW disagreement 数量和原因。

Disagreement 表示 SHADOW 结果在至少一个已记录对比中不同于当前生产路径。它不能证明哪一方正确。候选产生的告警更少不代表更准确，也可能意味着漏掉了应关注的情况。

候选训练完成后仍保持 SHADOW，直到独立的授权晋升决策。

决定候选是否有价值时，应结合现场发现、已审阅维护结果、运行工况和数据质量证据。

审慎晋升

在界面中晋升设备基线

对于处于 SHADOW 的合格基线，模型控制台可向具有 pdm:write 的用户显示晋升操作。后端发布门只验证基线是否能与当前判据进行可比回放，不会声称该基线更准确。

如果晋升被拒绝，按返回原因处理。典型动作包括修复设备档案、先训练候选、等待有效运行样本或恢复时序服务。

通过 API 晋升可执行 assignment

可执行异常模型 assignment 使用管理员 endpoint：

方法	Endpoint
POST	/api/v1/pdm/model-console/assignments/{assignmentId}/promote

晋升以原子方式改变生命周期状态。成功后确认：

• 目标 assignment 为 ACTIVE；
• 目标 registry 版本为 PRODUCTION；
• 原设备级生产 assignment 已退役；
• artifact 仍为已验证状态；
• 出现新鲜的 ACTIVE 运行证据；
• 如果产生客户可见 Finding，其模型 provenance 指向预期版本。

页面报告 ACTIVE_AWAITING_EVIDENCE、STALE、FALLBACK、CONFLICT 或 ARTIFACT_UNAVAILABLE 时，不要宣称模型正在生产运行。

回滚可执行 Assignment

回滚目前属于管理员 API 工作流：

方法	Endpoint
POST	/api/v1/pdm/model-console/assignments/{assignmentId}/rollback

assignmentId 指向需要沿生命周期历史回滚的 assignment。使用当前租户模型 API 返回的标识，不要从 URL、模型名称或其他环境推断。

回滚后：

1. 确认替代 assignment 为 ACTIVE；
2. 确认被回滚 assignment 和 registry 的历史状态正确；
3. 等待恢复 artifact 的新鲜运行证据；
4. 确认旧 artifact 不再被 live assignment 引用；
5. 检查客户可见 Finding 和告警是否连续。

回滚会改变模型选择路径，但不会删除历史 assignment、生命周期事件、运行证据、Finding 或反馈。

理解主要状态

状态	能证明什么	不能证明什么
STAGING	Registry 版本是候选。	它可以影响客户结果。
SHADOW	Assignment 可用于非写入对比。	它是生产模型。
ACTIVE	Assignment 具有生产选模权限。	最近一次执行成功。
PRODUCTION	Registry 版本是其治理范围的生产版本。	每次设备评估都使用了它。
RETIRED 或 ROLLED_BACK	版本或 assignment 已成为历史。	它的审计证据被删除。

要判断是否真实执行，请查看模型使用详情页的运行证据。

故障处理

现象	检查项
看不到训练操作	pdm:write、就绪状态、当前 assignment 状态，以及当前是否属于 API-only 的异常模型流程。
训练被拒绝	设备身份、目标信号、运行态历史、窗口覆盖和返回原因。
候选一直是 SHADOW	在人工发布决策前这是正常安全状态；继续审阅对比证据和晋升前置条件。
晋升成功但页面没有显示生产使用	等待新鲜运行证据，并检查 ACTIVE_AWAITING_EVIDENCE、过期数据、fallback 或 artifact 验证。
页面报告多个 live assignment	停止生命周期操作，请管理员处理冲突。
找不到回滚按钮	Assignment 回滚目前是管理员 API，不是标准模型使用详情操作。
模型运行过但没有 Finding	检查数据质量、持续性、融合条件和 Finding 启用范围；没有 Finding 不等于没有执行。

验证清单

• 设备和目标正确。
• 没有混淆统计基线和可执行异常 artifact。
• 训练只创建候选，没有静默改变生产。
• SHADOW 证据没有改变客户可见结果。
• 授权用户在完成审阅后执行晋升。
• 新鲜 ACTIVE 运行证据确认真实使用。
• 执行回滚时恢复了目标 artifact，并保留审计历史。

相关文档

• 健康指数、基线和模型准备
• 理解模型使用和运行证据
• 审阅 Finding 并记录反馈
• 异常审阅和维护建议