KSP_project/handover/wiki_vehicle_creation_guide.md

KSP Wiki 载具技术参数提取指南

版本: v1.1 用途: 从 KSP .craft 文件中提取 wiki 页面所需的全部技术参数 目标读者: KSP 技术玩家 & 设定团队成员 前提: 读者已了解 KSP craft 文件格式（PART 块结构、坐标系等）

---

1. 概述

本文档定义了创建 KSP Wiki 载具页面时，可从 craft 文件及游戏内直接获取的技术参数。这些参数构成 wiki 页面 Infobox 和技术规格章节的核心数据。

不在本文档范围内: 设计背景、历史叙事、运营故事、任务时间线、安全记录、命名/代号等需人工设定的内容。

---

2. 通用技术参数（所有载具类型）

2.1 质量参数

#	参数	Craft 文件位置	提取方法	单位
1	干重	每个 PART 块的 mass	所有 part 质量求和（含对称副本）	吨
2	满载质量	PART 的 mass + RESOURCE 的 amount × density	干重 + 所有资源质量	吨
3	推进剂质量	RESOURCE 块	各资源 amount × density 求和	吨

注意:

• symmetry = N 的 part 质量需乘以 N
• 常见资源密度: LiquidFuel = 0.005, Oxidizer = 0.005, MonoPropellant = 0.008（吨/单位）

2.2 尺寸参数

#	参数	Craft 文件位置	提取方法	单位
4	长度	part.position (x, y, z)	Y 轴方向最大值 - 最小值	米
5	宽度	part.position	X 轴方向最大值 - 最小值（考虑对称）	米
6	高度	part.position	Z 轴方向最大值 - 最小值	米

坐标系说明:

• KSP craft 文件使用右手坐标系
• Y 轴 = 垂直方向（通常对应载具长度）
• X 轴 = 横向（对应宽度/翼展）
• Z 轴 = 纵深（对应高度）
• 实际对应关系取决于载具建造方向，提取后需人工校验

重要: 尺寸为包围盒估算值，需与游戏内实际外观对比校验。

2.3 乘员参数

#	参数	Craft 文件位置	提取方法
7	乘员容量	MODULE { name = ModuleCommand } 内的 CrewCapacity	求和所有 command pod

2.4 推进系统

#	参数	Craft 文件位置	提取方法
8	主引擎型号	PART 的 part 字段（如 liquidEngine3）	提取引擎 part 名称列表
9	主引擎数量	PART 块 + symmetry 字段	统计引擎 part 数量（含对称副本）
10	推进剂类型	RESOURCE 块的 name	如 LiquidFuel, Oxidizer, MonoPropellant
11	推进剂储量	RESOURCE 块的 amount	各资源分别列出
12	辅助推进器	PART 名称含 RCS	RCS 型号和数量
13	各级 Δv	—	🔵 使用 MJ/KER 在 VAB 中读取
14	推重比 (TWR)	—	🔵 使用 MJ/KER 读取（区分海平面/真空）

2.5 电力系统

#	参数	Craft 文件位置	提取方法
15	太阳能板	MODULE { name = ModuleDeployableSolarPanel } 或固定太阳能板 part	型号和数量
16	核发电机	MODULE { name = ModuleGenerator } 或 ModuleRadioisotopeGenerator	型号和数量
17	蓄电池	含电荷资源 (ElectricCharge) 的 part	型号和容量

2.6 结构配置

#	参数	Craft 文件位置	提取方法
18	分级配置	Staging 信息 + 分离装置 part	各级包含的引擎和分离装置
19	外挂/助推器	PART 的 symmetry 字段和子节点树	通过对称性和 parent 链识别
20	着陆装置	PART 名称含 LandingGear 或 LandingLeg	型号和数量
21	对接口	PART 名称含 dockingPort	型号和数量
22	货舱	PART 名称含 CargoBay	型号和尺寸
23	整体布局	Part 树结构	🟢 拓扑可提取 → 🔵 需人工描述

---

3. 载具类型专项参数

3.1 航天飞机 (Space Shuttle)

#	参数	来源	提取方法
S1	翼面部件	🟢 Craft	含 ModuleControlSurface 或 ModuleLiftingSurface 的 part
S2	热防护	🟢 Craft	HeatShield part 名称和 ablator 储量
S3	逃逸系统	🟢 Craft	LaunchEscapeSystem part
S4	着陆方式	🟢 Craft	有起落架 = 跑道着陆；无 = 水溅落/其他

3.2 母舰 (Mothership)

#	参数	来源	提取方法
M1	环形结构	🟢 Craft	旋转部件 (Gravitron/Centrifuge) part 和半径
M2	搭载子载具	🟢 Craft	子节点树中的独立载具 part 群组
M3	对接口配置	🟢 Craft	各对接口类型和位置

3.3 空间站 (Space Station)

#	参数	来源	提取方法
ST1	模块数量	🟢 Craft	独立 part 群组（通过分离节点划分）
ST2	对接口总数	🟢 Craft	DockingPort part 数量

