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

移动端相关内容/README.md

@@ -0,0 +1,25 @@
+# 奇妙小屏幕移动控制器
+
+本目录维护独立的 Kotlin Multiplatform（KMP）移动程序。首版是 Android 8.0+ 的 BLE 控制器，未来 iOS 复用业务和 Compose Multiplatform 界面，平台蓝牙与权限分别实现。
+
+## 阅读顺序
+
+1. [协作约定](AGENTS.md)
+2. [移动端需求](开发要求/移动端需求.md)：产品行为、范围和平台差异。
+3. [设备通信协议](开发要求/设备通信协议.md)：手机与设备的稳定契约。
+4. [安卓详细设计](安卓app/安卓开发详细设计.md)：模块、状态、异常与实现边界。
+5. [测试入口](安卓app/如何安卓测试/README.md)、[构建与发布](安卓app/构建与发布/README.md)。
+
+设备侧入口为 `../整体开发需求/`、`../核桃派软件源代码/README.md` 和 `../测试相关资料/如何测试/核桃派点阵屏控制服务测试流程.md`。
+
+## 维护边界
+
+- 设备版本、App 版本、协议版本分别管理。用户明确要求移动端功能迭代时才改动或发布 App；更新设备不得顺便升级手机程序。
+- 设备公共接口、驱动或部署调整必须评估移动端影响，记录在[跨端兼容记录](开发要求/跨端兼容与变更记录.md)。不影响契约的驱动内部调整不要求手机更新。
+- 首版不依赖网页 DOM、按钮名称或布局，也不直接操作 GPIO。设备公共业务层统一处理显示保护和状态。
+- 当前只允许 debug 签名。正式签名需要用户单独明确指令。
+- 本文及需求是实施契约，不是验收证据。已完成工作和未完成门槛以[实施状态](安卓app/测试结果归档/实施状态.md)为准。
+
+## 视觉检查
+
+普通前端、App 界面、BLE 入口开发没有改变驱动或显示输出实现时，不新增实屏视觉验收。协议、输出帧和驱动统计优先。确需视觉检查时先停止相关步骤，说明原因，询问用户如何启动并等待明确指示；不得自动开启摄像头、DroidCam、采集或视觉测试程序，不主动切换实屏测试图案。专用测试手机授权不等于视觉检查授权。不适用时记录“不适用”。