4. 参数文档化与基线建立：参数清单模板、基线版本管理、参数变更记录规范

在产线导入阶段，参数调试的成果若仅停留在工程师的笔记本或PLC离线程序中，将导致后续量产维护、故障排查、产线复制时出现严重的信息断层。本章聚焦于将调试过程中的“隐性知识”转化为“显性文档”，通过建立参数清单模板、基线版本管理机制及变更记录规范，确保参数状态可追溯、可复现、可审计。

4.1 参数清单模板：结构化参数描述

参数清单是参数文档化的基础单元。一个合格的参数清单模板应包含参数标识、属性、值域、来源及关联信息，避免仅记录“参数名=数值”的简陋形式。

4.1.1 参数清单核心字段定义

4.1.2 参数清单模板示例（JSON格式）

{
  "parameterID": "PRM-SRV-AX01-ACC-001",
  "parameterName": "伺服轴1加速度",
  "dataType": "REAL",
  "unit": "mm/s²",
  "rangeMin": 0.1,
  "rangeMax": 500.0,
  "subsystem": "伺服驱动",
  "deviceID": "EQP-PK-001",
  "currentValue": 250.0,
  "defaultValue": 100.0,
  "status": "已确认",
  "dependencies": ["PRM-SRV-AX01-DEC-001", "PRM-SRV-AX01-VEL-001"],
  "testCaseID": "TC-SRV-ACC-01"
}

4.2 基线版本管理：参数状态的“快照”机制

基线（Baseline）是在特定里程碑节点（如功能调试完成、试产通过、量产放行）对全部参数状态的一次正式“快照”。基线版本管理确保在任何时间点都能回退到已知的稳定状态。

4.2.1 基线版本命名规范

4.2.2 基线版本管理流程

1. 基线创建：由调试负责人发起，确认所有参数状态为“已确认”或“已锁定”。
2. 基线审核：由工艺工程师、质量工程师、设备工程师联合评审，确认参数值满足工艺与质量要求。
3. 基线发布：将参数清单导出为只读格式（如PDF/A或加密Excel），存入版本管理库。
4. 基线锁定：发布后的基线参数在系统中标记为“锁定”，修改需走变更流程。
5. 基线回退：当产线出现异常且无法快速定位时，可回退至最近一次稳定基线。

4.3 参数变更记录规范：每一次修改都有据可查

参数变更记录是基线管理的“日志系统”。没有规范的变更记录，基线将失去意义——因为无法判断当前参数状态与基线之间的差异。

4.3.1 变更记录核心要素

4.3.2 变更记录操作规范

• 先申请，后执行：任何参数修改必须先在系统中创建变更记录（CR），获得审核批准后方可执行。
• 单次变更最小化：一次变更记录只修改一个逻辑关联的参数组，避免“批量修改”导致影响范围失控。
• 变更后验证：参数修改后必须执行关联的测试用例，并将测试结果附在变更记录中。
• 变更闭环：验证通过后，更新参数清单中的当前值，并标记变更记录为“已关闭”。

4.4 参数文档化工具链建议