cyBattery 中文电池完整教程

按照 Anemone 教程的写法重排：每个电池都写清楚什么时候用、左侧输入端口从上到下怎么接、右侧输出端口接到哪里、注意事项、输入输出端口表、底层信息和可复制模板。图标已和 cyBattery.gha 内嵌资源同步。

插件文件：cyBattery.gha电池总数：59中文分类：10图标资源：75 个 PNG教程更新：2026-05-16

常用实战

这几个属性电池怎么串

这几个电池的分工

几何属性查询负责把几何变成数值、点、边、面、布尔值，例如 Area、Centroid、Faces。几何过滤负责按条件保留或剔除，例如 Area > 5。几何排序负责按一个依据重排列表，例如 CentroidZ。几何匹配负责把两组对象按位置关系配对。点环排列主要用于一圈点按角度/半径整理顺序。

几何匹配怎么理解

它不是查询属性，也不是排序；它是给两组对象建立对应关系。比如一组面板和一组文字点、一组螺栓孔和一组螺栓、一组源构件和一组目标定位点。closest 是每个源对象找最近目标，mutual 是双方互相最近才算配上，distance 是小于容差才匹配，index 是第 0 个对第 0 个、第 1 个对第 1 个。

快速求物体最上面面的中心点

适合一个封闭 Brep 或盒子类实体：先把实体拆成面，再按每个面的质心高度排序，最后取最高那张面的质心。

实体接到 几何属性查询 / 输入几何，属性端口输入 Faces，得到每一张面。
Faces 输出接到 几何排序 / 输入几何，排序依据输入 CentroidZ。
排序电池的 升序 设为 false，让最高的面排在第 0 个。
用 Grasshopper 的 List Item 取第 0 个面。
这个面再接 几何属性查询，属性输入 Centroid，输出就是最上面面的中心点。

属性查询：Faces
排序依据：CentroidZ
升序：false
List Item：0
属性查询：Centroid

指令与输出速查

复制到 Panel，再接 Text 端口

这一段只按当前 cyBattery.gha 的实际解析规则写。当前 .gha 不解析括号调用。要测试时先把下面的值复制到 Panel，再接到对应 Text 端口；属性名大小写不敏感，但不要加括号。

1. 几何属性查询：接到「几何属性查询 / 属性」端口

这个电池输出三项：属性值、成功、几何类型。几何类型是右侧固定输出，不需要在属性端口输入 Type。下面只列当前属性端口真正支持的命令。

1.1 点 Point 可用属性

属性指令	对象	输出说明
`X`	Point / GH_Point	输出点的 X 坐标。用于左右分区、排序和坐标检查。
`Y`	Point / GH_Point	输出点的 Y 坐标。用于前后方向排序、过滤和检查。
`Z`	Point / GH_Point	输出点的 Z 坐标。用于高度、楼层、标高判断。
`Coordinates` `Coords` `Point`	Point / GH_Point	输出原始点对象本身。适合确认属性查询端口是否接对。
`DistanceToOrigin` `Magnitude`	Point / GH_Point	输出点到世界原点的距离。适合按离原点远近排序或过滤。

1.2 曲线 Curve / Line / Polyline 可用属性

属性指令	对象	输出说明
`Length` `L`	Curve / Line / Polyline	输出曲线长度。当前 cy 新命令不带括号，短写 L 与 Length 等价。
`IsClosed`	Curve / Polyline	输出 Boolean，判断曲线是否闭合。
`StartPoint` `Start`	Curve / Line	输出曲线起点。
`EndPoint` `End`	Curve / Line	输出曲线终点。
`MidPoint` `Mid`	Curve / Line	输出曲线参数域中点位置的点。
`AvePt` `AveragePoint`	Curve / Polyline	输出曲线采样/控制点平均位置，适合做粗略代表点。
`Points` `Pts`	Curve / Polyline	输出曲线离散点或多段线点集合。
`PtsCount` `PointsCount`	Curve / Polyline	输出点数量，用于判断多段线复杂度。
`EndPts` `EndPoints`	Curve / Line	输出起点和终点列表。
`Domain`	Curve	输出曲线参数域。
`Degree`	Curve	输出曲线阶数。
`SpanCount`	Curve	输出曲线 Span 数量。
`CrvVector` `Direction`	Curve / Line	输出曲线方向向量。
`IsLinear`	Curve	输出 Boolean，判断是否为直线型曲线。
`IsArc`	Curve	输出 Boolean，判断是否为圆弧。
`IsCircle`	Curve	输出 Boolean，判断是否为整圆。
`IsEllipse`	Curve	输出 Boolean，判断是否为椭圆。
`IsPlanar`	Curve	输出 Boolean，判断曲线是否共面。
`IsPr`	Curve / Polyline	输出 Boolean，判断是否为 Polyline。
`Dimension`	Curve	输出 1 / 2 / 3：直线型、平面曲线或空间曲线的粗略维度判断。

1.3 Brep 可用属性

属性指令	对象	输出说明
`Area`	Brep	输出 Brep 面积。失败时当前代码返回 0。
`Volume`	Brep	输出 Brep 体积。开放对象或失败时当前代码返回 0。
`Centroid`	Brep	输出 Brep 面积质心点。注意：属性查询支持 Centroid 点，不支持 CentroidX/Y/Z；质心坐标排序请用几何排序电池。
`IsClosed` `IsSolid`	Brep	输出 Boolean，判断 Brep 是否封闭成实体。
`FaceCount`	Brep	输出面数量。
`EdgeCount`	Brep	输出边数量。
`VertexCount`	Brep	输出顶点数量。
`IsManifold`	Brep	输出 Boolean，判断是否流形。
`IsSurface`	Brep	输出 Boolean，判断是否为单面 Brep。
`Faces`	Brep	输出每个 BrepFace 复制后的面列表。
`Edges`	Brep	输出每条边复制后的 Curve 列表。

1.4 Surface 可用属性

属性指令	对象	输出说明
`Area`	Surface	输出曲面面积。
`Centroid`	Surface	输出曲面面积质心点。
`DomainU` `UDomain`	Surface	输出 U 方向参数域。
`DomainV` `VDomain`	Surface	输出 V 方向参数域。
`IsClosedU`	Surface	输出 Boolean，判断 U 方向是否闭合。
`IsClosedV`	Surface	输出 Boolean，判断 V 方向是否闭合。
`IsPeriodicU`	Surface	输出 Boolean，判断 U 方向是否周期。
`IsPeriodicV`	Surface	输出 Boolean，判断 V 方向是否周期。
`IsSingular`	Surface	输出 Boolean，判断曲面是否存在奇点。
`DegreeU`	Surface	输出 U 方向阶数。
`DegreeV`	Surface	输出 V 方向阶数。

1.5 Mesh 可用属性

属性指令	对象	输出说明
`VertexCount`	Mesh	输出网格顶点数量。
`FaceCount`	Mesh	输出网格面数量。
`Volume`	Mesh	输出网格体积；开放网格或失败时返回 0。
`IsClosed`	Mesh	输出 Boolean，判断网格是否闭合。
`IsManifold`	Mesh	输出 Boolean，判断网格是否流形。
`Vertices`	Mesh	输出网格顶点 Point3d 列表。

2. 几何过滤：接到「几何过滤 / 过滤条件」端口

过滤表达式格式是 属性操作符数值，支持 >、>=、<、<=、==、!=。Boolean 属性也可以直接写 IsClosed，取反写 not IsClosed 或 !IsClosed。过滤只支持能转成数字或 Boolean 的属性，所以 Pts、Centroid、Faces 这类对象/列表输出不能作为过滤条件。

2.1 点 Point 过滤

过滤表达式	判断含义	适用对象
`X > 0`	点 X 坐标大于 0。	Point / GH_Point
`Y < 0`	点 Y 坐标小于 0。	Point / GH_Point
`Z >= 3000`	点 Z 高度大于等于 3000。	Point / GH_Point
`DistanceToOrigin < 10000`	点到世界原点距离小于 10000。	Point / GH_Point
`Magnitude >= 1`	Magnitude 是 DistanceToOrigin 的别名。	Point / GH_Point

2.2 曲线 Curve 过滤

过滤表达式	判断含义	适用对象
`Length > 100`	长度大于 100。	Curve / Line / Polyline
`L <= 500`	短写 L 与 Length 等价。	Curve / Line / Polyline
`IsClosed`	只保留闭合曲线。	Curve / Polyline
`not IsClosed`	只保留开放曲线。	Curve / Polyline
`!IsClosed`	开放曲线短写。	Curve / Polyline
`IsPlanar == true`	只保留共面曲线。	Curve
`IsLinear == true`	只保留直线型曲线。	Curve
`IsArc == true`	只保留圆弧。	Curve
`IsCircle == true`	只保留整圆。	Curve
`IsEllipse == true`	只保留椭圆。	Curve
`IsPr == true`	只保留 Polyline。	Curve / Polyline
`Degree <= 3`	曲线阶数小于等于 3。	Curve
`SpanCount > 1`	Span 数量大于 1。	Curve
`Dimension == 2`	保留平面曲线维度判断为 2 的对象。	Curve

2.3 Brep 过滤

过滤表达式	判断含义	适用对象
`Area > 5`	Brep 面积大于 5。	Brep
`Volume > 0`	Brep 体积大于 0。	Brep
`IsSolid == true`	只保留封闭实体。	Brep
`IsClosed == true`	IsClosed 对 Brep 等价于 IsSolid。	Brep
`IsSurface == true`	只保留单面 Brep。	Brep
`IsManifold == true`	只保留流形 Brep。	Brep
`FaceCount < 10`	面数量小于 10。	Brep
`EdgeCount <= 20`	边数量小于等于 20。	Brep
`VertexCount > 4`	顶点数量大于 4。	Brep

2.4 Surface 过滤

过滤表达式	判断含义	适用对象
`Area >= 5`	曲面面积大于等于 5。	Surface
`IsClosedU == true`	U 方向闭合。	Surface
`IsClosedV == true`	V 方向闭合。	Surface
`IsPeriodicU == true`	U 方向周期。	Surface
`IsPeriodicV == true`	V 方向周期。	Surface
`DegreeU <= 3`	U 方向阶数小于等于 3。	Surface
`DegreeV <= 3`	V 方向阶数小于等于 3。	Surface

2.5 Mesh 过滤

过滤表达式	判断含义	适用对象
`VertexCount > 100`	网格顶点数量大于 100。	Mesh
`FaceCount < 500`	网格面数量小于 500。	Mesh
`Volume > 0`	网格体积大于 0。	Mesh
`IsClosed == true`	只保留闭合网格。	Mesh
`IsManifold == true`	只保留流形网格。	Mesh

3. 几何排序：接到「几何排序 / 排序依据」端口

排序依据只填一个键，例如 Length 或 CentroidZ，升序/降序由排序电池的 Boolean 端口控制。排序电池和属性查询电池支持范围不完全一样：例如 CentroidZ 是排序键，但不是属性查询键。

3.1 点 Point 排序

排序依据	排序逻辑	适用对象	复制
`X` `Y` `Z`	按点坐标排序。升序开关决定从小到大或从大到小。	Point / GH_Point
`DistanceToOrigin` `Magnitude`	按点到世界原点距离排序。	Point / GH_Point

3.2 曲线 Curve 排序

排序依据	排序逻辑	适用对象
`Length` `L`	按曲线长度排序。	Curve / Line / Polyline
`Degree`	按曲线阶数排序。	Curve
`SpanCount`	按 Span 数量排序。	Curve
`Dimension`	按维度判断值排序：1/2/3。	Curve
`StartX` `StartY` `StartZ`	按曲线起点坐标排序。	Curve / Line
`EndX` `EndY` `EndZ`	按曲线终点坐标排序。	Curve / Line
`MidX` `MidY` `MidZ`	按曲线参数中点坐标排序。	Curve / Line

3.3 Brep 排序

排序依据	排序逻辑	适用对象
`Area`	按 Brep 面积排序。	Brep
`Volume`	按 Brep 体积排序。	Brep
`FaceCount` `EdgeCount` `VertexCount`	按面、边、顶点数量排序。	Brep
`CentroidX` `CentroidY` `CentroidZ`	按 Brep 面积质心坐标排序。注意这是排序电池支持的键，不是属性查询键。	Brep

3.4 Surface 排序

排序依据	排序逻辑	适用对象	复制
`Area`	按曲面面积排序。	Surface
`DegreeU` `DegreeV`	按 U/V 方向阶数排序。	Surface

3.5 Mesh 排序

排序依据	排序逻辑	适用对象	复制
`VertexCount` `FaceCount`	按网格顶点或面数量排序。	Mesh
`Volume`	按网格体积排序。	Mesh

4. 几何匹配：接到「几何匹配 / 匹配规则」端口

匹配规则	怎么匹配	输出会有什么
`closest`	每个源对象找最近目标对象。未识别的文本也会按 closest 处理。	输出源匹配项、目标匹配项、源索引、目标索引、未匹配源、未匹配目标和距离。
`mutual`	源和目标互相都是最近时才匹配。	适合更严格的一对一关系。
`distance`	距离小于容差端口时匹配。	需要同时设置容差端口。
`index`	按列表索引匹配。	第 0 对第 0，第 1 对第 1，适合已经排序好的列表。

5. 格式、文本、通道和路径：接到对应 Text 端口

接入端口	可复制值	说明
格式点 / 坐标分隔符	`,`	输出 `X,Y,Z`，适合 CSV 或普通文本。
格式点 / 坐标分隔符	`;`	输出 `X;Y;Z`，适合不想和小数逗号混淆的表格。
面板角点格式化 / 分隔符	`Tab`	复制到 Excel/WPS 时自动分列。
循环替代 / 查找内容	`old`	查找要替换的文本，可先用简单词测试。
循环替代 / 替换内容	`new`	把查找内容替换成新内容。
循环替代 / 查找内容	`\s+`	开启正则时可匹配连续空白。
无线发送 / 通道	`panel_A`	发送端和接收端使用同名通道。
无线发送 / 通道	`cyBattery_debug`	调试通道名，避免和正式通道混在一起。
批量出图 / 输出路径	`D:\\Output\\cyBattery`	示例文件夹路径；实际使用前确认文件夹存在。

6. 常用默认值和开关：接 Number / Integer / Boolean / Plane 端口

端口场景	可复制值	说明
布尔开关	`true`	开启：发送、正则、循环、顺时针、投影等开关。
布尔开关	`false`	关闭：先用 false 测试默认行为。
列表/轴向索引	`0`	常用于第 0 项、X 轴或起点。
列表/轴向索引	`1`	常用于第 1 项、Y 轴或中点。
列表/轴向索引	`2`	常用于第 2 项、Z 轴或终点。
自定义方向	`-1`	部分端口用 -1 表示使用自定义向量。
常用角度	`45`	斜切、折边、旋转测试角度。
常用角度	`90`	直角折边、垂直关系测试。
常用容差	`0.01`	分割、匹配、扫掠、曲线容差的起步测试值。
常用半径	`2.0`	折边半径、倒角半径、小圆角测试。

电池用法目录

59 个电池

00 属性读取、过滤、排序、匹配和查询几何属性。先确认几何类型，再决定属性关键词、过滤条件或匹配规则。5 01 点创建点阵、格式化点坐标、定位最近点、整理面板角点和双倾点位。重点检查点顺序、列表分支和参考平面。5 02 向量生成方向向量、平面和切分方向。重点检查起止点、法向方向、参考平面和坐标系。5 03 曲线处理边界、钣金折边、描线、倒角、角点属性、直弧化、偏移、容差分割和等分布置。12 04 曲面测量曲面夹角、单轨扫掠、面上线垂面、封面下拉和偏移封面下拉。5 05 实体处理螺栓、螺丝、龙骨、放样、曲面修正、扫掠、实体拉升、实体偏移和斜切放样。14 06 数据处理列表、镜像、复制、统计、文字统计和循环替代。重点检查列表长度、路径和文本分隔符。7 07 变换移动几何和三点定位。重点检查源点、目标点、方向向量和变换矩阵。2 08 烘焙批量出图、图框定位和无线发送。重点检查输出路径、通道、发送开关和 Rhino 文档状态。2 09 铝板铝板单边折边和多边折边。重点检查面板、边索引、角度、半径和折边方向。2

这份教程的结构已同步 Anemone 教程：每个电池都按“什么时候用 → 输入怎么接 → 输出接哪里 → 注意事项 → 端口表 → 底层信息”组织；cyBattery 新图标也在每张电池卡片中同步展示。

00 属性

5 个电池

读取、过滤、排序、匹配和查询几何属性。先确认几何类型，再决定属性关键词、过滤条件或匹配规则。

01 点环排列

环排 · cytoos > 00 属性

按角度位置将点集围绕圆形进行环形排列

图标识别：圆环、方向箭头和点位，对应按角度/半径对点做环形排序。

插件：cyBattery.gha 分类：cytoos 子分类：00 属性输入：7 输出：4

什么时候用

按角度位置将点集围绕圆形进行环形排列。当你的流程需要读取、过滤、排序或匹配几何属性时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 点点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
2. 参考平面平面：接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。；未连接时使用默认值：Plane.WorldXY。
3. 起始角度起始角：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。角度通常按度理解，先用 0、45、90 做小范围测试。；未连接时使用默认值：0.0。
4. 顺时针顺时针：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。
5. 按半径分组按半径：接 Boolean Toggle。True 开启，False 关闭。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：false。
6. 投影投影：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。
7. 分组数量分组数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。

右侧输出端口接到哪里

1. 排序后点排序后：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
2. 角度角度：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
3. 半径半径：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
4. 索引索引：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
点点	`Point`列表	输入点参数：点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
参考平面平面	`Plane`单项	用于定位、投影或切割的参考平面。默认值：Plane.WorldXY	接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。；未连接时使用默认值：Plane.WorldXY。
起始角度起始角	`Number`单项	输入数值参数：起始角度。默认值：0.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。角度通常按度理解，先用 0、45、90 做小范围测试。；未连接时使用默认值：0.0。
顺时针顺时针	`Boolean`单项	开启后按顺时针排序，关闭后按逆时针排序。默认值：false	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。
按半径分组按半径	`Boolean`单项	开启后先按半径分圈，再按角度排序。默认值：false	接 Boolean Toggle。True 开启，False 关闭。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：false。
投影投影	`Boolean`单项	开启后先把点投影到参考平面再排序，关闭则使用原始三维位置。but compute angle relative to the plane.默认值：false	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。
分组数量分组数	`Integer`单项	按角度容差分组时使用的分组数量。Points within the same angular group are sorted by radius. Set 0 to disable grouping.默认值：0	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。

输出端口

端口	类型/结构	中文说明	下游用法
排序后点排序后	`Point`列表	输出点参数：排序后点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
角度角度	`Number`列表	输出数值参数：角度。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
半径半径	`Number`列表	输出数值参数：半径。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
索引索引	`Integer`列表	输出整数参数：索引。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

