功能手册

野猪插件 全部功能与组件详解,按分类组织,含输入输出端口与使用方法。

界面管理

906 · UI MANAGEMENT

菜单栏管理

管理 Grasshopper 编辑器主菜单(文件、编辑、视图……)每个顶层菜单的显示与排序:任意勾选隐藏不常用项、拖拽调整顺序、一键恢复 GH 默认布局;配置持久保存,重启自动生效。

菜单栏管理

插件栏管理

管理 GH 组件库顶部选项卡(Params、Maths、Curve……及各类插件栏)的显示与排序:一键隐藏用不到的插件选项卡、自由排序、自动识别插件来源;通过绘制防线与看门狗对抗 GH 重建,隐藏设置稳定不丢。

插件栏管理

画布工具栏管理

管理画布顶部工具栏按钮:网格、命令行、搜索、断线、视窗等快捷按钮一键开关;野猪工具组自动钉在最左侧,不被 GH 重排挤走;按钮显隐与顺序持久化。

画布工具栏管理

GH 小功能开关

在管理器「小功能」面板集中开关各类画布小功能(加强版搜索、断线、视窗等),勾选即生效、状态持久化。

GH 小功能开关

画布快捷键

自定义画布快捷键,常用操作一键直达,键盘流高效操作。

画布快捷键

WB 电池包

920 · WBPACK

WB 电池包

WBPack

把一段完整的 Grasshopper 参数化逻辑打包成加密电池(.wbpack),自带输入输出端口,像积木一样复用与分发。支持双密码:运行密码(只看结果、可运行)与编辑密码(可查看和修改内部逻辑),文件本体经 Argon2id 密钥派生加密,无密码无法打开。

打包界面 1打包界面 2 打包界面 3打包界面 4
使用方法:① 框选要打包的组件(含输入输出)→ ② 右键「打包为 WB 电池包」→ ③ 设置运行密码 / 编辑密码 → ④ 保存为 .wbpack。使用时拖入画布,双击输入运行密码即可运行,输入编辑密码可进入内部编辑。

列表组件

03 · LIST

拆分列表

SplitList

按给定索引位置把列表拆成多段(树形结构)。

输入
  • 列表 L — 要拆分的列表
  • 索引 N — 拆分位置的索引值列表
输出
  • 列表 C — 拆分后的列表树
使用方法:索引 N 传 [2,5],把列表切成 [0-1]、[2-4]、[5-末尾] 三段,每段一个树枝。

清理数据

Clean

按需清除列表中的空值、无效数据、空白文本。

输入
  • 清理空值 N / 清理无效 X / 清理空白 E — 各清理开关
  • 数据 T — 待清理的数据列表
输出
  • 数据 T — 清理后的数据列表
使用方法:默认三项全开即可一键清洗列表,再按需关掉不需要的清理项。

提取分支

SubTree

按路径索引从数据树中提取子树,空端口 = 通配符,支持路径表达式。

输入
  • 树 T — 输入数据树
  • 索引 A — 第 1 层路径索引
  • 路径 P — 路径表达式,如 {0;?;2}
输出
  • 子树 S — 提取的子树数据
使用方法:路径 P 用 {0;?;2} 表示第 1 层固定 0、第 2 层任意、第 3 层固定 2。

定距等分列表

PartList

按给定大小列表循环等分列表,余项单独输出。

输入
  • 列表 L — 要等分的列表
  • 大小 S — 每份大小列表(如 2,3 循环)
输出
  • 列表 C — 等分后的列表树
  • 余项 R — 剩余项

定数等分列表

DivList

把列表按指定数量等分为若干份。

输入
  • 列表 L — 要等分的列表
  • 数量 N — 等分份数
输出
  • 列表 C — 等分后的列表树
  • 余项 R — 余项

删除首尾项

Trim

从列表开头/结尾删除指定数量的项,三种结果同时输出。

