本章讲如何在 Windows 开发机上运行 RhinoCompute，并确认服务是否可用。生产部署请看 06 Windows/IIS 生产部署。

• Rhino 已安装并能正常启动。
• Rhino 已完成授权或已登录 Cloud Zoo。
• Compute 源码分支与 Rhino 主版本一致。
• Visual Studio 2022 已安装必要的 .NET 桌面开发组件。
• 没有旧的 rhino.compute.exe 或 compute.geometry.exe 占用端口。

1. 打开源码目录下的解决方案文件。
2. 设置配置为 Debug。
3. 编译解决方案。
4. 将 rhino.compute 设置为启动项目。
5. 启动调试。
6. 等待控制台完成 Rhino、Grasshopper、插件加载。

官方本地调试指南建议访问以下端点确认服务：

http://localhost:6500/version
http://localhost:6500/healthcheck
http://localhost:6500/activechildren
http://localhost:6500/sdk

如果 /sdk 能打开，说明 Compute 已经列出可调用的 SDK 方法和扩展端点。

rhino.compute 支持多个命令行参数。常用项如下：

示例：

.\rhino.compute.exe --port 6500 --childcount 2 --spawn-on-startup --apikey local-dev-key

compute.geometry 是实际加载 Rhino.Inside 的进程。直接调试它可以帮助定位几何端点、Grasshopper 求解、插件加载问题。

常见启动参数：

.\compute.geometry.exe --port:8081 --apikey:local-dev-key

注意：在完整服务链中，通常由 rhino.compute 负责启动和管理多个 compute.geometry 子进程。直接启动 compute.geometry 更适合低层调试。

如果服务配置了 API Key，POST 请求必须携带 header：

RhinoComputeKey: local-dev-key

PowerShell 测试示例：

$headers = @{ RhinoComputeKey = 'local-dev-key' }
Invoke-WebRequest -Uri 'http://localhost:6500/healthcheck' -UseBasicParsing

/healthcheck 是 GET，一般不验证 API Key。真正验证 POST 时，应调用一个需要 POST 的几何或 Grasshopper 端点。

本地调试时优先看控制台输出。部署或后台运行时查看日志目录。

如果需要详细日志：

[System.Environment]::SetEnvironmentVariable('RHINO_COMPUTE_DEBUG', 'true', 'Machine')

然后重启 Compute。

日志中要重点观察：

• Rhino 版本和 Compute 版本。
• RhinoCore 是否成功启动。
• Grasshopper 是否加载。
• 第三方插件是否加载。
• 子进程端口和数量。
• 请求路径、HTTP 状态码、异常堆栈。

• 先用 /version 和 /healthcheck 确认服务活着，再测业务端点。
• 先在本机无 API Key 跑通最小调用，再加 API Key。
• 如果涉及 Grasshopper，先在 Rhino/Grasshopper 图形界面内打开定义，确认本地求解无错。
• 如果涉及第三方插件，先确认插件能在普通 Rhino 中加载，再确认无界面 Compute 中加载。
• 不要一开始就把 IIS、HTTPS、反向代理、业务系统全部接上；先让 Compute 自身可观测。

• /version 是否能打开？
• /healthcheck 是否返回健康？
• /activechildren 是否能看到子进程状态？
• 配置 API Key 后，错误 key 是否能稳定返回 401？

• Running and Debugging Compute Locally
• Compute FAQ