用途：诊断并解决 maui CLI 与运行中的、已注入 DevFlow agent 的 .NET MAUI 应用之间的连接问题。适用场景包括 maui devflow list 无 agent、maui devflow tree 报“Cannot connect to agent”、9223 或 broker 端口冲突、Android 模拟器连接问题、应用已运行但 DevFlow 命令失败。不适用于构建或部署失败、环境安装（可用 dotnet-maui-doctor）、连接成功后的视觉树查询、CDP/Blazor WebView 调试。
前提：已安装 maui CLI（dotnet tool install -g Microsoft.Maui.Cli）；应用已添加 Microsoft.Maui.DevFlow.Agent NuGet 包；应用需在目标设备或模拟器上运行。
主要流程：先确认 agent 集成，检查 csproj 中是否含该包，并在 MauiProgram.cs 中调用 builder.Services.AddMauiDevFlowAgent()；再查看 broker 状态 maui devflow broker status，未运行则 maui devflow broker start。平台连接方面，Android 模拟器需端口转发：adb reverse tcp:19223 tcp:19223 与 adb reverse tcp:9223 tcp:9223，可用 adb reverse --list 验证；iOS 模拟器共享主机网络无需转发，可用 xcrun simctl list devices booted 确认；Mac Catalyst/macOS、Windows、Linux(GTK) 均为 localhost 直连，可分别用 lsof -i :9223、防火墙规则、pgrep -f "YourApp" 排查。随后用 maui devflow list 查看 agent ID、应用名、平台与端口，用 maui devflow tree --depth 1 测试连接。
常见修复：无 agent 时检查包与初始化调用；Android 连接被拒时对两个端口执行 adb reverse；端口占用时用 lsof -i :9223 找到并结束进程；broker 未运行时启动它；应用启动崩溃时检查 DevFlow agent 版本与 MAUI 版本是否匹配。若恢复过程反复尝试 broker/list/wait/status、Android 转发绕行或直接端口回退，可询问用户是否运行 maui-devflow-session-review 汇总摩擦点，不要自动运行。