3.4 基地 (Base)

#	参数	来源	提取方法
B1	模块数量	🟢 Craft	独立 part 群组
B2	移动能力	🟢 Craft	是否有轮毂/履带 part

---

4. Craft 文件提取速查

4.1 关键字段映射表

需要的参数	Craft 文件字段	处理方式
干重	PART.mass	求和（× symmetry）
满载质量	PART.mass + RESOURCE.amount × density	求和
尺寸	PART.position (x, y, z)	包围盒极值差
乘员容量	CrewCapacity (在 ModuleCommand 内)	求和
引擎型号	PART.part (含 Engine 的 part 名)	去重列表
引擎数量	PART 计数 × symmetry	求和
推进剂类型	RESOURCE.name	去重列表
推进剂储量	RESOURCE.amount	按类型分别列出
太阳能板	Part 名含 SolarPanel	计数
对接口	Part 名含 dockingPort	计数
着陆装置	Part 名含 LandingGear/LandingLeg	计数
RCS	Part 名含 RCS	计数
分级	Staging 数据 + 分离装置 part	分析各级组成

4.2 注意事项

1. 对称性: symmetry = N 表示 N 个副本（含自身），质量/数量计算需乘以 N
2. 单位: 质量 = 吨，距离 = 米
3. 子节点: Part 通过 parent 字段形成树状结构，分析拓扑需遍历整棵树
4. Mod 部件: 非原版 part 名称需对照 mod 文档识别
5. 尺寸估算: 包围盒可能与实际外观有偏差，提取后务必与游戏内截图对比

4.3 推荐工具

工具	用途
KSP VAB/SPH	游戏内直接查看载具参数
MechJeb (MJ)	读取 Δv、TWR、各级参数
Kerbal Engineer Redux (KER)	实时飞行数据和 VAB 数据
自定义脚本	Python/Node 脚本批量解析 craft 文件

---

5. 参数完整性检查清单

提取完成后，确认以下参数已齐全。缺少的项目需标注"未提取"。

所有载具类型

• 干重 (吨)
• 满载质量 (吨)
• 长度 (米)
• 宽度/翼展 (米)
• 高度 (米)
• 乘员容量
• 主引擎型号 & 数量
• 推进剂类型 & 储量
• 各级 Δv（MJ/KER 读取值）
• 推重比 TWR（MJ/KER 读取值）
• 发电装置类型
• 着陆装置: 有/无
• 对接口数量

按类型补充

航天飞机:

• 翼面部件
• 热防护 part
• 逃逸系统: 有/无

母舰:

• 旋转结构: 有/无
• 搭载子载具识别
• 对接口配置

空间站:

• 模块划分
• 对接口总数

基地:

• 模块划分
• 移动能力: 有/无

---

附录 A: 参数采集表模板

复制此模板，逐项填写从 craft 文件中提取的参数。

# [载具英文名称] 技术参数采集表

## 基本信息
- Craft 文件名:
- Craft 文件路径:
- 使用的 Mod (若有):

## 质量
- 干重 (吨):
- 推进剂质量 (吨):
- 满载质量 (吨):

## 尺寸 (估算值，需游戏内校验)
- 长度 (米):
- 宽度 (米):
- 高度 (米):

## 乘员
- 乘员容量:

## 推进系统
- 主引擎型号:
- 主引擎数量:
- 推进剂类型:
- 推进剂储量:
- 各级 Δv (MJ/KER):
  - 第一级:
  - 第二级:
  - ...
- 推重比 TWR (真空):
- RCS 型号:
- RCS 数量:

## 电力系统
- 太阳能板: 型号 × 数量
- 核发电机: 型号 × 数量
- 蓄电池: 型号 × 数量

## 结构配置
- 分级数:
- 助推器: 有/无，数量:
- 着陆装置: 有/无，型号:
- 对接口: 数量
- 货舱: 有/无

## 航天飞机专项
- 翼面部件:
- 热防护 part:
- 逃逸系统: 有/无

## 母舰专项
- 旋转结构: 有/无
- 搭载子载具:

---

附录 B: 已有 Wiki 页面技术参数参考

以下已有页面可作为参数填写格式的参考（查看其 Infobox 中的技术参数部分）：

载具	文件	参考价值
Vulture Shuttle	data/wiki/vulture_shuttle_zh.html	航天飞机 Infobox 完整范例
Echo Shuttle	data/wiki/echo_shuttle_zh.html	轻型航天飞机参数格式
Enterprise Shuttle	data/wiki/enterprise_shuttle_zh.html	中型航天飞机参数格式
Xihe-class	data/wiki/xihe_mothership_zh.html	母舰级别 Infobox 范例
XH-01 Xihe	data/wiki/xh01_xihe_zh.html	单舰 Infobox 范例
ST-01 Wanxingyuan	data/wiki/st01_wanxingyuan_zh.html	复杂母舰参数范例