Skip to content

Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.

Agents: keep personal workflow rules out of the repository

v0lumehia613a4f22a4c
diff --git a/AGENTS.md b/AGENTS.md
index d2a84320..d8cb336a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -13,6 +13,5 @@ This is the fork's guide. The engine has its own, upstream's: [engine/AGENTS.md]
- **Merging with admin rights.** An admin merge never goes over a red check. That holds even when @LNPANDY overrides an objection. If a re-review is slow, the other maintainer pings the reviewer and does not merge with admin rights.
- **Mac launcher layers.** `frontend/` is four SwiftPM targets (`NXCore`, `NXModel`, `NXLauncher`, `NX2Apple`) and the compiler enforces which may import which. Read [frontend/ARCHITECTURE.md](frontend/ARCHITECTURE.md) before you add a file to `frontend/Sources`. It says where a new feature goes. `BuildModel` is gone: the stores are in `NXModel` and `LauncherStores` only wires them. No Swift file there is above 800 lines (`SourceSizeTests`), and the larger ones may only shrink.
- **Checks.** `cd frontend && swift build && swift test` for the Mac launcher (its tests read `engine/`, so sync first), `python3 -m unittest discover -s frontend-qt/tests` for the Qt front end, `python3 -m unittest discover tools/tests` for the tools. The engine's own tests run in `engine/` as `tests.yml` does. The pre-commit hook runs `python3 tools/engine.py check` when `patches/` or `.upstream-ref` is staged. The pre-push hook runs the checks above for the files the push changes, `tools/githooks.py` has the list. Fix the failure, do not bypass the hook.
-- **No long sleeps.** A command never sleeps longer than 60 seconds. Poll a build, a workflow or a download with sleeps of 60 seconds or less, do other useful work in between, and report interim progress instead of leaving the chat silent.
- **Language and text.** Everything is in English except the Chinese pages (`*.zh-CN.md`) and the launcher's strings. No semicolons in UI strings, READMEs and docs. The launcher's strings are not in Swift or Python code. They are one JSON file per language in `frontend/l10n/`, read by the Mac launcher and the Windows launcher. A new string is a line in `en.json` and `zh.json` (English and Chinese have every key, the other languages may miss one and then show English). The language list is in the files too (the `_language` entry: name, locale prefixes, order). `Lang` is not an enum, so a new language is one new file under `frontend/l10n/` for the Mac and Windows launchers (the iOS shell's texts are in the same files under `ios.ui.` and `ios.host.`, and `python3 tools/l10n_shell_catalogs.py` writes the shell's `Localizable.xcstrings` from them, never edit those by hand). The files go into the apps by the build workflows, see `frontend/README.md`, section "Language".
- **Release notes.** They follow `.github/release_notes_template.md`, English first, then Chinese, no emojis.