ModAVDExtras：路线和现状 #1

11-07 起由维护者自己做，不再找人接手。原来这里的交接稿（MAA issue 草稿、MaaCore 补丁全文、测量脚本）已经过时，删掉了：MaaCore 的改动以 MAA 的 PR 为准，旧稿在这个 issue 的编辑历史里能看到。

路线

1. 短期：AUTO-MAS 用本仓库 Release 里的兼容外壳 external_renderer_ipc.dll 冒充 MuMu 截图增强，导出、返回值和截出来的图都和旧伪装 DLL 一样。
2. 中期：MaaCore 有自己的 ModAVD 连接配置，从 ModAVD 根目录的 extras\ 载入 modavd_extras，不再冒充 MuMu，Windows、Linux、macOS 都能用。触控照旧用 MaaTouch。
3. 之后：宿主侧点击。有明确需求再做，开工前先写方案。

现在做到哪

Linux、macOS

• 11-09 有贡献者在 Apple Silicon 上实测了库（官方 Emulator 37.2.13，API 35 ARM64）：通知栏动态画面两轮各约 650 次采样全部成功，BGR、RGBA、上下翻转逐字节对得上。
  • 实测时 GuestAngle,Vulkan 下回读画面会崩溃，对应 host: Fix post callback readback without GL emulation google/gfxstream#190，测试时加了 -feature -VulkanNativeSwapchain 绕开。
• 实测发现的两个问题由 POSIX 连接先确认开流，截图拒绝未发布首帧 #8 修了（11-10 已合）：
  • 上次运行留下的共享内存被当成当前画面：POSIX 上打开时先经控制台开流；
  • 还没发布第一帧也当成截图成功：现在返回 MODAVD_E_NOT_READY。
• POSIX 连接先确认开流，截图拒绝未发布首帧 #8 让 Windows 上的 MuMu 外壳在第一帧前也返回失败，MaaCore 连上时会因此放弃这条路。MuMu 外壳在第一帧发布前照旧交出尺寸和黑图 #9 让外壳照旧交出尺寸和黑图，公开接口不变。
• Linux 上还没有在模拟器上实测。

以后：清理冒充 MuMu 的代码

MAA 和 MaaFramework 接 modavd_extras 的改动都合入并发版以后，冒充 MuMu 这条路就没用了，到时候一起删：

• 本仓库：兼容外壳 shim/mumu_shim.c、tests/test_shim.c，CMake 和 CI 里的 external_renderer_ipc 目标，Release 里的这个 DLL，README 的「兼容外壳」一节。
• AUTO-MAS：res/avdshim 里的外壳，以及让 MAA 把它当 MuMu 安装路径的配置，改走 MAA 的 ModAVD 连接配置。
• ModAVDManager：只有注释里提到，顺手改掉。

删了以后，旧版 MAA 在 ModAVD 上只剩 adb 截图，慢一些，但能用。

按需

• 防撕裂的新共享内存写法（要改模拟器）：真看到撕裂造成识别错误再做。
• 不再做的：测量脚本收进仓库，和 MFW AVDExtras 再做一轮对比测试。