docs(agents): add hostless unit-test conventions to NG2 AGENTS.md

2026-10-29 21:53:43 +00:00 · 2026-09-30 20:54:08 +08:00
parent ab5a153477
commit 913696941d
1 changed files with 9 additions and 0 deletions
@@ -1,3 +1,12 @@
 # ShadowsocksX-NG2

 新实现（2.0）所在目录。仓库级约定见根目录 [`AGENTS.md`](../AGENTS.md)；工程结构、外部二进制供应链、签名基线、构建测试命令、代码风格工具安装与基线版本见 [`README.md`](README.md)，本文件不重复。
+
+## Unit tests（hostless）
+
+单测不以 app 为宿主（ADR-0021）。两条约定：
+
+- 测试需要 app 产物（嵌入二进制、打包面 Info.plist 断言）时，一律经 `Tests/AppArtifact.swift` 定位。
+- 生产代码读取 app bundle 内打包资源（规则快照、LaunchDaemon 清单等）时，走注入缝——控制器的 `appBundle` 参数（生产默认 `Bundle.main`），测试夹具注入 `AppArtifact.bundle`。
+
+背景与三处资源缝的由来见 [ADR-0021](../docs/adr/0021-hostless-unit-tests.md)。