点环排列 (cytoos > 00 属性)
用途：按角度位置将点集围绕圆形进行环形排列
输入：
  1. 点 [Point/列表] - 输入点参数：点。
  2. 参考平面 [Plane/单项] 默认=Plane.WorldXY - 用于定位、投影或切割的参考平面。
  3. 起始角度 [Number/单项] 默认=0.0 - 输入数值参数：起始角度。
  4. 顺时针 [Boolean/单项] 默认=false - 开启后按顺时针排序，关闭后按逆时针排序。
  5. 按半径分组 [Boolean/单项] 默认=false - 开启后先按半径分圈，再按角度排序。
  6. 投影 [Boolean/单项] 默认=false - 开启后先把点投影到参考平面再排序，关闭则使用原始三维位置。but compute angle relative to the plane.
  7. 分组数量 [Integer/单项] 默认=0 - 按角度容差分组时使用的分组数量。Points within the same angular group are sorted by radius. Set 0 to disable grouping.
输出：
  1. 排序后点 [Point/列表] - 输出点参数：排序后点。
  2. 角度 [Number/列表] - 输出数值参数：角度。
  3. 半径 [Number/列表] - 输出数值参数：半径。
  4. 索引 [Integer/列表] - 输出整数参数：索引。
图标：圆环、方向箭头和点位，对应按角度/半径对点做环形排序。

底层信息

底层类型：PointsCircleSortComponent

GUID：A1B2C3D4-0005-4000-8000-000000000001

源码位置：cyBattery.Components.Property\PointsCircleSortComponent.cs

图标资源：Icon_PointsCircleSort.png

02 几何过滤

过滤 · cytoos > 00 属性

根据指定类型、图层、名称或自定义条件对几何体进行过滤筛选

图标识别：漏斗表示过滤，输入点表示按条件筛出通过和未通过对象。

插件：cyBattery.gha 分类：cytoos 子分类：00 属性输入：2 输出：3

什么时候用

根据指定类型、图层、名称或自定义条件对几何体进行过滤筛选。当你的流程需要读取、过滤、排序或匹配几何属性时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入几何几何：接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
2. 过滤条件过滤条：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值："Length > 0"。

右侧输出端口接到哪里

1. 通过项通过项：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 未通过项未通过：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
3. 结果结果：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
输入几何几何	`Geometry`列表	需要处理的几何对象。	接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
过滤条件过滤条	`Text`单项	过滤判断条件，例如按长度、面积、闭合状态或坐标范围筛选。默认值："Length > 0"	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值："Length > 0"。

输出端口

端口	类型/结构	中文说明	下游用法
通过项通过项	`Geometry`列表	输出几何数据：通过项。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
未通过项未通过	`Geometry`列表	输出几何数据：未通过项。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
结果结果	`Boolean`列表	输出布尔开关：结果。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。

复制用法模板

几何过滤 (cytoos > 00 属性)
用途：根据指定类型、图层、名称或自定义条件对几何体进行过滤筛选
输入：
  1. 输入几何 [Geometry/列表] - 需要处理的几何对象。
  2. 过滤条件 [Text/单项] 默认="Length > 0" - 过滤判断条件，例如按长度、面积、闭合状态或坐标范围筛选。
输出：
  1. 通过项 [Geometry/列表] - 输出几何数据：通过项。
  2. 未通过项 [Geometry/列表] - 输出几何数据：未通过项。
  3. 结果 [Boolean/列表] - 输出布尔开关：结果。
图标：漏斗表示过滤，输入点表示按条件筛出通过和未通过对象。

底层信息

底层类型：FilterComponent

GUID：A1B2C3D4-0002-4000-8000-000000000001

源码位置：cyBattery.Components.Property\FilterComponent.cs

图标资源：Icon_Filter.png

03 几何排序

排序 · cytoos > 00 属性

按指定属性（面积、体积、长度等）对几何体列表进行排序

图标识别：长短横线和方向箭头，对应按属性值重新排序。

插件：cyBattery.gha 分类：cytoos 子分类：00 属性输入：3 输出：3

什么时候用

按指定属性（面积、体积、长度等）对几何体列表进行排序。当你的流程需要读取、过滤、排序或匹配几何属性时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入几何几何：接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
2. 排序依据排序依：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值："Length"。
3. 升序升序：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

右侧输出端口接到哪里

1. 排序后排序后：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 索引索引：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
3. 数值数值：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
输入几何几何	`Geometry`列表	需要处理的几何对象。	接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
排序依据排序依	`Text`单项	排序使用的几何属性，可按坐标、长度、面积、体积或顶点数量排序。默认值："Length"	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值："Length"。
升序升序	`Boolean`单项	开启后按从小到大排序，关闭后按从大到小排序。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

输出端口

端口	类型/结构	中文说明	下游用法
排序后排序后	`Geometry`列表	输出几何数据：排序后。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
索引索引	`Integer`列表	输出整数参数：索引。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
数值数值	`Number`列表	输出数值参数：数值。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

几何排序 (cytoos > 00 属性)
用途：按指定属性（面积、体积、长度等）对几何体列表进行排序
输入：
  1. 输入几何 [Geometry/列表] - 需要处理的几何对象。
  2. 排序依据 [Text/单项] 默认="Length" - 排序使用的几何属性，可按坐标、长度、面积、体积或顶点数量排序。
  3. 升序 [Boolean/单项] 默认=true - 开启后按从小到大排序，关闭后按从大到小排序。
输出：
  1. 排序后 [Geometry/列表] - 输出几何数据：排序后。
  2. 索引 [Integer/列表] - 输出整数参数：索引。
  3. 数值 [Number/列表] - 输出数值参数：数值。
图标：长短横线和方向箭头，对应按属性值重新排序。

底层信息

底层类型：SortComponent

GUID：A1B2C3D4-0003-4000-8000-000000000001

源码位置：cyBattery.Components.Property\SortComponent.cs

图标资源：Icon_Sort.png

04 几何匹配

匹配 · cytoos > 00 属性

按属性值对几何体进行匹配分组，返回分组结果

图标识别：两组点和连线，对应源对象与目标对象建立匹配关系。

插件：cyBattery.gha 分类：cytoos 子分类：00 属性输入：4 输出：7

什么时候用

按属性值对几何体进行匹配分组，返回分组结果。当你的流程需要读取、过滤、排序或匹配几何属性时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 源几何源：接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
2. 目标几何目标：接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
3. 匹配规则匹配规：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值："closest"。
4. 容差容差：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：2.3283064365386963E-08。

右侧输出端口接到哪里

1. 源匹配项源项：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 目标匹配项目标项：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
3. 源索引源索：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
4. 目标索引目标索：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
5. 未匹配源未源：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
6. 未匹配目标未目标：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
7. 距离距离：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
源几何源	`Geometry`列表	作为匹配来源的几何列表。	接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
目标几何目标	`Geometry`列表	用于查找对应关系的目标几何列表。	接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
匹配规则匹配规	`Text`单项	匹配方式，可按最近、互选、距离或索引进行匹配。默认值："closest"	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值："closest"。
容差容差	`Number`单项	几何判断、分组或偏移使用的容许误差。默认值：2.3283064365386963E-08	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：2.3283064365386963E-08。

输出端口

端口	类型/结构	中文说明	下游用法
源匹配项源项	`Geometry`列表	已找到对应关系的源几何。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
目标匹配项目标项	`Geometry`列表	与源几何对应的目标几何。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
源索引源索	`Integer`列表	匹配项在源列表中的原始索引。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
目标索引目标索	`Integer`列表	匹配项在目标列表中的原始索引。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
未匹配源未源	`Geometry`列表	源列表中没有找到对应项的几何。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
未匹配目标未目标	`Geometry`列表	目标列表中没有被匹配到的几何。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
距离距离	`Number`列表	匹配项或测量点之间的距离值。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

几何匹配 (cytoos > 00 属性)
用途：按属性值对几何体进行匹配分组，返回分组结果
输入：
  1. 源几何 [Geometry/列表] - 作为匹配来源的几何列表。
  2. 目标几何 [Geometry/列表] - 用于查找对应关系的目标几何列表。
  3. 匹配规则 [Text/单项] 默认="closest" - 匹配方式，可按最近、互选、距离或索引进行匹配。
  4. 容差 [Number/单项] 默认=2.3283064365386963E-08 - 几何判断、分组或偏移使用的容许误差。
输出：
  1. 源匹配项 [Geometry/列表] - 已找到对应关系的源几何。
  2. 目标匹配项 [Geometry/列表] - 与源几何对应的目标几何。
  3. 源索引 [Integer/列表] - 匹配项在源列表中的原始索引。
  4. 目标索引 [Integer/列表] - 匹配项在目标列表中的原始索引。
  5. 未匹配源 [Geometry/列表] - 源列表中没有找到对应项的几何。
  6. 未匹配目标 [Geometry/列表] - 目标列表中没有被匹配到的几何。
  7. 距离 [Number/列表] - 匹配项或测量点之间的距离值。
图标：两组点和连线，对应源对象与目标对象建立匹配关系。

底层信息

底层类型：MatchComponent

GUID：A1B2C3D4-0004-4000-8000-000000000001

源码位置：cyBattery.Components.Property\MatchComponent.cs

图标资源：Icon_Match.png

05 几何属性查询

属查 · cytoos > 00 属性

查询输入几何体的指定属性，如长度、面积、体积、质心、是否闭合等

图标识别：盒体加放大镜，对应读取几何属性。

插件：cyBattery.gha 分类：cytoos 子分类：00 属性输入：2 输出：3

什么时候用

查询输入几何体的指定属性，如长度、面积、体积、质心、是否闭合等。当你的流程需要读取、过滤、排序或匹配几何属性时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入几何几何：接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
2. 属性属性：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值："Length"。

右侧输出端口接到哪里

1. 属性值属性值：先接 Panel 或 Param Viewer 检查数据，再接到下游组件。
2. 成功成功：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
3. 几何类型几何类：可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
输入几何几何	`Geometry`单项	需要处理的几何对象。	接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
属性属性	`Text`单项	输入文本参数：属性。默认值："Length"	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值："Length"。

输出端口

端口	类型/结构	中文说明	下游用法
属性值属性值	`Generic`单项	输出通用数据：属性值。	先接 Panel 或 Param Viewer 检查数据，再接到下游组件。
成功成功	`Boolean`单项	输出布尔开关：成功。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
几何类型几何类	`Text`单项	输出文本参数：几何类型。	可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。

复制用法模板

几何属性查询 (cytoos > 00 属性)
用途：查询输入几何体的指定属性，如长度、面积、体积、质心、是否闭合等
输入：
  1. 输入几何 [Geometry/单项] - 需要处理的几何对象。
  2. 属性 [Text/单项] 默认="Length" - 输入文本参数：属性。
输出：
  1. 属性值 [Generic/单项] - 输出通用数据：属性值。
  2. 成功 [Boolean/单项] - 输出布尔开关：成功。
  3. 几何类型 [Text/单项] - 输出文本参数：几何类型。
图标：盒体加放大镜，对应读取几何属性。

底层信息

底层类型：GeoPropertyComponent

GUID：A1B2C3D4-0001-4000-8000-000000000001

源码位置：cyBattery.Components.Property\GeoPropertyComponent.cs

图标资源：Icon_GeoProperty.png

01 点

5 个电池

创建点阵、格式化点坐标、定位最近点、整理面板角点和双倾点位。重点检查点顺序、列表分支和参考平面。

06 点阵

点阵 · cytoos > 01 点

在指定平面上创建矩形点阵网格，可控制行列间距

图标识别：九宫格点阵，对应按行列生成点阵。

插件：cyBattery.gha 分类：cytoos 子分类：01 点输入：6 输出：2

什么时候用

在指定平面上创建矩形点阵网格，可控制行列间距。当你的流程需要生成、定位或格式化点数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 平面平面：接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。；未连接时使用默认值：Plane.WorldXY。
2. X向数量向数量：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。
3. Y向数量向数量：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。
4. X向间距向间距：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：1000.0。
5. Y向间距向间距：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：1000.0。
6. 锚点锚点：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：1。

右侧输出端口接到哪里

1. 点点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
2. 数量数量：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
平面平面	`Plane`单项	基准平面。默认值：Plane.WorldXY	接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。；未连接时使用默认值：Plane.WorldXY。
X向数量向数量	`Integer`单项	X 方向点数。默认值：5	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。
Y向数量向数量	`Integer`单项	Y 方向点数。默认值：5	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。
X向间距向间距	`Number`单项	X 方向间距。默认值：1000.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：1000.0。
Y向间距向间距	`Number`单项	Y 方向间距。默认值：1000.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：1000.0。
锚点锚点	`Integer`单项	锚点位置：0为起点或左下，1为居中，2为终点或右上。默认值：1	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：1。

输出端口

端口	类型/结构	中文说明	下游用法
点点	`Point`列表	生成的点阵。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
数量数量	`Integer`单项	点总数。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

点阵 (cytoos > 01 点)
用途：在指定平面上创建矩形点阵网格，可控制行列间距
输入：
  1. 平面 [Plane/单项] 默认=Plane.WorldXY - 基准平面。
  2. X向数量 [Integer/单项] 默认=5 - X 方向点数。
  3. Y向数量 [Integer/单项] 默认=5 - Y 方向点数。
  4. X向间距 [Number/单项] 默认=1000.0 - X 方向间距。
  5. Y向间距 [Number/单项] 默认=1000.0 - Y 方向间距。
  6. 锚点 [Integer/单项] 默认=1 - 锚点位置：0为起点或左下，1为居中，2为终点或右上。
输出：
  1. 点 [Point/列表] - 生成的点阵。
  2. 数量 [Integer/单项] - 点总数。
图标：九宫格点阵，对应按行列生成点阵。

底层信息

底层类型：PointArrayComponent

GUID：3D9B5C2F-7E0A-48B3-C4D6-F2E8B9A0C531

源码位置：cyBattery.Components.PointCmpts\PointArrayComponent.cs

图标资源：Icon_PointArray.png

07 格式点

格点 · cytoos > 01 点

按指定精度和格式对点坐标进行格式化输出

图标识别：点到文本横线，对应点坐标格式化输出。

插件：cyBattery.gha 分类：cytoos 子分类：01 点输入：4 输出：5

什么时候用

按指定精度和格式对点坐标进行格式化输出。当你的流程需要生成、定位或格式化点数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 点点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
2. 小数位小数位：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
3. 坐标分隔符坐标分：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值：","。
4. 加括号加括号：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

右侧输出端口接到哪里

1. 格式化结果格式化：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
2. 圆整点圆整点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
3. X坐标 X：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
4. Y坐标 Y：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
5. Z坐标 Z：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
点点	`Point`列表	待格式化的点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
小数位小数位	`Integer`单项	小数位数。默认值：3	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
坐标分隔符坐标分	`Text`单项	坐标分隔符，默认逗号。默认值：","	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值：","。
加括号加括号	`Boolean`单项	是否加括号包裹。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

输出端口

端口	类型/结构	中文说明	下游用法
格式化结果格式化	`Text`列表	格式化后的坐标字符串。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
圆整点圆整点	`Point`列表	四舍五入后的点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
X坐标X	`Number`列表	X 坐标值列表。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
Y坐标Y	`Number`列表	Y 坐标值列表。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
Z坐标Z	`Number`列表	Z 坐标值列表。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

格式点 (cytoos > 01 点)
用途：按指定精度和格式对点坐标进行格式化输出
输入：
  1. 点 [Point/列表] - 待格式化的点。
  2. 小数位 [Integer/单项] 默认=3 - 小数位数。
  3. 坐标分隔符 [Text/单项] 默认="," - 坐标分隔符，默认逗号。
  4. 加括号 [Boolean/单项] 默认=true - 是否加括号包裹。
输出：
  1. 格式化结果 [Text/列表] - 格式化后的坐标字符串。
  2. 圆整点 [Point/列表] - 四舍五入后的点。
  3. X坐标 [Number/列表] - X 坐标值列表。
  4. Y坐标 [Number/列表] - Y 坐标值列表。
  5. Z坐标 [Number/列表] - Z 坐标值列表。
图标：点到文本横线，对应点坐标格式化输出。

底层信息

底层类型：FormatPointComponent

GUID：2C8A4B1E-6D9F-47A2-B3C5-E1D7F8A9B420

源码位置：cyBattery.Components.PointCmpts\FormatPointComponent.cs

图标资源：Icon_FormatPoint.png

08 快速点定位

点定 · cytoos > 01 点

在点云中使用R树空间索引快速定位离目标点最近的点

图标识别：靶心和点阵，对应在点云中定位最近点。

插件：cyBattery.gha 分类：cytoos 子分类：01 点输入：3 输出：3

什么时候用

在点云中使用R树空间索引快速定位离目标点最近的点。当你的流程需要生成、定位或格式化点数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 点云点云：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
2. 目标点目标点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
3. 数量数量：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：1。

右侧输出端口接到哪里

1. 最近点最近点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
2. 索引索引：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
3. 距离距离：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
点云点云	`Point`列表	点云数据。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
目标点目标点	`Point`单项	目标点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
数量数量	`Integer`单项	返回最近点的个数，默认1。默认值：1	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：1。

输出端口

端口	类型/结构	中文说明	下游用法
最近点最近点	`Point`列表	输出点参数：最近点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
索引索引	`Integer`列表	输出整数参数：索引。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
距离距离	`Number`列表	匹配项或测量点之间的距离值。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

快速点定位 (cytoos > 01 点)
用途：在点云中使用R树空间索引快速定位离目标点最近的点
输入：
  1. 点云 [Point/列表] - 点云数据。
  2. 目标点 [Point/单项] - 目标点。
  3. 数量 [Integer/单项] 默认=1 - 返回最近点的个数，默认1。
输出：
  1. 最近点 [Point/列表] - 输出点参数：最近点。
  2. 索引 [Integer/列表] - 输出整数参数：索引。
  3. 距离 [Number/列表] - 匹配项或测量点之间的距离值。
图标：靶心和点阵，对应在点云中定位最近点。

底层信息

底层类型：QuickPointLocateComponent

GUID：4E0C6D3A-8F1B-49C4-D5E7-A3F9B0D1C642

源码位置：cyBattery.Components.PointCmpts\QuickPointLocateComponent.cs

图标资源：Icon_QuickPointLocate.png

09 面板角点数据输出格式化

角格 · cytoos > 01 点

格式化面板角点数据，用于输出和导出处理

图标识别：矩形四角点，对应面板角点数据整理。

插件：cyBattery.gha 分类：cytoos 子分类：01 点输入：4 输出：2

什么时候用

格式化面板角点数据，用于输出和导出处理。当你的流程需要生成、定位或格式化点数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 角点角点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
2. 小数位小数位：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
3. 分隔符分隔符：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值："\t"。
4. 输出表头输出表：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

