---
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. 质量校验：命名归一化、去重、引用完整性

## 输出

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

```yaml
对象清单:
  显式对象:
    - 名称: ""
      别名: []
      业务含义: ""
      候选主键: ""
      来源证据: ""
      存储位置: 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` 直接消费：

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