openbkn-ai 关系绑定
公约：../_shared/contract.md
做什么
在对象类绑定完成后，分析已绑定资源的 property schema，判定每条关系的类型（direct 或 indirect），并为 indirect 类型推荐/绑定 backing resource。
触发时机
在 bkn-bind 之后、bkn-map 之前执行。此时对象类已绑定到资源，可以分析资源间的关联关系。
输入
binding_decision_list：bkn-bind的输出（bound 对象列表）resource_schema_map：各对象资源的 property schema + 外键信息relation_list：关系清单（来自bkn-extract）resource_availability：可选，平台可用资源列表（用于 backing resource 推荐）
关系类型判定规则
direct 类型
满足以下条件之一：
| 条件 | 说明 |
|---|---|
| 起点视图有字段直接引用终点视图 | 外键关系：orders.product_code → products.product_code |
| 起点属性与终点属性同名且类型兼容 | 如 supplier_code 在两端都存在 |
| 单数据源内的主键-外键关系 | 同一数据库内可直接 JOIN |
indirect 类型
满足以下条件之一：
| 条件 | 说明 |
|---|---|
| 起点视图无字段直接引用终点视图 | 需中间表做桥梁 |
| 跨数据源 | 起点对象和终点对象来自不同数据源 |
| 多对多关系的中间表 | 如"订单-产品"通过"订单明细"关联 |
| 业务描述提及中间实体 | 文本中有"订单明细"、"关联表"等线索 |
流程
1. 遍历关系清单
对每条关系执行：
1. 获取起点对象的 view_schema
2. 获取终点对象的 view_schema
3. 检查起点视图是否有字段直接引用终点视图（外键检查）
4. 检查起点属性名是否与终点属性名匹配（同名检查）
5. 判定类型：
- 有直接关联 → direct
- 无直接关联 → indirect
2. direct 类型处理
1. 提取 Mapping Rules：
- 从外键信息提取 Source Property → Target Property
- 或从同名属性提取映射
2. 输出到 direct_relations 列表
3. indirect 类型处理
1. 中间视图推荐：
- 扫描 resource_availability，找同时关联起点和终点资源的候选
- 或根据业务名称线索匹配（如"订单明细"、"关联表"）
- 输出候选列表（最多 5 个）
2. 用户确认：
- 有候选 → 展示候选列表，用户选择或跳过
- 无候选 → 标记 pending，提示后续补绑
3. 确认后提取映射：
- Source Mapping: 起点属性 → 中间视图字段
- Target Mapping: 中间视图字段 → 终点属性
4. pending 关系处理
- 不阻断流程
- 输出到 pending_relations 列表
- 在 pipeline_state.yaml 记录
- 后续可通过 update pipeline 补绑
中间视图推荐策略
策略 1：外键链路追踪
起点视图 → 找引用它的视图 → 这些视图是否也引用终点视图？
↓
中间候选
策略 2：名称线索匹配
业务文本中提到的中间实体：
"订单包含多个产品" → 搜索名称含"订单明细"、"order_item"的视图
匹配规则：
- 起点对象名 + 终点对象名 → "订单产品"
- 起点对象名 + "明细" → "订单明细"
- 起点/终点的别名组合
策略 3：数据源关联表
起点视图所属数据源 → 扫描该数据源的关联表 → 找同时含起点主键和终点主键的表
输出
relation_binding_result:
direct_relations:
- 关系ID: ""
关系名称: ""
源对象: ""
目标对象: ""
mapping_rules:
- source_property: ""
target_property: ""
判定依据: "" # 如"起点视图 product_code 外键引用终点视图"
confidence: high | medium | low
indirect_relations:
- 关系ID: ""
关系名称: ""
源对象: ""
目标对象: ""
backing_resource_id: "" # 确认后填入
backing_resource_name: "" # 确认后填入
backing_resource_candidates: # 推荐候选
- resource_id: ""
resource_name: ""
match_reason: ""
confidence: high | medium | low
status: confirmed | pending | rejected
source_mapping_rules: # 确认后填入
- source_property: ""
resource_property: ""
target_mapping_rules: # 确认后填入
- resource_property: ""
target_property: ""
判定依据: "" # 如"跨数据源，需中间视图"
pending_relations:
- 关系ID: ""
关系名称: ""
原因: "" # 如"无匹配中间视图候选"
建议: "" # 如"请手动指定中间视图或后续补绑"
relation_binding_summary:
total_relations: 0
direct_count: 0
indirect_confirmed_count: 0
indirect_pending_count: 0
pending_count: 0
用户确认阶段
当存在 indirect 类型关系需要确认时，pipeline 会暂停并展示：
检测到 {n} 条关系需要中间视图绑定：
【{关系名称}】
起点对象: {源对象} → 已绑定视图: {起点视图名}
终点对象: {目标对象} → 已绑定视图: {终点视图名}
判定依据: {判定依据}
推荐中间视图：
1. {候选1名} ({候选1ID}) - 匹配原因: {原因1}
2. {候选2名} ({候选2ID}) - 匹配原因: {原因2}
...
请选择：
A. 选择推荐候选（输入序号 1-5）
B. 手动指定中间视图（输入 view_id 或 view_name）
C. 暂时跳过，标记为 pending（后续可补绑）
D. 改为 direct 类型（起点属性直接关联终点属性）
与后续 Skill 的衔接
| Skill | 消费内容 |
|---|---|
bkn-map |
direct_relations.mapping_rules + indirect_relations.source/target_mapping_rules（仅 confirmed） |
bkn-draft |
关系类型 + Mapping 结构（pending 关系生成占位符版本） |
bkn-backfill |
关系类 Backing Resource + Source/Target Mapping 回填 |
约束
- 仅处理
bkn-bind输出的bound对象涉及的关系 - 起点或终点对象为
pending或rejected时，对应关系也标记为pending pending关系不阻断流程，可后续补绑- 推荐候选最多 5 个，置信度排序
- 不编造映射规则，必须有外键或用户确认依据
跳过条件
以下情况跳过本 skill：
bind_mode == deferred（无可用数据视图）relation_list为空- 所有起点/终点对象都是
pending或rejected