右侧输出端口接到哪里

1. 格式化结果格式化：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
2. 面板数量面板数：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
角点角点	`Point`列表	面板角点列表，每4个点一组。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
小数位小数位	`Integer`单项	小数位数。默认值：3	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
分隔符分隔符	`Text`单项	列之间使用的分隔符，默认使用制表符。默认值："\t"	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。；未连接时使用默认值："\t"。
输出表头输出表	`Boolean`单项	是否输出表头。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

输出端口

端口	类型/结构	中文说明	下游用法
格式化结果格式化	`Text`列表	格式化后的面板数据字符串。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
面板数量面板数	`Integer`单项	面板数量。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

面板角点数据输出格式化 (cytoos > 01 点)
用途：格式化面板角点数据，用于输出和导出处理
输入：
  1. 角点 [Point/列表] - 面板角点列表，每4个点一组。
  2. 小数位 [Integer/单项] 默认=3 - 小数位数。
  3. 分隔符 [Text/单项] 默认="\t" - 列之间使用的分隔符，默认使用制表符。
  4. 输出表头 [Boolean/单项] 默认=true - 是否输出表头。
输出：
  1. 格式化结果 [Text/列表] - 格式化后的面板数据字符串。
  2. 面板数量 [Integer/单项] - 面板数量。
图标：矩形四角点，对应面板角点数据整理。

底层信息

底层类型：PanelCornerFormatComponent

GUID：5F1D7E4B-90C2-4A05-E6F8-B4A0C1D2E753

源码位置：cyBattery.Components.PointCmpts\PanelCornerFormatComponent.cs

图标资源：Icon_PanelCornerFormat.png

10 双倾算法

双倾 · cytoos > 01 点

对点集进行双轴倾斜变换，沿两个方向独立调整倾斜角度

图标识别：斜向点列和双弧线，对应双倾角定位算法。

插件：cyBattery.gha 分类：cytoos 子分类：01 点输入：4 输出：2

什么时候用

对点集进行双轴倾斜变换，沿两个方向独立调整倾斜角度。当你的流程需要生成、定位或格式化点数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入点点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
2. X向倾斜向倾斜：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.0。
3. Y向倾斜向倾斜：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.0。
4. 中心中心：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。

右侧输出端口接到哪里

1. 输出点点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
2. 变换变换：可接 Transform、Orient、阵列或用于调试实际变换矩阵。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
输入点点	`Point`列表	需要参与计算或变换的点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
X向倾斜向倾斜	`Number`单项	绕 X 轴的倾斜角度（度）。默认值：0.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.0。
Y向倾斜向倾斜	`Number`单项	绕 Y 轴的倾斜角度（度）。默认值：0.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.0。
中心中心	`Point`单项	倾斜中心点，默认为原点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。

输出端口

端口	类型/结构	中文说明	下游用法
输出点点	`Point`列表	完成变换后的点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
变换变换	`Transform`单项	应用的变换矩阵。	可接 Transform、Orient、阵列或用于调试实际变换矩阵。

复制用法模板

双倾算法 (cytoos > 01 点)
用途：对点集进行双轴倾斜变换，沿两个方向独立调整倾斜角度
输入：
  1. 输入点 [Point/列表] - 需要参与计算或变换的点。
  2. X向倾斜 [Number/单项] 默认=0.0 - 绕 X 轴的倾斜角度（度）。
  3. Y向倾斜 [Number/单项] 默认=0.0 - 绕 Y 轴的倾斜角度（度）。
  4. 中心 [Point/单项] - 倾斜中心点，默认为原点。
输出：
  1. 输出点 [Point/列表] - 完成变换后的点。
  2. 变换 [Transform/单项] - 应用的变换矩阵。
图标：斜向点列和双弧线，对应双倾角定位算法。

底层信息

底层类型：DualTiltPointComponent

GUID：7A1B3F2D-8E4C-49A6-B1D7-F3E5A9C2B810

源码位置：cyBattery.Components.PointCmpts\DualTiltPointComponent.cs

图标资源：Icon_DualTiltPoint.png

02 向量

5 个电池

生成方向向量、平面和切分方向。重点检查起止点、法向方向、参考平面和坐标系。

11 多重分割

多重分 · cytoos > 02 向量

使用多个切割对象对几何体进行多重分割

图标识别：多条切割线，对应多重分割。

插件：cyBattery.gha 分类：cytoos 子分类：02 向量输入：2 输出：2

什么时候用

使用多个切割对象对几何体进行多重分割。当你的流程需要建立方向、平面或分割参考时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入实体实体：接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
2. 参考平面平面：接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。。

右侧输出端口接到哪里

1. 结果实体结果：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
2. 数量数量：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
输入实体实体	`Brep`列表	需要处理的实体对象。	接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
参考平面平面	`Plane`列表	用于定位、投影或切割的参考平面。	接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。。

输出端口

端口	类型/结构	中文说明	下游用法
结果实体结果	`Brep`列表	组件计算后得到的实体结果。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
数量数量	`Integer`单项	输出整数参数：数量。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

多重分割 (cytoos > 02 向量)
用途：使用多个切割对象对几何体进行多重分割
输入：
  1. 输入实体 [Brep/列表] - 需要处理的实体对象。
  2. 参考平面 [Plane/列表] - 用于定位、投影或切割的参考平面。
输出：
  1. 结果实体 [Brep/列表] - 组件计算后得到的实体结果。
  2. 数量 [Integer/单项] - 输出整数参数：数量。
图标：多条切割线，对应多重分割。

底层信息

底层类型：SplitMulComponent

GUID：D8E4C3A1-7B2F-4C59-9D01-358F6A2E1C47

源码位置：cyBattery.Components.VectorCmpts\SplitMulComponent.cs

图标资源：Icon_SplitMul.png

12 两点向量

两点量 · cytoos > 02 向量

通过两个点创建方向向量，从起点指向终点

图标识别：两个端点和箭头，对应由两点生成向量。

插件：cyBattery.gha 分类：cytoos 子分类：02 向量输入：2 输出：1

什么时候用

通过两个点创建方向向量，从起点指向终点。当你的流程需要建立方向、平面或分割参考时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 起点起点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
2. 终点终点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。

右侧输出端口接到哪里

1. 向量向量：先接 Panel 或 Param Viewer 检查数据，再接到下游组件。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
起点起点	`Point`单项	向量或边界的起始参考点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
终点终点	`Point`单项	向量或边界的终止参考点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。

输出端口

端口	类型/结构	中文说明	下游用法
向量向量	`Vector`单项	输出向量参数：向量。	先接 Panel 或 Param Viewer 检查数据，再接到下游组件。

复制用法模板

两点向量 (cytoos > 02 向量)
用途：通过两个点创建方向向量，从起点指向终点
输入：
  1. 起点 [Point/单项] - 向量或边界的起始参考点。
  2. 终点 [Point/单项] - 向量或边界的终止参考点。
输出：
  1. 向量 [Vector/单项] - 输出向量参数：向量。
图标：两个端点和箭头，对应由两点生成向量。

底层信息

底层类型：VectorByTwoPointsComponent

GUID：7E9A2F1C-3D8B-4A65-B1E0-912C5F6A8D34

源码位置：cyBattery.Components.VectorCmpts\VectorByTwoPointsComponent.cs

图标资源：Icon_VectorByTwoPoints.png

13 三点平面

三点面 · cytoos > 02 向量

通过三个点创建参考平面

图标识别：斜面和三点，对应三点确定平面。

插件：cyBattery.gha 分类：cytoos 子分类：02 向量输入：3 输出：1

什么时候用

通过三个点创建参考平面。当你的流程需要建立方向、平面或分割参考时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 原点原点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
2. X向点向点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
3. Y向点向点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。

右侧输出端口接到哪里

1. 平面平面：先接 Panel 或 Param Viewer 检查数据，再接到下游组件。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
原点原点	`Point`单项	输入点参数：原点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
X向点向点	`Point`单项	输入点参数：X向点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
Y向点向点	`Point`单项	输入点参数：Y向点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。

输出端口

端口	类型/结构	中文说明	下游用法
平面平面	`Plane`单项	输出平面参数：平面。	先接 Panel 或 Param Viewer 检查数据，再接到下游组件。

复制用法模板

三点平面 (cytoos > 02 向量)
用途：通过三个点创建参考平面
输入：
  1. 原点 [Point/单项] - 输入点参数：原点。
  2. X向点 [Point/单项] - 输入点参数：X向点。
  3. Y向点 [Point/单项] - 输入点参数：Y向点。
输出：
  1. 平面 [Plane/单项] - 输出平面参数：平面。
图标：斜面和三点，对应三点确定平面。

底层信息

底层类型：PlaneByThreePointsComponent

GUID：5F2A8D1E-9C7B-4E36-A2D0-813B4F7C9E65

源码位置：cyBattery.Components.VectorCmpts\PlaneByThreePointsComponent.cs

图标资源：Icon_PlaneByThreePoints.png

14 实体布尔分割

布尔分 · cytoos > 02 向量

对两个实体执行布尔差集运算进行分割

图标识别：盒体、圆和斜切线，对应实体布尔分割。

插件：cyBattery.gha 分类：cytoos 子分类：02 向量输入：2 输出：2

什么时候用

对两个实体执行布尔差集运算进行分割。当你的流程需要建立方向、平面或分割参考时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 被减实体被减体：接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
2. 切割实体切割体：接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。

右侧输出端口接到哪里

1. 结果实体结果：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
2. 成功成功：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
被减实体被减体	`Brep`单项	布尔差集中保留主体的实体。	接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
切割实体切割体	`Brep`单项	从主体中扣除的切割实体。	接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。

输出端口

端口	类型/结构	中文说明	下游用法
结果实体结果	`Brep`单项	组件计算后得到的实体结果。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
成功成功	`Boolean`单项	输出布尔开关：成功。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。

复制用法模板

实体布尔分割 (cytoos > 02 向量)
用途：对两个实体执行布尔差集运算进行分割
输入：
  1. 被减实体 [Brep/单项] - 布尔差集中保留主体的实体。
  2. 切割实体 [Brep/单项] - 从主体中扣除的切割实体。
输出：
  1. 结果实体 [Brep/单项] - 组件计算后得到的实体结果。
  2. 成功 [Boolean/单项] - 输出布尔开关：成功。
图标：盒体、圆和斜切线，对应实体布尔分割。

底层信息

底层类型：BrepBoolSplitComponent

GUID：B2F7D9E3-6A1C-4D48-B5E2-749A3C0F8D16

源码位置：cyBattery.Components.VectorCmpts\BrepBoolSplitComponent.cs

图标资源：Icon_BrepBoolSplit.png

15 实体平面分割

面切体 · cytoos > 02 向量

使用平面对实体进行切割分割操作

图标识别：盒体斜切线，对应用平面切分实体。

插件：cyBattery.gha 分类：cytoos 子分类：02 向量输入：2 输出：2

什么时候用

使用平面对实体进行切割分割操作。当你的流程需要建立方向、平面或分割参考时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入实体实体：接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
2. 参考平面平面：接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。。

右侧输出端口接到哪里

1. 上侧实体上侧实：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 下侧实体下侧实：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
输入实体实体	`Brep`单项	需要处理的实体对象。	接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
参考平面平面	`Plane`单项	用于定位、投影或切割的参考平面。	接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。。

输出端口

端口	类型/结构	中文说明	下游用法
上侧实体上侧实	`Brep`单项	平面上侧的分割结果。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
下侧实体下侧实	`Brep`单项	平面下侧的分割结果。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

实体平面分割 (cytoos > 02 向量)
用途：使用平面对实体进行切割分割操作
输入：
  1. 输入实体 [Brep/单项] - 需要处理的实体对象。
  2. 参考平面 [Plane/单项] - 用于定位、投影或切割的参考平面。
输出：
  1. 上侧实体 [Brep/单项] - 平面上侧的分割结果。
  2. 下侧实体 [Brep/单项] - 平面下侧的分割结果。
图标：盒体斜切线，对应用平面切分实体。

底层信息

底层类型：BrepSplitByPlaneComponent

GUID：A3C7E1B2-5F9D-4A18-B6C0-274D8E0F6A52

源码位置：cyBattery.Components.VectorCmpts\BrepSplitByPlaneComponent.cs

图标资源：Icon_BrepSplitByPlane.png

03 曲线

12 个电池

处理边界、钣金折边、描线、倒角、角点属性、直弧化、偏移、容差分割和等分布置。

16 2点定边界

两点界 · cytoos > 03 曲线

通过两点定义曲线边界范围，截取中间段

图标识别：两个端点和边界框，对应两点确定边界。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：3 输出：3

什么时候用

通过两点定义曲线边界范围，截取中间段。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 起点起点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
2. 终点终点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
3. 边距边距：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.0。

右侧输出端口接到哪里

1. 边界边界：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
2. 最小点最小点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
3. 最大点最大点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
起点起点	`Point`单项	向量或边界的起始参考点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
终点终点	`Point`单项	向量或边界的终止参考点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
边距边距	`Number`单项	输入数值参数：边距。默认值：0.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.0。

输出端口

端口	类型/结构	中文说明	下游用法
边界边界	`Curve`单项	输出曲线参数：边界。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
最小点最小点	`Point`单项	输出点参数：最小点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
最大点最大点	`Point`单项	输出点参数：最大点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。

复制用法模板

2点定边界 (cytoos > 03 曲线)
用途：通过两点定义曲线边界范围，截取中间段
输入：
  1. 起点 [Point/单项] - 向量或边界的起始参考点。
  2. 终点 [Point/单项] - 向量或边界的终止参考点。
  3. 边距 [Number/单项] 默认=0.0 - 输入数值参数：边距。
输出：
  1. 边界 [Curve/单项] - 输出曲线参数：边界。
  2. 最小点 [Point/单项] - 输出点参数：最小点。
  3. 最大点 [Point/单项] - 输出点参数：最大点。
图标：两个端点和边界框，对应两点确定边界。

底层信息

底层类型：TwoPointBoundaryComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF000002

源码位置：cyBattery.Components.CurveCmpts\TwoPointBoundaryComponent.cs

图标资源：Icon_TwoPointBoundary.png

17 钣金折边

钣金折 · cytoos > 03 曲线

对钣金件进行折边操作，生成折弯效果

图标识别：红色折板，对应钣金折边。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：4 输出：1

什么时候用

对钣金件进行折边操作，生成折弯效果。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 基准曲线基准曲：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 折弯角度折弯角：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。角度通常按度理解，先用 0、45、90 做小范围测试。；未连接时使用默认值：90.0。
3. 折弯半径折弯半：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：2.0。
4. 翻边长度翻边长：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：20.0。

右侧输出端口接到哪里

1. 折弯几何折弯几：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
基准曲线基准曲	`Curve`单项	输入曲线参数：基准曲线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
折弯角度折弯角	`Number`单项	输入数值参数：折弯角度。默认值：90.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。角度通常按度理解，先用 0、45、90 做小范围测试。；未连接时使用默认值：90.0。
折弯半径折弯半	`Number`单项	输入数值参数：折弯半径。默认值：2.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：2.0。
翻边长度翻边长	`Number`单项	输入数值参数：翻边长度。默认值：20.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：20.0。

输出端口

端口	类型/结构	中文说明	下游用法
折弯几何折弯几	`Brep`单项	输出实体参数：折弯几何。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

钣金折边 (cytoos > 03 曲线)
用途：对钣金件进行折边操作，生成折弯效果
输入：
  1. 基准曲线 [Curve/单项] - 输入曲线参数：基准曲线。
  2. 折弯角度 [Number/单项] 默认=90.0 - 输入数值参数：折弯角度。
  3. 折弯半径 [Number/单项] 默认=2.0 - 输入数值参数：折弯半径。
  4. 翻边长度 [Number/单项] 默认=20.0 - 输入数值参数：翻边长度。
输出：
  1. 折弯几何 [Brep/单项] - 输出实体参数：折弯几何。
图标：红色折板，对应钣金折边。

底层信息

底层类型：SheetMetalFoldComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF00000C

源码位置：cyBattery.Components.CurveCmpts\SheetMetalFoldComponent.cs

图标资源：Icon_SheetMetalFold.png

18 多点描线

多点描 · cytoos > 03 曲线

通过多个控制点描摹生成曲线

图标识别：多点折线路径，对应多点描线。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：3 输出：1

什么时候用

通过多个控制点描摹生成曲线。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 点点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
2. 次数次数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
3. 周期闭合周期闭：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。

右侧输出端口接到哪里

1. 输出曲线曲线：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
点点	`Point`列表	输入点参数：点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
次数次数	`Integer`单项	输入整数参数：次数。默认值：3	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
周期闭合周期闭	`Boolean`单项	输入布尔开关：周期闭合。默认值：false	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。

输出端口

端口	类型/结构	中文说明	下游用法
输出曲线曲线	`Curve`单项	计算后生成的曲线结果。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

复制用法模板

多点描线 (cytoos > 03 曲线)
用途：通过多个控制点描摹生成曲线
输入：
  1. 点 [Point/列表] - 输入点参数：点。
  2. 次数 [Integer/单项] 默认=3 - 输入整数参数：次数。
  3. 周期闭合 [Boolean/单项] 默认=false - 输入布尔开关：周期闭合。
输出：
  1. 输出曲线 [Curve/单项] - 计算后生成的曲线结果。
图标：多点折线路径，对应多点描线。

底层信息

底层类型：MultiPointTraceComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF000001

源码位置：cyBattery.Components.CurveCmpts\MultiPointTraceComponent.cs

图标资源：Icon_MultiPointTrace.png

19 多段线不等角倒角

不等角倒 · cytoos > 03 曲线

对多段线进行不等角度倒角处理

图标识别：折线和斜切短线，对应不等角倒角。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：2 输出：1

什么时候用

对多段线进行不等角度倒角处理。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 多段线多段线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 倒角半径倒角半：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。。

右侧输出端口接到哪里

1. 倒角曲线倒角曲：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
多段线多段线	`Curve`单项	输入曲线参数：多段线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
倒角半径倒角半	`Number`列表	输入数值参数：倒角半径。	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。。

输出端口

端口	类型/结构	中文说明	下游用法
倒角曲线倒角曲	`Curve`单项	输出曲线参数：倒角曲线。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

复制用法模板

多段线不等角倒角 (cytoos > 03 曲线)
用途：对多段线进行不等角度倒角处理
输入：
  1. 多段线 [Curve/单项] - 输入曲线参数：多段线。
  2. 倒角半径 [Number/列表] - 输入数值参数：倒角半径。
输出：
  1. 倒角曲线 [Curve/单项] - 输出曲线参数：倒角曲线。
图标：折线和斜切短线，对应不等角倒角。

底层信息

底层类型：PolylineUnequalChamferComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF00000A

