Hops 把一个外部 Grasshopper 定义变成当前画布上的“函数组件”。这个外部定义可以保存在本地、网络路径、远程服务器，也可以是 REST 端点。

在教学中可以把 Hops 理解成：

外部 .gh 文件 = 函数定义
Context Get = 函数输入
Context Print / Context Bake = 函数输出
Hops 组件 = 函数调用
RhinoCompute = 执行函数的服务器

• 拆分大型 Grasshopper 画布，降低复杂度。
• 把重复逻辑封装为可复用定义。
• 团队共享同一组参数化函数。
• 把耗时求解交给远程服务器。
• 支持异步和并行求解，减少主画布阻塞。

在 Rhino 命令行输入：

PackageManager

搜索 Hops 并安装。安装后，在 Grasshopper 的 Params > Util 中可找到 Hops 相关组件。

一个可被 Hops 调用的 Grasshopper 定义通常分三段：

1. 输入定义区：使用 Context Get 组件，例如 Get Number、Get String、Get Curve。
2. 计算逻辑区：普通 Grasshopper 组件、脚本组件、插件组件。
3. 输出定义区：使用 Context Print 或 Context Bake。

命名规则很关键：

• Context Get 组件的名称会变成 Hops 输入参数名。
• Context Print/Bake 的输入参数名会变成 Hops 输出参数名。
• 命名应稳定、简短、语义明确，例如 width、height、floor_count。

目标：输入半径，输出圆面积。

1. 新建 Grasshopper 定义。
2. 放置 Get Number，命名为 radius。
3. 用圆或表达式计算面积。
4. 放置 Context Print，输入命名为 area。
5. 保存为 circle_area.gh。
6. 在另一个 Grasshopper 文件中放置 Hops 组件。
7. 右键 Hops，选择 Path，指向 circle_area.gh。
8. Hops 组件会自动生成 radius 输入和 area 输出。

在 Grasshopper 中打开：

File -> Preferences -> Solver

配置：

右键 Hops 组件可看到常用选项：

适合：

• 输入输出清晰。
• 计算过程无人工交互。
• 不依赖当前 Rhino 文档选择集。
• 文件路径和外部资源可配置。
• 插件依赖能在服务端安装和授权。

不适合：

• 依赖鼠标选择、弹窗、视口状态。
• 依赖本机临时路径或用户桌面文件。
• 使用只能在有界面 Rhino 中运行的插件。
• 输出过大且每次都完整传回客户端。

• 把大定义拆成多个稳定函数，而不是把整个项目一次性丢给 Hops。
• 对频繁调用的纯函数开启缓存。
• 对耗时定义使用异步，但要控制最大并发。
• 远程部署时，子进程数量不要简单等于 CPU 核心数，还要考虑 Rhino/Grasshopper 插件的内存占用。
• 第一次求解可能较慢，因为 Rhino、Grasshopper、脚本环境或插件需要初始化。

练习 1：把“输入长宽高，输出盒子体积和 Brep”的定义封装成 Hops 函数。

练习 2：把同一 Hops 函数分别指向本地 Compute 和远程 Compute，比较第一次求解和第二次求解耗时。

练习 3：关闭 API Key 或输入错误 API Key，观察 Hops 组件和 Compute 日志中的错误表现。

• 你是否能说明 Context Get 和 Context Print/Bake 的作用？
• 你是否能配置 Hops 指向远程 Compute URL？
• 你是否知道 Hops API Key 要和服务器 RHINO_COMPUTE_KEY 一致？

• What is Hops
• The Hops Component
• Deployment to Production Servers