bkn-extract

name	bkn-extract
description	从文本提取对象/关系/动作，输出四分组结构化清单。

对象关系提取

公约：../_shared/contract.md

做什么

给定业务文本和领域识别结果，提取对象类、关系类、动作候选，分组输出。

输入

• source_text：业务文本
• domain：bkn-domain 的识别结果
• domain_reference（可选）：对应领域参考文件路径

流程

1. 按领域参考（或通用规则 ../bkn-domain/references/generic-extraction.md）提取
2. 对象分为四组：
   • 显式对象（explicit）：文本直接出现，有明确定义
   • 推断对象（inferred）：领域闭环补全（每项必须含推断理由）
   • 待确认对象（pending）：证据不足，需用户确认
   • 排除候选（rejected）：复合表达/噪音/不适合建模的
3. 对每个对象判定 存储位置（platform 或 local）：
   • platform：需要与外部系统/数据视图绑定的业务对象（如物料、订单、工单等），有实际数据源
   • local：仅用于模型内部逻辑推理、规则锚定、中间态表示的对象（如监控任务、状态标记、规则容器等），无外部数据源
   • 判定依据：是否提及数据来源/系统对接/视图绑定；若无则为 local
   • 不确定时默认标记为 platform，并在业务含义中备注
4. 提取关系（name 用中文业务名）
5. 提取动作候选
6. 领域闭环完整性检查（缺失对象补入推断组）
7. 质量校验：命名归一化、去重、引用完整性

输出

所有键名和分组标签使用中文，便于非技术人员阅读：

对象清单:
  显式对象:
    - 名称: ""
      别名: []
      业务含义: ""
      候选主键: ""
      来源证据: ""
      存储位置: platform | local
  推断对象:
    - 名称: ""
      别名: []
      业务含义: ""
      候选主键: ""
      推断理由: ""
      存储位置: platform | local
  待确认对象:
    - 名称: ""
      不确定原因: ""
      存储位置: platform | local
  排除候选:
    - 候选名: ""
      排除原因: ""
关系清单:
  - 名称: ""
    关系ID: ""
    源对象: ""
    目标对象: ""
    基数: ""
    来源证据: ""
动作候选:
  - 名称: ""
    触发条件: ""
    目标对象: ""
    风险等级: 低 | 中 | 高

风险等级说明

等级	标签	含义	示例
低	低	只读或对单条记录的非破坏性操作	查询、生成报表
中	中	影响多条记录或触发下游流程	批量状态变更、MRP 计算
高	高	删除、跨系统推送、审批流触发、资金相关	删除网络、推送生产计划

升级条件

以下情况建议 pipeline 调用 bkn-doctor：

• 待确认对象 >= 3
• 关系方向冲突
• 主键缺失
• 清单质量不足

业务规则检查（阶段一末尾）

清单确认后，逐对象扫描规则：

规则类型	示例
主键规则	forecast 以 billno 为主键
外键规则	mrp.rootdemandbillno → forecast.billno
过滤规则	mrp 仅取 closestatus_title='正常'
状态枚举	采购状态 = normal / watch / abnormal
计算规则	coverage = (mapped + waived) / total
层级规则	BOM 多版本取 audit_date 最近
约束规则	alt_priority == 0 才参与 MRP

输出 rule_extraction_check，供后续 bkn-rules 直接消费：

rule_extraction_check:
  - rule_id: "RE-001"
    rule_type: 主键规则 | 外键规则 | 过滤规则 | 状态枚举 | 计算规则 | 层级规则 | 约束规则
    description: ""
    related_objects: [""]
    source_evidence: ""
    confidence: high | medium | low
    risk_level: 低 | 中 | 高