AGENTS.md@androidA

AGENTS.md@android from jhaizhou-ops/s2arm is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add jhaizhou-ops/s2arm/android/AGENTS.md@git:20261111.edd424b

Pins git:20261111.edd424b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
jhaizhou-ops/s2arm
Path
android/AGENTS.md
Versions recorded
2
Latest version
git:20261111.edd424b, committed Nov 11, 2026
First version recorded
Nov 9, 2026
Size
4,001 bytes
Repository stars
3,578
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 给 AI 代理的说明:安卓线(android/)

先读仓库根目录的 [AGENTS.md](../AGENTS.md),那里的规矩在这里全部适用。本文件只补安卓线特有的说明,方向是:**安卓只做直连,不与 iOS 各写一套**。安卓直连追平 iOS 的任务总表在 #48。

## 1. 安卓只做直连

- 安卓线只做直连:NVN 款走 `android/native/nvn/`,Vulkan 类游戏走 `android/native/direct*`。
- 通用路径(`graphics/vulkan/` 的 Ryujinx 后端)不再为安卓修:安卓的问题不在通用后端里修,也不新增 `s2arm.graphics_mode=generic` 专用的逻辑。

## 2. 先分清你改的是哪一层

```
runtime/(装载、线程、改写器)              ← 共用:两端同一份源码
graphics/nvn/gfx/nvn/hle_nvn.c(NVN 前端)   ← 共用
回放层:命令解码、状态与脏位、池与别名、     ← 应当共用;目前 iOS 在 nvn_mtl.m,
  资源身份、管线变体、通道规划、节拍策略        安卓在 mtl_vk_shim.c / vk_record.c 另写了一套
nvn_gpu_* 后端(graphics/nvn/gfx/nvn/nvn_backend.h) ← 平台专属:只放 Metal / Vulkan API 调用
节拍源(nvn_vsync.h)                        ← 平台专属:DisplayLink / AChoreographer
```

收敛的设计和步骤(D0–D9)见 [docs/设计_回放核心共用.md](../docs/设计_回放核心共用.md)。

## 3. 尽量不分叉(建议)

共用层还没成形,下面是建议,不是硬约束。确实只能写在安卓侧的,在 PR 里说一句为什么。

- **新能力优先做到共用层。** 要加命令解码、状态跟踪、资源身份 / 别名、管线变体、节拍策略这类回放层能力时,先看 iOS 在 `graphics/nvn/gfx/nvn/nvn_mtl.m` 里怎么做,能抽到共用层就抽,或者做在 `nvn_gpu_*` 契约之下的 Vulkan 后端里;只能写进 `android/native/nvn/mtl_vk_shim.c`、`android/native/direct/vk_record.c`、`android/native/nvn/nvn_be_android.c` 的,PR 里说明原因。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jhaizhou-ops/s2arm/android/AGENTS.md@sha256:b2d9f9d3d5eb1bd2

