DoL-Lyra整合包构建系统：新手也能快速上手的自动化游戏打包指南

DoL-Lyra整合包构建系统：新手也能快速上手的自动化游戏打包指南

【免费下载链接】DOL-CHS-MODSDegrees of Lewdity 整合项目地址: https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS

你是否曾为Degrees of Lewdity游戏的各种MOD组合感到头疼？手动下载、解压、配置、打包，整个过程繁琐且容易出错。DoL-Lyra构建系统v2.0正是为解决这一问题而生的自动化工具，它让复杂的MOD整合变得简单高效，即使是新手也能轻松上手。

🚀 特性展示：为什么选择DoL-Lyra构建系统？

一键式自动化流程

DoL-Lyra构建系统采用四阶段CI/CD流程，将复杂的MOD打包过程简化为几个简单命令。你不再需要手动下载游戏文件、寻找MOD资源、处理兼容性问题。系统自动完成从资源准备到最终打包的全过程。

智能MOD组合管理

通过配置文件驱动的组合管理，系统支持13种不同的MOD自由组合，包括BESC美化、作弊功能、CSD显示、多种特写效果等。所有组合规则通过TOML配置文件管理，无需修改代码即可调整组合。

双平台支持与并行构建

系统同时支持ZIP（PC/Web）和APK（Android）两种平台打包，并通过多进程并行构建技术实现2-6倍的性能提升。无论你是为个人使用还是为社区分发，都能高效完成构建任务。

📋 实践指南：快速上手DoL-Lyra构建系统

环境准备与安装

首先，你需要准备好基础环境。系统要求Python 3.8+和Java 17+（APK构建需要）。安装过程非常简单：

# 克隆仓库 git clone https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS cd DOL-CHS-MODS # 安装Python依赖 pip install -r requirements.txt # 验证Java环境 java -version

核心配置文件说明

系统的主要配置文件位于config/目录下：

• config/build.toml- 构建过程配置，包含资源下载地址和路径设置
• config/features.toml- MOD功能定义，描述每个MOD的位标志和显示名称
• config/combinations.toml- MOD组合规则，定义推荐组合和互斥关系

完整构建流程示例

下面是一个典型的完整构建流程：

# 1. 准备游戏资源（下载游戏文件、额外MOD、生成基包） python main.py prepare --tag v0.5.7.9-5.0.2a-0112 # 2. 预热美化资源（下载并解压所有DoL+图包、AU变体） python main.py warmup # 3. 并行构建所有组合（使用8个进程） python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs 8 # 4. 生成下载页面 python main.py page --tag v0.5.7.9-5.0.2a-0112 -o index.md

这个流程将生成50+个不同的MOD组合包，包括ZIP和APK格式，满足不同用户的需求。

🔧 技巧分享：高级用法与故障排除

自定义MOD组合

如果你想创建自己的MOD组合，只需编辑config/combinations.toml文件。例如，要添加一个新的推荐组合：

[rules] # 推荐组合（优先显示） recommended = [3, 35, 259, 291, 1058, 2082, 4130, 1059] # 新增1059 # 必须包含的MOD must_include = [2] # 作弊 # 互斥组（不能同时启用） [[rules.exclusive_groups]] mods = [1024, 2048, 4096] # AU三个变体互斥 reason = "AU变体互斥"

资源预热机制的优势

系统采用资源预热机制解决并行构建时的资源冲突问题。在warmup阶段，所有美化资源（DoL+图包、AU变体）会被提前下载并解压到固定位置。在构建阶段，各个工作进程直接复制这些预热的资源，避免了多个进程同时下载同一资源导致的文件损坏。

并发构建优化建议

根据你的硬件配置，合理设置并发进程数可以获得最佳性能：

• 4GB内存，4核CPU：建议使用-j 2（保守配置）
• 8GB内存，8核CPU：建议使用-j 4-6（标准配置）
• 16GB内存，16核CPU：建议使用-j 8-12（高性能配置）
• 32GB+内存，32核+CPU：可以使用-j 16+（服务器配置）

常见问题解决

Q: 构建过程中出现下载失败怎么办？A: 检查网络连接，或者修改config/build.toml中的资源URL为镜像地址。系统支持使用代理加速，例如：

dolp_base = "https://ghproxy.com/https://gitgud.io/Frostberg/degrees-of-lewdity-plus/-/archive/master/degrees-of-lewdity-plus-master.tar.gz"

