Hello KSP Launcher

仓库地址

一个现代化的轻量级 Kerbal Space Program 启动器 —— 管理游戏实例、调整游戏设置、浏览存档、打包整合包，一切尽在简洁的半透明界面中。

功能特色

• 实例管理 — 轻松添加、重命名、删除和切换多个 KSP 游戏实例。
• Steam 发现 — 启动时自动扫描 Steam 库（通过 Windows 注册表 + libraryfolders.vdf），找到 KSP 安装并自动加入实例列表（按检测到的版本命名，按路径去重）。
• 一键启动 — 立即启动所选 KSP 实例。支持启动后行为：保持打开、最小化到任务栏或自动关闭启动器。
• 游戏设置编辑 — 以树形视图浏览和编辑 KSP 的 settings.cfg 配置。布尔值使用平滑动画开关控件，修改后一键保存。
• 模组与 DLC 检测 — 自动检测已安装的 DLC 和 GameData 目录下的第三方模组。
• 模组管理（CKAN） — 从 CKAN 仓库安装、升级、卸载模组，自动解析依赖（Depends/Recommends/Suggests），根据实际游戏版本做严格兼容性检查，并对每次下载做 SHA256 完整性校验。
• 并行下载 — 模组并发下载（并发数可配，最高 8），统一进度显示与取消按钮。
• 模组建议 — 安装过程中弹窗显示可选建议模组（源自 "suggests" 字段），勾选后连同其依赖自动解析安装；可在设置中关闭。
• 灵活的下载源与缓存 — 官方/镜像下载源可切换，索引刷新间隔可配置，支持下载缓存文件夹管理（精确清理与缓存迁移）。
• 原子事务 — 安装、卸载、升级以原子事务执行，失败或取消时自动回滚，不残留任何文件，并还原注册表到操作前状态。
• 存档管理 — 查看实例的所有存档，浏览存档元数据（模式、版本、是否含模组等），并支持编辑 Kerbal 属性（名称、职业、勇敢度、愚蠢度、坏蛋/老兵/英雄标志），布尔值使用开关控件。
• 备份管理 — 创建、浏览和删除存档备份，支持进度条显示。
• 整合包导出 / 导入 — 将 GameData 目录打包为 ZIP 或导出为 CKAN 元包；也可从 ZIP（替换模组，保留 Squad/SquadExpansion）或 .ckan 文件（跳转到模组管理界面经依赖解析下载安装）导入整合包。
• 自定义背景 — 选择任意 PNG/JPG 图片作为启动器背景，Cover 模式缩放填充，一键恢复默认。
• 主题支持 — 深色和浅色主题，半透明 UI 搭配自动图标色调适配。
• 启动参数 — 为每个实例配置自定义命令行参数（如 -force-d3d11 -popupwindow）。
• 仅支持 Windows — 基于 Qt 6 和 CMake 构建，面向 Windows（x64）平台。

系统要求

• Windows（x64）
• Qt 6（Core, Widgets, Svg, Concurrent）
• CMake ≥ 3.16
• C++17 编译器
• mingw（Windows 工具链）

构建依赖

本项目使用 miniz（已内置于 thirdparty/）处理 ZIP 操作。

构建

git clone <repo-url>
cd HelloKSPLauncher
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build .

Windows 提示： 请使用 Qt 自带的 mingw（如 E:\Qt\Tools\mingw1310_64\bin），而非独立的 mingw 安装。

编译产物位于 dist/ 目录。

使用说明

1. 启动程序。
2. 点击侧边栏的「实例管理」，然后点击「添加实例」并选择 KSP 可执行文件。
3. 选择一个实例，点击「启动游戏」即可开始游玩。
4. 使用侧边栏在首页、实例管理、实例列表和设置之间导航。

配置文件

设置以 JSON 格式持久化在 HKSPL.json 中（与可执行文件同级），包括：

• 当前实例
• 主题（深色/浅色）
• 语言（zh_CN / en_US）
• 启动后行为（保持打开 / 最小化 / 关闭）
• 背景图片路径
• 模组索引刷新间隔与下载源（官方 / 镜像）
• 下载并发数（1–8）
• 安装时是否显示建议模组
• 下载缓存文件夹

项目结构

HelloKSPLauncher/
├── CMakeLists.txt
├── LICENSE
├── README.md
├── resources/
│   ├── backgrounds/       # 默认背景图片
│   ├── icons/             # SVG 图标
│   ├── themes/            # QSS 主题文件 (dark.qss, light.qss)
│   └── resources.qrc
├── src/
│   ├── main.cpp
│   ├── mainwindow.cpp/h
│   ├── backgroundmanager.cpp/h
│   ├── configmanager.cpp/h
│   ├── iconutils.cpp/h
│   ├── instancemanager.cpp/h
│   ├── pages/             # UI 页面（首页、实例、设置、存档等）
│   └── widgets/           # 自定义控件（开关、实例列表项）
├── thirdparty/
│   └── miniz.c/h          # ZIP 库
└── README/                # 更新日志（中文）

许可证

Copyright (C) 2026 Zhu Wenqian. 基于 GNU General Public License v3.0 发布。详见 LICENSE。