DoL-Lyra 整合包使用全指南

核心功能解析

项目定位与技术架构

DoL-Lyra是基于Degrees of Lewdity游戏的社区整合包项目，通过自动化工具链提供模块化的游戏增强方案。该项目采用三层架构设计：

• 基础层：原版游戏核心引擎与汉化补丁
• 功能层：战斗状态显示（CSD）、内置作弊系统等功能模组
• 资源层：KR/BJ特写镜头、角色美化素材等视觉资源

核心技术栈对比

技术类型	具体实现	功能作用
自动化工具	GitHub Actions（自动化打包工具）	监控汉化仓库更新，自动构建整合包
模组管理	ModLoader（模组加载器）	处理模组依赖关系，控制资源加载优先级
脚本系统	Shell脚本	实现打包流程控制、版本号生成等自动化任务
资源格式	ZIP/APK封装	分别对应PC端与Android端的分发需求

特色功能说明

• 多版本并行：提供基础版（仅核心功能）、美化版（含视觉增强）、完整版（全功能集成）三种打包方案
• 特写系统：包含KR特写（基础角色动作）和BJ特写（扩展互动场景）两套独立视觉模组
• 存档兼容：通过应用名称差异化（DoL Lyra）实现与官方版、纯汉化版的共存运行

环境搭建指南

基础环境配置

准备工具

• Git客户端（版本控制工具）
• 7-Zip或同类压缩软件（用于解压ZIP格式整合包）
• Android文件传输工具（如需要安装APK版本）

操作流程

👉 步骤A：获取项目文件

git clone https://gitcode.com/gh_mirrors/do/DoL-Lyra.git

💡 建议：克隆仓库前检查网络连接稳定性，国内用户可配置Git代理加速访问

👉 步骤B：验证项目完整性 进入项目目录后检查关键文件：

cd DoL-Lyra && ls -l

确认包含以下核心文件：

• mod.sh（自动化打包脚本）
• assets/（存放BJ_Extend.zip等扩展资源）
• README.md（项目说明文档）

👉 步骤C：选择整合包类型 根据设备类型选择对应版本：

• PC用户：下载ZIP格式整合包
• Android用户：下载APK格式整合包

验证方法

查看项目根目录下的assets文件夹，确认包含以下扩展资源：

• BJ_Extend.zip（BJ特写扩展包）
• KR_Extend.zip（KR特写扩展包）

高级功能启用

准备工具

• 现代浏览器（推荐Chrome/Firefox最新版）
• 文本编辑器（用于修改配置文件）

操作流程

👉 步骤A：安装整合包

• ZIP版：解压至非系统盘目录（如D:\Games\DoL-Lyra）
• APK版：传输至Android设备后，允许"未知来源应用"安装

👉 步骤B：启用视觉增强

1. 解压assets目录中的BJ_Extend.zip
2. 将解压得到的img文件夹复制到游戏根目录
3. 确认覆盖提示时选择"全部替换"

👉 步骤C：配置作弊系统

1. 启动游戏并完成初始设置
2. 按F12打开开发者工具（PC版）
3. 在Console面板输入enableCheats()启用作弊功能

验证方法

启动游戏后观察：

• 主界面左下角显示"ModLoader已加载"
• 战斗界面出现CSD状态面板（生命值/状态值显示）
• 角色互动场景加载新的特写镜头

进阶使用技巧

常见场景配置方案

场景一：低配置设备优化

适用情况：老旧手机或低配电脑运行卡顿
配置步骤：

1. 使用基础版整合包（不含美化资源）
2. 打开config.js文件，修改以下参数：

   window.graphicsQuality = "low"; // 降低画质
   window.animationEnabled = false; // 禁用动画效果
   

3. 清除浏览器缓存后重启游戏

场景二：多版本共存方案

适用情况：需要同时保留纯净汉化版与Lyra增强版
实现方法：

1. 安装官方汉化版到默认位置
2. 将Lyra版安装到独立目录（如D:\Games\DoL-Lyra）
3. 使用不同浏览器/用户配置文件分别启动

资源管理技巧

• 特写切换：通过修改mods.json中的priority值调整KR/BJ特写优先级（值越高越优先）
• 资源清理：定期删除cache目录下的临时文件（游戏会自动重建必要缓存）
• 模组冲突：发现界面异常时，检查是否加载了GameOriginalImagePack类图片包模组，此类模组会覆盖整合包自带资源

版本控制策略

• 关注项目更新日志中的{原版版本号}-{汉化版本号}标识，如v1.3.0-0904表示基于原版1.3.0和汉化0904版本构建
• 重大版本更新前建议导出存档（通过游戏内"导出存档"功能）
• 使用git pull命令可获取最新的自动化打包脚本，但整合包仍需从发布站下载

问题解决方案

安装常见问题

启动异常类

• 症状：APK版启动后显示英文界面且无ModLoader
  解决：更新Android系统WebView组件，或尝试"兼容版"APK，仍有问题可使用在线版：

  在线版访问方式：通过浏览器打开游戏目录下的index.html文件

• 症状：ZIP版解压后无法运行
  解决：检查解压路径是否包含中文或特殊字符，建议使用纯英文路径如C:\Games\DoL

功能异常类

• 症状：启用作弊功能后游戏崩溃
  解决：打开cheat.js文件，将enableExperimental值改为false，禁用实验性作弊功能

• 症状：视觉美化未生效
  解决：检查ModLoader的"旁加载"列表，确保已卸载所有外部图片包模组，整合包采用独立文件夹方式加载图片资源

高级排障流程

1. 复现问题：记录问题发生的具体场景（如战斗/对话/菜单）
2. 版本验证：确认使用的整合包版本号，检查是否为最新构建
3. 对比测试：使用纯汉化版测试相同操作，判断是否为Lyra特有问题
4. 日志收集：PC版按F12打开控制台，复制错误信息；APK版通过adb logcat抓取应用日志
5. 反馈提交：访问项目Issues页面，按模板提供：版本号+问题步骤+错误日志+复现概率

资源冲突解决

当出现中英文混杂、界面元素错位等问题时，执行以下步骤：

1. 关闭游戏并打开ModLoader
2. 在"已安装模组"列表中禁用所有第三方模组
3. 仅保留Lyra整合包自带的核心模组：
   • CombatStatusDisplay
   • CheatSystem
   • KR_Sideview/BJ_Sideview（根据使用需求选择其一）
4. 重启游戏使设置生效

附录：版本迁移指南

从旧版本升级时，建议采用"干净安装"流程：

1. 导出当前存档（通过游戏内"导出存档"功能保存为JSON文件）
2. 完全删除旧版游戏目录
3. 安装新版整合包
4. 通过"导入存档"功能恢复游戏进度
5. 重新配置个人偏好设置

💡 注意：大版本更新（如1.2.x→1.3.x）可能存在存档格式变更，建议在反馈平台确认存档兼容性后再进行升级操作。