源码位置：cyBattery.Components.CurveCmpts\PolylineUnequalChamferComponent.cs

图标资源：Icon_PolylineUnequalChamfer.png

20 多段线角点属性

线角性 · cytoos > 03 曲线

分析多段线角点的几何属性，包括角度、转角方向等

图标识别：折线角度弧，对应读取多段线角点属性。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：1 输出：4

什么时候用

分析多段线角点的几何属性，包括角度、转角方向等。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 多段线多段线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。

右侧输出端口接到哪里

1. 角点角点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
2. 角度角度：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
3. 分段长度分段长：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
4. 转向转向：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
多段线多段线	`Curve`单项	输入曲线参数：多段线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。

输出端口

端口	类型/结构	中文说明	下游用法
角点角点	`Point`列表	输出点参数：角点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
角度角度	`Number`列表	输出数值参数：角度。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
分段长度分段长	`Number`列表	输出数值参数：分段长度。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
转向转向	`Integer`列表	输出整数参数：转向。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

多段线角点属性 (cytoos > 03 曲线)
用途：分析多段线角点的几何属性，包括角度、转角方向等
输入：
  1. 多段线 [Curve/单项] - 输入曲线参数：多段线。
输出：
  1. 角点 [Point/列表] - 输出点参数：角点。
  2. 角度 [Number/列表] - 输出数值参数：角度。
  3. 分段长度 [Number/列表] - 输出数值参数：分段长度。
  4. 转向 [Integer/列表] - 输出整数参数：转向。
图标：折线角度弧，对应读取多段线角点属性。

底层信息

底层类型：PolylineCornerPropsComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF000005

源码位置：cyBattery.Components.CurveCmpts\PolylineCornerPropsComponent.cs

图标资源：Icon_PolylineCornerProps.png

21 多段线直弧化

直转弧 · cytoos > 03 曲线

将多段线的直线段转换为圆弧段，使线条更加平滑

图标识别：折线转圆弧，对应直线段圆弧化。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：2 输出：1

什么时候用

将多段线的直线段转换为圆弧段，使线条更加平滑。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 多段线多段线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 最小偏转最小偏：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：5.0。

右侧输出端口接到哪里

1. 圆弧拟合曲线圆弧拟：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
多段线多段线	`Curve`单项	输入曲线参数：多段线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
最小偏转最小偏	`Number`单项	输入数值参数：最小偏转。默认值：5.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：5.0。

输出端口

端口	类型/结构	中文说明	下游用法
圆弧拟合曲线圆弧拟	`Curve`单项	输出曲线参数：圆弧拟合曲线。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

复制用法模板

多段线直弧化 (cytoos > 03 曲线)
用途：将多段线的直线段转换为圆弧段，使线条更加平滑
输入：
  1. 多段线 [Curve/单项] - 输入曲线参数：多段线。
  2. 最小偏转 [Number/单项] 默认=5.0 - 输入数值参数：最小偏转。
输出：
  1. 圆弧拟合曲线 [Curve/单项] - 输出曲线参数：圆弧拟合曲线。
图标：折线转圆弧，对应直线段圆弧化。

底层信息

底层类型：PolylineStraightToArcComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF00000B

源码位置：cyBattery.Components.CurveCmpts\PolylineStraightToArcComponent.cs

图标资源：Icon_PolylineStraightToArc.png

22 多重线不等距偏移

多不等偏 · cytoos > 03 曲线

对多重曲线进行不等距偏移操作

图标识别：两条错位曲线，对应多曲线不等距偏移。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：4 输出：1

什么时候用

对多重曲线进行不等距偏移操作。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入曲线曲线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 距离距离：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。。
3. 平面法向平面法：接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。；未连接时使用默认值：Vector3d.ZAxis。
4. 容差容差：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.01。

右侧输出端口接到哪里

1. 偏移曲线偏移曲：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
输入曲线曲线	`Curve`列表	需要处理的曲线对象。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
距离距离	`Number`列表	输入数值参数：距离。	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。。
平面法向平面法	`Vector`单项	定义偏移平面法线方向的向量。默认值：Vector3d.ZAxis	接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。；未连接时使用默认值：Vector3d.ZAxis。
容差容差	`Number`单项	几何判断、分组或偏移使用的容许误差。默认值：0.01	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.01。

输出端口

端口	类型/结构	中文说明	下游用法
偏移曲线偏移曲	`Curve`列表	输出曲线参数：偏移曲线。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

复制用法模板

多重线不等距偏移 (cytoos > 03 曲线)
用途：对多重曲线进行不等距偏移操作
输入：
  1. 输入曲线 [Curve/列表] - 需要处理的曲线对象。
  2. 距离 [Number/列表] - 输入数值参数：距离。
  3. 平面法向 [Vector/单项] 默认=Vector3d.ZAxis - 定义偏移平面法线方向的向量。
  4. 容差 [Number/单项] 默认=0.01 - 几何判断、分组或偏移使用的容许误差。
输出：
  1. 偏移曲线 [Curve/列表] - 输出曲线参数：偏移曲线。
图标：两条错位曲线，对应多曲线不等距偏移。

底层信息

底层类型：MultiCurveUnequalOffsetComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF000007

源码位置：cyBattery.Components.CurveCmpts\MultiCurveUnequalOffsetComponent.cs

图标资源：Icon_MultiCurveUnequalOffset.png

23 内差点

内插点 · cytoos > 03 曲线

在曲线上按参数插值生成点，支持等距和等参两种方式

图标识别：曲线上的点，对应曲线内插点。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：3 输出：1

什么时候用

在曲线上按参数插值生成点，支持等距和等参两种方式。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入曲线曲线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 数量数量：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：10。
3. 模式模式：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。

右侧输出端口接到哪里

1. 点点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
输入曲线曲线	`Curve`单项	需要处理的曲线对象。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
数量数量	`Integer`单项	需要生成、提取或统计的数量。默认值：10	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：10。
模式模式	`Integer`单项	组件的计算模式，用数字选择不同处理方式。默认值：0	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。

输出端口

端口	类型/结构	中文说明	下游用法
点点	`Point`列表	输出点参数：点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。

复制用法模板

内差点 (cytoos > 03 曲线)
用途：在曲线上按参数插值生成点，支持等距和等参两种方式
输入：
  1. 输入曲线 [Curve/单项] - 需要处理的曲线对象。
  2. 数量 [Integer/单项] 默认=10 - 需要生成、提取或统计的数量。
  3. 模式 [Integer/单项] 默认=0 - 组件的计算模式，用数字选择不同处理方式。
输出：
  1. 点 [Point/列表] - 输出点参数：点。
图标：曲线上的点，对应曲线内插点。

底层信息

底层类型：InterpolationPointComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF000008

源码位置：cyBattery.Components.CurveCmpts\InterpolationPointComponent.cs

图标资源：Icon_InterpolationPoint.png

24 曲线偏移

线偏 · cytoos > 03 曲线

对曲线进行偏移操作，生成平行曲线

图标识别：双曲线，对应曲线偏移。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：5 输出：1

什么时候用

对曲线进行偏移操作，生成平行曲线。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入曲线曲线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 距离距离：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：10.0。
3. 平面法向平面法：接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。；未连接时使用默认值：Vector3d.ZAxis。
4. 容差容差：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.01。
5. 转角样式转角样：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：2。

右侧输出端口接到哪里

1. 偏移曲线偏移曲：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
输入曲线曲线	`Curve`单项	需要处理的曲线对象。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
距离距离	`Number`单项	输入数值参数：距离。默认值：10.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：10.0。
平面法向平面法	`Vector`单项	定义偏移平面法线方向的向量。默认值：Vector3d.ZAxis	接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。；未连接时使用默认值：Vector3d.ZAxis。
容差容差	`Number`单项	几何判断、分组或偏移使用的容许误差。默认值：0.01	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.01。
转角样式转角样	`Integer`单项	转角处理方式：0为无处理，1为尖角，2为圆角，3为平滑，4为倒角。默认值：2	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：2。

输出端口

端口	类型/结构	中文说明	下游用法
偏移曲线偏移曲	`Curve`列表	输出曲线参数：偏移曲线。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

复制用法模板

曲线偏移 (cytoos > 03 曲线)
用途：对曲线进行偏移操作，生成平行曲线
输入：
  1. 输入曲线 [Curve/单项] - 需要处理的曲线对象。
  2. 距离 [Number/单项] 默认=10.0 - 输入数值参数：距离。
  3. 平面法向 [Vector/单项] 默认=Vector3d.ZAxis - 定义偏移平面法线方向的向量。
  4. 容差 [Number/单项] 默认=0.01 - 几何判断、分组或偏移使用的容许误差。
  5. 转角样式 [Integer/单项] 默认=2 - 转角处理方式：0为无处理，1为尖角，2为圆角，3为平滑，4为倒角。
输出：
  1. 偏移曲线 [Curve/列表] - 输出曲线参数：偏移曲线。
图标：双曲线，对应曲线偏移。

底层信息

底层类型：CurveOffsetComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF000006

源码位置：cyBattery.Components.CurveCmpts\CurveOffsetComponent.cs

图标资源：Icon_CurveOffset.png

25 容差分割曲线

容差分 · cytoos > 03 曲线

按容差精度对曲线进行自适应分割

图标识别：曲线分点和容差圈，对应按容差分割曲线。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：3 输出：3

什么时候用

按容差精度对曲线进行自适应分割。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入曲线曲线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 容差容差：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.1。
3. 最小长度最小长：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：0.01。

右侧输出端口接到哪里

1. 分割点分割点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
2. 参数参数：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
3. 分段分段：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
输入曲线曲线	`Curve`单项	需要处理的曲线对象。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
容差容差	`Number`单项	几何判断、分组或偏移使用的容许误差。默认值：0.1	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.1。
最小长度最小长	`Number`单项	输入数值参数：最小长度。默认值：0.01	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：0.01。

输出端口

端口	类型/结构	中文说明	下游用法
分割点分割点	`Point`列表	输出点参数：分割点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
参数参数	`Number`列表	输出数值参数：参数。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
分段分段	`Curve`列表	输出曲线参数：分段。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

复制用法模板

容差分割曲线 (cytoos > 03 曲线)
用途：按容差精度对曲线进行自适应分割
输入：
  1. 输入曲线 [Curve/单项] - 需要处理的曲线对象。
  2. 容差 [Number/单项] 默认=0.1 - 几何判断、分组或偏移使用的容许误差。
  3. 最小长度 [Number/单项] 默认=0.01 - 输入数值参数：最小长度。
输出：
  1. 分割点 [Point/列表] - 输出点参数：分割点。
  2. 参数 [Number/列表] - 输出数值参数：参数。
  3. 分段 [Curve/列表] - 输出曲线参数：分段。
图标：曲线分点和容差圈，对应按容差分割曲线。

底层信息

底层类型：ToleranceDivideCurveComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF000004

源码位置：cyBattery.Components.CurveCmpts\ToleranceDivideCurveComponent.cs

图标资源：Icon_ToleranceDivideCurve.png

26 线等分布置

等分布 · cytoos > 03 曲线

在线段上按等分方式布置对象，生成均匀分布点

图标识别：直线等距点，对应线等分布置。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：2 输出：3

什么时候用

在线段上按等分方式布置对象，生成均匀分布点。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入曲线曲线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 数量数量：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：10。

右侧输出端口接到哪里

1. 分割点分割点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
2. 参数参数：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
3. 图框图框：先接 Panel 或 Param Viewer 检查数据，再接到下游组件。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
输入曲线曲线	`Curve`单项	需要处理的曲线对象。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
数量数量	`Integer`单项	需要生成、提取或统计的数量。默认值：10	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：10。

输出端口

端口	类型/结构	中文说明	下游用法
分割点分割点	`Point`列表	输出点参数：分割点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
参数参数	`Number`列表	输出数值参数：参数。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
图框图框	`Plane`列表	输出平面参数：图框。	先接 Panel 或 Param Viewer 检查数据，再接到下游组件。

复制用法模板

线等分布置 (cytoos > 03 曲线)
用途：在线段上按等分方式布置对象，生成均匀分布点
输入：
  1. 输入曲线 [Curve/单项] - 需要处理的曲线对象。
  2. 数量 [Integer/单项] 默认=10 - 需要生成、提取或统计的数量。
输出：
  1. 分割点 [Point/列表] - 输出点参数：分割点。
  2. 参数 [Number/列表] - 输出数值参数：参数。
  3. 图框 [Plane/列表] - 输出平面参数：图框。
图标：直线等距点，对应线等分布置。

底层信息

底层类型：EqualDivideLayoutComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF000009

源码位置：cyBattery.Components.CurveCmpts\EqualDivideLayoutComponent.cs

图标资源：Icon_EqualDivideLayout.png

27 中心矩阵

中阵 · cytoos > 03 曲线

在曲线几何中心创建参考矩阵坐标系

图标识别：中心十字和矩形，对应中心矩阵。

插件：cyBattery.gha 分类：cytoos 子分类：03 曲线输入：5 输出：2

什么时候用

在曲线几何中心创建参考矩阵坐标系。当你的流程需要处理曲线、边界、偏移、倒角或等分时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 中心中心：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
2. 单元宽度单元宽：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：100.0。
3. 单元高度单元高：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：100.0。
4. 列数列数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
5. 行数行数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。

右侧输出端口接到哪里

1. 网格单元网格单：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
2. 单元中心单元中：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
曲线类电池尤其注意方向、闭合状态和模型容差。

输入端口

端口	类型/结构	中文说明	连接建议
中心中心	`Point`单项	输入点参数：中心。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
单元宽度单元宽	`Number`单项	输入数值参数：单元宽度。默认值：100.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：100.0。
单元高度单元高	`Number`单项	输入数值参数：单元高度。默认值：100.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：100.0。
列数列数	`Integer`单项	输入整数参数：列数。默认值：3	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
行数行数	`Integer`单项	输入整数参数：行数。默认值：3	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。

输出端口

端口	类型/结构	中文说明	下游用法
网格单元网格单	`Curve`列表	输出曲线参数：网格单元。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
单元中心单元中	`Point`列表	输出点参数：单元中心。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。

复制用法模板

中心矩阵 (cytoos > 03 曲线)
用途：在曲线几何中心创建参考矩阵坐标系
输入：
  1. 中心 [Point/单项] - 输入点参数：中心。
  2. 单元宽度 [Number/单项] 默认=100.0 - 输入数值参数：单元宽度。
  3. 单元高度 [Number/单项] 默认=100.0 - 输入数值参数：单元高度。
  4. 列数 [Integer/单项] 默认=3 - 输入整数参数：列数。
  5. 行数 [Integer/单项] 默认=3 - 输入整数参数：行数。
输出：
  1. 网格单元 [Curve/列表] - 输出曲线参数：网格单元。
  2. 单元中心 [Point/列表] - 输出点参数：单元中心。
图标：中心十字和矩形，对应中心矩阵。

底层信息

底层类型：CenterMatrixComponent

GUID：8F3A1B2C-D4E5-4F67-8901-ABCDEF000003

源码位置：cyBattery.Components.CurveCmpts\CenterMatrixComponent.cs

图标资源：Icon_CenterMatrix.png

04 曲面

5 个电池

测量曲面夹角、单轨扫掠、面上线垂面、封面下拉和偏移封面下拉。

28 两曲面夹角

面夹角 · cytoos > 04 曲面

测量两个曲面之间的夹角

图标识别：两张面和角度弧，对应测量两曲面夹角。

插件：cyBattery.gha 分类：cytoos 子分类：04 曲面输入：2 输出：3

什么时候用

测量两个曲面之间的夹角。当你的流程需要生成或分析曲面关系时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 基准曲面基准面：接曲面或单面 Brep。注意 UV 方向、法线方向和边界。。
2. 测量曲面测量面：接曲面或单面 Brep。注意 UV 方向、法线方向和边界。。

右侧输出端口接到哪里

1. 角度角度：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
2. 基准点基准点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
3. 测量点测量点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
基准曲面基准面	`Surface`单项	用于夹角测量的第一张曲面。	接曲面或单面 Brep。注意 UV 方向、法线方向和边界。。
测量曲面测量面	`Surface`单项	与基准曲面进行夹角测量的第二张曲面。	接曲面或单面 Brep。注意 UV 方向、法线方向和边界。。

输出端口

端口	类型/结构	中文说明	下游用法
角度角度	`Number`单项	输出数值参数：角度。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
基准点基准点	`Point`单项	基准曲面上参与测量的最近点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
测量点测量点	`Point`单项	测量曲面上参与测量的最近点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。

复制用法模板

两曲面夹角 (cytoos > 04 曲面)
用途：测量两个曲面之间的夹角
输入：
  1. 基准曲面 [Surface/单项] - 用于夹角测量的第一张曲面。
  2. 测量曲面 [Surface/单项] - 与基准曲面进行夹角测量的第二张曲面。
输出：
  1. 角度 [Number/单项] - 输出数值参数：角度。
  2. 基准点 [Point/单项] - 基准曲面上参与测量的最近点。
  3. 测量点 [Point/单项] - 测量曲面上参与测量的最近点。
图标：两张面和角度弧，对应测量两曲面夹角。

底层信息

底层类型：TwoSurfaceAngleComponent

GUID：F6A7B8C9-D0E1-2345-FABC-456789012345

源码位置：cyBattery.Components.SurfaceCmpts\TwoSurfaceAngleComponent.cs

图标资源：Icon_TwoSurfaceAngle.png

29 面单轨放样

单轨扫 · cytoos > 04 曲面

沿路径曲线扫掠截面生成曲面

图标识别：轨道曲线和截面，对应单轨扫掠。

插件：cyBattery.gha 分类：cytoos 子分类：04 曲面输入：2 输出：1

什么时候用

沿路径曲线扫掠截面生成曲面。当你的流程需要生成或分析曲面关系时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 截面截面：接曲面或单面 Brep。注意 UV 方向、法线方向和边界。。
2. 轨道轨道：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。

右侧输出端口接到哪里

1. 输出实体实体：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
截面截面	`Surface`单项	输入曲面参数：截面。	接曲面或单面 Brep。注意 UV 方向、法线方向和边界。。
轨道轨道	`Curve`单项	输入曲线参数：轨道。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。

输出端口

端口	类型/结构	中文说明	下游用法
输出实体实体	`Brep`单项	计算后生成的实体结果。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

面单轨放样 (cytoos > 04 曲面)
用途：沿路径曲线扫掠截面生成曲面
输入：
  1. 截面 [Surface/单项] - 输入曲面参数：截面。
  2. 轨道 [Curve/单项] - 输入曲线参数：轨道。
输出：
  1. 输出实体 [Brep/单项] - 计算后生成的实体结果。
图标：轨道曲线和截面，对应单轨扫掠。

底层信息

底层类型：SingleRailSweepComponent

GUID：B2C3D4E5-F6A7-8901-BCDE-F12345678901

