布尔差集 · BrepDiff
从一个或多个目标物体中减去相交的切割体，生成差集结果
📖 功能概述
这是 LK 工具集中的核心布尔运算组件，从一个目标物体中减去一个或多个切割体，生成差集结果。它比 Grasshopper 原生的布尔差分组件更加智能和健壮：
- 支持 单个目标 + 多个切割体 批量处理
- 自动过滤无交集的切割体，提升运算效率
- 批量运算失败时自动回退到逐个布尔运算
- 内置 GH_TaskCapableComponent 异步任务支持，复杂运算不卡界面
- 精细的 资源管理，避免 Rhino 几何体内存泄漏
- 自动报告失败和无交集的切割体，便于排查
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 目标物体 (B) | Brep | 必需 | 被切割的目标物体（单个 Brep，可以是实体或曲面） |
| 切割体 (C) | Brep | 必需 | 用于切割的物体（列表，多个切割体同时输入） |
| 容差 (T) | Number | 可选 | 布尔运算容差。默认为当前 Rhino 文档的绝对容差。通常无需修改。 |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 结果 (R) | Brep | 布尔差集运算结果（列表）。成功减去所有有效切割体后得到的目标物体。 |
| 失败切割体 (F) | Brep | 布尔运算失败的切割体（列表）。用于排查哪些切割体导致了问题。 |
| 无交集切割体 (N) | Brep | 与目标物体无交集的切割体（列表）。这些切割体不会影响结果。 |
🧠 核心流程
1
输入目标 + 切割体
→
2
过滤切割体
→
3
尝试批量布尔
→
4
输出结果
🔍 步骤 2 详细：切割体过滤
在对切割体执行布尔运算之前，组件使用两阶段过滤提前剔除无效切割体：
- 边界盒检测 — 快速检查切割体的边界盒是否与目标相交，完全不交的直接归为"无交集"
- 几何碰撞检测 — 通过
BrepBrep求交判断是否有实际相交
过滤过程使用 并行计算（Parallel.ForEach），显著提升多切割体场景下的性能。
⚙️ 步骤 3 详细：双策略布尔运算
A 批量布尔（首选）
一次性将所有切割体与目标做布尔差集运算。效率最高，但不一定能处理复杂重叠几何。
B 逐个布尔（回退）
批量失败后自动切换，逐个切割体依次运算。更稳健，失败时精确标记哪个切割体有问题。
✅ 智能回退：批量布尔失败后，组件自动切换到逐个布尔模式，无需用户手动干预。
⛓️ 碰撞检测逻辑详解
内部的 Collide 方法按以下顺序判断两个 Brep 是否有交集：
- 执行
BrepBrep相交计算 - 若有相交曲线 → 判定为有交集
- 若没有相交曲线但有相交点 → 判定为有交集
- 若目标为实体且切割体的端点在目标内部 → 判定为有交集（包含关系）
- 反之亦然
⚡ 异步任务支持
该组件继承自 GH_TaskCapableComponent，在 Grasshopper 的数据驱动运算（DataTree 多分支）场景下，每个分支的布尔运算会以独立任务在后台执行：
- 预处理阶段（
InPreSolve）：为每个数据分支创建异步 Task - 求解阶段（
SolveInstance）：通过GetSolveResults获取各分支结果 - 界面不卡顿，复杂几何体运算时 Grasshopper 画布仍然可交互
💡 说明：若 Grasshopper 不支持任务系统（旧版本），组件会自动降级到同步求解模式，行为一致。
🧪 典型使用场景
| 场景 | 说明 |
|---|---|
| 开孔打洞 | 在目标实体上减去圆柱/方体等切割体，生成孔洞效果。 |
| 复杂外形切割 | 使用多个切割体对一个目标反复切减，得到复杂外形。 |
| 模型减材 | 从扫描或导入的模型中减去不需要的部分。 |
| 批量布尔运算 | 一次性输入大量切割体，组件自动过滤无交集部分并执行运算。 |
⚠️ 注意事项
- 目标物体只能输入一个（item），切割体可以是多个（list）。
- 输入无效或空的切割体会被自动跳过，不影响整体运算。
- 容差参数通常保持默认值即可。过小可能导致运算失败，过大会降低精度。
- 如果大量切割体出现在"失败"输出中，可以尝试调整容差或检查切割体几何本身是否有效。
- "无交集"切割体不一定是问题——它们只是物理上没有与目标相交。
📋 组件信息
| 名称 | 布尔差集 |
| 英文名 | BrepDiff (BooleanDifferenceFinal) |
| 分类 | LK → Brep |
| Exposure | secondary（次级标签页可见） |
| 基类 | GH_TaskCapableComponent<SolveResults> |
| GUID | 21B04604-21A8-4AD3-8FA7-DC6AC6188037 |