DoL-Lyra 构建系统完整指南：自动化游戏美化整合方案

DoL-Lyra 构建系统完整指南：自动化游戏美化整合方案

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

想要为 Degrees of Lewdity 游戏打造个性化的美化体验，但面对复杂的 MOD 组合和手动配置感到困惑？DoL-Lyra 构建系统为你提供了一站式解决方案。这个开源自动化构建工具能够快速生成数十种不同的美化组合包，无论是 PC 版还是 Android 版，都能轻松应对。

项目概览：游戏美化整合的革命性工具

DoL-Lyra 是一个专为 Degrees of Lewdity 游戏设计的自动化构建系统。它通过智能化的配置管理和并行构建技术，将原本复杂的手动 MOD 整合过程简化为几个简单的命令。无论你是想要 BESC 社区精灵合集、Hikari 特写、UCB 战斗美化，还是 AU 身体变体，都能通过这个系统快速生成对应的整合包。

核心价值定位：告别繁琐的手动配置，享受一键式游戏美化体验。DoL-Lyra 不仅节省了用户的大量时间，还确保了各种美化 MOD 之间的兼容性和稳定性。

快速入门：五分钟完成首次构建

环境准备与安装

在开始之前，确保你的系统满足以下基本要求：

安装步骤：

# 1. 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS cd DOL-CHS-MODS # 2. 安装 Python 依赖 pip install -r requirements.txt # 3. 验证安装 python main.py --help

四步构建流程

DoL-Lyra 采用四阶段构建流程，确保每个步骤都清晰可控：

1. 资源准备阶段：下载游戏本体和基础 MOD
2. 美化预热阶段：提前获取所有美化资源
3. 并行构建阶段：生成各种 MOD 组合
4. 页面生成阶段：创建下载页面

完整构建示例：

# 1. 准备游戏资源 python main.py prepare --tag v0.5.7.9-5.0.2a-0112 # 2. 预热美化资源 python main.py warmup # 3. 并行构建所有组合 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 download.md

核心功能深度解析

智能配置管理系统

DoL-Lyra 的核心优势在于其灵活的配置系统。所有 MOD 组合都通过配置文件定义，无需修改代码即可调整构建选项。

配置文件结构：

config/ ├── build.toml # 构建过程配置 ├── features.toml # MOD 功能定义 └── combinations.toml # MOD 组合规则

MOD 代码系统：每个美化功能都有一个唯一的位标志值，通过位运算组合实现灵活的 MOD 选择：

组合计算示例：

# BESC + 作弊 + Hikari 特写 code = 1 | 2 | 32 = 35 # 作弊 + Hikari + AU 女性变体 code = 2 | 32 | 1024 = 1058

并行构建优化技术

DoL-Lyra v2.0 采用了先进的并行构建技术，大幅提升了构建效率：

性能对比表：

并发安全设计：

• 三级目录隔离：zip/apk 分离，MOD 代码分离
• 资源预热机制：避免并行下载冲突
• 独立工作空间：每个进程拥有独立的工作目录

配置与个性化设置

自定义 MOD 组合

想要创建自己的特色组合包？只需编辑config/combinations.toml文件：

[rules] # 推荐组合列表 recommended = [3, 35, 259, 291, 1058, 2082, 4130] # 必须包含的 MOD（所有组合都必须包含作弊功能） must_include = [2] # 互斥规则定义 [[rules.exclusive_groups]] mods = [1024, 2048, 4096] # AU 三个变体互斥 reason = "AU变体互斥" [[rules.exclusive_groups]] mods = [8, 16, 32, 512] # Sideview 特写互斥 reason = "Sideview特写互斥"

高级构建选项

DoL-Lyra 支持多种构建模式，满足不同场景需求：

仅构建特定类型：

# 仅构建 ZIP 版本（PC/Web） python main.py build zip --tag v0.5.7.9-5.0.2a-0112 # 仅构建 APK 版本（Android） python main.py build apk --tag v0.5.7.9-5.0.2a-0112 # 构建所有版本（默认） python main.py build --tag v0.5.7.9-5.0.2a-0112

并发控制：

# 使用 4 个进程构建 python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs 4 # 使用自动检测的 CPU 核心数 python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs auto # 顺序执行，便于调试 python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs 1

性能优化技巧

资源缓存策略

DoL-Lyra 采用了智能的资源缓存机制，避免重复下载：

缓存目录结构：

workspace/ ├── base/ # 游戏基包缓存 ├── dolp/ # DoL+ 图包缓存 │ ├── dolp/ │ ├── b3s/ │ ├── kaervek/ │ └── ... ├── au/ # AU 变体缓存 │ ├── AUfemale/ │ ├── AUmale/ │ └── AUandrogynous/ └── versions.json # 版本信息记录

缓存使用建议：

