桌面应用游戏开发【免费下载链接】LumaflyA cross platform mod manager for Hollow Knight written in Avalonia.项目地址https://gitcode.com/gh_mirrors/lu/Lumafly点击查看免费下载Lumafly 是一款基于 Avalonia 开发的跨平台《空洞骑士》(Hollow Knight) 模组管理器支持 Windows、macOS 与 Linux并内置了英、西、葡、法、中、日、俄、波等语言界面。本文以仓库根目录的 README.md 为主线结合 Lumafly 主工程源码与 Lumafly.Tests 测试用例系统讲解它的安装使用、六大核心能力以及下载校验—安装切换—状态持久化—Modpack 分享背后的完整实现链路。读完本文你将既能独立完成从安装到管理 Mod 的全流程操作也能理解其 modlinks 数据源、API 切换、URL Scheme 命令等底层机制为二次开发或定制部署打下基础。Lumafly 是什么从 Scarab 到跨平台 Mod 管理器按 README 的定位Lumafly 是一个跨平台的《空洞骑士》Mod 管理器前身是Scarab继承自早期 Scarab 项目目前界面已完全本地化。README 明确列出的本地化语言为英语、西班牙语、葡萄牙语、法语、中文、日语、俄语与波兰语而在源码层面SupportedLanguages.cs 中的枚举还额外包含荷兰语nl与意大利语it即共支持 10 种语言对应的本地化资源文件位于 Localizations 目录含Resources.zh.resx等。从工程结构看Lumafly.csproj它基于Avalonia 11.0.4 Skia Fluent 主题实现跨平台 UI.NET 7TargetFramework为net7.0OutputType为WinExeReactiveUI / PropertyChanged.SourceGenerator驱动 MVVM 视图模型Mono.Cecil读取程序集元数据、HPackage.Net处理 Modpack 分享格式、NetSparkleUpdater负责 Windows 端自更新。Program.cs 是启动入口先完成日志初始化与语言探测随后注册scarab://URL Scheme 处理器、注册 SIGTERM/SIGINT 信号处理最后以经典桌面生命周期启动 Avalonia 应用。日志文件ModInstaller.log会写入配置目录超过 5 MB 时自动归档崩溃信息另存为ModInstaller_Error_*.log。快速上手从下载到进入游戏README 的 Usage 一节给出了完整的用户操作路径这也是每个玩家的标准使用流程下载安装从官方下载页获取最新版本或从 Releases 页面手动下载。搜索并安装在 Mod 列表中搜索并下载你喜欢的 Mod。进入游戏安装完成后Mod 会出现在游戏标题界面的左上角。开关与更新通过开关按钮启用/禁用某个 Mod 对游戏的影响过期的 Mod 会显示橙色更新按钮点击即可更新。离线使用无法联网时可以以离线模式启动 Lumafly此时仍可开关已安装的 Mod 与 Modding API。需要补充的是Mod 出现在标题界面左上角这一行为源自《空洞骑士》Modding API 的加载机制——Lumafly 只是负责把 Mod 文件放置到游戏目录并维护启用状态真正让 Mod 生效的是游戏进程内加载的 API。核心功能总览README Features 完整解读README 的 Features 一节定义了 Lumafly 的六大核心能力下面逐条展开并结合源码说明其实现方式。1. 自动安装 Modding API随时切换原版/Mod 版Lumafly 会自动下载并安装 Mod 加载所必需的Modding API并提供Toggle API按钮在Mod 版游戏与原版游戏之间切换。实现上ModDatabase.cs 会从官方 modlinks 拉取ApiLinks.xml得到 API 的下载地址、版本号与 SHA256 哈希Installer.cs 中的InstallApi/ToggleApi则负责实际安装与切换。切换的关键是游戏目录下三个文件名的轮换Assembly-CSharp.dll—— 当前生效的程序集Assembly-CSharp.dll.v—— 备份的原版程序集vanillaAssembly-CSharp.dll.m—— 备份的 Mod 版程序集modded。ToggleApi的底层逻辑Installer.cs就是在这三个文件之间做文件移动启用 API 时把原版Current移到.v、再从.m恢复 Mod 版关闭 API 时反向操作。首次安装 API 时还会用FetchVanillaAssemblyLink按操作系统Windows/macOS/Linux下载对应的原版程序集备份确保之后可以无损切回原版。2. 搜索官方 modlinks 中的 300 ModREADME 声称官方 modlinks 中收录了300 多个 ModLumafly 提供统一的搜索、浏览入口。数据侧ModDatabase每次启动都会抓取ModLinks.xml与ApiLinks.xml两个清单文件请求超时 30 秒失败自动回退到 jsdelivr CDN 镜像。ModLinks.xml中每个Manifest条目被反序列化为 ModLinks.cs 中的Manifest记录包含名称、版本、三个平台的下载链接与 SHA256、依赖、描述、标签、集成、作者等字段。测试用例 DatabaseTest.cs 直接用一段内嵌的ModLinks.xml/ApiLinks.xml验证了这套反序列化逻辑它断言QoL这个 Mod 的版本、依赖Vasi、下载链接等字段均被正确解析且 API 版本号被正确读取为 63。这也是理解 modlinks 数据格式最直接的示例。3. Modpack 分组与分享命令Lumafly 允许把一组 Mod 打包成Modpack配置文件/合集并分享。本地实现位于 PackManager.cs每个 Modpack 对应游戏目录下的一个文件夹内含packMods.json清单packInfoFileName常量。支持叠加加载additive把包内 Mod 合并进当前列表与独占加载exclusive清空现有 Mods 目录后整体替换加载前会先把旧 Mod 目录缓存到Temp_Mods_Storage失败时自动回滚。分享则通过 URL Scheme 命令README 指向的 Commands 文档完成把包转换为HPackageJSON 格式后上传到在线文本存储实现为 PastebinTextStorage.cs得到一个分享码其他人用scarab://modpack/code即可导入。此外还支持把包导出为.zip文件。4. 展示最近更新/新发布的 ModREADME 提到 Lumafly 能Display mods that were recently updated or released。这由 ModLinksChanges.cs 实现它从静态资源仓库的ModlinksChanges.json获取本周/本月新增与更新的 Mod 名单再结合上次使用的ModLinks.xml与当前清单做差量对比得出今天的改动最终在界面上标记ModChangeState.New / Updated枚举见 ModChangeState.cs并按其排序权重展示。5. 一站式管理下载、更新、设置、Readme、报 Bug单个 Mod 的详情操作非常完整全部集中在 ModItem.cs 的ModItem模型上OnInstall/OnUpdate/Uninstall安装、更新、卸载OpenSettingsFile直接打开该 Mod 的*.GlobalSettings.json配置文件由 GlobalSettingsFinder.cs 在存档目录中定位必要时会用 Mono.Cecil 反查 Mod 程序集中的类名以匹配Modding.Mod、SFCore、Satchel等基类OpenReadme/OpenReleaseNotes弹出窗口查看 Readme 与更新日志ReportBug跳转到该 Mod 的 Issues 页面。6. 手动安装非 modlinks 的 Modmodlinks 之外的第三方 Mod 通过手动安装入口支持。这类 Mod 在源码中以NotInModLinksState见 ModState.cs标识ModlinksMod字段区分官方清单里有同名项但本地装的是自定义版本与完全自定义的 Mod两种情况列表中对它们会显示not from official modlinks的说明。配置系统HKInstallerSettings.json 全参数说明Lumafly 的配置持久化在 Settings.cs 中定义配置文件位于系统应用数据目录下的HKModInstaller文件夹Windows 为%APPDATA%Linux 为~/.configmacOS 为~/Library/Application Support文件名是HKInstallerSettings.json采用缩进 JSON 序列化。常用配置项如下表配置项类型 / 默认值说明ManagedFolder字符串《空洞骑士》游戏安装目录即Managed目录所在位置AutoRemoveUnusedDepsNever默认/Ask/Always是否自动移除卸载后不再被依赖的 ModAutoRemoveUnusedDepsOptions.csWarnBeforeRemovingDependents布尔默认true移除某 Mod 前是否警告其依赖方UseCustomModlinks布尔默认false是否使用自定义 modlinks 数据源CustomModlinksUri字符串默认空自定义 modlinks 的地址UseGithubMirror布尔默认false是否通过 GitHub 镜像下载GithubMirrorFormat字符串默认空镜像 URL 模板PreferredLanguage可空枚举默认自动探测首选语言取值为 SupportedLanguages.cs 的 10 种语言之一LowStorageMode布尔默认false低存储模式不缓存下载的 Mod 压缩包RequiresWorkaroundClient布尔是否强制使用 IPv4 专用 HTTP 客户端网络兼容性开关Settings.Load()在 JSON 损坏时会静默回退为空配置而不是崩溃。此外Program.cs 的SetPreferredLanguage会优先读取该配置否则跟随系统区域语言再次兜底为英语。游戏目录的自动定位同样在Settings中完成先遍历内置的静态路径列表Steam / Xbox / GOG 的常见安装路径再检查用户主目录下的 Linux含 Flatpak与 macOS 路径最后在 Windows 上读取注册表Valve Steam 的libraryfolders.vdf与 GOG 注册表键来定位游戏库。也就是说即使玩家把游戏装到了非默认位置Lumafly 也能大概率自动找到。安装、更新与卸载的实现原理Installer是操作游戏目录的核心服务Installer.cs安装流程可以概括为确保 Modding API 已安装递归调用InstallApi通过信号量SemaphoreSlim串行化安装操作递归处理依赖_Install会遍历mod.Dependencies先装好每个依赖及其传递依赖下载 Mod 文件支持进度回调下载前优先命中本地缓存CacheFolder下的HKInstallerCache用 manifest 中声明的SHA256 哈希做完整性校验不匹配则抛HashMismatchException并中止按文件类型落盘.zip解压解压过程会做路径穿越防护file_dest.StartsWith(dest_dir_path)检查防止恶意压缩包逃逸出目录.dll直接写入Mods/ModName/更新内存状态并写入持久化文件。更新OnUpdate本质是带clearDlls标志的重装先清空 Mod 文件夹中的旧 DLL 再放置新文件避免残留旧程序集卸载_Uninstall则直接删除对应目录并把NotInModLinksState的 Mod 从列表移除。状态模型是理解 UI 的关键。ModState.cs 定义了三种状态NotInstalledState未安装InstalledState已安装含Enabled启用、Version本地版本、Updated是否最新、Pinned置顶NotInModLinksState已安装但不在官方清单中区分ModlinksMod。当清单版本与本地版本一致时Updatedtrue否则UpdateAvailable为真界面上就会显示橙色更新按钮。开关 Mod 与 API目录搬运与文件轮换启用/禁用 Mod 的实现非常朴素且可靠整体移动文件夹。_ToggleInstaller.cs把 Mod 目录在Mods启用与Disabled禁用两个目录之间移动——游戏只加载Mods目录下的内容因此禁用不会丢失任何文件可以随时切回。值得注意的两个细节启用时自动带起依赖Toggle在启用某 Mod 前会先递归启用它的所有依赖源码注释明确说明这是为了避免启用后因缺少依赖而失效目标目录冲突保护如果目标目录已存在同名文件夹会弹窗询问用户是否删除冲突项。API 的开关则使用前面提到的.v/.m/Current三文件轮换且由独立的_modToggleSemaphore保护避免与 Mod 切换并发冲突。已安装状态持久化与自恢复InstalledMods.cs 负责把已安装哪些 Mod、启用状态如何、API 状态如何持久化为配置文件目录下的InstalledMods.json。它有两个值得称道的健壮性设计损坏自恢复JSON 损坏或首次安装时会扫描Mods/Disabled目录重建状态版本未知的 Mod 标记为过期Updatedfalse并提示更新目录状态对账每次加载都会把磁盘目录与记录状态做对比——玩家手动移动、删除文件夹后状态记录会被自动修正源码中enabled state mismatch, fixing!与Removing missing mod的 Trace 日志即出自此处。ModSourceTest.csModSourceTest.cs用内存文件系统验证了记录安装状态 → 从 manifest 判断是否过期 → 记录卸载的完整闭环是对这套持久化逻辑的直接测试佐证。Modpack 机制分组、导入导出与分享PackManager 是 Modpack 功能的核心PackManager.cs核心机制包括保存SavePack把当前Mods目录排除Disabled复制到ManagedFolder/包名/并写入packMods.json含名称、描述、作者与启用状态的 Mod 清单加载LoadPack区分叠加与独占两种模式加载前用CacheOldModsFolder备份当前 Mods 目录任何一步失败都会RevertToPreviousModsFolder完整还原导出SavePackToZip借助系统保存对话框把包目录压缩为.zip导入/分享ConvertToHPackage用 HPackage.Net 把包序列化为 Hollow Knight 标准包格式 JSON上传在线文本存储后得到SharingCodeImportPack则反向解析分享码导入重名包会被拒绝。Pack模型定义在 Pack.csIsSame/DeepCopy用于编辑后判断是否发生变化。加载包前还会检测游戏进程hollow_knight是否在运行必要时提醒用户关闭游戏。URL Scheme 命令远程控制与分享的通道README 中提到的 commands 即scarab://自定义协议。注册与解析在 UrlSchemeHandler.csWindows 上写注册表HKEY_CURRENT_USER\SOFTWARE\Classes\scarabLinux 上生成scarab.desktop桌面条目x-scheme-handler/scarabmacOS 则在编译期写入Info.plist见 Scripts/Lumafly.app/Contents/Info.plist。支持的命令枚举定义见 UrlSchemeCommands.cs如下命令用途download下载一个或多个 Mod格式为scarab://download/名称:链接/名称2:链接2reset重置已安装状态forceUpdateAll强制更新全部 ModcustomModLinks切换并使用自定义 modlinksuseOfficialModLinks切回官方 modlinksremoveAllModsGlobalSettings清空所有 Mod 的全局设置文件removeGlobalSettings移除指定 Mod 的全局设置文件launch启动游戏modpack导入某个分享码对应的 Modpacklocation定位/指定游戏目录download命令的解析器ParseDownloadCommand会对名称做非法字符校验、对链接做 URI 合法性校验非法输入直接拒绝解析非scarab://前缀或未知命令会弹出警告框。ModItem.Share()方法会把单个 Mod 编码进分享链接与 modpack 分享形成闭环。“最近更新”与反向依赖搜索最近更新由ModLinksChanges服务完成详见上文功能 4其IsLoaded三态布尔null未加载 /true成功 /false失败确保数据异常时界面不做无意义的展示离线模式或使用自定义 modlinks 时该功能自动关闭。反向依赖搜索ReverseDependencySearch.cs 提供三类查询GetAllDependentAndIntegratedMods依赖方 集成方、GetAllIntegratedMods仅集成方、GetAllEnabledDependents仅已启用的依赖方且依赖关系支持传递递归判断。这与 UI 中的SearchTypeNormal / DependencyAndIntegration / Integration见 SearchType.cs以及ModFilterStateAll / Installed / Enabled / OutOfDate / WhatsNew见 ModFilerState.cs筛选器配合能快速回答卸载这个 Mod 会影响谁、哪些 Mod 集成了这个 Mod等实际问题。本地化与字体本地化采用 Avalonia 标准的.resx资源机制Lumafly.csproj 中把所有Localizations\*.resx设为嵌入资源翻译工作通过 Crowdin 平台协作完成README Contributions 一节有说明。Program.cs 还针对不同语言做了字体覆盖中文使用内嵌的 Noto Sans SC、其余语言使用 Noto Sans字体文件位于 Assets/Fonts确保 CJK 字符渲染正常。网络容错与离线模式离线模式LumaflyMode枚举LumaflyMode.cs区分Online/Offline。离线启动时不拉取任何在线数据仅基于本地InstalledMods.json与已下载缓存工作仍可开关 Mod 与 API——这正是 README 描述的离线能力。IPv4 回退客户端WorkaroundHttpClient.cs 针对 .NET 默认双栈 socket 在某些网络/驱动下走 IPv6 失败的问题提供了强制 IPv4 连接的替代客户端RequiresWorkaroundClient为 true 时全程使用否则先试常规客户端、超时再回退HttpSetting.OnlyWorkaround / TryBoth。自更新机制AppUpdater.cs 负责应用自更新Windows 端基于 NetSparkleUpdater 读取 appcast.xml仓库根目录当前最新条目为 v3.3.0.0支持自动下载安装、重启后替换非 Windows 平台改为手动检查 GitHub Releases 的tag_name版本号高于本地版本时提示用户跳转下载。更新信息发布说明、下载链接、变更日志通过静态资源仓库的UpdateLinks.json动态下发无需发版即可调整。测试保障仓库自带的 Lumafly.Tests 覆盖了最关键的两条链路DatabaseTest.cs验证ModLinks.xml/ApiLinks.xml的 XML 反序列化、ModDatabase的 Item 构建以及三种状态未安装 / 已安装 / 过期的判定ModSourceTest.cs验证InstalledMods的持久化读写与版本一致即最新逻辑。它们使用System.IO.Abstractions.TestingHelpers的内存文件系统可在无真实游戏目录的情况下运行也间接证明了核心逻辑与具体文件系统解耦。参与贡献与社区生态按 README 的 Contributions 说明功能建议与 Bug 请走 Issues 页面想参与开发可关注 enhancement 标签下的待办功能本地化翻译请通过 Crowdin 平台提交。README 的 Credits 部分同时列出了项目渊源——基于 fifty-six 的 Scarab 开发以及来自社区的多语言译者与美术作者。结语从 README 的六项核心特性出发本文结合仓库源码把 Lumafly 拆解为一条清晰的实现主线modlinks 数据源驱动内容、Installer 负责文件级安装与切换、InstalledMods 持久化状态、PackManager 支持批量管理、URL Scheme 打通远程分享、离线模式兜底断网场景。无论你是普通玩家想正确安装和使用它还是开发者想为《空洞骑士》生态贡献一个 Mod 管理器插件或定制版本都可以从 README.md 起步再按本文给出的源码路径逐层深入。赞分享桌面应用游戏开发【免费下载链接】LumaflyA cross platform mod manager for Hollow Knight written in Avalonia.项目地址https://gitcode.com/gh_mirrors/lu/Lumafly点击查看免费下载相关推荐Lumafly跨平台空洞骑士模组管理完全指南Lumafly跨平台空洞骑士模组管理完全指南 您是否曾为安装空洞骑士模组时的繁琐步骤感到困扰Lumafly作为一款基于Avalonia开发的跨平台模组管理工桌面应用游戏开发Lumafly跨平台空洞骑士模组管理完全指南Lumafly跨平台空洞骑士模组管理完全指南 您是否曾为安装空洞骑士模组时的繁琐步骤感到困扰Lumafly作为一款基于Avalonia开发的跨平台模组管理工桌面应用游戏开发Lumafly跨平台空洞骑士模组管理完全指南Lumafly跨平台空洞骑士模组管理完全指南 Lumafly是一款基于Avalonia开发的跨平台模组管理工具专门为《空洞骑士》游戏设计。它让玩家能够轻松管桌面应用游戏开发上一篇SPT-AKI存档编辑器终极指南如何快速掌握你的塔科夫单机版游戏进度下一篇LX Music 桌面版聚合五平台音乐搜索与批量下载的上手指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
桌面应用游戏开发【免费下载链接】LumaflyA cross platform mod manager for Hollow Knight written in Avalonia.项目地址https://gitcode.com/gh_mirrors/lu/Lumafly点击查看免费下载Lumafly 是一款基于 Avalonia 开发的跨平台《空洞骑士》(Hollow Knight) 模组管理器支持 Windows、macOS 与 Linux并内置了英、西、葡、法、中、日、俄、波等语言界面。本文以仓库根目录的 README.md 为主线结合 Lumafly 主工程源码与 Lumafly.Tests 测试用例系统讲解它的安装使用、六大核心能力以及下载校验—安装切换—状态持久化—Modpack 分享背后的完整实现链路。读完本文你将既能独立完成从安装到管理 Mod 的全流程操作也能理解其 modlinks 数据源、API 切换、URL Scheme 命令等底层机制为二次开发或定制部署打下基础。Lumafly 是什么从 Scarab 到跨平台 Mod 管理器按 README 的定位Lumafly 是一个跨平台的《空洞骑士》Mod 管理器前身是Scarab继承自早期 Scarab 项目目前界面已完全本地化。README 明确列出的本地化语言为英语、西班牙语、葡萄牙语、法语、中文、日语、俄语与波兰语而在源码层面SupportedLanguages.cs 中的枚举还额外包含荷兰语nl与意大利语it即共支持 10 种语言对应的本地化资源文件位于 Localizations 目录含Resources.zh.resx等。从工程结构看Lumafly.csproj它基于Avalonia 11.0.4 Skia Fluent 主题实现跨平台 UI.NET 7TargetFramework为net7.0OutputType为WinExeReactiveUI / PropertyChanged.SourceGenerator驱动 MVVM 视图模型Mono.Cecil读取程序集元数据、HPackage.Net处理 Modpack 分享格式、NetSparkleUpdater负责 Windows 端自更新。Program.cs 是启动入口先完成日志初始化与语言探测随后注册scarab://URL Scheme 处理器、注册 SIGTERM/SIGINT 信号处理最后以经典桌面生命周期启动 Avalonia 应用。日志文件ModInstaller.log会写入配置目录超过 5 MB 时自动归档崩溃信息另存为ModInstaller_Error_*.log。快速上手从下载到进入游戏README 的 Usage 一节给出了完整的用户操作路径这也是每个玩家的标准使用流程下载安装从官方下载页获取最新版本或从 Releases 页面手动下载。搜索并安装在 Mod 列表中搜索并下载你喜欢的 Mod。进入游戏安装完成后Mod 会出现在游戏标题界面的左上角。开关与更新通过开关按钮启用/禁用某个 Mod 对游戏的影响过期的 Mod 会显示橙色更新按钮点击即可更新。离线使用无法联网时可以以离线模式启动 Lumafly此时仍可开关已安装的 Mod 与 Modding API。需要补充的是Mod 出现在标题界面左上角这一行为源自《空洞骑士》Modding API 的加载机制——Lumafly 只是负责把 Mod 文件放置到游戏目录并维护启用状态真正让 Mod 生效的是游戏进程内加载的 API。核心功能总览README Features 完整解读README 的 Features 一节定义了 Lumafly 的六大核心能力下面逐条展开并结合源码说明其实现方式。1. 自动安装 Modding API随时切换原版/Mod 版Lumafly 会自动下载并安装 Mod 加载所必需的Modding API并提供Toggle API按钮在Mod 版游戏与原版游戏之间切换。实现上ModDatabase.cs 会从官方 modlinks 拉取ApiLinks.xml得到 API 的下载地址、版本号与 SHA256 哈希Installer.cs 中的InstallApi/ToggleApi则负责实际安装与切换。切换的关键是游戏目录下三个文件名的轮换Assembly-CSharp.dll—— 当前生效的程序集Assembly-CSharp.dll.v—— 备份的原版程序集vanillaAssembly-CSharp.dll.m—— 备份的 Mod 版程序集modded。ToggleApi的底层逻辑Installer.cs就是在这三个文件之间做文件移动启用 API 时把原版Current移到.v、再从.m恢复 Mod 版关闭 API 时反向操作。首次安装 API 时还会用FetchVanillaAssemblyLink按操作系统Windows/macOS/Linux下载对应的原版程序集备份确保之后可以无损切回原版。2. 搜索官方 modlinks 中的 300 ModREADME 声称官方 modlinks 中收录了300 多个 ModLumafly 提供统一的搜索、浏览入口。数据侧ModDatabase每次启动都会抓取ModLinks.xml与ApiLinks.xml两个清单文件请求超时 30 秒失败自动回退到 jsdelivr CDN 镜像。ModLinks.xml中每个Manifest条目被反序列化为 ModLinks.cs 中的Manifest记录包含名称、版本、三个平台的下载链接与 SHA256、依赖、描述、标签、集成、作者等字段。测试用例 DatabaseTest.cs 直接用一段内嵌的ModLinks.xml/ApiLinks.xml验证了这套反序列化逻辑它断言QoL这个 Mod 的版本、依赖Vasi、下载链接等字段均被正确解析且 API 版本号被正确读取为 63。这也是理解 modlinks 数据格式最直接的示例。3. Modpack 分组与分享命令Lumafly 允许把一组 Mod 打包成Modpack配置文件/合集并分享。本地实现位于 PackManager.cs每个 Modpack 对应游戏目录下的一个文件夹内含packMods.json清单packInfoFileName常量。支持叠加加载additive把包内 Mod 合并进当前列表与独占加载exclusive清空现有 Mods 目录后整体替换加载前会先把旧 Mod 目录缓存到Temp_Mods_Storage失败时自动回滚。分享则通过 URL Scheme 命令README 指向的 Commands 文档完成把包转换为HPackageJSON 格式后上传到在线文本存储实现为 PastebinTextStorage.cs得到一个分享码其他人用scarab://modpack/code即可导入。此外还支持把包导出为.zip文件。4. 展示最近更新/新发布的 ModREADME 提到 Lumafly 能Display mods that were recently updated or released。这由 ModLinksChanges.cs 实现它从静态资源仓库的ModlinksChanges.json获取本周/本月新增与更新的 Mod 名单再结合上次使用的ModLinks.xml与当前清单做差量对比得出今天的改动最终在界面上标记ModChangeState.New / Updated枚举见 ModChangeState.cs并按其排序权重展示。5. 一站式管理下载、更新、设置、Readme、报 Bug单个 Mod 的详情操作非常完整全部集中在 ModItem.cs 的ModItem模型上OnInstall/OnUpdate/Uninstall安装、更新、卸载OpenSettingsFile直接打开该 Mod 的*.GlobalSettings.json配置文件由 GlobalSettingsFinder.cs 在存档目录中定位必要时会用 Mono.Cecil 反查 Mod 程序集中的类名以匹配Modding.Mod、SFCore、Satchel等基类OpenReadme/OpenReleaseNotes弹出窗口查看 Readme 与更新日志ReportBug跳转到该 Mod 的 Issues 页面。6. 手动安装非 modlinks 的 Modmodlinks 之外的第三方 Mod 通过手动安装入口支持。这类 Mod 在源码中以NotInModLinksState见 ModState.cs标识ModlinksMod字段区分官方清单里有同名项但本地装的是自定义版本与完全自定义的 Mod两种情况列表中对它们会显示not from official modlinks的说明。配置系统HKInstallerSettings.json 全参数说明Lumafly 的配置持久化在 Settings.cs 中定义配置文件位于系统应用数据目录下的HKModInstaller文件夹Windows 为%APPDATA%Linux 为~/.configmacOS 为~/Library/Application Support文件名是HKInstallerSettings.json采用缩进 JSON 序列化。常用配置项如下表配置项类型 / 默认值说明ManagedFolder字符串《空洞骑士》游戏安装目录即Managed目录所在位置AutoRemoveUnusedDepsNever默认/Ask/Always是否自动移除卸载后不再被依赖的 ModAutoRemoveUnusedDepsOptions.csWarnBeforeRemovingDependents布尔默认true移除某 Mod 前是否警告其依赖方UseCustomModlinks布尔默认false是否使用自定义 modlinks 数据源CustomModlinksUri字符串默认空自定义 modlinks 的地址UseGithubMirror布尔默认false是否通过 GitHub 镜像下载GithubMirrorFormat字符串默认空镜像 URL 模板PreferredLanguage可空枚举默认自动探测首选语言取值为 SupportedLanguages.cs 的 10 种语言之一LowStorageMode布尔默认false低存储模式不缓存下载的 Mod 压缩包RequiresWorkaroundClient布尔是否强制使用 IPv4 专用 HTTP 客户端网络兼容性开关Settings.Load()在 JSON 损坏时会静默回退为空配置而不是崩溃。此外Program.cs 的SetPreferredLanguage会优先读取该配置否则跟随系统区域语言再次兜底为英语。游戏目录的自动定位同样在Settings中完成先遍历内置的静态路径列表Steam / Xbox / GOG 的常见安装路径再检查用户主目录下的 Linux含 Flatpak与 macOS 路径最后在 Windows 上读取注册表Valve Steam 的libraryfolders.vdf与 GOG 注册表键来定位游戏库。也就是说即使玩家把游戏装到了非默认位置Lumafly 也能大概率自动找到。安装、更新与卸载的实现原理Installer是操作游戏目录的核心服务Installer.cs安装流程可以概括为确保 Modding API 已安装递归调用InstallApi通过信号量SemaphoreSlim串行化安装操作递归处理依赖_Install会遍历mod.Dependencies先装好每个依赖及其传递依赖下载 Mod 文件支持进度回调下载前优先命中本地缓存CacheFolder下的HKInstallerCache用 manifest 中声明的SHA256 哈希做完整性校验不匹配则抛HashMismatchException并中止按文件类型落盘.zip解压解压过程会做路径穿越防护file_dest.StartsWith(dest_dir_path)检查防止恶意压缩包逃逸出目录.dll直接写入Mods/ModName/更新内存状态并写入持久化文件。更新OnUpdate本质是带clearDlls标志的重装先清空 Mod 文件夹中的旧 DLL 再放置新文件避免残留旧程序集卸载_Uninstall则直接删除对应目录并把NotInModLinksState的 Mod 从列表移除。状态模型是理解 UI 的关键。ModState.cs 定义了三种状态NotInstalledState未安装InstalledState已安装含Enabled启用、Version本地版本、Updated是否最新、Pinned置顶NotInModLinksState已安装但不在官方清单中区分ModlinksMod。当清单版本与本地版本一致时Updatedtrue否则UpdateAvailable为真界面上就会显示橙色更新按钮。开关 Mod 与 API目录搬运与文件轮换启用/禁用 Mod 的实现非常朴素且可靠整体移动文件夹。_ToggleInstaller.cs把 Mod 目录在Mods启用与Disabled禁用两个目录之间移动——游戏只加载Mods目录下的内容因此禁用不会丢失任何文件可以随时切回。值得注意的两个细节启用时自动带起依赖Toggle在启用某 Mod 前会先递归启用它的所有依赖源码注释明确说明这是为了避免启用后因缺少依赖而失效目标目录冲突保护如果目标目录已存在同名文件夹会弹窗询问用户是否删除冲突项。API 的开关则使用前面提到的.v/.m/Current三文件轮换且由独立的_modToggleSemaphore保护避免与 Mod 切换并发冲突。已安装状态持久化与自恢复InstalledMods.cs 负责把已安装哪些 Mod、启用状态如何、API 状态如何持久化为配置文件目录下的InstalledMods.json。它有两个值得称道的健壮性设计损坏自恢复JSON 损坏或首次安装时会扫描Mods/Disabled目录重建状态版本未知的 Mod 标记为过期Updatedfalse并提示更新目录状态对账每次加载都会把磁盘目录与记录状态做对比——玩家手动移动、删除文件夹后状态记录会被自动修正源码中enabled state mismatch, fixing!与Removing missing mod的 Trace 日志即出自此处。ModSourceTest.csModSourceTest.cs用内存文件系统验证了记录安装状态 → 从 manifest 判断是否过期 → 记录卸载的完整闭环是对这套持久化逻辑的直接测试佐证。Modpack 机制分组、导入导出与分享PackManager 是 Modpack 功能的核心PackManager.cs核心机制包括保存SavePack把当前Mods目录排除Disabled复制到ManagedFolder/包名/并写入packMods.json含名称、描述、作者与启用状态的 Mod 清单加载LoadPack区分叠加与独占两种模式加载前用CacheOldModsFolder备份当前 Mods 目录任何一步失败都会RevertToPreviousModsFolder完整还原导出SavePackToZip借助系统保存对话框把包目录压缩为.zip导入/分享ConvertToHPackage用 HPackage.Net 把包序列化为 Hollow Knight 标准包格式 JSON上传在线文本存储后得到SharingCodeImportPack则反向解析分享码导入重名包会被拒绝。Pack模型定义在 Pack.csIsSame/DeepCopy用于编辑后判断是否发生变化。加载包前还会检测游戏进程hollow_knight是否在运行必要时提醒用户关闭游戏。URL Scheme 命令远程控制与分享的通道README 中提到的 commands 即scarab://自定义协议。注册与解析在 UrlSchemeHandler.csWindows 上写注册表HKEY_CURRENT_USER\SOFTWARE\Classes\scarabLinux 上生成scarab.desktop桌面条目x-scheme-handler/scarabmacOS 则在编译期写入Info.plist见 Scripts/Lumafly.app/Contents/Info.plist。支持的命令枚举定义见 UrlSchemeCommands.cs如下命令用途download下载一个或多个 Mod格式为scarab://download/名称:链接/名称2:链接2reset重置已安装状态forceUpdateAll强制更新全部 ModcustomModLinks切换并使用自定义 modlinksuseOfficialModLinks切回官方 modlinksremoveAllModsGlobalSettings清空所有 Mod 的全局设置文件removeGlobalSettings移除指定 Mod 的全局设置文件launch启动游戏modpack导入某个分享码对应的 Modpacklocation定位/指定游戏目录download命令的解析器ParseDownloadCommand会对名称做非法字符校验、对链接做 URI 合法性校验非法输入直接拒绝解析非scarab://前缀或未知命令会弹出警告框。ModItem.Share()方法会把单个 Mod 编码进分享链接与 modpack 分享形成闭环。“最近更新”与反向依赖搜索最近更新由ModLinksChanges服务完成详见上文功能 4其IsLoaded三态布尔null未加载 /true成功 /false失败确保数据异常时界面不做无意义的展示离线模式或使用自定义 modlinks 时该功能自动关闭。反向依赖搜索ReverseDependencySearch.cs 提供三类查询GetAllDependentAndIntegratedMods依赖方 集成方、GetAllIntegratedMods仅集成方、GetAllEnabledDependents仅已启用的依赖方且依赖关系支持传递递归判断。这与 UI 中的SearchTypeNormal / DependencyAndIntegration / Integration见 SearchType.cs以及ModFilterStateAll / Installed / Enabled / OutOfDate / WhatsNew见 ModFilerState.cs筛选器配合能快速回答卸载这个 Mod 会影响谁、哪些 Mod 集成了这个 Mod等实际问题。本地化与字体本地化采用 Avalonia 标准的.resx资源机制Lumafly.csproj 中把所有Localizations\*.resx设为嵌入资源翻译工作通过 Crowdin 平台协作完成README Contributions 一节有说明。Program.cs 还针对不同语言做了字体覆盖中文使用内嵌的 Noto Sans SC、其余语言使用 Noto Sans字体文件位于 Assets/Fonts确保 CJK 字符渲染正常。网络容错与离线模式离线模式LumaflyMode枚举LumaflyMode.cs区分Online/Offline。离线启动时不拉取任何在线数据仅基于本地InstalledMods.json与已下载缓存工作仍可开关 Mod 与 API——这正是 README 描述的离线能力。IPv4 回退客户端WorkaroundHttpClient.cs 针对 .NET 默认双栈 socket 在某些网络/驱动下走 IPv6 失败的问题提供了强制 IPv4 连接的替代客户端RequiresWorkaroundClient为 true 时全程使用否则先试常规客户端、超时再回退HttpSetting.OnlyWorkaround / TryBoth。自更新机制AppUpdater.cs 负责应用自更新Windows 端基于 NetSparkleUpdater 读取 appcast.xml仓库根目录当前最新条目为 v3.3.0.0支持自动下载安装、重启后替换非 Windows 平台改为手动检查 GitHub Releases 的tag_name版本号高于本地版本时提示用户跳转下载。更新信息发布说明、下载链接、变更日志通过静态资源仓库的UpdateLinks.json动态下发无需发版即可调整。测试保障仓库自带的 Lumafly.Tests 覆盖了最关键的两条链路DatabaseTest.cs验证ModLinks.xml/ApiLinks.xml的 XML 反序列化、ModDatabase的 Item 构建以及三种状态未安装 / 已安装 / 过期的判定ModSourceTest.cs验证InstalledMods的持久化读写与版本一致即最新逻辑。它们使用System.IO.Abstractions.TestingHelpers的内存文件系统可在无真实游戏目录的情况下运行也间接证明了核心逻辑与具体文件系统解耦。参与贡献与社区生态按 README 的 Contributions 说明功能建议与 Bug 请走 Issues 页面想参与开发可关注 enhancement 标签下的待办功能本地化翻译请通过 Crowdin 平台提交。README 的 Credits 部分同时列出了项目渊源——基于 fifty-six 的 Scarab 开发以及来自社区的多语言译者与美术作者。结语从 README 的六项核心特性出发本文结合仓库源码把 Lumafly 拆解为一条清晰的实现主线modlinks 数据源驱动内容、Installer 负责文件级安装与切换、InstalledMods 持久化状态、PackManager 支持批量管理、URL Scheme 打通远程分享、离线模式兜底断网场景。无论你是普通玩家想正确安装和使用它还是开发者想为《空洞骑士》生态贡献一个 Mod 管理器插件或定制版本都可以从 README.md 起步再按本文给出的源码路径逐层深入。赞分享桌面应用游戏开发【免费下载链接】LumaflyA cross platform mod manager for Hollow Knight written in Avalonia.项目地址https://gitcode.com/gh_mirrors/lu/Lumafly点击查看免费下载相关推荐Lumafly跨平台空洞骑士模组管理完全指南Lumafly跨平台空洞骑士模组管理完全指南 您是否曾为安装空洞骑士模组时的繁琐步骤感到困扰Lumafly作为一款基于Avalonia开发的跨平台模组管理工桌面应用游戏开发Lumafly跨平台空洞骑士模组管理完全指南Lumafly跨平台空洞骑士模组管理完全指南 您是否曾为安装空洞骑士模组时的繁琐步骤感到困扰Lumafly作为一款基于Avalonia开发的跨平台模组管理工桌面应用游戏开发Lumafly跨平台空洞骑士模组管理完全指南Lumafly跨平台空洞骑士模组管理完全指南 Lumafly是一款基于Avalonia开发的跨平台模组管理工具专门为《空洞骑士》游戏设计。它让玩家能够轻松管桌面应用游戏开发上一篇SPT-AKI存档编辑器终极指南如何快速掌握你的塔科夫单机版游戏进度下一篇LX Music 桌面版聚合五平台音乐搜索与批量下载的上手指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
