tyc-tech 受益所有人穿透 (UBO Screening)
触发条件
反洗钱开户合规、复杂股权架构企业的 UBO 识别、增强尽调中的实控关系核查时触发。
关键词：UBO、受益所有人、股权穿透、实控人、FATF、AML
输入要求
用户输入的企业标识可能是以下三种形式之一，Step 0 会按形式分流，不要急着把用户原话当成 searchKey 喂给后续步骤：
| 输入形式 | 示例 | 是否需要 L0 实体锚定 |
|---|---|---|
完整企业名（含组织形式后缀：有限公司 / 股份有限公司 / 集团 / 合伙企业 / 个体工商户 / 事务所 / 中心 等） |
北京字节跳动科技有限公司 / 腾讯科技（深圳）有限公司 |
❌ 跳过 L0，直接当 searchKey |
| 统一社会信用代码（USCC） 18 位大写字母+数字 | 91110108551385082Q |
❌ 跳过 L0，直接当 searchKey |
| 企业简称 / 曾用名 / 品牌名 / 模糊指代 | 字节 / 抖音 / 今日头条 / 乐视 / 阿里 |
✅ 必须先走 L0，由用户在候选中确认唯一企业，再拿 creditCode 作为 searchKey |
经过 Step 0 锚定后，下文 Step 1+ 的
searchKey都指精确企业名或 USCC，调用方式不变。
执行流程
Step 0: 实体锚定（条件性 · L0 工具：search_companies）
目的：用户给的常常是简称、曾用名、模糊指代，下游所有步骤都依赖精确企业；先用 L0 把它消歧成唯一 creditCode，避免后续步骤在错主体上反复烧 token。
判定与分流：
若 userInput 匹配 USCC 正则
^[0-9A-Z]{18}$→ 跳过 L0，searchKey = userInput若 userInput 含组织形式后缀（
有限公司/股份/集团/合伙企业/事务所/个体工商户/分公司等）且长度 ≥ 6 → 跳过 L0，searchKey = userInput否则（简称 / 曾用名 / 品牌名 / 任何看起来不完整的字符串）→ 必须走 L0：
- 调用
search_companies(searchKey: userInput) - 在返回
items[]中默认按regStatus ∈ {存续, 在业, 在营, 开业}过滤，按regCapital倒序取 Top 5 作为候选展示 - 候选 = 1 → 自动锚定，
searchKey = items[0].creditCode - 候选 ≥ 2 → 暂停执行，向用户输出候选清单（
name/creditCode/regStatus/regLocation/legalPersonName）请求确认，待回复后取选定企业的creditCode作为searchKey - 候选 = 0 → 终止流程，提示"未找到匹配企业，请提供更完整的名称或换关键词"
- 调用
对用户的话术（候选 ≥ 2 时）：
你说的「{userInput}」匹配到 N 家企业，请确认是哪一家：
# 企业名称 USCC 状态 法定代表人 注册地 1 … … 存续 … … 2 … … 存续 … … 回复编号（1-N）以继续，或回复"都不是"重新输入。
Step 1: 主体确认
get_company_registration_info— 主体存续
Step 2: 直接股东
get_shareholder_info— 直接股东列表与持股比例
Step 3: 受益所有人识别
get_beneficial_owners— UBO 直查（含 25% 阈值与 finalRatio 字段）
Step 4: 实控人路径
get_actual_controller— 实控人get_equity_ratio— 控制结构 + 控股路径
Step 5: 向下穿透（可选，识别隐性关联）
get_controlled_companies— 向下穿透看实控人控股的全部公司
输出格式
# UBO 穿透报告 — {name}
## 一、直接股权层
| 股东 | 持股比例 | 类型 |
|------|---------|------|
## 二、最终受益人 (UBO ≥25%)
| UBO 姓名 | 受益类型 | 最终受益股份 | 控制路径 |
|---------|---------|-------------|---------|
## 三、实际控制人
- 实控人: {name}
- 控制路径: {path}
- 总持股比例: {totalRatio}
- 表决权比例: {voteRatio}
## 四、关联企业网络（实控人维度）
表格列出实控人控股的其他企业
## 五、合规判定
- 满足 FATF 25% 透明度要求: 是/否
- UBO 自然人是否清晰: 是/否
- 是否需要 EDD: 是/否
错误处理
- 若 Step 0 候选 = 0 → 终止流程，提示"未找到匹配企业，请提供更完整的名称或 USCC"，不要带着错主体往下跑
- 若 Step 0 候选 ≥ 2 而用户在合理时间内未回复 → 暂存上下文，不要自行选择第一条作为锚定（错锚定的代价远大于等待）
示例
输入: searchKey = "xxxx有限公司"
新输入形态参考（Step 0 引入后的三种典型）：
例 1（USCC 直通，跳过 L0）：
输入: userInput = "91110108551385082Q" → Step 0 判定 USCC，searchKey = userInput，直接进 Step 1。
例 2（完整企业名直通，跳过 L0）：
输入: userInput = "北京字节跳动科技有限公司" → Step 0 判定含 有限公司 后缀且长度 ≥ 6，searchKey = userInput，直接进 Step 1。
例 3（简称，必走 L0）：
输入: userInput = "字节" → Step 0 调 search_companies (searchKey: "字节")，过滤存续后取 Top 5，向用户列出候选请求确认；用户回复"1"（北京字节跳动科技有限公司）→ searchKey = items[0].creditCode，再进 Step 1。