输入
  • 列表 L — 要处理的列表
  • 首数 F / 尾数 E — 删除项数
输出
  • 去首 F / 去尾 E / 去首尾 FE

点组件

04 · POINT

删除重复点

DupPt

按距离公差删除重复点,并输出原始索引分组。

输入
  • 点集 P — 输入点列表
  • 公差 T — 距离公差
输出
  • 点集 Q — 去重后的唯一点列表
  • 索引 I — 每组重复点的原始索引(树形)

曲线组件

05 · CURVE

按长度分析曲线

CrvStats

统计曲线集合的最短、最长、平均长度及总长度,并返回对应索引。

输入
  • 曲线 C — 要分析的曲线集合
输出
  • 最短 MinC / 索引 MinI · 最长 MaxC / 索引 MaxI
  • 平均长度 Avg · 长度总和 Sum

截取曲线头尾

HeadTail

从曲线两端按长度分别截取头段与尾段曲线。

输入
  • 曲线 C — 要截取的曲线
  • 头长 H / 尾长 T — 截取长度
输出
  • 头线 Hc — 起点段
  • 尾线 Tc — 终点段

参考点偏移曲线

B-OffCrv

带参考点和闭合选项的高级曲线偏移——参考点决定偏移方向。

输入
  • 曲线 C / 距离 D / 参考点 P / 平面 Pl
  • 闭合 T — 0 不闭合 / 1 平直 / 2 圆角
输出
  • 曲线 C — 偏移后的曲线

生成闭合轮廓线

SeekPerimeter

从杂乱曲线集合(可含重复、自相交)中找出最外层封闭外轮廓。

输入
  • 曲线 C — 输入曲线集合
  • 平面 P — 投影基准面
输出
  • 外轮廓 R — 最外层封闭外轮廓
使用方法:把互相交错的线丢进去,自动算出外圈边界,常用于从线稿提取轮廓。

曲面组件

06 · SURFACE

曲线分割多重曲面

BrepSplit

用曲线集合把多重曲面分割成多个曲面。

输入
  • 多重曲面 B / 分割线 C / 工作平面 P / 合并共面 M
输出
  • 曲面 S — 分割后的曲面列表

按面积分析曲面

BrepStats

统计曲面集合的最大、最小、平均面积及总和。

输入
  • 曲面 B — 要分析的曲面集合
输出
  • 最大面积 MaxB / 索引 MaxI · 最小面积 MinB / 索引 MinI
  • 平均面积 Avg · 面积总和 Sum

按体积分析实体

VolStats

统计闭合实体集合的最大、最小、平均体积及总和。

输入
  • 实体 S — 要分析的闭合实体集合
输出
  • 最大体积 MaxS / 索引 MaxI · 最小体积 MinS / 索引 MinI
  • 平均体积 Avg · 体积总和 Sum

平面度检查

Flat

检测曲面是否平面,输出平面标志、拟合平面与平面度偏差。

输入
  • 曲面 S — 测试曲面
  • 内部 I — 只在曲面内部测试
输出
  • 标志 F — True=平面
  • 平面 P — 拟合平面
  • 偏差 D — 平面度偏差

优化多重曲面

BrepJoin

合并/优化多重曲面:检测重叠边缘合并,可保持大面、简化弧面。

输入
  • 多重曲面 Brep / 优化容差 tol
  • 保持大面 Large / 简化弧面 Simplify / 简化公差 simpTol
输出
  • 多重曲面 Brep — 优化后的多重曲面
使用方法:导入带碎面/重叠边的多重曲面,保持大面 + 简化弧面通常能得到最干净的合并结果。

展开多重曲面

Unroll

把多重曲面或曲面展开为平面(钣金展开),可选组合碎片。

输入
  • 多重曲面 Brep — 待展开对象
  • 是否组合 Join — 组合碎片
输出
  • 展开后的平面曲面

标注组件

08 · ANNOTATION

文本

Text