Q: APK构建失败怎么办？A: 首先确认Java版本是否为17+，然后检查APK反编译工具是否正确下载。系统会自动下载apktool.jar和uber-apk-signer.jar，如果下载失败可以手动放置到工作目录。

Q: 如何添加新的MOD？A: 需要三个步骤：

1. 在config/features.toml中添加MOD定义
2. 在config/combinations.toml中设置组合规则
3. 在代码中实现对应的构建逻辑

版本管理与追溯

系统通过VersionRegistry记录所有组件的版本信息，便于问题追溯和调试。每次构建都会生成versions.json文件，包含汉化仓库版本、DoL+提交哈希、AU变体标签等信息。这在排查兼容性问题时非常有用。

🎯 高级应用：定制化构建与社区分发

修改APK包名和版本

如果你需要为不同渠道分发不同的APK版本，可以轻松修改包名和版本显示：

[[apk.replacements]] file = "AndroidManifest.xml" pattern = '"com.vrelnir.dol"' replacement = '"com.yourname.dol"' # 自定义包名 [[apk.replacements]] file = "apktool.yml" pattern = 'versionName: .*' replacement = 'versionName: "Lyra {version}"' # 自定义版本格式

生成GitHub Actions构建矩阵

系统支持生成GitHub Actions构建矩阵JSON，便于在CI/CD流水线中自动化构建：

python main.py matrix

这将输出适用于GitHub Actions的矩阵配置，支持按MOD代码和包类型进行并行构建。

检查汉化仓库更新

定期检查汉化仓库是否有新版本发布：

python main.py check

命令返回退出码0表示有新版本，1表示已是最新版本。你可以将此命令集成到自动化脚本中，实现自动更新检测。

📊 MOD代码系统详解

DoL-Lyra使用位标志系统管理MOD组合，每个MOD对应一个2的幂次方的位值：

MOD代码通过位运算计算，例如：

• BESC + 作弊：1 | 2 = 3
• BESC + 作弊 + Hikari：1 | 2 | 32 = 35
• 作弊 + Hikari + AU女性：2 | 32 | 1024 = 1058

💡 最佳实践建议

开发与测试流程

对于开发者，建议使用以下流程：

# 1. 安装依赖 pip install -r requirements.txt # 2. 准备环境（一次性） python main.py prepare --tag v0.5.7.9-5.0.2a-0112 python main.py warmup # 3. 构建特定组合进行测试 python main.py build zip --tag v0.5.7.9-5.0.2a-0112 # 仅ZIP python main.py build apk --tag v0.5.7.9-5.0.2a-0112 # 仅APK

目录结构管理

系统自动创建以下目录结构，建议了解每个目录的作用：

项目根目录/ ├── main.py # 统一命令行入口 ├── lyra/ # 核心模块 ├── config/ # 配置文件 ├── workspace/ # 工作目录（自动创建） │ ├── base/ # 基包存放目录 │ ├── prepare_package/ # 预处理目录 │ ├── extract/ # 构建临时目录 │ ├── dolp/ # DoL+图包缓存 │ ├── au/ # AU变体缓存 │ ├── temp/ # 临时文件 │ └── versions.json # 版本信息 └── output/ # 最终输出目录

性能优化技巧

1. 使用SSD存储：构建过程涉及大量文件操作，SSD能显著提升性能
2. 合理设置并发数：根据CPU核心数和内存大小调整-j参数
3. 复用预热资源：同一版本的多次构建可以复用warmup阶段的资源
4. 清理旧版本：定期清理workspace目录中的旧版本文件，释放磁盘空间

🎉 开始你的DoL-Lyra构建之旅

DoL-Lyra构建系统将复杂的MOD打包过程变得简单高效。无论你是个人玩家想要定制自己的游戏版本，还是社区维护者需要为大量用户提供多种MOD组合，这个系统都能满足你的需求。

通过本文的指导，你已经掌握了从基础安装到高级定制的完整知识。现在就开始使用DoL-Lyra构建系统，体验自动化MOD打包的便利吧！记住，系统的核心优势在于其灵活性和可配置性，你可以根据自己的需求调整任何部分。

如果在使用过程中遇到问题，可以参考项目中的BUILD.md文档获取更详细的技术说明，或者查看config/examples/目录中的配置文件示例。祝你构建顺利！

【免费下载链接】DOL-CHS-MODSDegrees of Lewdity 整合项目地址: https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS