NX Library：Mac 游戏库与启动器

项目简介

NX Library 是一个独立的 SwiftUI 前端，为外部的 nxnative 工具链提供 Mac 原生的游戏库与启动器界面。它把已安装的游戏 App、本地构建流程和游戏选项集中到一处，界面风格参考 Selene。

项目当前为 0.1.3.3 alpha，采用 MIT 许可证。

主要功能

模块	能力
游戏库	在 Spotlight 与 Collection 两种视图中浏览游戏，支持搜索、收藏、隐藏和排序
本地构建	选择自己的来源文件，检查更新与 DLC，查看构建进度，失败后可重试
游戏选项	为每个游戏保存启动设置、封面和元数据
存档	备份本地进度，预览导入并恢复之前的副本
金手指	导入匹配的 cheat 文件，并选择下次启动时启用哪些
个性化	选择配色、壁纸、动态背景、界面音效和手柄按键提示

支持手柄导航，并针对 Apple Silicon 优化。

安装与使用

环境要求

• Apple Silicon Mac，macOS 13 或更高版本
• Xcode 27.2 或更高版本（含与引擎匹配的 Metal 编译器）
• .NET 10 SDK（引擎的提取器使用）
• nxnative 引擎（可在 Setup 中准备检出，也可在 Settings → Engine 选择已有目录）
• 自己的游戏来源文件与密钥，以及使用它们所需的授权

从源码构建

git clone https://github.com/Bium23/NxLibrary.git
cd NxLibrary
bash scripts/bundle_runtime.sh
bash scripts/build_app.sh

bundle_runtime.sh 只需运行一次，runtime.lock 变化时再运行。build_app.sh 会准备、签名并校验 App，然后安装到 ~/Applications。

安装打包版本

1. 从 Releases 下载 DMG。
2. 打开 DMG，把 NX Library 拖入 Applications。
3. 打开 App，完成 Setup。

首次设置

Setup 分为 Get ready 与 Your games 两步。前者检查引擎、构建工具和密钥，Install all 可处理引擎检出、Metal 编译器和官方 .NET 安装器；Xcode 需自行从 App Store 安装。后者设置 Game apps 文件夹（默认 ~/Applications），可选择 NSP、XCI、NSZ、XCZ 文件或来源文件夹。

导入 prod.keys 时，NX Library 会保留一份权限为 0600 的私有副本，不修改原文件，也不显示或记录密钥内容。

添加或重建游戏

1. 打开 Add game，选择或拖入受支持的文件或文件夹。
2. 检查识别出的基础游戏、更新与 DLC。
3. 确认目标位置、磁盘占用估算和游戏选项。
4. 选择 Add and port 开始构建，或 Add to library only 仅保留条目。

来源文件保留在原位，暂存工作区使用符号链接。构建过程中关闭移植界面不会中断任务，取消是单独的操作。

注意事项

• 项目不提供游戏文件、密钥或固件，需自行准备并确保拥有相应权利与许可。
• 当前 alpha 版本为 ad-hoc 签名且未公证。若 macOS 阻止首次打开，仅对你自行构建或信任来源的副本使用 系统设置 → 隐私与安全性 → 打开方式。
• 打包版本会检查本仓库的应用更新，最多每 24 小时自动检查一次，也可通过菜单栏 NX Library → Check for Updates… 或 Settings → About → Check now 立即检查。
• NX Library 不会运行 sudo、代替你接受 Xcode 许可协议或修改 xcode-select。
• 若已安装的 App 被移动或删除，库中条目会保留为锁定状态并显示 App not found；把它放回原文件夹或修改 Game apps 后刷新即可。

---

本作品整理自 GitHub 开源项目 Bium23/NxLibrary，原作者 @Bium23，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。