# 野猪CAD 安装程序 - 使用说明

## 使用方法

1. **完全关闭 AutoCAD 和 Rhino**（安装器会强制检查：CAD 未关闭将拒绝安装）
2. **双击 WbCadInstaller.exe** 运行安装程序
3. 自动检测本机环境（**仅支持 AutoCAD 2024 + Rhino 8**）
4. 勾选 AutoCAD 2024
5. 点击「一键安装」按钮
6. 重启 AutoCAD 2024，输入命令 `WBGH` 启动（官方命令 `GRASSHOPPER` / `RHINO` 同样可用）

安装位置：`%APPDATA%\Autodesk\ApplicationPlugins\Rhino.Inside.AutoCAD.bundle\`
（安装器会自动移除旧的 `WbCad.bundle`，无需手工清理）

> **升级说明**：安装器采用"整体切换"机制——新版本全部就绪后才替换旧版本，
> 中途失败不会影响现有安装。若旧版本曾安装中断导致启动报错
> （如 `致命错误: Unhandled e0434352h`），关闭 CAD 后用本安装器重装一次即可修复。

## 手动选择路径

如果自动检测未找到，点击「选择目录...」按钮：
- **AutoCAD**：选择包含 `acad.exe` 的目录
- **Rhino 8**：选择 Rhino 8 安装根目录（包含 `System\RhinoCommon.dll`）


## 日志与故障排查

### 日志位置

| 日志 | 路径 | 内容 |
|---|---|---|
| **主诊断日志** | `%APPDATA%\Grasshopper\WildBoar\pick-debug.log` | 插件初始化 / WBGH 命令 / Rhino 启动 / GH 组件加载全流程 |
| 安装器日志 | 安装程序窗口内实时显示 | 环境检测 / 部署过程 |
| Windows 事件查看器 | `eventvwr.msc` → Windows 日志 → 应用程序 | .NET 程序集加载失败等系统级错误 |

### 常见问题与排查

| 现象 | 排查步骤 |
|---|---|
| **WBGH 提示未知命令** | ① 确认 `%APPDATA%\Autodesk\ApplicationPlugins\Rhino.Inside.AutoCAD.bundle\` 存在且含 `PackageContents.xml`；② 重启 CAD（插件按命令加载，首次需重启）；③ 查看 pick-debug.log |
| **WBGH 启动 GH 报错/红屏** | ① 确认 Rhino 8 已安装且能独立运行；② 查看 pick-debug.log 最后 30 行；③ 确认没有与其他 Rhino.Inside 变体混装 |
| **GH 打开了但组件面板没有野猪组件** | 查看 pick-debug.log 是否有组件库加载异常；确认 Rhino 安装完整（GH 自带组件能正常显示） |
| **弹出 GhPython 版本警告** | 点"关闭"即可，不影响野猪组件（GH 组件与 SDK 版本差异的兼容提示） |

### 反馈问题时的信息收集

请随问题提供：
1. **日志文件**：`%APPDATA%\Grasshopper\WildBoar\pick-debug.log`（最新 50 行即可）
2. **环境信息**：AutoCAD 版本、Rhino 8 版本（Rhino 里 `Help → About`）
3. **复现步骤**：什么时候出现（启动/命令/操作），报错截图
