v0.7.1 — 主机模式全屏、金手指、失败行卡片 / Console fullscreen, cheats, failure rows

What this release does

Console mode becomes a real console, and the launcher tells you what to do when a build fails. Play from console mode starts the game fullscreen on the launcher's display, like a Switch docked to a TV; a cheats sheet opens per game; a failed build gets rows for keys, game files and the build's own steps, each with the next step and a button that does it. The update page reads its release notes as Markdown, an NSP without a ticket gives its title ID from the package itself, and a batch of build-flow papercuts is fixed.

New

• Console mode starts games fullscreen (#220, #219, seedds/nxnative#665): Play from console mode forces DM_FULLSCREEN, and the game's window enters fullscreen once it is on the active Space — no more windowed games in the TV mode. The console options sheet no longer offers the Display row (console is always fullscreen); the desktop launcher's launch options still control it there. Games keep the host they were built with: a game rebuild picks the fix up.
• The game opens on the launcher's display (#221, seedds/nxnative#670): with two displays the window now opens where console mode was started (DM_SCREEN).
• Cheats (#218, seedds/nxnative#406): a per-game cheats sheet in the launcher — enable, edit and manage cheat files, carried with the upstream engine work.
• Build failures say what to do (#215): the failure card has rows for keys, game files, drive, disk space, signing and the device install — each names the cause and offers the button that fixes it (choose keys, show folder, open Xcode, try again).
• Slim iOS builds carry the DLC you pick (#212): the selected DLC's add-on content reaches the game folder and the app finds it there.
• The update page reads Markdown (#216): release notes with links render as links.
• An NSP with no ticket gives its title ID from the package (#217): the title ID is read from the package's own meta NCA when the ticket and the file name are no help.

Fixes

• The launcher goes idle after a build (#208): the build log's pipes detach at the end of the output instead of holding the app busy.
• A folder with several games stages cleanly (#209): multi-folder game files are staged in a stable folder per game.
• Python detection (#211): a venv below 3.12 is not ready; Pythons installed through mise and asdf are found.
• Qt front end: the shutdown crash is gone (#224).
• Upstream sync (#223): the daily host and profile fixes.

Known issues

• The dual-display placement (DM_SCREEN) was written and reviewed with two displays but not validated end-to-end on one; a report from a two-display setup is welcome.
• Route C M1 (the game's modules as an optional framework) is still in review.

Install

• macOS: download NX2Apple-macOS-arm64.zip, unzip, right-click → Open (first time). In-app updates work under the NX2Apple name since 0.4.9.
• Windows: not on this page; the Qt front end is in the Actions artifacts.

Credits

• v0lumehi: the fullscreen host fix, the display placement, the cheats sheet, the failure rows, the Markdown notes, the NSP title ID, the Python detection, the stable staging, the log-pipe fix, the slim DLC, the Qt shutdown fix — eleven reviewed PRs.

---

这一版做了什么

主机模式成为真正的"主机"，构建失败时启动器告诉你下一步。 主机模式下按 Play，游戏像插到底座上的 Switch 一样直接全屏打开；每个游戏有了金手指面板；构建失败卡片列出 keys、游戏文件和构建步骤各自的问题行，每行带下一步和一键修复按钮。更新页的发布说明按 Markdown 渲染，无 ticket 的 NSP 从包内读标题 ID，另有一批构建流程的小毛病修复。

新增

• 主机模式游戏直接全屏（#220、#219，上游 seedds/nxnative#665）：主机模式 Play 强制 DM_FULLSCREEN，游戏窗口落到活动 Space 后即进入全屏——电视模式下不再出现窗口化的游戏。主机选项页不再提供"显示"行（主机恒为全屏）；桌面启动器的启动选项照常控制。游戏保留构建时的 host：重新构建一次游戏即获得修复。
• 游戏开在启动器所在显示器（#221，上游 seedds/nxnative#670）：双显示器下窗口现在开在主机模式启动的那块屏（DM_SCREEN）。
• 金手指（#218，上游 seedds/nxnative#406）：启动器内按游戏打开的金手指面板——启用、编辑、管理金手指文件，随上游引擎工作一起带来。
• 构建失败告诉你怎么做（#215）：失败卡片新增 keys、游戏文件、磁盘/卷、签名和设备安装各自行——每行写明原因，并给出对应修复按钮（选 keys、显示文件夹、打开 Xcode、重试）。
• 瘦身 iOS 构建带上你选的 DLC（#212）：所选 DLC 的追加内容进入游戏文件夹，App 能在原地找到它。
• 更新页支持 Markdown（#216）：带链接的发布说明按链接渲染。
• 无 ticket 的 NSP 从包内读标题 ID（#217）：ticket 和文件名都帮不上时，标题 ID 从包自己的 meta NCA 读取。

修复

• 构建结束后启动器恢复空闲（#208）：构建日志管道在输出结束时断开，不再占着应用。
• 多游戏文件夹稳定暂存（#209）：多文件夹游戏文件按游戏暂存到稳定文件夹。
• Python 检测（#211）：低于 3.12 的 venv 视为未就绪；通过 mise 和 asdf 安装的 Python 能被找到。
• Qt 前端：修复退出崩溃（#224）。
• 上游同步（#223）：每日的 host 与游戏档案修复。

已知问题

• 双显示器定位（DM_SCREEN）在双屏环境下编写并评审，但未做端到端实测；欢迎双屏用户反馈。
• 路线 C M1（游戏模块作为可选 framework）仍在评审。

安装

• macOS：下载 NX2Apple-macOS-arm64.zip，解压后右键 → 打开（首次）。0.4.9 起 App 内更新在 NX2Apple 名下正常工作。
• Windows：本页不提供；Actions 产物里有 Qt 前端。

致谢

• v0lumehi：全屏 host 修复、显示器定位、金手指面板、失败行卡片、Markdown 说明、NSP 标题 ID、Python 检测、稳定暂存、日志管道修复、瘦身 DLC、Qt 退出修复——十一个经过评审的 PR。