在模型空间放置 3D 文字标注,可预览、可烘焙到 Rhino 文档,字体/样式/颜色/对齐全可控。

输入
  • 文字 T / 平面 P / 高度 H / 对齐 A
  • 颜色 C / 字体 F / 样式 S(0 常规 1 粗体 2 斜体 3 粗斜体)
输出
  • 文本 T — 文本实体(可预览、可烘焙)
使用方法:接文字 + 定位平面即可标注;配合「烘焙对象」把文字正式写入 Rhino。

文本 · Excel 组件

11 · TEXT & EXCEL

读取文本

Reader

从文本文件读取内容,编码自动检测,支持预览、行号筛选。

输入
  • 读取数据 Read — 拨 True 读取
  • 文件路径 Path / 文件名称 Name / 行号 Lines
输出
  • 状态 out / 路径 File / 文本 Text

写入文本

Writer

把文本写入文件,编码自动匹配,支持覆盖 / 追加 / 插入开头三种模式。

输入
  • 写入数据 Write / 文件路径 Path / 文件名称 Name
  • 文本 Text — 待写内容
  • 写入模式 Mode — 覆盖写入 / 之后追加 / 之前写入
输出
  • 状态 out / 路径 File

读取 Excel 文件

ExcelRead

读取 .xlsx 为树形数据,支持单文件 / 批量文件夹 / 工作表选择 / 范围限定,带实时预览。

输入
  • 读取数据 Read / 文件路径 Path / 文件名称 Name
  • 工作表 Worksheet / 数据范围 Range
输出
  • 状态 out / 路径 File / 数据 Data(右键切换按列/按行)
读取 Excel 预览

写入 Excel 文件

ExcelWrite

把数据树写入 .xlsx,支持文件选择 / 预览 / 工作表切换 / 路径校验。

输入
  • 写入数据 Write / 文件路径 Path / 文件名称 Name
  • 工作表 Worksheet / 列标题 Headings / 起始位置 Cell
  • 数据 Data(右键切换按列/按行) / 清空表格 Clear
输出
  • 状态 out / 路径 File
写入 Excel 预览

搜索重复字符串

StrDup

查找文本列表中的重复项,输出去重结果、重复索引与重复标记。

输入
  • 列表 L — 文本列表
  • 模式 M — False 唯一项 / True 仅重复项
输出
  • 结果 R / 索引 I / 标记 P

文本查找

StrFind

在文本列表中搜索关键字,输出匹配布尔值与索引。

输入
  • 关键字 K / 列表项 T / 大小写 C
输出
  • 结果 R — 是否含关键字
  • 索引 I — 匹配项索引

实用组件 · 工具

10 · UTILITY & 00 · TOOL

烘焙对象

Bake

把几何对象正式烘焙进 Rhino 文档,支持图层、名称、颜色、自定义用户数据。

输入
  • 烘焙开关 Bake / 几何对象 Objects
  • 图层名称 Layer / 对象名称 ObjName / 对象颜色 ObjColor / 图层颜色 LayerColor
  • 用户值 UserStrings / 用户键 UserKeys
输出
  • 对象 Objects — 输入直通
使用方法:接几何 + 设图层名,拨 True 一键写入 Rhino;用「用户键/值」打自定义标签。

导出对象

Export

把几何对象批量导出为文件(3dm / dwg / stl 等),目录自动创建。

输入
  • 导出开关 Save / 文件目录 Dir / 文件名称 File(含扩展名列表)
  • 几何对象 Objects / 图层名称 Layer / 对象名称 ObjName / 颜色
输出
  • 信息 Path — 成功导出的文件完整路径
使用方法:文件名称传 [a.3dm, b.stl],几何一一对应导出,无需逐个保存。

计时器

Timer

按设定间隔定时触发下游重算,用于定时刷新、动画、周期任务。

使用方法:拖入画布设置周期,输出脉冲信号驱动下游组件周期性重新计算。