源码位置：cyBattery.Components.SurfaceCmpts\SingleRailSweepComponent.cs

图标资源：Icon_SingleRailSweep.png

30 面上多重线线垂面

多垂面 · cytoos > 04 曲面

在基础面上创建多重垂面

图标识别：面上多根竖向箭头，对应多线垂面。

插件：cyBattery.gha 分类：cytoos 子分类：04 曲面输入：2 输出：1

什么时候用

在基础面上创建多重垂面。当你的流程需要生成或分析曲面关系时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 线线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 基准面基准面：接曲面或单面 Brep。注意 UV 方向、法线方向和边界。。

右侧输出端口接到哪里

1. 曲面曲面：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
线线	`Curve`列表	输入曲线参数：线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
基准面基准面	`Surface`单项	输入曲面参数：基准面。	接曲面或单面 Brep。注意 UV 方向、法线方向和边界。。

输出端口

端口	类型/结构	中文说明	下游用法
曲面曲面	`Brep`列表	输出实体参数：曲面。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

面上多重线线垂面 (cytoos > 04 曲面)
用途：在基础面上创建多重垂面
输入：
  1. 线 [Curve/列表] - 输入曲线参数：线。
  2. 基准面 [Surface/单项] - 输入曲面参数：基准面。
输出：
  1. 曲面 [Brep/列表] - 输出实体参数：曲面。
图标：面上多根竖向箭头，对应多线垂面。

底层信息

底层类型：MultiLinePerpSurfaceComponent

GUID：E5F6A7B8-C9D0-1234-EFAB-345678901234

源码位置：cyBattery.Components.SurfaceCmpts\MultiLinePerpSurfaceComponent.cs

图标资源：Icon_MultiLinePerpSurface.png

31 线封面下拉 v1

线封面 · cytoos > 04 曲面

将线段向下拉伸形成覆盖面

图标识别：线段和下拉箭头，对应线封面下拉。

插件：cyBattery.gha 分类：cytoos 子分类：04 曲面输入：2 输出：1

什么时候用

将线段向下拉伸形成覆盖面。当你的流程需要生成或分析曲面关系时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入曲线曲线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 高度高度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。。

右侧输出端口接到哪里

1. 曲面曲面：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
输入曲线曲线	`Curve`单项	需要处理的曲线对象。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
高度高度	`Number`单项	目标对象或图框的高度。	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。。

输出端口

端口	类型/结构	中文说明	下游用法
曲面曲面	`Brep`单项	输出实体参数：曲面。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

线封面下拉 v1 (cytoos > 04 曲面)
用途：将线段向下拉伸形成覆盖面
输入：
  1. 输入曲线 [Curve/单项] - 需要处理的曲线对象。
  2. 高度 [Number/单项] - 目标对象或图框的高度。
输出：
  1. 曲面 [Brep/单项] - 输出实体参数：曲面。
图标：线段和下拉箭头，对应线封面下拉。

底层信息

底层类型：LineCoverDropdownComponent

GUID：C3D4E5F6-A7B8-9012-CDEF-123456789012

源码位置：cyBattery.Components.SurfaceCmpts\LineCoverDropdownComponent.cs

图标资源：Icon_LineCoverDropdown.png

32 线偏封面下拉 v2

线偏封 · cytoos > 04 曲面

将偏移后的线段向下拉伸形成覆盖面

图标识别：偏移曲线和下拉箭头，对应偏线封面下拉。

插件：cyBattery.gha 分类：cytoos 子分类：04 曲面输入：3 输出：1

什么时候用

将偏移后的线段向下拉伸形成覆盖面。当你的流程需要生成或分析曲面关系时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入曲线曲线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 偏移量偏移量：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。。
3. 高度高度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。。

右侧输出端口接到哪里

1. 曲面曲面：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
输入曲线曲线	`Curve`单项	需要处理的曲线对象。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
偏移量偏移量	`Number`单项	输入数值参数：偏移量。	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。。
高度高度	`Number`单项	目标对象或图框的高度。	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。。

输出端口

端口	类型/结构	中文说明	下游用法
曲面曲面	`Brep`单项	输出实体参数：曲面。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

线偏封面下拉 v2 (cytoos > 04 曲面)
用途：将偏移后的线段向下拉伸形成覆盖面
输入：
  1. 输入曲线 [Curve/单项] - 需要处理的曲线对象。
  2. 偏移量 [Number/单项] - 输入数值参数：偏移量。
  3. 高度 [Number/单项] - 目标对象或图框的高度。
输出：
  1. 曲面 [Brep/单项] - 输出实体参数：曲面。
图标：偏移曲线和下拉箭头，对应偏线封面下拉。

底层信息

底层类型：LineOffsetCoverDropdownComponent

GUID：D4E5F6A7-B8C9-0123-DEFA-234567890123

源码位置：cyBattery.Components.SurfaceCmpts\LineOffsetCoverDropdownComponent.cs

图标资源：Icon_LineOffsetCoverDropdown.png

05 实体

14 个电池

处理螺栓、螺丝、龙骨、放样、曲面修正、扫掠、实体拉升、实体偏移和斜切放样。

33 6角螺栓

六角栓 · cytoos > 05 实体

生成六角螺栓实体模型

图标识别：六边形和中心孔，对应六角螺栓。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：5 输出：1

什么时候用

生成六角螺栓实体模型。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 参考平面平面：接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。；未连接时使用默认值：Plane.WorldXY。
2. 头部直径头部直：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：20.0。
3. 头部高度头部高：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：8.0。
4. 杆身直径杆身直：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：10.0。
5. 杆身长度杆身长：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：30.0。

右侧输出端口接到哪里

1. 螺栓螺栓：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
参考平面平面	`Plane`单项	用于定位、投影或切割的参考平面。默认值：Plane.WorldXY	接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。；未连接时使用默认值：Plane.WorldXY。
头部直径头部直	`Number`单项	输入数值参数：头部直径。默认值：20.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：20.0。
头部高度头部高	`Number`单项	输入数值参数：头部高度。默认值：8.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：8.0。
杆身直径杆身直	`Number`单项	输入数值参数：杆身直径。默认值：10.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：10.0。
杆身长度杆身长	`Number`单项	输入数值参数：杆身长度。默认值：30.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：30.0。

输出端口

端口	类型/结构	中文说明	下游用法
螺栓螺栓	`Brep`单项	输出实体参数：螺栓。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

6角螺栓 (cytoos > 05 实体)
用途：生成六角螺栓实体模型
输入：
  1. 参考平面 [Plane/单项] 默认=Plane.WorldXY - 用于定位、投影或切割的参考平面。
  2. 头部直径 [Number/单项] 默认=20.0 - 输入数值参数：头部直径。
  3. 头部高度 [Number/单项] 默认=8.0 - 输入数值参数：头部高度。
  4. 杆身直径 [Number/单项] 默认=10.0 - 输入数值参数：杆身直径。
  5. 杆身长度 [Number/单项] 默认=30.0 - 输入数值参数：杆身长度。
输出：
  1. 螺栓 [Brep/单项] - 输出实体参数：螺栓。
图标：六边形和中心孔，对应六角螺栓。

底层信息

底层类型：HexBoltComponent

GUID：B1A2C3D4-0002-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\HexBoltComponent.cs

图标资源：Icon_HexBolt.png

34 单一表皮垂面龙骨

表皮骨 · cytoos > 05 实体

在单一表皮曲面上建立垂直龙骨

图标识别：面片和单根肋线，对应单一表皮龙骨。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：6 输出：2

什么时候用

在单一表皮曲面上建立垂直龙骨。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 曲面曲面：接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
2. 龙骨深度龙骨深：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：50.0。
3. 龙骨厚度龙骨厚：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：5.0。
4. 龙骨数量龙骨数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。
5. 沿U方向沿方向：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。
6. 两侧两侧：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。

右侧输出端口接到哪里

1. 龙骨龙骨：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 基准曲线基准曲：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
曲面曲面	`Brep`单项	输入实体参数：曲面。	接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
龙骨深度龙骨深	`Number`单项	输入数值参数：龙骨深度。默认值：50.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：50.0。
龙骨厚度龙骨厚	`Number`单项	输入数值参数：龙骨厚度。默认值：5.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：5.0。
龙骨数量龙骨数	`Integer`单项	输入整数参数：龙骨数量。默认值：5	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。
沿U方向沿方向	`Boolean`单项	输入布尔开关：沿U方向。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。
两侧两侧	`Boolean`单项	输入布尔开关：两侧。默认值：false	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。

输出端口

端口	类型/结构	中文说明	下游用法
龙骨龙骨	`Brep`列表	输出实体参数：龙骨。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
基准曲线基准曲	`Curve`列表	输出曲线参数：基准曲线。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

复制用法模板

单一表皮垂面龙骨 (cytoos > 05 实体)
用途：在单一表皮曲面上建立垂直龙骨
输入：
  1. 曲面 [Brep/单项] - 输入实体参数：曲面。
  2. 龙骨深度 [Number/单项] 默认=50.0 - 输入数值参数：龙骨深度。
  3. 龙骨厚度 [Number/单项] 默认=5.0 - 输入数值参数：龙骨厚度。
  4. 龙骨数量 [Integer/单项] 默认=5 - 输入整数参数：龙骨数量。
  5. 沿U方向 [Boolean/单项] 默认=true - 输入布尔开关：沿U方向。
  6. 两侧 [Boolean/单项] 默认=false - 输入布尔开关：两侧。
输出：
  1. 龙骨 [Brep/列表] - 输出实体参数：龙骨。
  2. 基准曲线 [Curve/列表] - 输出曲线参数：基准曲线。
图标：面片和单根肋线，对应单一表皮龙骨。

底层信息

底层类型：SingleSkinKeelComponent

GUID：B1A2C3D4-0013-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\SingleSkinKeelComponent.cs

图标资源：Icon_SingleSkinKeel.png

35 多段线龙骨的建立

多段骨 · cytoos > 05 实体

沿多段线路径建立龙骨结构

图标识别：折线和多根肋线，对应沿多段线建立龙骨。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：6 输出：2

什么时候用

沿多段线路径建立龙骨结构。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 多段线多段线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 宽度宽度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：10.0。
3. 高度高度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
4. 厚度厚度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：2.0。
5. 圆整点圆整点：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。
6. 圆角半径圆角半：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：5.0。

右侧输出端口接到哪里

1. 龙骨龙骨：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 分段分段：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
多段线多段线	`Curve`单项	输入曲线参数：多段线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
宽度宽度	`Number`单项	目标对象或图框的宽度。默认值：10.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：10.0。
高度高度	`Number`单项	目标对象或图框的高度。默认值：50.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
厚度厚度	`Number`单项	输入数值参数：厚度。默认值：2.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：2.0。
圆整点圆整点	`Boolean`单项	输入布尔开关：圆整点。默认值：false	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。
圆角半径圆角半	`Number`单项	输入数值参数：圆角半径。默认值：5.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：5.0。

输出端口

端口	类型/结构	中文说明	下游用法
龙骨龙骨	`Brep`列表	输出实体参数：龙骨。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
分段分段	`Curve`列表	输出曲线参数：分段。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

复制用法模板

多段线龙骨的建立 (cytoos > 05 实体)
用途：沿多段线路径建立龙骨结构
输入：
  1. 多段线 [Curve/单项] - 输入曲线参数：多段线。
  2. 宽度 [Number/单项] 默认=10.0 - 目标对象或图框的宽度。
  3. 高度 [Number/单项] 默认=50.0 - 目标对象或图框的高度。
  4. 厚度 [Number/单项] 默认=2.0 - 输入数值参数：厚度。
  5. 圆整点 [Boolean/单项] 默认=false - 输入布尔开关：圆整点。
  6. 圆角半径 [Number/单项] 默认=5.0 - 输入数值参数：圆角半径。
输出：
  1. 龙骨 [Brep/列表] - 输出实体参数：龙骨。
  2. 分段 [Curve/列表] - 输出曲线参数：分段。
图标：折线和多根肋线，对应沿多段线建立龙骨。

底层信息

底层类型：PolylineKeelComponent

GUID：B1A2C3D4-0012-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\PolylineKeelComponent.cs

图标资源：Icon_PolylineKeel.png

36 两端截面放样

双截放 · cytoos > 05 实体

在两端截面之间进行放样生成实体

图标识别：两个截面和连接线，对应两端截面放样。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：6 输出：1

什么时候用

在两端截面之间进行放样生成实体。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 起始曲线起始曲：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 结束曲线结束曲：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
3. 放样类型放样类：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。
4. 封口封口：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。
5. 重建点数重建点：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。
6. 次数次数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。

右侧输出端口接到哪里

1. 输出实体实体：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
起始曲线起始曲	`Curve`单项	输入曲线参数：起始曲线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
结束曲线结束曲	`Curve`单项	输入曲线参数：结束曲线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
放样类型放样类	`Integer`单项	放样类型：0为普通，1为松弛，2为紧密，3为直线。默认值：0	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。
封口封口	`Boolean`单项	开启后对拉伸或放样结果进行封口生成实体。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。
重建点数重建点	`Integer`单项	输入整数参数：重建点数。默认值：0	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。
次数次数	`Integer`单项	输入整数参数：次数。默认值：3	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。

输出端口

端口	类型/结构	中文说明	下游用法
输出实体实体	`Brep`单项	计算后生成的实体结果。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

两端截面放样 (cytoos > 05 实体)
用途：在两端截面之间进行放样生成实体
输入：
  1. 起始曲线 [Curve/单项] - 输入曲线参数：起始曲线。
  2. 结束曲线 [Curve/单项] - 输入曲线参数：结束曲线。
  3. 放样类型 [Integer/单项] 默认=0 - 放样类型：0为普通，1为松弛，2为紧密，3为直线。
  4. 封口 [Boolean/单项] 默认=true - 开启后对拉伸或放样结果进行封口生成实体。
  5. 重建点数 [Integer/单项] 默认=0 - 输入整数参数：重建点数。
  6. 次数 [Integer/单项] 默认=3 - 输入整数参数：次数。
输出：
  1. 输出实体 [Brep/单项] - 计算后生成的实体结果。
图标：两个截面和连接线，对应两端截面放样。

底层信息

底层类型：TwoSectionLoftComponent

GUID：B1A2C3D4-0006-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\TwoSectionLoftComponent.cs

图标资源：Icon_TwoSectionLoft.png

37 螺丝

螺丝 · cytoos > 05 实体

生成螺丝实体模型

图标识别：斜向螺旋线，对应螺丝。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：8 输出：1

什么时候用

生成螺丝实体模型。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 参考平面平面：接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。；未连接时使用默认值：Plane.WorldXY。
2. 头部直径头部直：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：12.0。
3. 头部高度头部高：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：5.0。
4. 杆身直径杆身直：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：6.0。
5. 杆身长度杆身长：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：25.0。
6. 螺距螺距：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：1.5。
7. 螺纹深度螺纹深：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.8。
8. 螺纹圈数螺纹圈：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。

右侧输出端口接到哪里

1. 螺丝螺丝：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
参考平面平面	`Plane`单项	用于定位、投影或切割的参考平面。默认值：Plane.WorldXY	接参考平面。默认 WorldXY 只适合水平逻辑，立面、斜面和局部构件建议显式接入。；未连接时使用默认值：Plane.WorldXY。
头部直径头部直	`Number`单项	输入数值参数：头部直径。默认值：12.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：12.0。
头部高度头部高	`Number`单项	输入数值参数：头部高度。默认值：5.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：5.0。
杆身直径杆身直	`Number`单项	输入数值参数：杆身直径。默认值：6.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：6.0。
杆身长度杆身长	`Number`单项	输入数值参数：杆身长度。默认值：25.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：25.0。
螺距螺距	`Number`单项	输入数值参数：螺距。默认值：1.5	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：1.5。
螺纹深度螺纹深	`Number`单项	输入数值参数：螺纹深度。默认值：0.8	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.8。
螺纹圈数螺纹圈	`Integer`单项	输入整数参数：螺纹圈数。默认值：5	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。

输出端口

端口	类型/结构	中文说明	下游用法
螺丝螺丝	`Brep`单项	输出实体参数：螺丝。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

螺丝 (cytoos > 05 实体)
用途：生成螺丝实体模型
输入：
  1. 参考平面 [Plane/单项] 默认=Plane.WorldXY - 用于定位、投影或切割的参考平面。
  2. 头部直径 [Number/单项] 默认=12.0 - 输入数值参数：头部直径。
  3. 头部高度 [Number/单项] 默认=5.0 - 输入数值参数：头部高度。
  4. 杆身直径 [Number/单项] 默认=6.0 - 输入数值参数：杆身直径。
  5. 杆身长度 [Number/单项] 默认=25.0 - 输入数值参数：杆身长度。
  6. 螺距 [Number/单项] 默认=1.5 - 输入数值参数：螺距。
  7. 螺纹深度 [Number/单项] 默认=0.8 - 输入数值参数：螺纹深度。
  8. 螺纹圈数 [Integer/单项] 默认=5 - 输入整数参数：螺纹圈数。
输出：
  1. 螺丝 [Brep/单项] - 输出实体参数：螺丝。
图标：斜向螺旋线，对应螺丝。

底层信息

底层类型：ScrewComponent

GUID：B1A2C3D4-0003-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\ScrewComponent.cs

图标资源：Icon_Screw.png

38 面上线垂面

线垂面 · cytoos > 05 实体

在实体面上创建垂直于线的曲面

图标识别：面片和垂直箭头，对应面上线垂面。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：6 输出：3

什么时候用

在实体面上创建垂直于线的曲面。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 基准面基准面：接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
2. 线线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
3. 高度高度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
4. 宽度宽度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
5. 采样数采样数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：10。
6. 投影到曲面投影到：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

右侧输出端口接到哪里

1. 垂直面垂直面：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 投影线投影线：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
3. 平面平面：先接 Panel 或 Param Viewer 检查数据，再接到下游组件。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
基准面基准面	`Brep`单项	输入实体参数：基准面。	接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
线线	`Curve`单项	输入曲线参数：线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
高度高度	`Number`单项	目标对象或图框的高度。默认值：50.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
宽度宽度	`Number`单项	目标对象或图框的宽度。默认值：50.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
采样数采样数	`Integer`单项	沿线采样生成构造面的数量。默认值：10	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：10。
投影到曲面投影到	`Boolean`单项	开启后先把线投影到基准曲面再生成结果。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

输出端口

端口	类型/结构	中文说明	下游用法
垂直面垂直面	`Brep`列表	输出实体参数：垂直面。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
投影线投影线	`Curve`单项	输出曲线参数：投影线。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
平面平面	`Plane`列表	输出平面参数：平面。	先接 Panel 或 Param Viewer 检查数据，再接到下游组件。

复制用法模板

面上线垂面 (cytoos > 05 实体)
用途：在实体面上创建垂直于线的曲面
输入：
  1. 基准面 [Brep/单项] - 输入实体参数：基准面。
  2. 线 [Curve/单项] - 输入曲线参数：线。
  3. 高度 [Number/单项] 默认=50.0 - 目标对象或图框的高度。
  4. 宽度 [Number/单项] 默认=50.0 - 目标对象或图框的宽度。
  5. 采样数 [Integer/单项] 默认=10 - 沿线采样生成构造面的数量。
  6. 投影到曲面 [Boolean/单项] 默认=true - 开启后先把线投影到基准曲面再生成结果。
输出：
  1. 垂直面 [Brep/列表] - 输出实体参数：垂直面。
  2. 投影线 [Curve/单项] - 输出曲线参数：投影线。
  3. 平面 [Plane/列表] - 输出平面参数：平面。
图标：面片和垂直箭头，对应面上线垂面。

底层信息

底层类型：LinePerpSurfaceComponent

GUID：B1A2C3D4-0014-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\LinePerpSurfaceComponent.cs

图标资源：Icon_LinePerpSurface.png

39 曲面龙骨建立

面龙骨建 · cytoos > 05 实体

在曲面上建立龙骨结构

图标识别：面片交叉肋线，对应曲面龙骨建立。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：6 输出：2

什么时候用

在曲面上建立龙骨结构。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 曲面曲面：接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
2. 龙骨宽度龙骨宽：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：10.0。
3. 龙骨高度龙骨高：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
4. U向分割向分割：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：4。
5. V向分割向分割：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：4。
6. 边距边距：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：10.0。

右侧输出端口接到哪里

1. 龙骨龙骨：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 龙骨中心线龙骨中：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
曲面曲面	`Brep`单项	输入实体参数：曲面。	接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
龙骨宽度龙骨宽	`Number`单项	输入数值参数：龙骨宽度。默认值：10.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：10.0。
龙骨高度龙骨高	`Number`单项	输入数值参数：龙骨高度。默认值：50.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
U向分割向分割	`Integer`单项	输入整数参数：U向分割。默认值：4	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：4。
V向分割向分割	`Integer`单项	输入整数参数：V向分割。默认值：4	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：4。
边距边距	`Number`单项	输入数值参数：边距。默认值：10.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：10.0。

输出端口

端口	类型/结构	中文说明	下游用法
龙骨龙骨	`Brep`列表	输出实体参数：龙骨。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
龙骨中心线龙骨中	`Curve`列表	输出曲线参数：龙骨中心线。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

复制用法模板

曲面龙骨建立 (cytoos > 05 实体)
用途：在曲面上建立龙骨结构
输入：
  1. 曲面 [Brep/单项] - 输入实体参数：曲面。
  2. 龙骨宽度 [Number/单项] 默认=10.0 - 输入数值参数：龙骨宽度。
  3. 龙骨高度 [Number/单项] 默认=50.0 - 输入数值参数：龙骨高度。
  4. U向分割 [Integer/单项] 默认=4 - 输入整数参数：U向分割。
  5. V向分割 [Integer/单项] 默认=4 - 输入整数参数：V向分割。
  6. 边距 [Number/单项] 默认=10.0 - 输入数值参数：边距。
输出：
  1. 龙骨 [Brep/列表] - 输出实体参数：龙骨。
  2. 龙骨中心线 [Curve/列表] - 输出曲线参数：龙骨中心线。
图标：面片交叉肋线，对应曲面龙骨建立。

底层信息

底层类型：SurfaceKeelCreateComponent

GUID：B1A2C3D4-0009-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\SurfaceKeelCreateComponent.cs

图标资源：Icon_SurfaceKeelCreate.png

40 曲面修正

面修正 · cytoos > 05 实体

对曲面进行修正调整和平滑处理

图标识别：面片和确认折线，对应曲面修正。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：8 输出：2

什么时候用

对曲面进行修正调整和平滑处理。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 曲面曲面：接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
2. 方法方法：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。
3. U向点数向点数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：10。
4. V向点数向点数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：10。
5. U向次数向次数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
6. V向次数向次数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
7. 平滑系数平滑系：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.5。
8. 延伸距离延伸距：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：10.0。

右侧输出端口接到哪里

1. 输出实体实体：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 报告报告：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
曲面曲面	`Brep`单项	输入实体参数：曲面。	接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
方法方法	`Integer`单项	处理方法，用数字选择重建、平滑、延伸或修剪等方式。默认值：0	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。
U向点数向点数	`Integer`单项	输入整数参数：U向点数。默认值：10	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：10。
V向点数向点数	`Integer`单项	输入整数参数：V向点数。默认值：10	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：10。
U向次数向次数	`Integer`单项	输入整数参数：U向次数。默认值：3	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
V向次数向次数	`Integer`单项	输入整数参数：V向次数。默认值：3	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
平滑系数平滑系	`Number`单项	输入数值参数：平滑系数。默认值：0.5	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.5。
延伸距离延伸距	`Number`单项	输入数值参数：延伸距离。默认值：10.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：10.0。

输出端口

端口	类型/结构	中文说明	下游用法
输出实体实体	`Brep`单项	计算后生成的实体结果。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
报告报告	`Number`单项	组件运行结果说明，0表示成功，大于0表示存在警告。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

曲面修正 (cytoos > 05 实体)
用途：对曲面进行修正调整和平滑处理
输入：
  1. 曲面 [Brep/单项] - 输入实体参数：曲面。
  2. 方法 [Integer/单项] 默认=0 - 处理方法，用数字选择重建、平滑、延伸或修剪等方式。
  3. U向点数 [Integer/单项] 默认=10 - 输入整数参数：U向点数。
  4. V向点数 [Integer/单项] 默认=10 - 输入整数参数：V向点数。
  5. U向次数 [Integer/单项] 默认=3 - 输入整数参数：U向次数。
  6. V向次数 [Integer/单项] 默认=3 - 输入整数参数：V向次数。
  7. 平滑系数 [Number/单项] 默认=0.5 - 输入数值参数：平滑系数。
  8. 延伸距离 [Number/单项] 默认=10.0 - 输入数值参数：延伸距离。
输出：
  1. 输出实体 [Brep/单项] - 计算后生成的实体结果。
  2. 报告 [Number/单项] - 组件运行结果说明，0表示成功，大于0表示存在警告。
图标：面片和确认折线，对应曲面修正。

底层信息

底层类型：SurfaceCorrectionComponent

GUID：B1A2C3D4-0010-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\SurfaceCorrectionComponent.cs

图标资源：Icon_SurfaceCorrection.png

41 曲面原点龙骨扫掠

面龙骨扫 · cytoos > 05 实体

从曲面原点沿龙骨方向扫掠生成实体

图标识别：面片和扫掠曲线，对应曲面龙骨扫掠。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：6 输出：2

什么时候用

从曲面原点沿龙骨方向扫掠生成实体。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 曲面曲面：接曲面或单面 Brep。注意 UV 方向、法线方向和边界。。
2. 截面截面：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
3. U向分割向分割：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。
4. V向分割向分割：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。
5. 龙骨高度龙骨高：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
6. 双向双向：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

右侧输出端口接到哪里

1. 龙骨实体龙骨实：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 轨道轨道：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
曲面曲面	`Surface`单项	输入曲面参数：曲面。	接曲面或单面 Brep。注意 UV 方向、法线方向和边界。。
截面截面	`Curve`单项	输入曲线参数：截面。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
U向分割向分割	`Integer`单项	输入整数参数：U向分割。默认值：5	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。
V向分割向分割	`Integer`单项	输入整数参数：V向分割。默认值：5	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：5。
龙骨高度龙骨高	`Number`单项	输入数值参数：龙骨高度。默认值：50.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
双向双向	`Boolean`单项	输入布尔开关：双向。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

输出端口

端口	类型/结构	中文说明	下游用法
龙骨实体龙骨实	`Brep`列表	输出实体参数：龙骨实体。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
轨道轨道	`Curve`列表	输出曲线参数：轨道。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。

复制用法模板

曲面原点龙骨扫掠 (cytoos > 05 实体)
用途：从曲面原点沿龙骨方向扫掠生成实体
输入：
  1. 曲面 [Surface/单项] - 输入曲面参数：曲面。
  2. 截面 [Curve/单项] - 输入曲线参数：截面。
  3. U向分割 [Integer/单项] 默认=5 - 输入整数参数：U向分割。
  4. V向分割 [Integer/单项] 默认=5 - 输入整数参数：V向分割。
  5. 龙骨高度 [Number/单项] 默认=50.0 - 输入数值参数：龙骨高度。
  6. 双向 [Boolean/单项] 默认=true - 输入布尔开关：双向。
输出：
  1. 龙骨实体 [Brep/列表] - 输出实体参数：龙骨实体。
  2. 轨道 [Curve/列表] - 输出曲线参数：轨道。
图标：面片和扫掠曲线，对应曲面龙骨扫掠。

底层信息

底层类型：SurfaceKeelSweepComponent

GUID：B1A2C3D4-0007-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\SurfaceKeelSweepComponent.cs

图标资源：Icon_SurfaceKeelSweep.png

42 容差扫掠

容差扫 · cytoos > 05 实体

按容差进行扫掠操作

图标识别：扫掠曲线和容差圈，对应容差扫掠。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：5 输出：3

什么时候用

按容差进行扫掠操作。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 轨道轨道：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 截面截面：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
3. 容差容差：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.1。
4. 角度容差角度容：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。角度通常按度理解，先用 0、45、90 做小范围测试。；未连接时使用默认值：10.0。
5. 闭合闭合：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。

右侧输出端口接到哪里

1. 扫掠结果扫掠结：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
2. 分组轨道分组轨：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
3. 分组分组：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
轨道轨道	`Curve`列表	输入曲线参数：轨道。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
截面截面	`Curve`单项	输入曲线参数：截面。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
容差容差	`Number`单项	几何判断、分组或偏移使用的容许误差。默认值：0.1	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.1。
角度容差角度容	`Number`单项	输入数值参数：角度容差。默认值：10.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。角度通常按度理解，先用 0、45、90 做小范围测试。；未连接时使用默认值：10.0。
闭合闭合	`Boolean`单项	开启后生成闭合的曲线或扫掠结果。默认值：false	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。

输出端口

端口	类型/结构	中文说明	下游用法
扫掠结果扫掠结	`Brep`列表	生成的扫掠实体结果。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
分组轨道分组轨	`Curve`列表	输出曲线参数：分组轨道。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
分组分组	`Integer`单项	输出整数参数：分组。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

容差扫掠 (cytoos > 05 实体)
用途：按容差进行扫掠操作
输入：
  1. 轨道 [Curve/列表] - 输入曲线参数：轨道。
  2. 截面 [Curve/单项] - 输入曲线参数：截面。
  3. 容差 [Number/单项] 默认=0.1 - 几何判断、分组或偏移使用的容许误差。
  4. 角度容差 [Number/单项] 默认=10.0 - 输入数值参数：角度容差。
  5. 闭合 [Boolean/单项] 默认=false - 开启后生成闭合的曲线或扫掠结果。
输出：
  1. 扫掠结果 [Brep/列表] - 生成的扫掠实体结果。
  2. 分组轨道 [Curve/列表] - 输出曲线参数：分组轨道。
  3. 分组 [Integer/单项] - 输出整数参数：分组。
图标：扫掠曲线和容差圈，对应容差扫掠。

底层信息

底层类型：ToleranceSweepComponent

GUID：B1A2C3D4-0008-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\ToleranceSweepComponent.cs

图标资源：Icon_ToleranceSweep.png

43 实体拉升

体拉升 · cytoos > 05 实体

将曲面或曲线拉升为实体

图标识别：矩形实体和上拉箭头，对应实体拉升。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：5 输出：1

什么时候用

将曲面或曲线拉升为实体。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入曲线曲线：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 高度高度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：100.0。
3. 方向向量方向：接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。；未连接时使用默认值：Vector3d.ZAxis。
4. 居中居中：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。
5. 封口封口：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

右侧输出端口接到哪里

1. 输出实体实体：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
输入曲线曲线	`Curve`单项	需要处理的曲线对象。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
高度高度	`Number`单项	目标对象或图框的高度。默认值：100.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：100.0。
方向向量方向	`Vector`单项	移动、复制或生成方向使用的向量。默认值：Vector3d.ZAxis	接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。；未连接时使用默认值：Vector3d.ZAxis。
居中居中	`Boolean`单项	开启后在中心两侧均分生成结果。默认值：false	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。
封口封口	`Boolean`单项	开启后对拉伸或放样结果进行封口生成实体。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

输出端口

端口	类型/结构	中文说明	下游用法
输出实体实体	`Brep`单项	计算后生成的实体结果。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

实体拉升 (cytoos > 05 实体)
用途：将曲面或曲线拉升为实体
输入：
  1. 输入曲线 [Curve/单项] - 需要处理的曲线对象。
  2. 高度 [Number/单项] 默认=100.0 - 目标对象或图框的高度。
  3. 方向向量 [Vector/单项] 默认=Vector3d.ZAxis - 移动、复制或生成方向使用的向量。
  4. 居中 [Boolean/单项] 默认=false - 开启后在中心两侧均分生成结果。
  5. 封口 [Boolean/单项] 默认=true - 开启后对拉伸或放样结果进行封口生成实体。
输出：
  1. 输出实体 [Brep/单项] - 计算后生成的实体结果。
图标：矩形实体和上拉箭头，对应实体拉升。

底层信息

底层类型：SolidExtrudeComponent

GUID：B1A2C3D4-0005-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\SolidExtrudeComponent.cs

图标资源：Icon_SolidExtrude.png

44 实体偏移

体偏移 · cytoos > 05 实体

对实体进行向内或向外偏移操作

图标识别：盒体和外框，对应实体/Brep 偏移。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：4 输出：1

什么时候用

对实体进行向内或向外偏移操作。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入实体实体：接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
2. 距离距离：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。。
3. 实体化实体化：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。
4. 容差容差：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.01。

右侧输出端口接到哪里

1. 输出实体实体：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
输入实体实体	`Brep`单项	需要处理的实体对象。	接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
距离距离	`Number`单项	输入数值参数：距离。	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。。
实体化实体化	`Boolean`单项	开启后尝试生成封闭实体结果。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。
容差容差	`Number`单项	几何判断、分组或偏移使用的容许误差。默认值：0.01	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.01。

输出端口

端口	类型/结构	中文说明	下游用法
输出实体实体	`Brep`单项	计算后生成的实体结果。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

实体偏移 (cytoos > 05 实体)
用途：对实体进行向内或向外偏移操作
输入：
  1. 输入实体 [Brep/单项] - 需要处理的实体对象。
  2. 距离 [Number/单项] - 输入数值参数：距离。
  3. 实体化 [Boolean/单项] 默认=true - 开启后尝试生成封闭实体结果。
  4. 容差 [Number/单项] 默认=0.01 - 几何判断、分组或偏移使用的容许误差。
输出：
  1. 输出实体 [Brep/单项] - 计算后生成的实体结果。
图标：盒体和外框，对应实体/Brep 偏移。

底层信息

底层类型：SolidBrepOffsetComponent

GUID：B1A2C3D4-0001-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\SolidBrepOffsetComponent.cs

图标资源：Icon_SolidBrepOffset.png

45 实体斜切放样

斜切放 · cytoos > 05 实体

对实体进行斜切放样操作

图标识别：盒体斜切线，对应实体斜切放样。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：5 输出：1

什么时候用

对实体进行斜切放样操作。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 底部曲线底部曲：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 顶部曲线顶部曲：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
3. 斜切尺寸斜切尺：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.5。
4. 斜切段数斜切段：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
5. 高度高度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：0.0。

右侧输出端口接到哪里

1. 输出实体实体：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
底部曲线底部曲	`Curve`单项	输入曲线参数：底部曲线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
顶部曲线顶部曲	`Curve`单项	输入曲线参数：顶部曲线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
斜切尺寸斜切尺	`Number`单项	输入数值参数：斜切尺寸。默认值：0.5	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.5。
斜切段数斜切段	`Integer`单项	输入整数参数：斜切段数。默认值：3	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
高度高度	`Number`单项	目标对象或图框的高度。默认值：0.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：0.0。

输出端口

端口	类型/结构	中文说明	下游用法
输出实体实体	`Brep`单项	计算后生成的实体结果。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

实体斜切放样 (cytoos > 05 实体)
用途：对实体进行斜切放样操作
输入：
  1. 底部曲线 [Curve/单项] - 输入曲线参数：底部曲线。
  2. 顶部曲线 [Curve/单项] - 输入曲线参数：顶部曲线。
  3. 斜切尺寸 [Number/单项] 默认=0.5 - 输入数值参数：斜切尺寸。
  4. 斜切段数 [Integer/单项] 默认=3 - 输入整数参数：斜切段数。
  5. 高度 [Number/单项] 默认=0.0 - 目标对象或图框的高度。
输出：
  1. 输出实体 [Brep/单项] - 计算后生成的实体结果。
图标：盒体斜切线，对应实体斜切放样。

底层信息

底层类型：BevelLoftComponent

GUID：B1A2C3D4-0004-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\BevelLoftComponent.cs

图标资源：Icon_BevelLoft.png

46 引导线向量对齐龙骨

引导骨 · cytoos > 05 实体

通过引导线创建向量对齐的龙骨结构

图标识别：引导线、箭头和肋线，对应按引导线对齐龙骨。

插件：cyBattery.gha 分类：cytoos 子分类：05 实体输入：5 输出：2

什么时候用

通过引导线创建向量对齐的龙骨结构。当你的流程需要生成实体、龙骨、扫掠或螺栓螺丝构件时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 引导曲线引导曲：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
2. 截面截面：接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
3. 对齐向量对齐向：接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。；未连接时使用默认值：Vector3d.ZAxis。
4. 高度高度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
5. 自动定向自动定：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

右侧输出端口接到哪里

1. 龙骨龙骨：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 定向平面定向平：先接 Panel 或 Param Viewer 检查数据，再接到下游组件。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
实体类电池先确认 Brep 有效、面法线和闭合状态。

输入端口

端口	类型/结构	中文说明	连接建议
引导曲线引导曲	`Curve`列表	输入曲线参数：引导曲线。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
截面截面	`Curve`单项	输入曲线参数：截面。	接曲线或多段线。优先检查闭合、方向、是否共面和模型容差。。
对齐向量对齐向	`Vector`单项	输入向量参数：对齐向量。默认值：Vector3d.ZAxis	接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。；未连接时使用默认值：Vector3d.ZAxis。
高度高度	`Number`单项	目标对象或图框的高度。默认值：50.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。
自动定向自动定	`Boolean`单项	开启后自动调整截面方向，使其垂直于引导线。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

输出端口

端口	类型/结构	中文说明	下游用法
龙骨龙骨	`Brep`列表	输出实体参数：龙骨。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
定向平面定向平	`Plane`列表	输出平面参数：定向平面。	先接 Panel 或 Param Viewer 检查数据，再接到下游组件。

