用途：在 MAUI 应用已集成 DevFlow 包并注册 builder.AddMauiDevFlowAgent() 后，执行主动调试循环。
主要能力：在 Android、iOS、Mac Catalyst、macOS、Windows 或 GTK 上构建并运行 MAUI 应用；为项目选择或创建模拟器/仿真器；等待 DevFlow 代理、检查可视化树、点击/填写 UI、截图；在集成后恢复 DevFlow 连接失败（含 broker、端口、Android adb 转发）；通过 DevFlow WebView/CDP 命令调试 Blazor Hybrid 内容；读取应用日志、网络抓取、偏好设置、设备信息或录制；以构建→部署→检查→修复循环迭代应用缺陷。
使用方式：先确认已集成，例如 grep -rl "Microsoft.Maui.DevFlow" --include="*.csproj" .；若没有包引用则改用 maui-devflow-onboard。检查目标框架，不要假设 net10.0，例如 grep -i "TargetFramework" *.csproj Directory.Build.props 2>/dev/null。启动或选择设备/模拟器，避免复用正在运行其他待查应用的模拟器。启动应用并在需要时保持启动进程存活：iOS、Android 和 Mac Catalyst 的 dotnet build -t:Run 通常阻塞至应用生命周期结束；GTK 的 dotnet run 阻塞至应用生命周期结束；macOS AppKit 构建可能在编译后退出，需单独启动 .app。检查 UI 前等待代理：maui devflow wait 与 maui devflow ui tree --depth 3 --fields "id,type,text,automationId"。若无法连接，加载 references/connectivity.md 恢复 broker/代理连接。
限制与注意：空的 maui devflow list 不代表项目未集成，list 是运行时状态，项目文件才是事实来源；不要用任意 sleep，应使用 maui devflow wait 等待代理连接；不要杀死仍需要的异步 dotnet build -t:Run 或 dotnet run shell；不要复用繁忙的模拟器/仿真器；不要仅通过原生可视化树调试 Blazor WebView DOM 问题，应使用 WebView/CDP 命令。缺少包引用或 AddMauiDevFlowAgent() 时停止并改用 maui-devflow-onboard；多个候选匹配时先询问目标项目、设备或代理；两次相同失败后先检查首个有意义的构建/运行时错误；不要用截图获取精确属性值，应查询可视化树或属性。参考文档按需加载：setup.md、connectivity.md、android.md、ios-and-mac.md、macos.md、linux.md、batch.md、troubleshooting.md。