• 首次构建后，后续构建无需重新下载资源
• 定期清理 workspace 目录可释放磁盘空间
• 版本更新时，系统会自动检测并下载新资源

构建流程优化

分阶段执行策略：

# 阶段1：准备基础资源（仅需执行一次） python main.py prepare --tag v0.5.7.9-5.0.2a-0112 # 阶段2：预热美化资源（仅需执行一次） python main.py warmup # 阶段3：快速构建测试（可重复执行） 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

磁盘空间管理：

故障排查与技术支持

常见问题解决方案

构建失败排查流程：

1. 检查依赖环境：

   # 验证 Python 版本 python --version # 验证依赖包 pip list | grep -E "requests|toml|tqdm"

2. 检查网络连接：

   # 测试资源下载 curl -I https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS

3. 查看详细日志：

   # 启用详细日志模式 python main.py prepare --tag v0.5.7.9-5.0.2a-0112 -v

常见错误代码：

调试技巧

启用调试模式：

# 设置环境变量 export LYRA_DEBUG=1 python main.py build --tag v0.5.7.9-5.0.2a-0112 # 或使用 Python 调试器 python -m pdb main.py build --tag v0.5.7.9-5.0.2a-0112

查看中间文件：

# 检查构建中间状态 ls -la workspace/extract/zip/3/ ls -la workspace/extract/apk/35/ # 查看版本信息 cat workspace/versions.json | python -m json.tool

进阶应用场景

自定义美化资源集成

如果你有自己的美化资源想要集成到 DoL-Lyra 中，可以按照以下步骤操作：

1. 准备资源结构：

   自定义资源/ ├── img/ # 图片资源 ├── css/ # 样式文件 └── js/ # 脚本文件

2. 创建 MOD 定义： 编辑config/features.toml，添加新的功能定义：

   [[feature]] id = "custom_pack" name = "自定义美化包" bit = 8192 # 下一个 2 的幂 display_name = "自定义美化" description = "我的个性化美化包"

3. 实现构建逻辑： 在lyra/目录下添加相应的构建处理代码。

自动化 CI/CD 集成

DoL-Lyra 完美支持 GitHub Actions 等 CI/CD 平台：

GitHub Actions 配置示例：

name: Build DoL-Lyra on: push: branches: [ main ] schedule: - cron: '0 0 * * *' # 每天自动构建 jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Set up Python uses: actions/setup-python@v4 with: python-version: '3.10' - name: Install dependencies run: pip install -r requirements.txt - name: Build packages run: | python main.py prepare --tag v0.5.7.9-5.0.2a-0112 python main.py warmup python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs 4 - name: Upload artifacts uses: actions/upload-artifact@v3 with: name: dol-lyra-packages path: output/

多版本管理策略

版本标签格式：

v{原版版本号}-{汉化版本号}-{日期}[.{修订号}] 示例：v0.5.7.9-5.0.2a-0112

版本回滚机制：

# 查看历史版本 ls output/*.zip | sort -V # 重新构建特定版本 python main.py prepare --tag v0.5.7.9-5.0.2a-0112 python main.py build --tag v0.5.7.9-5.0.2a-0112 # 清理旧版本 find output/ -name "*.zip" -mtime +30 -delete find output/ -name "*.apk" -mtime +30 -delete

总结与后续步骤

DoL-Lyra 构建系统为 Degrees of Lewdity 游戏的美化整合提供了完整的自动化解决方案。通过智能配置管理、并行构建技术和灵活的扩展机制，它极大地简化了 MOD 整合的复杂性。

核心优势总结

1. 配置驱动：所有 MOD 组合通过配置文件管理，无需修改代码
2. 并行构建：多进程加速，构建效率提升 3-15 倍
3. 资源复用：智能缓存机制避免重复下载
4. 平台兼容：同时支持 ZIP（PC/Web）和 APK（Android）格式
5. 易于扩展：模块化设计，支持自定义美化资源集成

立即开始你的构建之旅

快速启动步骤：

# 1. 获取项目代码 git clone https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS cd DOL-CHS-MODS # 2. 安装必要依赖 pip install -r requirements.txt # 3. 执行完整构建流程 python main.py prepare --tag v0.5.7.9-5.0.2a-0112 python main.py warmup python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs 4 python main.py page --tag v0.5.7.9-5.0.2a-0112 -o download.md # 4. 查看构建结果 ls -lh output/

后续学习资源

• 项目文档：详细阅读 BUILD.md 了解高级配置选项
• 配置文件参考：查看 config/ 目录下的配置文件示例
• 源码学习：研究 lyra/ 目录下的核心模块实现
• 社区支持：参与项目讨论，分享你的使用经验

通过掌握 DoL-Lyra 构建系统，你不仅能够快速生成个性化的游戏美化包，还能深入了解自动化构建的最佳实践。现在就开始你的构建之旅，为 Degrees of Lewdity 游戏打造独一无二的视觉体验吧！

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