复制用法模板

引导线向量对齐龙骨 (cytoos > 05 实体)
用途：通过引导线创建向量对齐的龙骨结构
输入：
  1. 引导曲线 [Curve/列表] - 输入曲线参数：引导曲线。
  2. 截面 [Curve/单项] - 输入曲线参数：截面。
  3. 对齐向量 [Vector/单项] 默认=Vector3d.ZAxis - 输入向量参数：对齐向量。
  4. 高度 [Number/单项] 默认=50.0 - 目标对象或图框的高度。
  5. 自动定向 [Boolean/单项] 默认=true - 开启后自动调整截面方向，使其垂直于引导线。
输出：
  1. 龙骨 [Brep/列表] - 输出实体参数：龙骨。
  2. 定向平面 [Plane/列表] - 输出平面参数：定向平面。
图标：引导线、箭头和肋线，对应按引导线对齐龙骨。

底层信息

底层类型：GuideLineKeelComponent

GUID：B1A2C3D4-0011-4A1B-8C2D-3E4F5A6B7C8D

源码位置：cyBattery.Components.BrepCmpts\GuideLineKeelComponent.cs

图标资源：Icon_GuideLineKeel.png

06 数据

7 个电池

处理列表、镜像、复制、统计、文字统计和循环替代。重点检查列表长度、路径和文本分隔符。

47 多重复制

多重复 · cytoos > 06 数据

对几何体进行多重复制，支持阵列和偏移

图标识别：层叠方框，对应多重复制。

插件：cyBattery.gha 分类：cytoos 子分类：06 数据输入：5 输出：2

什么时候用

对几何体进行多重复制，支持阵列和偏移。当你的流程需要整理列表、文本、统计或替换数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入几何几何：接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
2. 数量数量：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：1。
3. 方向向量方向：接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。。
4. 步距步距：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.0。
5. 自定义变换变换：按端口类型接入对应 Grasshopper 数据，先用 Panel 检查数据结构。。

右侧输出端口接到哪里

1. 复制结果复制结：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
2. 变换矩阵矩阵：可接 Transform、Orient、阵列或用于调试实际变换矩阵。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
数据类电池先确认列表长度是否对齐，文本分隔符是否和 Panel 内容一致。

输入端口

端口	类型/结构	中文说明	连接建议
输入几何几何	`Geometry`单项	需要处理的几何对象。	接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
数量数量	`Integer`单项	需要生成、提取或统计的数量。默认值：1	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：1。
方向向量方向	`Vector`单项	移动、复制或生成方向使用的向量。	接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。。
步距步距	`Number`单项	输入数值参数：步距。默认值：0.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。；未连接时使用默认值：0.0。
自定义变换变换	`Transform`单项	可选的自定义重复变换。	按端口类型接入对应 Grasshopper 数据，先用 Panel 检查数据结构。。

输出端口

端口	类型/结构	中文说明	下游用法
复制结果复制结	`Geometry`列表	输出几何数据：复制结果。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
变换矩阵矩阵	`Transform`列表	本次操作实际应用的变换矩阵。	可接 Transform、Orient、阵列或用于调试实际变换矩阵。

复制用法模板

多重复制 (cytoos > 06 数据)
用途：对几何体进行多重复制，支持阵列和偏移
输入：
  1. 输入几何 [Geometry/单项] - 需要处理的几何对象。
  2. 数量 [Integer/单项] 默认=1 - 需要生成、提取或统计的数量。
  3. 方向向量 [Vector/单项] - 移动、复制或生成方向使用的向量。
  4. 步距 [Number/单项] 默认=0.0 - 输入数值参数：步距。
  5. 自定义变换 [Transform/单项] - 可选的自定义重复变换。
输出：
  1. 复制结果 [Geometry/列表] - 输出几何数据：复制结果。
  2. 变换矩阵 [Transform/列表] - 本次操作实际应用的变换矩阵。
图标：层叠方框，对应多重复制。

底层信息

底层类型：MultiCopyComponent

GUID：a1b2c3d4-1005-4000-8000-000000000005

源码位置：cyBattery.Components.Data\MultiCopyComponent.cs

图标资源：Icon_MultiCopy.png

48 列表居中数据

居中数 · cytoos > 06 数据

从列表中提取中间位置的元素，支持多个居中项

图标识别：列表中间点高亮，对应提取列表居中数据。

插件：cyBattery.gha 分类：cytoos 子分类：06 数据输入：2 输出：2

什么时候用

从列表中提取中间位置的元素，支持多个居中项。当你的流程需要整理列表、文本、统计或替换数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 列表列表：接任意数据。先用 Panel 或 Param Viewer 检查类型和数据树。。
2. 数量数量：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。

右侧输出端口接到哪里

1. 中间项中间项：先接 Panel 或 Param Viewer 检查数据，再接到下游组件。
2. 索引索引：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
数据类电池先确认列表长度是否对齐，文本分隔符是否和 Panel 内容一致。

输入端口

端口	类型/结构	中文说明	连接建议
列表列表	`Generic`列表	输入通用数据：列表。	接任意数据。先用 Panel 或 Param Viewer 检查类型和数据树。。
数量数量	`Integer`单项	需要生成、提取或统计的数量。默认值：0	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：0。

输出端口

端口	类型/结构	中文说明	下游用法
中间项中间项	`Generic`列表	输出通用数据：中间项。	先接 Panel 或 Param Viewer 检查数据，再接到下游组件。
索引索引	`Integer`列表	输出整数参数：索引。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

列表居中数据 (cytoos > 06 数据)
用途：从列表中提取中间位置的元素，支持多个居中项
输入：
  1. 列表 [Generic/列表] - 输入通用数据：列表。
  2. 数量 [Integer/单项] 默认=0 - 需要生成、提取或统计的数量。
输出：
  1. 中间项 [Generic/列表] - 输出通用数据：中间项。
  2. 索引 [Integer/列表] - 输出整数参数：索引。
图标：列表中间点高亮，对应提取列表居中数据。

底层信息

底层类型：ListMiddleDataComponent

GUID：a1b2c3d4-1001-4000-8000-000000000001

源码位置：cyBattery.Components.Data\ListMiddleDataComponent.cs

图标资源：Icon_ListMiddleData.png

49 列表选项

列选项 · cytoos > 06 数据

对列表数据进行选项操作和交互选择

图标识别：列表点和横线，对应列表选项。

插件：cyBattery.gha 分类：cytoos 子分类：06 数据输入：2 输出：4

什么时候用

对列表数据进行选项操作和交互选择。当你的流程需要整理列表、文本、统计或替换数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 选项选项：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
2. 索引索引：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。索引从 0 开始，列表长度不足会导致空结果。；未连接时使用默认值：0。

右侧输出端口接到哪里

1. 选中项选中项：可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。
2. 索引索引：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
3. 全部选项全部选：可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。
4. 数量数量：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
数据类电池先确认列表长度是否对齐，文本分隔符是否和 Panel 内容一致。

输入端口

端口	类型/结构	中文说明	连接建议
选项选项	`Text`列表	输入文本参数：选项。	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
索引索引	`Integer`单项	输入整数参数：索引。默认值：0	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。索引从 0 开始，列表长度不足会导致空结果。；未连接时使用默认值：0。

输出端口

端口	类型/结构	中文说明	下游用法
选中项选中项	`Text`单项	输出文本参数：选中项。	可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。
索引索引	`Integer`单项	输出整数参数：索引。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
全部选项全部选	`Text`列表	输出文本参数：全部选项。	可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。
数量数量	`Integer`单项	输出整数参数：数量。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

列表选项 (cytoos > 06 数据)
用途：对列表数据进行选项操作和交互选择
输入：
  1. 选项 [Text/列表] - 输入文本参数：选项。
  2. 索引 [Integer/单项] 默认=0 - 输入整数参数：索引。
输出：
  1. 选中项 [Text/单项] - 输出文本参数：选中项。
  2. 索引 [Integer/单项] - 输出整数参数：索引。
  3. 全部选项 [Text/列表] - 输出文本参数：全部选项。
  4. 数量 [Integer/单项] - 输出整数参数：数量。
图标：列表点和横线，对应列表选项。

底层信息

底层类型：ListOptionsComponent

GUID：a1b2c3d4-1007-4000-8000-000000000007

源码位置：cyBattery.Components.Data\ListOptionsComponent.cs

图标资源：Icon_ListOptions.png

50 数据镜像

数镜像 · cytoos > 06 数据

对数据进行镜像操作，反转列表顺序或对称映射

图标识别：中轴左右对象，对应数据镜像。

插件：cyBattery.gha 分类：cytoos 子分类：06 数据输入：2 输出：1

什么时候用

对数据进行镜像操作，反转列表顺序或对称映射。当你的流程需要整理列表、文本、统计或替换数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 数据数据：接任意数据。先用 Panel 或 Param Viewer 检查类型和数据树。。
2. 模式模式：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：2。

右侧输出端口接到哪里

1. 镜像结果镜像结：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
数据类电池先确认列表长度是否对齐，文本分隔符是否和 Panel 内容一致。

输入端口

端口	类型/结构	中文说明	连接建议
数据数据	`Generic`数据树	输入通用数据：数据。	接任意数据。先用 Panel 或 Param Viewer 检查类型和数据树。。
模式模式	`Integer`单项	组件的计算模式，用数字选择不同处理方式。默认值：2	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：2。

输出端口

端口	类型/结构	中文说明	下游用法
镜像结果镜像结	`Generic`数据树	输出通用数据：镜像结果。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。

复制用法模板

数据镜像 (cytoos > 06 数据)
用途：对数据进行镜像操作，反转列表顺序或对称映射
输入：
  1. 数据 [Generic/数据树] - 输入通用数据：数据。
  2. 模式 [Integer/单项] 默认=2 - 组件的计算模式，用数字选择不同处理方式。
输出：
  1. 镜像结果 [Generic/数据树] - 输出通用数据：镜像结果。
图标：中轴左右对象，对应数据镜像。

底层信息

底层类型：DataMirrorComponent

GUID：a1b2c3d4-1002-4000-8000-000000000002

源码位置：cyBattery.Components.Data\DataMirrorComponent.cs

图标资源：Icon_DataMirror.png

51 数值统计

数统 · cytoos > 06 数据

对数值列表进行统计分析，包括求和、均值、最大最小值等

图标识别：柱状图，对应数值统计。

插件：cyBattery.gha 分类：cytoos 子分类：06 数据输入：2 输出：6

什么时候用

对数值列表进行统计分析，包括求和、均值、最大最小值等。当你的流程需要整理列表、文本、统计或替换数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 数值数值：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。。
2. 总体统计总体统：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

右侧输出端口接到哪里

1. 最小值最小值：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
2. 最大值最大值：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
3. 平均值平均值：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
4. 标准差标准差：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
5. 总和总和：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
6. 数量数量：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
数据类电池先确认列表长度是否对齐，文本分隔符是否和 Panel 内容一致。

输入端口

端口	类型/结构	中文说明	连接建议
数值数值	`Number`列表	输入数值参数：数值。	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。。
总体统计总体统	`Boolean`单项	开启后按总体标准差计算，关闭后按样本标准差计算。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

输出端口

端口	类型/结构	中文说明	下游用法
最小值最小值	`Number`单项	输出数值参数：最小值。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
最大值最大值	`Number`单项	输出数值参数：最大值。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
平均值平均值	`Number`单项	输出数值参数：平均值。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
标准差标准差	`Number`单项	输出数值参数：标准差。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
总和总和	`Number`单项	输出数值参数：总和。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
数量数量	`Integer`单项	输出整数参数：数量。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

数值统计 (cytoos > 06 数据)
用途：对数值列表进行统计分析，包括求和、均值、最大最小值等
输入：
  1. 数值 [Number/列表] - 输入数值参数：数值。
  2. 总体统计 [Boolean/单项] 默认=true - 开启后按总体标准差计算，关闭后按样本标准差计算。
输出：
  1. 最小值 [Number/单项] - 输出数值参数：最小值。
  2. 最大值 [Number/单项] - 输出数值参数：最大值。
  3. 平均值 [Number/单项] - 输出数值参数：平均值。
  4. 标准差 [Number/单项] - 输出数值参数：标准差。
  5. 总和 [Number/单项] - 输出数值参数：总和。
  6. 数量 [Integer/单项] - 输出整数参数：数量。
图标：柱状图，对应数值统计。

底层信息

底层类型：NumberStatisticsComponent

GUID：a1b2c3d4-1004-4000-8000-000000000004

源码位置：cyBattery.Components.Data\NumberStatisticsComponent.cs

图标资源：Icon_NumberStatistics.png

52 文字统计

文统 · cytoos > 06 数据

对文本数据进行统计分析，包括字符统计、字频分析等

图标识别：字母 T 和文本线，对应文字统计。

插件：cyBattery.gha 分类：cytoos 子分类：06 数据输入：2 输出：4

什么时候用

对文本数据进行统计分析，包括字符统计、字频分析等。当你的流程需要整理列表、文本、统计或替换数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 文本文本：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
2. 区分大小写区分大：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。

右侧输出端口接到哪里

1. 总数量总数量：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
2. 唯一数量唯一数：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
3. 唯一文本唯一文：可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。
4. 频次频次：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
数据类电池先确认列表长度是否对齐，文本分隔符是否和 Panel 内容一致。

输入端口

端口	类型/结构	中文说明	连接建议
文本文本	`Text`列表	输入文本参数：文本。	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
区分大小写区分大	`Boolean`单项	开启后会区分中文、英文大小写和不同字符形式。默认值：false	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。

输出端口

端口	类型/结构	中文说明	下游用法
总数量总数量	`Integer`单项	输出整数参数：总数量。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
唯一数量唯一数	`Integer`单项	输出整数参数：唯一数量。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。
唯一文本唯一文	`Text`列表	输出文本参数：唯一文本。	可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。
频次频次	`Integer`列表	输出整数参数：频次。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

文字统计 (cytoos > 06 数据)
用途：对文本数据进行统计分析，包括字符统计、字频分析等
输入：
  1. 文本 [Text/列表] - 输入文本参数：文本。
  2. 区分大小写 [Boolean/单项] 默认=false - 开启后会区分中文、英文大小写和不同字符形式。
输出：
  1. 总数量 [Integer/单项] - 输出整数参数：总数量。
  2. 唯一数量 [Integer/单项] - 输出整数参数：唯一数量。
  3. 唯一文本 [Text/列表] - 输出文本参数：唯一文本。
  4. 频次 [Integer/列表] - 输出整数参数：频次。
图标：字母 T 和文本线，对应文字统计。

底层信息

底层类型：TextStatisticsComponent

GUID：a1b2c3d4-1003-4000-8000-000000000003

源码位置：cyBattery.Components.Data\TextStatisticsComponent.cs

图标资源：Icon_TextStatistics.png

53 循环替代

循环替 · cytoos > 06 数据

对文本或数据进行循环查找替换处理

图标识别：循环箭头和替换线，对应循环查找替代。

插件：cyBattery.gha 分类：cytoos 子分类：06 数据输入：5 输出：2

什么时候用

对文本或数据进行循环查找替换处理。当你的流程需要整理列表、文本、统计或替换数据时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入文本输入文：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
2. 查找内容查找内：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
3. 替换内容替换内：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
4. 正则正则：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。
5. 循环循环：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。

右侧输出端口接到哪里

1. 结果结果：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
2. 替换次数替换次：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
数据类电池先确认列表长度是否对齐，文本分隔符是否和 Panel 内容一致。

输入端口

端口	类型/结构	中文说明	连接建议
输入文本输入文	`Text`列表	输入文本参数：输入文本。	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
查找内容查找内	`Text`列表	输入文本参数：查找内容。	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
替换内容替换内	`Text`列表	输入文本参数：替换内容。	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
正则正则	`Boolean`单项	开启后把查找内容按正则表达式解析。默认值：false	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。
循环循环	`Boolean`单项	开启后重复执行查找替换，直到没有可替换内容。默认值：false	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：false。

输出端口

端口	类型/结构	中文说明	下游用法
结果结果	`Text`列表	输出文本参数：结果。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
替换次数替换次	`Integer`列表	输出整数参数：替换次数。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

循环替代 (cytoos > 06 数据)
用途：对文本或数据进行循环查找替换处理
输入：
  1. 输入文本 [Text/列表] - 输入文本参数：输入文本。
  2. 查找内容 [Text/列表] - 输入文本参数：查找内容。
  3. 替换内容 [Text/列表] - 输入文本参数：替换内容。
  4. 正则 [Boolean/单项] 默认=false - 开启后把查找内容按正则表达式解析。
  5. 循环 [Boolean/单项] 默认=false - 开启后重复执行查找替换，直到没有可替换内容。
输出：
  1. 结果 [Text/列表] - 输出文本参数：结果。
  2. 替换次数 [Integer/列表] - 输出整数参数：替换次数。
图标：循环箭头和替换线，对应循环查找替代。

底层信息

底层类型：LoopReplaceComponent

GUID：a1b2c3d4-1006-4000-8000-000000000006

源码位置：cyBattery.Components.Data\LoopReplaceComponent.cs

图标资源：Icon_LoopReplace.png

07 变换

2 个电池

移动几何和三点定位。重点检查源点、目标点、方向向量和变换矩阵。

54 物件三点定位

三点定 · cytoos > 07 变换

通过三个点定位变换物件位置，实现精确对齐

图标识别：三点和方向箭头，对应物件三点定位。

插件：cyBattery.gha 分类：cytoos 子分类：07 变换输入：7 输出：2

什么时候用

通过三个点定位变换物件位置，实现精确对齐。当你的流程需要移动、定位或对齐几何时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入几何几何：接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
2. 源原点源原点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
3. 源X向点源向点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
4. 源Y向点源向点：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
5. 目标原点目标原：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
6. 目标X向点目标向：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
7. 目标Y向点目标向：接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。

右侧输出端口接到哪里

1. 结果几何结果：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
2. 变换矩阵矩阵：可接 Transform、Orient、阵列或用于调试实际变换矩阵。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
输入几何几何	`Geometry`单项	需要处理的几何对象。	接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
源原点源原点	`Point`单项	输入点参数：源原点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
源X向点源向点	`Point`单项	输入点参数：源X向点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
源Y向点源向点	`Point`单项	输入点参数：源Y向点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
目标原点目标原	`Point`单项	输入点参数：目标原点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
目标X向点目标向	`Point`单项	输入点参数：目标X向点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。
目标Y向点目标向	`Point`单项	输入点参数：目标Y向点。	接 Point 参数、点列表或由几何提取的端点/角点。注意点顺序、分支和坐标系。。

输出端口

