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