同步移动端工程、设备控制改进与发布资料

AGENTS.md

@@ -21,6 +21,10 @@
 
 ## 2. 需求与测试编号
 
+移动端是独立维护的程序，入口为 `移动端相关内容/README.md`，协作规则见 `移动端相关内容/AGENTS.md`。本轮已授权 Android 首版；未来设备端更新不得自动迭代或发布 App。设备公共接口、协议、驱动边界及部署变化必须在 `移动端相关内容/开发要求/跨端兼容与变更记录.md` 登记影响；对外契约不变的驱动内部修改不要求手机更新。App、设备及协议分别管理版本。正式 APK 签名只在用户明确命令后执行，当前只允许 debug 签名。
+
+移动测试设备真实登记唯一位置为 `移动端相关内容/安卓app/如何安卓测试/测试设备登记/测试设备.local.json`，精确忽略；提交同目录空白 `测试设备.example.json` 和门禁脚本。此登记只存手机测试信息，不复制核桃派或开发机凭据；自动化前检查登记及 ADB 授权，不回显真实设备标识，不覆盖已有登记。
+
 - `WEB-*`：网页、REST、WebSocket、交互和安全入口。
 - `DISPLAY-*`：显示服务、帧、方向、字体、动画、mock 与 H618 真实驱动。
 - `CONFIG-*`：schema、默认值、迁移、持久数据和损坏保护。
@@ -36,7 +40,9 @@
 - 核桃派无负载验证编译、寄存器映射、线程调度、双缓冲、截止统计和异常清屏；在该门槛通过前禁止接屏。
 - HUB75 实屏测试按全黑、红、绿、蓝、白、四角、关键行、方向、文字、图片、动画逐项执行；上一项失败就停止，只排查对应线组。
 - ADC 测试按总线、地址、原始读取、同点万用表校准、正常档、单个低压档、恢复逐项执行，不合并人工动作。
-- 有清晰摄像头时由 Codex 判断；画面缺失或有拍频、曝光、视角歧义时必须等待用户确认。
+- 普通网页前端、手机界面、BLE 控制入口开发没有改变驱动或显示输出实现时，不新增实屏视觉验收；优先协议、状态、输出帧与驱动统计，不适用时记录“不适用”。
+- 仅在驱动、扫描时序、底层输出变化或具体显示异常确需视觉证据时提出视觉检查。必须先停止相关步骤、说明原因、询问用户下一步如何启动，并等待本次明确指示；不得自动启动 DroidCam、摄像头、采集或视觉测试程序，也不得主动切换实屏测试图案。专用测试手机的一般自动化授权不能替代此门禁。
+- 用户明确启动后，有清晰摄像头时可由 Codex 判断；画面缺失或有拍频、曝光、视角歧义时仍等待用户确认。
 
 ## 4. 人工停顿与电气安全
 
@@ -92,3 +98,7 @@
 - 普通开发不检查历史 IMG 是否齐全；只有用户明确要求处理某个镜像时，才核对该任务实际需要的输入文件。官方基线和其他离线依赖按各自规则管理。
 - 仓库内描述工作区文件时使用相对路径或 `<仓库根目录>`、`<受保护临时目录>` 等文字占位符，不固化盘符、Windows 用户目录、macOS 用户目录或开发者 home。核桃派上的 `/opt`、`/var/lib`、`/run`、`/boot`、`/usr/local` 等固定部署路径不属于此限制。
 - 正式 IMG 通过仓库外的发行渠道保存，根 `.gitignore` 必须忽略所有 `*.img`；Git 只保留对应 README、manifest、SHA-256、发布记录等元数据，不得让源码、文档命令或后续构建依赖仓库中存在 IMG。OTA、离线依赖、编辑器程序和历史归档仍由私有 Git 仓库保留，大体积二进制可使用 Git LFS；秘密、本机状态、运行数据和可再生缓存继续按各自规则排除。
+
+## 9. 测试经验与交付反馈
+
+每轮测试完成后，将测试中遇到的问题及已验证解法补到对应可重复测试流程、排障指南或构建文档，防止后续重复试错；单次失败证据、恢复及重测结果留在测试归档。已知问题先查已有经验，不把未证实推测固化成根因。最终反馈说明经验更新位置和仍未解决的边界；没有新增经验时沿用已有记录，不重复复制。文档不得包含真实凭据、测试设备标识或开发机绝对路径。