端口	类型/结构	中文说明	下游用法
结果几何结果	`Geometry`单项	组件计算后得到的几何结果。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
变换矩阵矩阵	`Transform`单项	本次操作实际应用的变换矩阵。	可接 Transform、Orient、阵列或用于调试实际变换矩阵。

复制用法模板

物件三点定位 (cytoos > 07 变换)
用途：通过三个点定位变换物件位置，实现精确对齐
输入：
  1. 输入几何 [Geometry/单项] - 需要处理的几何对象。
  2. 源原点 [Point/单项] - 输入点参数：源原点。
  3. 源X向点 [Point/单项] - 输入点参数：源X向点。
  4. 源Y向点 [Point/单项] - 输入点参数：源Y向点。
  5. 目标原点 [Point/单项] - 输入点参数：目标原点。
  6. 目标X向点 [Point/单项] - 输入点参数：目标X向点。
  7. 目标Y向点 [Point/单项] - 输入点参数：目标Y向点。
输出：
  1. 结果几何 [Geometry/单项] - 组件计算后得到的几何结果。
  2. 变换矩阵 [Transform/单项] - 本次操作实际应用的变换矩阵。
图标：三点和方向箭头，对应物件三点定位。

底层信息

底层类型：ThreePointPositionComponent

GUID：a1b2c3d4-2002-4000-8000-000000000009

源码位置：cyBattery.Components.TransformCmpts\ThreePointPositionComponent.cs

图标资源：Icon_ThreePointPosition.png

55 移动

移动 · cytoos > 07 变换

沿指定方向或轴向移动几何体

图标识别：小方块和箭头，对应移动几何。

插件：cyBattery.gha 分类：cytoos 子分类：07 变换输入：4 输出：2

什么时候用

沿指定方向或轴向移动几何体。当你的流程需要移动、定位或对齐几何时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入几何几何：接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
2. 方向向量方向：接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。。
3. 距离距离：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：1.0。
4. 轴向轴向：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：-1。

右侧输出端口接到哪里

1. 结果几何结果：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
2. 变换矩阵矩阵：可接 Transform、Orient、阵列或用于调试实际变换矩阵。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。

输入端口

端口	类型/结构	中文说明	连接建议
输入几何几何	`Geometry`单项	需要处理的几何对象。	接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
方向向量方向	`Vector`单项	移动、复制或生成方向使用的向量。	接向量参数、两点向量或 Unit X/Y/Z。注意方向是否需要反转。。
距离距离	`Number`单项	输入数值参数：距离。默认值：1.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：1.0。
轴向轴向	`Integer`单项	轴向选择：0为X轴，1为Y轴，2为Z轴，-1使用自定义方向。默认值：-1	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：-1。

输出端口

端口	类型/结构	中文说明	下游用法
结果几何结果	`Geometry`单项	组件计算后得到的几何结果。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。
变换矩阵矩阵	`Transform`单项	本次操作实际应用的变换矩阵。	可接 Transform、Orient、阵列或用于调试实际变换矩阵。

复制用法模板

移动 (cytoos > 07 变换)
用途：沿指定方向或轴向移动几何体
输入：
  1. 输入几何 [Geometry/单项] - 需要处理的几何对象。
  2. 方向向量 [Vector/单项] - 移动、复制或生成方向使用的向量。
  3. 距离 [Number/单项] 默认=1.0 - 输入数值参数：距离。
  4. 轴向 [Integer/单项] 默认=-1 - 轴向选择：0为X轴，1为Y轴，2为Z轴，-1使用自定义方向。
输出：
  1. 结果几何 [Geometry/单项] - 组件计算后得到的几何结果。
  2. 变换矩阵 [Transform/单项] - 本次操作实际应用的变换矩阵。
图标：小方块和箭头，对应移动几何。

底层信息

底层类型：MoveComponent

GUID：a1b2c3d4-2001-4000-8000-000000000008

源码位置：cyBattery.Components.TransformCmpts\MoveComponent.cs

图标资源：Icon_Move.png

08 烘焙

2 个电池

批量出图、图框定位和无线发送。重点检查输出路径、通道、发送开关和 Rhino 文档状态。

56 批量出图-定位图框

批出图 · cytoos > 08 烘焙

将几何体布置到图框网格中，用于批量出图排版

图标识别：图框和导出箭头，对应批量出图定位图框。

插件：cyBattery.gha 分类：cytoos 子分类：08 烘焙输入：6 输出：5

什么时候用

将几何体布置到图框网格中，用于批量出图排版。当你的流程需要导出、发送或布置图框时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入几何几何：接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
2. 宽度宽度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：800.0。
3. 高度高度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：600.0。
4. 输出路径输出路：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。路径类输入建议使用完整路径，并确认文件夹存在。。
5. 列数列数：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
6. 间距间距：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。

右侧输出端口接到哪里

1. 图框图框：先接 Panel 或 Param Viewer 检查数据，再接到下游组件。
2. 原点原点：可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
3. 变换矩阵矩阵：可接 Transform、Orient、阵列或用于调试实际变换矩阵。
4. 导出路径导出路：可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。
5. 索引索引：可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
烘焙/导出前先保存 Rhino 文件，并确认输出路径或发送通道。

输入端口

端口	类型/结构	中文说明	连接建议
输入几何几何	`Geometry`列表	需要处理的几何对象。	接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
宽度宽度	`Number`单项	目标对象或图框的宽度。默认值：800.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：800.0。
高度高度	`Number`单项	目标对象或图框的高度。默认值：600.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：600.0。
输出路径输出路	`Text`单项	输入文本参数：输出路径。	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。路径类输入建议使用完整路径，并确认文件夹存在。。
列数列数	`Integer`单项	输入整数参数：列数。默认值：3	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。；未连接时使用默认值：3。
间距间距	`Number`单项	输入数值参数：间距。默认值：50.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：50.0。

输出端口

端口	类型/结构	中文说明	下游用法
图框图框	`Rectangle`列表	输出几何数据：图框。	先接 Panel 或 Param Viewer 检查数据，再接到下游组件。
原点原点	`Point`列表	输出点参数：原点。	可接点预览、连线、拟合曲线、标注、坐标格式化或最近点查询。
变换矩阵矩阵	`Transform`列表	本次操作实际应用的变换矩阵。	可接 Transform、Orient、阵列或用于调试实际变换矩阵。
导出路径导出路	`Text`列表	输出文本参数：导出路径。	可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。
索引索引	`Integer`数据树	输出整数参数：索引。	可接 Panel 检查，也可驱动排序、筛选、尺寸、统计或列表索引。

复制用法模板

批量出图-定位图框 (cytoos > 08 烘焙)
用途：将几何体布置到图框网格中，用于批量出图排版
输入：
  1. 输入几何 [Geometry/列表] - 需要处理的几何对象。
  2. 宽度 [Number/单项] 默认=800.0 - 目标对象或图框的宽度。
  3. 高度 [Number/单项] 默认=600.0 - 目标对象或图框的高度。
  4. 输出路径 [Text/单项] - 输入文本参数：输出路径。
  5. 列数 [Integer/单项] 默认=3 - 输入整数参数：列数。
  6. 间距 [Number/单项] 默认=50.0 - 输入数值参数：间距。
输出：
  1. 图框 [Rectangle/列表] - 输出几何数据：图框。
  2. 原点 [Point/列表] - 输出点参数：原点。
  3. 变换矩阵 [Transform/列表] - 本次操作实际应用的变换矩阵。
  4. 导出路径 [Text/列表] - 输出文本参数：导出路径。
  5. 索引 [Integer/数据树] - 输出整数参数：索引。
图标：图框和导出箭头，对应批量出图定位图框。

底层信息

底层类型：BatchExportFrameComponent

GUID：E9F0A1B2-C3D4-4E5F-6A70-89012345670B

源码位置：cyBattery.Components.Bake\BatchExportFrameComponent.cs

图标资源：Icon_BatchExportFrame.png

57 无线发送

无线发 · cytoos > 08 烘焙

无线发送数据到外部设备或服务

图标识别：发射点、波纹和箭头，对应无线发送。

插件：cyBattery.gha 分类：cytoos 子分类：08 烘焙输入：3 输出：2

什么时候用

无线发送数据到外部设备或服务。当你的流程需要导出、发送或布置图框时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 输入几何几何：接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
2. 通道通道：接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
3. 发送发送：接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

右侧输出端口接到哪里

1. 输出几何几何：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 说明说明：可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
烘焙/导出前先保存 Rhino 文件，并确认输出路径或发送通道。

输入端口

端口	类型/结构	中文说明	连接建议
输入几何几何	`Geometry`列表	需要处理的几何对象。	接 Brep、Curve、Point、Mesh 等通用几何。列表输入先检查 Flatten/Graft 是否符合预期。。
通道通道	`Text`单项	无线数据传递使用的通道名称，接收端需使用同名通道。	接 Panel 文本。关键词、路径、通道名和分隔符建议直接复制模板测试。。
发送发送	`Boolean`单项	开启后将几何数据发送到指定通道。默认值：true	接 Boolean Toggle。True 开启，False 关闭。；未连接时使用默认值：true。

输出端口

端口	类型/结构	中文说明	下游用法
输出几何几何	`Geometry`列表	原始几何的传递输出。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
说明说明	`Text`单项	组件运行状态与提示信息。	可接 Panel、文本标注、导出、无线发送、文件路径或下游命令输入。

复制用法模板

无线发送 (cytoos > 08 烘焙)
用途：无线发送数据到外部设备或服务
输入：
  1. 输入几何 [Geometry/列表] - 需要处理的几何对象。
  2. 通道 [Text/单项] - 无线数据传递使用的通道名称，接收端需使用同名通道。
  3. 发送 [Boolean/单项] 默认=true - 开启后将几何数据发送到指定通道。
输出：
  1. 输出几何 [Geometry/列表] - 原始几何的传递输出。
  2. 说明 [Text/单项] - 组件运行状态与提示信息。
图标：发射点、波纹和箭头，对应无线发送。

底层信息

底层类型：WirelessSendComponent

GUID：D8E9F0A1-2B3C-4D5E-6F70-89012345670A

源码位置：cyBattery.Components.Bake\WirelessSendComponent.cs

图标资源：Icon_WirelessSend.png

09 铝板

2 个电池

铝板单边折边和多边折边。重点检查面板、边索引、角度、半径和折边方向。

58 铝板-单边折边

单边折 · cytoos > 09 铝板

对铝板进行单边折边处理

图标识别：单侧红色折边，对应铝板单边折边。

插件：cyBattery.gha 分类：cytoos 子分类：09 铝板输入：4 输出：3

什么时候用

对铝板进行单边折边处理。当你的流程需要处理铝板折边时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 面板面板：接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
2. 边索引边索引：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。索引从 0 开始，列表长度不足会导致空结果。。
3. 角度角度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。角度通常按度理解，先用 0、45、90 做小范围测试。；未连接时使用默认值：90.0。
4. 半径半径：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：0.0。

右侧输出端口接到哪里

1. 折弯面板折弯面：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 折弯线折弯线：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
3. 翻边翻边：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
折边前先确认边索引和折边方向，建议先在单块面板上测试。

输入端口

端口	类型/结构	中文说明	连接建议
面板面板	`Brep`单项	输入实体参数：面板。	接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
边索引边索引	`Integer`单项	输入整数参数：边索引。	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。索引从 0 开始，列表长度不足会导致空结果。。
角度角度	`Number`单项	以度为单位的角度值。默认值：90.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。角度通常按度理解，先用 0、45、90 做小范围测试。；未连接时使用默认值：90.0。
半径半径	`Number`单项	折弯、偏移或圆角使用的半径值。默认值：0.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：0.0。

输出端口

端口	类型/结构	中文说明	下游用法
折弯面板折弯面	`Brep`单项	输出实体参数：折弯面板。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
折弯线折弯线	`Curve`单项	输出曲线参数：折弯线。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
翻边翻边	`Brep`单项	输出实体参数：翻边。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。

复制用法模板

铝板-单边折边 (cytoos > 09 铝板)
用途：对铝板进行单边折边处理
输入：
  1. 面板 [Brep/单项] - 输入实体参数：面板。
  2. 边索引 [Integer/单项] - 输入整数参数：边索引。
  3. 角度 [Number/单项] 默认=90.0 - 以度为单位的角度值。
  4. 半径 [Number/单项] 默认=0.0 - 折弯、偏移或圆角使用的半径值。
输出：
  1. 折弯面板 [Brep/单项] - 输出实体参数：折弯面板。
  2. 折弯线 [Curve/单项] - 输出曲线参数：折弯线。
  3. 翻边 [Brep/单项] - 输出实体参数：翻边。
图标：单侧红色折边，对应铝板单边折边。

底层信息

底层类型：SingleEdgeFoldComponent

GUID：F1A2B3C4-D5E6-4F70-8A90-12345678900C

源码位置：cyBattery.Components.Aluminum\SingleEdgeFoldComponent.cs

图标资源：Icon_SingleEdgeFold1.png

59 铝板-多重边折边

多边折 · cytoos > 09 铝板

对铝板进行多重边折边处理，支持不同折角和折弯半径

图标识别：多条红色折线，对应铝板多重边折边。

插件：cyBattery.gha 分类：cytoos 子分类：09 铝板输入：4 输出：3

什么时候用

对铝板进行多重边折边处理，支持不同折角和折弯半径。当你的流程需要处理铝板折边时使用它；先用少量数据测试，确认输出数量、顺序和数据树正确后再接入完整模型。

左侧输入端口从上到下怎么接

1. 面板面板：接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
2. 边索引边索引：接整数 Slider、Panel 或列表索引。索引通常从 0 开始。索引从 0 开始，列表长度不足会导致空结果。。
3. 角度角度：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。角度通常按度理解，先用 0、45、90 做小范围测试。。
4. 半径半径：接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：0.0。

右侧输出端口接到哪里

1. 折弯面板折弯面：可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
2. 折弯线折弯线：可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
3. 中间结果中间结：先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。

注意事项

先接 Panel 或 Param Viewer 检查输入输出数量、类型和路径，再连接到下游。
如果结果为空，优先检查必填输入是否接入、数据树是否需要 Flatten/Graft、默认值是否符合当前模型单位。
折边前先确认边索引和折边方向，建议先在单块面板上测试。

输入端口

端口	类型/结构	中文说明	连接建议
面板面板	`Brep`单项	输入实体参数：面板。	接有效 Brep 或封闭实体。布尔、偏移和折边前先检查是否有效、是否闭合。。
边索引边索引	`Integer`列表	输入整数参数：边索引。	接整数 Slider、Panel 或列表索引。索引通常从 0 开始。索引从 0 开始，列表长度不足会导致空结果。。
角度角度	`Number`列表	以度为单位的角度值。	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。角度通常按度理解，先用 0、45、90 做小范围测试。。
半径半径	`Number`单项	折弯、偏移或圆角使用的半径值。默认值：0.0	接 Number Slider 或 Panel。单位跟随 Rhino 当前模型单位。尺寸值跟随 Rhino 文件单位，先用小数值验证方向。；未连接时使用默认值：0.0。

输出端口

端口	类型/结构	中文说明	下游用法
折弯面板折弯面	`Brep`单项	输出实体参数：折弯面板。	可接预览、布尔、偏移、烘焙、统计或继续作为下游几何输入。
折弯线折弯线	`Curve`列表	输出曲线参数：折弯线。	可接偏移、分段、放样、扫掠、边界生成或 Bake 流程。
中间结果中间结	`Brep`列表	每一步折弯后的中间实体结果。	先接 Panel 检查 True/False，也可接 Dispatch、Cull Pattern 或作为流程开关。

复制用法模板

铝板-多重边折边 (cytoos > 09 铝板)
用途：对铝板进行多重边折边处理，支持不同折角和折弯半径
输入：
  1. 面板 [Brep/单项] - 输入实体参数：面板。
  2. 边索引 [Integer/列表] - 输入整数参数：边索引。
  3. 角度 [Number/列表] - 以度为单位的角度值。
  4. 半径 [Number/单项] 默认=0.0 - 折弯、偏移或圆角使用的半径值。
输出：
  1. 折弯面板 [Brep/单项] - 输出实体参数：折弯面板。
  2. 折弯线 [Curve/列表] - 输出曲线参数：折弯线。
  3. 中间结果 [Brep/列表] - 每一步折弯后的中间实体结果。
图标：多条红色折线，对应铝板多重边折边。

底层信息

底层类型：MultiEdgeFoldComponent

GUID：A2B3C4D5-E6F7-4A80-9B01-23456789000D

源码位置：cyBattery.Components.Aluminum\MultiEdgeFoldComponent.cs

图标资源：Icon_MultiEdgeFold.png

cyBattery 中文电池完整教程

推荐使用流程

1. 先确认分类

2. 先接必填端口

3. 先看 Panel

常用实战

这几个电池的分工

几何匹配怎么理解

快速求物体最上面面的中心点

指令与输出速查

1. 几何属性查询：接到「几何属性查询 / 属性」端口

1.1 点 Point 可用属性

1.2 曲线 Curve / Line / Polyline 可用属性

1.3 Brep 可用属性

1.4 Surface 可用属性

1.5 Mesh 可用属性

2. 几何过滤：接到「几何过滤 / 过滤条件」端口

2.1 点 Point 过滤

2.2 曲线 Curve 过滤

2.3 Brep 过滤

2.4 Surface 过滤

2.5 Mesh 过滤

3. 几何排序：接到「几何排序 / 排序依据」端口

3.1 点 Point 排序

3.2 曲线 Curve 排序

3.3 Brep 排序

3.4 Surface 排序

3.5 Mesh 排序

4. 几何匹配：接到「几何匹配 / 匹配规则」端口

5. 格式、文本、通道和路径：接到对应 Text 端口

6. 常用默认值和开关：接 Number / Integer / Boolean / Plane 端口

电池用法目录

00 属性

01 点环排列

什么时候用

左侧输入端口从上到下怎么接

右侧输出端口接到哪里

注意事项

02 几何过滤

什么时候用

左侧输入端口从上到下怎么接

右侧输出端口接到哪里

注意事项

03 几何排序

什么时候用

左侧输入端口从上到下怎么接

右侧输出端口接到哪里

注意事项

04 几何匹配

什么时候用

左侧输入端口从上到下怎么接

右侧输出端口接到哪里

注意事项

05 几何属性查询

什么时候用

左侧输入端口从上到下怎么接

右侧输出端口接到哪里

注意事项

01 点

06 点阵

什么时候用

左侧输入端口从上到下怎么接

右侧输出端口接到哪里

注意事项

07 格式点

什么时候用

左侧输入端口从上到下怎么接

右侧输出端口接到哪里

注意事项

08 快速点定位

什么时候用

左侧输入端口从上到下怎么接

右侧输出端口接到哪里

注意事项

09 面板角点数据输出格式化

什么时候用

左侧输入端口从上到下怎么接

右侧输出端口接到哪里

注意事项

10 双倾算法