Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.
Swift apple-siliconcustom-formathomebrewiosipaipadipadosiphonemetalnative-portnintendo-switchnxnativeromfsswitch-games
Agents attach screenshots with gh --attach
v0lumehi58d8bf0f3ef3
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.mdindex 811df71c..c81b5222 100644--- a/.github/copilot-instructions.md+++ b/.github/copilot-instructions.md@@ -9,5 +9,5 @@ Read [AGENTS.md](../AGENTS.md) and [CONTRIBUTING.md](../CONTRIBUTING.md) first;- No AI attribution anywhere: no "Generated with", no `Co-Authored-By` for a tool, in commits, PRs or issues.- Never attach or commit keys, game files or anything extracted from a game.- You work on a Linux runner and cannot build or run the macOS app. The macOS jobs of `tests.yml` are the check: do not claim a Swift or Metal change works until they are green.-- A PR that changes the launcher needs before and after screenshots. You cannot capture them: say so under Screenshots and ask for them in the PR (CONTRIBUTING.md, "For AI agents and other tools").+- A PR that changes the launcher needs before and after screenshots. You cannot capture them on a Linux runner: say so under Screenshots and ask for them in the PR (CONTRIBUTING.md, "For AI agents and other tools").- Issues and PRs follow the forms and the PR template (CONTRIBUTING.md, "For AI agents and other tools").diff --git a/.github/pull_request_template.md b/.github/pull_request_template.mdindex 81a05743..6a4c2da1 100644--- a/.github/pull_request_template.md+++ b/.github/pull_request_template.md@@ -19,7 +19,7 @@## Screenshots-<!-- A change to anything visible in the launcher (`frontend/` or `frontend-qt/`) needs before and after images of every view it changes, in the languages it touches. Attach them here. Captures from `NX_LAUNCHER_CAPTURE_DIR` are fine (`NX_CAPTURE_LANG=de` picks the language). A PR without them is not reviewed. -->+<!-- A change to anything visible in the launcher (`frontend/` or `frontend-qt/`) needs before and after images of every view it changes, in the languages it touches. Attach them here (`gh pr edit --attach <file>` uploads an image). Captures from `NX_LAUNCHER_CAPTURE_DIR` are fine (`NX_CAPTURE_LANG=de` picks the language). A PR without them is not reviewed. --><!-- With no visible change, write: None, no visible change. -->diff --git a/CLAUDE.md b/CLAUDE.mdindex 68289a5a..e78a526b 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -2,6 +2,6 @@- Read [AGENTS.md](AGENTS.md) first.- For an issue or a pull request, follow [CONTRIBUTING.md](CONTRIBUTING.md), section "For AI agents and other tools", and the templates in `.github/`.-- A PR that changes the launcher needs before and after screenshots: see "For AI agents and other tools" in CONTRIBUTING.md for how to capture and attach them.+- A PR that changes the launcher needs before and after screenshots: see "For AI agents and other tools" in CONTRIBUTING.md for how to capture them and attach them with `gh pr create --attach`.- `dm/`, `scripts/`, `docs/`, `ref/` and `AGENTS.md` are upstream plus the patch queue in `patches/`: a change there is a patch (`scripts/patches.py export`, see [patches/README.md](patches/README.md)), not a direct edit, and `scripts/patches.py check` fails otherwise.- **Commit with your own git identity.** Use the one configured for your clone, or your own name and email. AGENTS.md ends with `git -c user.name=seedds -c user.email=…`: that is seedds' own identity, written for his repository. Do not copy it unless you are seedds: it attributes your commits, and the `From:` line of patches made with `scripts/patches.py export`, to him (six commits on 2026-10-30 did, including `v0.7.2`, and patch 0033 in #230).diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 76a58416..6fb399a5 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -48,5 +48,5 @@ Issue forms and the PR template apply in the browser only. `gh issue create`, th- **Problem reports.** Write the body as `###` headings with the same names as the form's fields (for example `### Game, title ID and versions`, `### Copy diagnostics`, `### The game's log`) and fill every required field from [.github/ISSUE_TEMPLATE](.github/ISSUE_TEMPLATE). Ask the user for what you cannot read yourself: the Copy diagnostics output, the log, the versions. If a required field is missing, do not open the issue.- **Ideas and plans.** These have no form. Write plain sections that fit the content, for example `### Idea`, `### Plan` and `### Done when`. Leave out the problem fields (`This is`, `NX2Apple version`, `Computer and OS`, `Copy diagnostics`). Open it with the labels `idea` and `no-triage`.- **Pull requests.** Use the sections of [.github/pull_request_template.md](.github/pull_request_template.md): `gh pr create --template .github/pull_request_template.md`, or the same headings in `--body`. Answer each section and remove the `<!-- -->` hints. Under Fix or feature, tick one box. A change to a vendored path follows the rule above.-- **Screenshots.** A PR that changes the launcher needs before and after images in its body (see "A pull request"). On a Mac, capture the changed views of `frontend/` with `NX_LAUNCHER_CAPTURE_DIR=<dir> swift test` and `NX_CAPTURE_LANG` for the language (`de`, `sv` or `zh`, English is the default). `frontend-qt/` has no capture, so take its screenshots by hand. `gh` and the API cannot upload images. So an agent cannot attach them itself. Under Screenshots, say that, give the paths of the captures, and ask the user to attach them. Keep the PR a draft until the images are there. An agent without a Mac (a Linux runner) says under Screenshots that it could not capture the views and asks for screenshots in the PR.+- **Screenshots.** A PR that changes the launcher needs before and after images in its body (see "A pull request"). On a Mac, capture the changed views of `frontend/` with `NX_LAUNCHER_CAPTURE_DIR=<dir> swift test` and `NX_CAPTURE_LANG` for the language (`de`, `sv` or `zh`, English is the default). `frontend-qt/` has no capture, so take its screenshots by hand. Attach the images with `gh pr create --attach` or `gh pr edit --attach`, once per file. Write `` in the body and pass `--attach ./before.png`. `gh` uploads the file and rewrites the path to a `https://github.com/user-attachments/assets/...` URL. This needs `gh` 2.99.0 or newer, push access to the repository, and an OAuth or personal access token (a GitHub App token is rejected). Afterwards, read the body back and check that it holds the asset URLs and no local paths. If your `gh` or token cannot attach, say so under Screenshots, give the paths of the captures, and ask the user to attach them. An agent without a Mac (a Linux runner) says under Screenshots that it could not capture the views and asks for screenshots in the PR.- Never attach or commit keys, game files or data extracted from a game, and do not paste key values into a log or a diagnostics report.