NX2Apple 的版本历史，最新在上，每个版本的完整说明见发布页。English: CHANGELOG.md.
最新在上。本 fork 每天跟随上游，标「同步上游」的条目是自动来的。
| 日期 | 版本 | 变更 |
|---|---|---|
| 2026-11-01 | v1.0.1 | 壳 App 按镜像本身找到每个游戏（#441、#443）：iPhone 或 iPad 上共用的游戏数据文件夹不再要求每个游戏一个文件夹。每个游戏按它的 romfs.img 的标识匹配，在所选文件夹下两层以内查找，文件夹叫什么都可以。同步上游到 cd859c38（#444）：仅引擎本身现在能做到下面这些，出自上游的说明，我们没有在启动器里验证过：Donkey Kong Bananza（Switch 2，只测试到第一关，仅 Mac）和 Hollow Knight 可以运行，Dead Cells 有了配置，游戏可从装有其文件的文件夹构建，不再需要 prod.keys。启动器目前还不能构建 Switch 2 游戏，也不能从文件夹构建，见 #445。Mac 上按 Shift 加方向键可操作右摇杆。NVN 游戏需要 Xcode 27.2（#447、#444）：新引擎锁定了 Xcode 27.2 的 Metal 编译器，启动器会提示这一点。使用 Xcode 27.1 的玩家，构建游戏前请先更新 Xcode。修复：新引擎的「文件夹里有多个游戏」失败提示仍能被识别（#444） |
| 2026-10-31 | v1.0.0 | 引擎随发布版提供（#267）：发布版 App 把引擎放在自己的引擎仓里，并从中构建，不再克隆或拉取仓库。设置里显示引擎，有「检查」按钮、稳定版和实验版两个通道和自动更新开关。切换通道前会先询问。引擎附带签名的 latest.json，校验不通过就什么也不安装。iPhone 和 iPad 共用一个壳 App（#226）：一个 App 装下你所有的游戏，有以图为主的游戏库、横屏时的 Cover Flow、每个游戏自己的设置，以及手柄和键盘操作。iPhone / iPad 目标把游戏构建进壳 App，重签和重装都保留游戏数据和存档。启动器综合更新（#281）：游戏库可在「已拥有」和「已构建」之间切换，滑块偏离测试过的默认值时出现重置箭头，新版本以顶栏末尾的一个图标显示，Dock 图标显示正在运行的构建进度，主机模式先列出这台 Mac 能玩的游戏。设置里新增卸载功能，删除启动器的设置和引擎副本。游戏、存档和密钥保留，App 移到废纸篓。Mac 图标改用 Liquid Glass（#290）。Qt 前端采用 Mac 启动器的配色和 Manrope 字体（#222）。同步上游到 c5fe6b5d（#319）：Metal 4 管线特化、共享主机着色器在构建时编译、rewriter 扫描并行，并修复 NVN 缓冲区偏移与大小、附件容量和深度/模板配对。上游自己的全屏修复取代了我们的补丁。发布候选版（#332）：每个版本先作为候选版测试，玩家拿到的就是测试过的那个构建。修复：iPhone 云存档文件夹选择器每次点击只弹一次，点「打开」会保存文件夹（#321）、《塞尔达传说 王国之泪》1.4.2 不再两倍速运行（#311、#312）、《马力欧网球 ACE》通过 rewrite 步骤（#307），并修复共享字体加载后的崩溃（#314）、能找到 Documents/aoc 里的 iOS DLC（#319）、Windows 工具链检查写明修复办法，涉及链接探针、SDK 存根、Metal 与 Git 安装和锁定版本的 wheel（#206）、主机模式在鼠标静止时隐藏指针，并在游戏结束后再次请求全屏（#339）、引擎同步失败后 engine/ 恢复原状（#338）、未能应用的补丁不再被误认为上游已有（#323） |
| 2026-10-31 | v0.7.5 | Xcode 27.2 不再拦住游戏构建：Xcode 自动更新把 Metal 编译器升到 32023.922 后，NVN 游戏会在着色器步骤前停下。现在同一代里更新的编译器会放行，构建正常完成，日志里留一条说明。更旧或跨代的编译器仍会提示。App 版本是 0.7.3 或更早？请立即更新。 旧版 App 已经无法构建游戏，会提示 "Repository: not found"。安装这个版本后就能正常构建，游戏和存档都会保留（详见讨论 #306） |
| 2026-10-31 | v0.7.4 | 引擎改为独立获取（#273）：更新包不再打包引擎源码，上游修复在启动器里自动在线同步，不必等新版本发布。这需要能访问 GitHub，同步进度和失败原因都显示在启动器里。游戏语言改为菜单选择（#283），与 iOS 相同，默认「跟随系统」。启动器提速：页面切换（#297）、Options 和 Manage 弹窗（#294）、字体与按钮渲染。修复：主机模式从刚退出全屏的窗口启动游戏不再异常、游戏文件夹在 iCloud Drive 里时构建会被拦下并说明原因，因为 iCloud 会挪走构建缓存（#279）、主机模式下鼠标静止几秒后自动隐藏（#280）、「立即重启」改为由助手进程在旧进程退出后拉起新版本（#277）。如果你在 0.7.3 或更早版本上看到 Repository: not found，是旧版 App 的仓库校验与新的仓库布局不匹配。请更新到 0.7.4 并重新设置 |
| 2026-10-30 | v0.7.3 | 德语界面（#225），感谢 @kidziiii。存档：先在设备上找到游戏存档，再选择要同步的 iPhone 或 iPad（#260）。内置 zbic（#258）：读取 Nintendo zstd 变体模块所需，依赖检查也会确认它可用。修复：游戏本体在 nsp本体 之类子目录时能找到同级的更新包和 DLC（#240、#246）、「选择文件」对话框能选 NSZ / XCZ（#243）、安装到设备时不再传 --remove-existing-content，它会删掉设备上的游戏数据（#266）、Qt 版在中文 Windows 上不再显示成英文（#256）、金手指在 iPhone / iPad 上标明不可用（#257）、内置 Python 依赖改为哈希锁定（#259） |
| 2026-10-30 | v0.7.2 | 部分游戏打开后黑屏的问题修复（如《超级马里奥兄弟 惊奇》）：Mac 管线存档改为按本机系统版本生成，不再在首次启动时重新编译全部管线（上游 #673）。同步上游 26 个提交：sampler 边框颜色模拟、NVN 逻辑运算、同 pass 反馈快照自动识别等 |
| 2026-10-29 | v0.7.1 | 主机模式游戏直接全屏（#220、#219）：Play 强制 DM_FULLSCREEN，游戏窗口落到活动 Space 后即进入全屏，重新构建一次游戏即获得修复。游戏开在启动器所在显示器（#221，DM_SCREEN，在双显示器下编写并评审，但未做端到端实测）。按游戏打开的金手指面板（#218）。构建失败告诉你怎么做（#215）：keys、游戏文件、磁盘/卷、磁盘空间、签名和设备安装各自一行，写明原因并给出修复按钮。瘦身 iOS 构建带上你选的 DLC（#212）。更新页支持 Markdown（#216），无 ticket 的 NSP 从包内读标题 ID（#217）。修复：构建结束后启动器恢复空闲（#208）、多游戏文件夹稳定暂存（#209）、低于 3.12 的 venv 视为未就绪并能找到 mise 和 asdf 安装的 Python（#211）、Qt 前端退出崩溃（#224）、每日上游同步（#223） |
| 2026-10-29 | v0.7.0 | 主机模式（#169）：连接手柄后按 Select 或视图 → 主机模式，游戏库变全屏、手柄优先，有封面、启动选项、电量徽章和手柄列表（也可用 Option-Command-K）。云存档（#185）：游戏的 Mac 版和 iPhone 版通过一个 iCloud Drive 文件夹接力同一个存档，带 SHA-256 校验和按日期备份，双平台用王国之泪验证。引导式首次启动（#119、#120）与构建工具和 Python 内置在 App 里（#154），没人需要装 Homebrew。不重构建就能重装和保存 IPA…（#155）。免费 Apple ID 的签名到期提示与原地续签（#156）。构建失败变成行提示，写明原因和下一步（#166、#205）。瑞典语本地化（#168）、玩家版 README、Issue triage 报告模式（#143），Windows 依赖面板引导两个 Apple 下载并修复链接探针崩溃（#192、#196）。修复：Xcode 装了但没打开过成为独立状态并带一键修复、依赖安装失败说出原因和命令、bundle-ID 检查不再崩在别的用户的项目上、诊断块不再打印 (null)、更新器找到 uv 安装的 Python 且字符串在 CI 中不再丢失。已知问题：Mods 还没有用真正的 mod 实测过，Windows 完整构建流水线未在真机验证 |
| 2026-10-28 | v0.6.0 | 引导式首次启动：欢迎、平台、Xcode、密钥、游戏，一次管理员密码切换工具链，Metal Toolchain 和 iOS 平台带进度下载。构建工具和 Python 装在 App 里（zstd、glslangValidator、spirv-cross、xcodegen、CPython 3.13，来自 sha256 锁定的源码），没人需要装 Homebrew。不重构建就能重装（devicectl），保存 IPA… 导出给侧载器。签名到期与续签：游戏卡片显示免费 Apple ID 的剩余天数，续签按钮原地重签。设备检测知道游戏是否真的装在连接的设备上。玩家版 README（1900 词而不是 8000）、报告模式的 Issue triage 和日志急救。上游同步换成补丁队列，真正的三方合并。修复：Xcode 装了但未选中成为独立状态并带一键修复、依赖安装失败说出原因和命令、bundle-ID 检查不再崩在别的用户的项目上、诊断块不再打印 (null)、更新器找到 uv 安装的 Python |
| 2026-10-27 | v0.5.0 | Mac 启动器来了：启动选项存进游戏自己的选择存储（launcher.<VAR>，上游读的同一处），游戏库的 Manage 菜单用手柄就能打开，只有普通 Apple ID 也能安装，因为 Xcode 在第一次安装时自动创建证书。iPhone 的游戏数据终于稳了（书签在 Files App 的安全作用域被持有期间写入），没有数据的 App 直接进启动器而不是死页面。安装器在通过 USB 拷贝游戏文件前先询问。构建工具自己更新，连旧版 ZIP 拷贝也能接上（#87）。Issue 表单和 PR 模板要求报告所需的信息。修复：签名重试复用同一行、每个解包的游戏版本都作为构建资源保留、下一次上游同步能跑通且每个补丁器都在 CI 里对着真实上游测试。已知问题：Mods 还没有用真正的 mod 实测过，发布页不提供 Windows |
| 2026-10-27 | v0.4.9 | 游戏库跟着文件夹走：Mac 游戏的存档和日志放在 .app 旁边，首次运行自动从 ~/Library 迁移。iPhone 的游戏数据可以放任何位置（Files 应用选择器，自动记住）。追踪器八项需求全部落地（#77–#84：密钥预检、文件拖拽、构建通知、旧工具标记、空间回收、Mac 与设备存档互拷、复制诊断报告、手柄布局）。Windows：中文界面修复、中文用户名下 Metal 探针正常、依赖安装失败闪退修复、Vulkan SDK 自动识别 |
| 2026-10-27 | v0.4.8 | Mac 启动器真正可用了：把 iPhone 版装到配对设备（#28）、手柄导航整个启动器（#56）、启动选项分基础/高级（#54）并加上显示模式与真实像素的 Render scale（#55）、Mods 区走 DM_ROMFS_OVERLAY（#57）、键位与手柄按钮可自定义（#39）。启动时自动更新构建工具（#60），新版本会先说明改了什么再让你决定。修复：每一款游戏的每一次重写都会崩（patch_nso.py 的 TEXT_LO 先用后定义，#59）、Mac 版建什么都报「需要 Python 3.12」（#53）、一个文件夹多款游戏时一款都建不了（#58）、构建失败指向窗口外的日志（#52）、Windows 中文系统显示英文界面、CI 建不了 issue |
| 2026-10-27 | v0.4.7 | 79 个游戏 profile（+7：歧路旅人、大金刚国度 归乡 HD、大金刚国度 热带冻结）来自每日同步。一个宿主二进制适配任意游戏的内存布局（运行时 profile——为通用启动器打下的地基，启动器本身尚未开始）。语言切换现在翻译整个界面。Xcode Beta 也算数（检测改问 xcode-select）。上游更新导致 shader 缓存失效时会醒目提示。「输出目录」同时是构建缓存的位置已写明。Windows 前端：App 内装 Python 3.12、SDK 克隆突破 Windows 路径长度限制、LLVM 用试编译而不是 --version 验证、不再弹黑色命令行窗口。外置 exFAT 工作目录重建不再崩溃 |
| 2026-10-26 | v0.4.6 | Windows 版按真机反馈修好：.NET SDK 那一行以前根本不存在（所以永远装不上）、不再弹出黑色命令行窗口抢走焦点、下载走镜像并用测速挑最快的一个（真机上 LLVM 曾下 974 秒）、工具装到 App 目录外所以更新不再把它删掉、检查更新会说明 git 在做什么 |
| 2026-10-26 | v0.4.5 | 可输出 Mac App（同一次构建产出可双击运行的 .app）。支持 A15 / A16 及更早设备（CPU 解压 BC 纹理，App 内开关）。每游戏独立数据目录（Documents/games/<id>/），外置硬盘可用。NRO 头不再被当作代码扫描。每日同步不会再静默失败 |
| 2026-10-26 | v0.4.4 | 修复了 v0.4.3 里每个 App 构建都会失败的问题（work 在赋值前被读取），72 款游戏（+3） |
| 2026-10-26 | v0.4.3 | NSZ/XCZ 压缩格式开箱可用，全新 Xcode 会明说缺 iOS SDK，三个环境陷阱关掉 |
| 2026-10-25 | v0.4.2 | App 自己下载并更新仓库、也能更新自己，58 款游戏（+10），读档死锁修复，NuGet 报错自动恢复 |
| 2026-10-24 | v0.4.1 | 集合啦！动物森友会在 iPhone 上验证通过（103,645 文件 → 72 片），归档打包复用未变的成果 |
| 2026-10-23 | v0.4.0 | 归档文件夹直接可拷贝并附安装引导，依赖列表可折叠，表格列出每个游戏的所需版本，更名为 NX2Apple |
| 2026-10-23 | v0.3.1 | 修复 Homebrew Python 3.15 与 DOTNET_ROOT 问题（#1、#2） |
| 2026-10-22 | v0.3.0 | App 图标，46 款游戏 |
| 2026-10-21 | v0.2.1 | Python 3.9 构建修复 |
| 2026-10-20 | v0.2.0 | 中英双语 |
| 2026-10-20 | v0.1.0 | 首个版本：图形界面、RomFS 归档 |