# fixed_wing_shape_detail_runbook

> 执行固定翼外形详细设计的产物生成（翼型/机身剖面/三视图HTML/创成式搜索/OpenVSP脚本）。用户要一键产出外形资产并验证时调用。

- Author: BaiSongtao
- Repository: BaiSongt/aircraft-design-skill
- Version: 20260205230839
- Stars: 3
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/BaiSongt/aircraft-design-skill
- Web: https://mule.run/skillshub/@@BaiSongt/aircraft-design-skill~fixed_wing_shape_detail_runbook:20260205230839

---

---
name: "fixed_wing_shape_detail_runbook"
description: "执行固定翼外形详细设计的产物生成（翼型/机身剖面/三视图HTML/创成式搜索/OpenVSP脚本）。用户要一键产出外形资产并验证时调用。"
---

# 固定翼外形详细设计（Runbook）

## 目标

- 从单一输入 JSON 出发，生成可复用外形资产与可视化
- 支持创成式外形搜索（候选集 + 每个候选的三视图预览）
- 支持 OpenVSP 脚本导出（可选在 OpenVSP Python 环境执行）

## 一键运行

### 1) 生成总体结果 + 三视图预览

```powershell
python .\scripts\run_fixed_wing_design.py .\examples\fixed_wing_ga_single.json
```

产物（`out/`）：

- `geometry_3d.html`：三视图预览
- `geometry.obj`：OBJ 资产
- `geometry_mesh.json`：网格 JSON

### 2) 生成 OpenVSP 脚本

```powershell
python .\scripts\generate_openvsp_script.py .\examples\fixed_wing_ga_single.json --out .\out\openvsp_generate.py
```

如在 OpenVSP 的 Python 环境中，可加 `--run` 直接生成 `generated.vsp3`。

### 3) 创成式外形搜索（候选集）

```powershell
python .\scripts\shape_search.py .\examples\fixed_wing_ga_single.json --n 32 --seed 1
```

产物（`out/`）：

- `shape_search_report.md`：Top 候选表格（含 3D 链接）
- `shape_search_results.json`：全部候选与可行集
- `shapes/shape_*.html`：每个候选的三视图预览

## 验证

```powershell
python -m unittest discover -s tests
```