输入输出契约¶

核心输入对象¶

1. CatalogBundle¶

由 /v1/catalogs/import 生成，字段包括： 1. catalog_id 2. scene_metadata 3. catalog
catalog.bindings 为点位绑定列表 4. field_dictionary 5. source_profiles

2. 自然语言需求¶

在 nl_requirements 传入，建议每条需求单独一行。

示例：

[
  "在安全边界内最小化能耗",
  "主蒸汽压力不低于30",
  "单次调节幅度不能超过20%"
]

3. SceneContext¶

用于仿真/评测：

{
  "values": {
    "energy_cost": 120.0,
    "pressure": 31.2
  },
  "metadata": {
    "shift": "day"
  }
}

核心输出对象¶

1. ParserResult¶

点位映射结果，包含 mappings、confidence、unmapped_points。

2. MigrationDraft¶

迁移草案，包含模板内容与审计信息。

3. MigrationValidationReport¶

草案校验报告。

4. TemplateQualityReport¶

评分阈值检查报告，字段 passed=true 才允许发布。

5. AgenticRunReport¶

完整运行报告，含迭代过程和阻断原因。

YAML 输入建议¶

standard 模式¶

适合新项目，结构明确，语义完整。

legacy 模式¶

适合已有工业项目，支持分组字典和大量点位，避免逐点手工录入。

常见输入问题¶

点位重复
系统会自动重命名重复 point_id，并在 warnings 中返回。
字段字典缺失
系统会从绑定关系推断初始字段字典，并标记待确认项。
语义映射置信度低
草案中会出现 pending_confirmations，需要人工复核后再发布。