空间船生成器(SpaceshipGenerator)使用手册

---

一、项目目录结构及介绍

项目根目录下包含了以下几个核心部分：

• README.md: 项目的主要说明文件，介绍了如何安装、使用此脚本以及项目的背景信息。
• LICENSE: 许可证文件，声明该项目遵循MIT协议。
• __init__.py: Python初始化文件，定义了脚本的基本导入路径。
• build.py: 构建脚本，用于项目相关的自动化任务（可能包括打包等）。
• spaceship_generator.py: 主要的Python脚本，实现了空间船的程序化生成逻辑。
• gitignore: 忽略列表，指定了Git在版本控制中应忽略哪些文件或目录。
• screenshots 和 textures 目录：分别存放项目截图和纹理图片，其中纹理图片用于空间船的细节渲染。

每个模块都有其特定用途，其中spaceship_generator.py是实现功能的核心，而其他文件则支持项目的管理和视觉展示。

---

二、项目的启动文件介绍

主要的启动操作并不通过直接运行某个文件来完成，而是集成在Blender软件内部作为插件使用。具体步骤如下：

1. 首先，确保安装有Blender 2.80或更高版本。
2. 下载项目中的最新“add_mesh_SpaceshipGenerator.zip”文件，这通常位于项目的“Releases”部分。
3. 在Blender中，进入“编辑 > 首选项...”(Edit > Preferences...)。
4. 转到“添加 ons”标签页，在那里点击“安装”，并从下载的ZIP文件中选择它。
5. 找到并启用名为“Add Mesh: Spaceship Generator”的插件（可以通过搜索“spaceship”找到）。
6. 关闭偏好设置，即可在Blender的界面上使用该插件创建空间船。

实际的“启动”即是通过Blender的界面进行，而非传统意义上执行一个独立的脚本文件。

---

三、项目的配置文件介绍

本项目并没有传统意义上的外部配置文件。所有的配置和调整都是通过Blender界面内直接操作完成的。当添加空间船时，一个“Spaceship”选项卡会在视口底部出现，允许用户自定义生成过程中的参数，比如 hull segments（船体段数）、asymmetry segments（不对称度）和其他细节选项。这些设置动态地影响生成的空间船形状和细节，形成不同的设计。

若要定制化初始化设置或默认行为，修改spaceship_generator.py内的相关函数参数是可行的方式。例如，可以调整generate_spaceship()函数的参数或功能，甚至可以提供种子值以重复生成相同的模型，这样的定制不依赖于分离的配置文件，而是嵌入代码之中。