解密电池包

Unlock

一键清除当前文档中所有 Grasshopper 原生 Cluster 的密码保护(不支持解密 WB 电池包)。

输入
  • 执行 R — True 清除所有 Cluster 密码
输出
  • 数量 N — 已清除密码的 Cluster 数量

创建时间

Time

输出当前时间字符串,可选择性显示年/月日/时分/秒,支持定时刷新。

输入
  • 年份 Y / 月日 MD / 时分 HM / 秒数 S — 是否显示
  • 频率 F — 刷新间隔(秒)
输出
  • 时间 R — 当前时间字符串

电子野猪

BoarPet

桌面电子宠物「电子野猪」,工作时陪伴解闷的小彩蛋组件。

使用方法:拖入画布即出现在桌面,双击可交互。

画布效率工具

910-925 · CANVAS

命令行(921)

在画布顶部输入组件别名快速调出组件,支持 PGP 自定义别名。输入缩写回车即放置,键盘流操作。

命令行

导线右键菜单(918)

对着导线右键,直接断开 / 加粗 / 换色,导线样式按参数持久化。

导线右键菜单

断开导线(922)

一键断开选中导线,配合右键菜单快速调整连线。

电池导线(902)

给导线应用电池样式与雷达波效果,连线关系一目了然。

导线加粗(914)

一键加粗导线,提升复杂画布可读性。

侧边视窗(923)

在画布侧边嵌入独立视窗,并排查看模型与逻辑。

片段管理(924)

把常用逻辑存成「片段」,拖到画布即展开为原生组件,随时复用不重写。

画布效率(910)

画布书签等效率增强。

启动加速(911)

加速 Grasshopper 启动加载。

搜索增强(912)

组件库搜索能力增强。

预览增强(913)

几何预览显示优化。

工具栏微调(915)

画布工具栏布局微调。

标题自定义(916)

自定义 GH 窗口标题。

悬浮条(917)

画布悬浮工具条显隐管理。

计算器(919)

工具栏内置计算器,随手算数不用切窗口。

系统模块

900-908 · SYSTEM

野猪 GH 管理器(906)

画布工具栏齿轮按钮打开管理器:菜单栏 / 插件栏 / 工具栏三大管理页、「我的」账号页(用户名 / 有效期 / 机器绑定 / 改密码 / 退出登录)、GH 小功能开关。

云授权(907)

账号即授权:登录后自动门控组件拖入与计算,机器绑定可管理,支持挤人、离线宽限(72h)、在线心跳踢出。

在线更新(908)

自动发现新版本,下载经 sha256 + RSA 签名双重校验后安装,安全省心。

抬头显(901)

「电池抬头显示」——在画布/视口显示电池状态悬浮信息。

对齐电池(903)

拖动组件时显示对齐参考线并自动吸附,排布画布更整齐。

遥控器(905)

RCP 遥控器集成,扩展控制能力。

小工具(900)

一组实用小工具合集。

CAD 互通

RELEASED · V1.3.3

CAD 与 GH 互通插件

在 AutoCAD 内嵌 Grasshopper:无需切换软件,在 CAD 环境中直接调用参数化建模能力,实现 CAD 与 GH 双向互通。安装包一键安装,自动检测 AutoCAD 2024 与 Rhino 8,v1.3.3 正式发布。

v1.3.3 更新(2026-09-09):插件在线自动更新——「WBCADCONFIG → 我的」页检查更新 / 立即更新 / 忽略此版本,内嵌下载进度条,签名校验 + 原子替换,重启 CAD 生效;CAD 块组件全链路打通——块引例可直连 GH 移动/旋转等变换组件并烘焙回 CAD,动态属性/块属性端口连线即改、不连线即读,嵌套块实时更新;GH 画布拖动组件快速点按 Alt 即复制;修复反复开关 CAD 崩溃与 CAD 点预览选中变绿问题。

免费下载 · v1.3.3