The line at the top of this page pins the label git:20261111.edd424b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tr4ldr4yux2qxxge.svg)](https://markdownregistry.com/a/art_tr4ldr4yux2qxxge)

1 badge image fetches in 30 days. What the badge shows.

Ask from your agent
claude mcp add --transport http markdownregistry https://markdownregistry.com/mcp/registry

Then ask it: what changed in jhaizhou-ops/s2arm/android/AGENTS.md since the version I have? It reads every saved version here, no key and no account. Any agent that speaks MCP can add it.

Got a copy of AGENTS.md from somewhere else? Ask it: where did my AGENTS.md come from, and what was changed? It names the public original, the version yours is closest to and every changed line. The text is not kept.

Versions

The registry has recorded 2 versions of this file, between Nov 9, 2026 and Nov 11, 2026, about one every 2 days.

Watch this file (sign in, one email per new version)

versioncommittedcommitsizeaudit
git:20261111.edd424b latest2026-11-11 edd424b 4,001 BA view · diff
git:20261109.4e7347d2026-11-09 4e7347d 4,018 BA view
Check a whole project

From the root of your project, one line hashes each installed skill's SKILL.md, your AGENTS.md and your CLAUDE.md, and asks the registry once. Only the fingerprints and paths are sent.

sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --data-binary @- https://markdownregistry.com/api/v1/check-copies

In CI, add --fail-with-body: the answer is 409 when any file is behind, so the step fails and still prints which files.

sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --fail-with-body --data-binary @- https://markdownregistry.com/api/v1/check-copies

No sha256sum on your machine? shasum -a 256 prints the same lines.

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (4001 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

jhaizhou-ops/s2arm · 3,578 stars · license Apache-2.0 · pushed 2026-11-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tr4ldr4yux2qxxge
GET https://markdownregistry.com/api/v1/resolve?ref=jhaizhou-ops/s2arm/android/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/b2d9f9d3d5eb1bd24caa63d2b827ab5bbd05e293704aae7562b8c7aabd19e454

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from jhaizhou-ops/s2arm

AGENTS.md AGENTS.md file
jhaizhou-ops/s2arm · AGENTS.md
git:20261112.11c850a · audit A · 3,578 stars
DESIGN.md@launchers/macos/frontend DESIGN.md file
jhaizhou-ops/s2arm · launchers/macos/frontend/DESIGN.md
git:20261115.00bc010 · audit A · 3,578 stars
s2arm-operator SKILL.md skill
jhaizhou-ops/s2arm · launchers/macos/skill/s2arm-operator/SKILL.md · 替玩家操作 S2Arm(把玩家自己的 Switch 游戏导出成 iPhone / iPad 或 Mac 能玩的版本、装到手机上的启动器):从下载启动器、导入密钥和游戏、导出、装到 iPhone,到排查每一步出的问题。玩家说「用 S2Arm…
git:20261114.9dade34 · audit A · 3,578 stars
fps-power-triage SKILL.md skill
jhaizhou-ops/s2arm · skills/fps-power-triage/SKILL.md · 读 S2Arm 一局(或关 / 开两局)的局目录,判帧率格、能耗格过没过,定位帧率低 / 耗电高 / 60 帧没生效 / 60 帧逻辑变快卡在哪一处;用于外部贡献者在自己机器上自查、自纠。
git:20261108.3925321 · audit A · 3,578 stars
gfx-triage SKILL.md skill
jhaizhou-ops/s2arm · skills/gfx-triage/SKILL.md · S2Arm 画面问题分诊与根修:拿到「花屏 / 贴图错 / 闪烁」「不满屏 / 宽屏两侧异常 / 拉伸」「没走直连 / 直连异常」任一类问题时先读本 skill。按症状分到三份排查手册,读 host.log…
git:20261108.3925321 · audit A · 3,578 stars
native-triage SKILL.md skill
jhaizhou-ops/s2arm · skills/native-triage/SKILL.md · 定位并根修 S2Arm 原生层 / 服务层问题:崩溃(含收局崩)、进不去或游戏 Break、系统服务回答不对。拿到一份 host.log(或一段帧栈 / 结果码)时用:按日志行分类,把游戏模块偏移符号化,对齐 Ryujinx…
git:20261108.3925321 · audit A · 3,578 stars
nvn-wire SKILL.md skill
jhaizhou-ops/s2arm · skills/nvn-wire/SKILL.md · S2Arm 的 NVN 语义与教训参照:实现或修零配置直连 NVN 前端(graphics/nvn)里任何一个 NVN 函数、对象或命令之前先查本 skill 的 references/。附带从小菠萝(三周 NVN→Metal…
git:20261108.3925321 · audit A · 3,578 stars
player-game-triage SKILL.md skill
jhaizhou-ops/s2arm · skills/player-game-triage/SKILL.md · 玩家的 AI 自查自修 S2Arm 游戏内问题的入口:游戏已经装好、能打开,但画面不对(花屏 / 闪烁 / 模型不见 / 黑边 / 拉伸)、帧率低 / 卡顿 / 耗电、游戏速度不对、闪退 / 卡死 / 进不去时先读本…
git:20261116.fb1fb3b · audit A · 3,578 stars
s2arm-rootfix SKILL.md skill
jhaizhou-ops/s2arm · skills/s2arm-rootfix/SKILL.md · S2Arm 通用根修方法论:修任何缺陷、做任何会改行为的改动之前先读本 skill。规定从「这件事要证明什么」出发,先量再猜、找到给错值的机制、对齐 Ryujinx 上游真值、先写会红的单测、做负对照、报射程,最后按 PR…
git:20261110.bd354e2 · audit A · 3,578 stars
widen-judge SKILL.md skill
jhaizhou-ops/s2arm · skills/widen-judge/SKILL.md · 审核同一录像的 16:9 与显卡侧放宽证据,识别拉伸、错位、界面越界、亮带、闪烁和不合理外延;用于 S2Arm 出包前的第三层宽屏判定。
git:20261108.3925321 · audit A · 3,578 stars

Every file in jhaizhou-ops/s2arm

Other files named AGENTS.md@android

AGENTS.md@android AGENTS.md file
omnesis-dev/omnesis · android/AGENTS.md
git:20261112.7149999 · audit A · 53 stars

Browse by kind, by grade A, or by owner.