三种组件类型

第三章：三种组件类型，选对不迷路

LoongCAD 提供了三种组件基类，分别对应不同的业务场景。选对基类是开发的第一步。

3.1 组件类型对照

类型	基类	典型场景	谁来选零件？	入口方法
自定义组件	CustomPlugin	桁架、支撑、楼梯等非节点构件	用户在场景中自由点选	Run(Component, List<InputDefinition>)
节点组件	ConnectionPlugin	梁柱节点、主次梁连接	用户在模型中指定主次零件	Run(Connection)
细部组件	DetailPlugin	柱脚、加劲肋、端板	用户指定一根构件+位置	Run(Detail)

3.2 什么时候用哪种？

你做的组件是：
├── 连接两根（或多根）构件的？    → 节点组件 (ConnectionPlugin)
├── 只需要附属在一根构件上的？    → 细部组件 (DetailPlugin)
└── 完全独立的（不依附于已有构件）？→ 自定义组件 (CustomPlugin)

节点组件 是最常用的类型（占 80% 以上）。它的主/次零件由用户在模型中通过节点位置自动识别，你不需要写 DefineInput()。

自定义组件 给了你最大的自由度，但需要你自己处理所有用户交互。

细部组件 类似于依附于单根构件的"附件"，比如柱脚板、加劲肋。可以通过 [PluginRefPoint(true)] 让用户额外指定一个参考点。

3.3 核心区别：谁负责采集用户输入？

节点组件：
  用户操作 → LoongCAD 框架自动识别主次零件 → 调用你的 Run(Connection)

自定义组件：
  用户操作 → 你的 DefineInput() 采集点/线/面 → 调用你的 Run(Component, input)

细部组件：
  用户操作 → 框架识别主零件 + 用户选参考点(可选) → 调用你的 Run(Detail)