安全删除文件或目录 Args: path: 要删除的路径 Returns: 是否成功

批量添加版本信息

加载构建配置

下载文件到指定路径 Args: url: 下载URL dest: 目标路径 quiet: 是否静默模式 Returns: 下载的文件路径

解压ZIP文件 Args: zip_path: ZIP文件路径 dest_dir: 目标目录 Returns: 解压目录

获取配置加载器实例

配置日志系统

获取组合的显示名称

检查指定位是否为1

添加版本信息

从 HTML 文件中提取 modDataValueZipList 数组

获取美化资源缓存目录 Args: name: 资源名称 (besc, hikari, goose, ucb) Returns: 缓存目录路径

从JSON文件加载版本信息 Args: path: 文件路径 Returns: VersionRegistry实例

复制目录内容

计算所有有效的MOD组合 Args: include_polyfill: 是否包含polyfill版本 Returns: 有效组合列表

复制目录内容 Args: src: 源目录 dest: 目标目录 overwrite: 是否覆盖已存在的文件

获取GitHub release信息 Args: repo: 仓库名称，格式为 "owner/repo" tag: release tag，或 "latest" 获取最新版本 Returns:

加载 TOML 文件

向 HTML 文件添加 mod Args: html_path: HTML 文件路径 mod_paths: mod 文件路径列表（按加载顺序）

确保所有必要目录存在

从 base64 编码的 zip 中提取 boot.json 信息

获取用于构建的code列表（字符串格式） Args: include_polyfill: 是否包含polyfill版本 Returns: code字符串列表，polyfill格式为 "polyfil

获取基于MOD代码的文件名后缀

运行外部命令 Args: cmd: 命令及参数列表 cwd: 工作目录 capture_output: 是否捕获输出 check: 是否检查返回码 Returns: CompletedPro

应用预热的美化资源 直接从 temp 目录复制已处理好的资源。 Returns: 应用的MOD名称列表

并行构建指定类型的包 Args: pack_type: 包类型 codes: 构建代码列表 version_dict: 版本信息字典 max_workers: 最大并发

生成表格行

检查组合中是否包含指定功能

构建并注入 Lyra 信息 mod 从 versions.json 加载完整版本信息（包含 prepare 和 warmup 阶段）， 构建 Lyra mod 并注入到 HTML 中。

注入 modloader mod 到 HTML 根据配置，将匹配当前 mod_code 的 modloader mod 注入到 HTML 的 modDataValueZipList 中。 Returns:

向 HTML 文件注入所有基础 mod 按 build.toml 中 base_mods 的配置顺序处理， 根据 inject 字段决定替换（replace 指定 slot）或追加（add）。 Args:

合并图片包

将图片包的img目录合并到目标目录 Args: image_pack_dir: 图片包解压目录 target_dir: 目标目录

处理单个 ZIP 版本

创建ZIP压缩包 Args: source_dir: 源目录 dest_path: 目标ZIP文件路径 Returns: ZIP文件路径

从tag字符串解析版本信息 Args: tag: 版本tag，格式如 v0.5.7.9-5.0.2a-0112 Returns: LyraVersion实例 Raises:

生成完整的 Markdown 下载页面 Returns: Markdown 内容

获取已解包APK目录路径

获取ZIP基包路径

获取下载链接

通过ID获取功能

生成文件名 使用 ModCode.get_suffix() 确保与构建时的文件名完全一致。 Args: mod_code: MOD组合代码 ext: 文件扩展名 (zip/apk)

从 GitHub Release 获取资源信息 Args: repo: 仓库名称，格式为 "owner/repo" asset_pattern: 资源文件名模式（用于匹配） tag: release tag，默认为 "latest"

获取镜像下载链接

获取 modloader mod 缓存文件路径 Args: name: mod 名称 (如 au_f, au_m, au_a) Returns: mod zip 文件路径

生成输出文件名

获取签名输出目录

将文件转换为 base64 字符串

主入口

保存版本信息到JSON文件 Args: path: 保存路径

生成组合详情字符串（用于组合对照） Args: include_polyfill: 是否包含 polyfill 版本，默认不包含 Returns: 格式化的组合对照字符串

构建功能映射

检查冲突关系 Returns: True 如果没有冲突，False 否则

检查依赖关系 Returns: True 如果所有依赖都满足，False 否则

下载单个 DoL+ 图片包 Args: pack_name: 包名称

下载单个 modloader mod Args: mod_config: mod 配置 config_loader: 配置加载器（用于查找 feature 信息）

从文件名提取版本号 支持格式： - AUfemale.imgpack_v0.8.0.zip -> v0.8.0 - mod_1.2.3.zip -> 1.2.3 - something-v2.0.0-beta.zip -> v2.0.0-beta

修复 BESC 的大小写问题

生成 README.md 内容 Args: version_str: Lyra 版本字符串 version_info: 资源版本信息列表 mod_suffix: MOD 组合后缀（如 "goose-ucb"） Returns

生成版本信息表格

准备 APK

准备 ZIP 基包

处理单个 APK 版本

处理 BESC 美化包

处理 Goose 美化包

处理 Hikari 美化包

处理 UCB 美化包

重新编译APK

检查是否应该跳过此组合

签名APK

对构建代码排序 polyfill 版本排在后面。

预热 DoL+ 图片包

预热 modloader mod

向已有的 .mod.html 文件中添加新 Mod

应用配置中的替换规则 Args: apk_dir: 已解包的 APK 目录

构建ZIP包

并行构建所有组合 Returns: (成功数, 失败数)

并行构建所有组合的便捷函数 Args: paths: 路径管理器 version: 版本信息 pack_types: 包类型列表 max_workers: 最大并发数 include_polyfill

构建 Lyra 信息 mod 生成一个仅用于显示版本信息的 mod.zip 文件。 Args: output_path: 输出文件路径 version: Lyra 版本信息 version_info: 资源版本信息列表

执行单个构建 Args: task: 构建任务 Returns: 构建结果

创建打包构建器 Args: task: 构建任务 Returns: 对应类型的构建器

反编译 APK Args: apk_path: APK 文件路径 dest_dir: 目标目录 Returns: 解压后的目录路径

下载uber-apk-signer

下载apktool

下载额外的mod文件 从 build.toml 的 base_mods 配置中读取需要下载的 mod， 下载配置了 github_repo 的 mod 的最新 .mod.zip 文件。 Returns: 下

从汉化仓库下载资源文件 Args: version: 版本信息（可选，为None时使用latest release） Returns: 下载文件的路径字典 {类型: 路径}

解压tar.gz文件 Args: tar_path: tar.gz文件路径 dest_dir: 目标目录 strip_components: 跳过的目录层级数 Returns: 解压目录

从代码字符串创建任务 Args: code_str: 代码字符串，如 "3" 或 "polyfill-3" pack_type: 包类型 version: 版本信息 p

从字典创建

便捷函数：生成下载页面 Args: version: 版本号 output_path: 输出路径（可选） github_owner: GitHub 用户名 github_repo: GitHub 仓库名

使用 pytablewriter 生成表格

简单表格生成（无需外部依赖）

获取特定构建的工作目录 Args: pack_type: 包类型 (zip/apk) mod_code: MOD代码 polyfill: 是否为polyfill版本 Retu

获取默认的构建code列表

获取 GitGud 仓库的最新 commit hash Args: repo: 仓库路径，如 "Frostberg/degrees-of-lewdity-plus" branch: 分支名，默认 "master" Returns:

获取临时APK文件路径

列出 HTML 文件中的所有 Mod（显示详细信息）

加载版本信息（兼容旧接口）