DeBorder
将“01 获取 CAD 图框”产生的一项有效图框数据拆成真实属性键、原始属性值、有效绘图区域和图框外边界，便于检查模板并驱动后续比例与属性流程。
功能概览
这个组件用于读取已经封装好的 CAD 图框结果，而不是直接读取 DWG 文件。它接收“01 获取 CAD 图框”输出的一项有效图框数据，并同时输出块实例中真实存在的属性键与原始属性值，以及从模板中识别出的有效绘图区域矩形和最外侧边界矩形。
属性键和值以两个顺序对应的列表输出：同一索引位置的 Key 与 Value 构成一对。例如，Keys 的第 3 项必须与 Values 的第 3 项一起理解。组件不会补写属性、改名、过滤或生成新 Key；输出反映上游图框数据中已有的真实属性。两个矩形则承担不同用途：有效绘图区域表示内容应适配的范围，外框线表示整张图框的最外侧范围，二者不应互换。
适合什么时候用
- 检查标准 DWG 图框实际包含哪些属性键，以及模板内原本保存了哪些属性值。
- 在创建新的图框属性数据前，先取得真实 Key，避免向模板不存在的属性名称写值。
- 将有效绘图区域连接到图框比例预计算流程，用模板的可用范围评估待放置图元。
- 同时取得有效绘图区域与外框边界，用于预览、范围核对或判断模板识别结果是否合理。
工作流程
- 先使用“01 获取 CAD 图框”读取标准 DWG，并确认其已经输出有效的 CAD 图框数据。
- 将该输出作为单项连接到“图框类”输入；不要分别连接文件路径、曲线或自行整理的键值列表。
- 读取“块属性 Keys”和“块属性 Values”，始终按相同列表索引配对，核对模板的真实属性内容。
- 将“有效绘图区域”用于比例适配或内容放置范围，将“图框外框线”用于整张图框的外轮廓检查。
- 若后续需要填写图框属性，使用输出的真实 Keys 作为依据，再在图框属性组件中构造对应键值。
使用逻辑图
输入
| 端口 | 是否必需 | 接受的数据 | 数据形式与匹配 | 默认或空值行为 | 常见误接 |
|---|---|---|---|---|---|
| 图框类 B | 必需 | 由“01 获取 CAD 图框”输出的有效 CAD 图框数据，其中包含模板身份、块属性、有效绘图区域和外框边界。 | 单项输入，不执行列表逐项处理，也不进行数据树分支匹配。所有四项输出均来自同一个图框，因此不会在多个模板之间交叉配对。 | 未取得输入时不输出。输入无效时报告错误，Keys、Values 和两个矩形均不会作为有效结果发布。 | 直接连接 DWG 文件路径、图框曲线、普通块对象、图框属性键值数据，或将多个图框作为列表接入并期待批量分解。 |
输出
| 端口 | 得到的内容 | 数据结构 | 空值与对应规则 | 典型下游 |
|---|---|---|---|---|
| 块属性 Keys K | CAD 图框块实例中真实存在的属性键。 | 文本列表。列表顺序与 Values 完全对应；Key 的第 n 项对应 Value 的第 n 项。 | 模板没有属性时可得到空列表。组件不会虚构、补齐或重命名 Key。 | 用于核对模板字段，并作为创建图框属性时选择或填写真实 Key 的依据。 |
| 块属性 Values V | 与各个真实属性键对应的模板原始属性值。 | 文本列表，与 Keys 等长并按索引配对；它不是独立排序的值集合。 | 某个属性的原始值可以为空文本，但其位置仍与同索引 Key 对应。模板没有属性时可得到空列表。 | 用于查看模板默认内容、比对现有填写结果，或作为修改前的参考值。 |
| 有效绘图区域 D | 图框内可用于放置和适配图纸内容的矩形范围。 | 单个矩形，属于当前输入图框，不生成列表或数据树。 | 只有有效图框输入才会发布；无效输入时没有可用矩形。 | 典型连接到“03 预计算图框比例”，用于依据模板可用范围计算内容适配比例。 |
| 图框外框线 O | 图框最外侧边界矩形，表示整张图框的总体范围。 | 单个矩形，与有效绘图区域来自同一模板，但含义不同。 | 只有有效图框输入才会发布；无效输入时没有可用矩形。 | 用于图框整体范围预览、模板识别核对，以及与有效绘图区域进行内外关系检查。 |
实际示例
假设“01 获取 CAD 图框”已经从一个标准模板中读到一项有效图框，其中块实例包含三个属性，依次是图号、项目名和日期，并且模板内已有相应原始值。将这一项图框数据连接到“图框类”。组件会输出三个 Keys 和三个 Values；读取时应把 Keys[0] 与 Values[0]、Keys[1] 与 Values[1]、Keys[2] 与 Values[2] 分别视为三组属性，而不能对两个列表单独排序。
同时，画布预览中可以分别查看两个矩形：较内侧的“有效绘图区域”代表后续图元应当适配的可用范围，可连接到“03 预计算图框比例”；“图框外框线”代表整张图框的外边界，可用来确认模板识别范围。可观察结果是，属性字段能够按真实 Key 准备后续填写，比例计算使用内侧有效范围，而外框仍保留用于整体边界核对。
配合使用
- 第 1 步上游：使用“01 获取 CAD 图框”读取标准 DWG，输出有效图框数据后再连接本组件。本组件本身不接收文件路径，也不负责读取模板。
- 第 2 步属性准备：查看 Keys 与 Values，确认模板真实字段。需要为新图框指定内容时，将这些真实 Keys 作为“02 图框属性”的填写依据。
- 第 3 步比例准备：把“有效绘图区域”交给“03 预计算图框比例”相关流程，以模板可用区域而非整张外框评估图元适配。
- 第 4 步检查：将两个矩形预览或比较，确认有效绘图区域位于外框范围内，并检查模板读取结果是否符合预期。
常见问题与限制
- 为什么输入后四个端口都没有有效结果？
- 输入必须是“01 获取 CAD 图框”产生的有效图框数据。文件路径、普通几何、块实例或仅包含属性的另一类数据都不能代替完整图框结果。
- 为什么 Keys 和 Values 不能分别排序？
- 两个列表依靠相同索引保持属性对应关系。单独排序其中一个列表会使 Key 与 Value 错配；若要重排，必须把每一对一起移动。
- 为什么 Keys 列表是空的？
- 有效模板可能没有可输出的块属性。组件不会制造属性键；空列表不等同于有效绘图区域和外框矩形也无效。
- 有效绘图区域与图框外框线应该选哪一个做比例适配？
- 使用“有效绘图区域”。外框线代表整张图框的总体边界，不等同于内容可用范围。
- 能否一次输入多个图框并得到对应数据树？
- 这个输入是单项形式，事实未确认批量列表或数据树处理。多个模板应分别提供单项输入，不应假定组件会自动匹配分支。
- 这个组件会修改图框属性或写回 DWG 吗？
- 不会。它只分解并输出已有图框数据，用于检查和连接后续步骤，不执行属性写入或 CAD 导出。