用途:为 AI 智能体提供 .NET MAUI 及 MAUI Blazor Hybrid 应用的端到端工作流,实现构建→部署→检查→修复→重建的完整反馈闭环,全部通过终端命令完成。
主要能力:检查项目是否集成 DevFlow;启动并等待智能体连接;查看 UI 树、查询元素、读取与实时修改属性;对 Entry、按钮等执行填充、点击、清空;对 Blazor WebView 做 DOM 快照、填表、点击与执行 JS;抓取 ILogger 与 WebView 控制台日志;屏幕录制;监控 HTTP 请求;读写 Preferences 与 Secure Storage。
必要用法:先安装工具,dotnet tool install --global Microsoft.Maui.Cli(或 update),Android 需 androidsdk.tool,iOS/Mac 需 appledev.tools;用 maui devflow --version 验证。项目需添加 Microsoft.Maui.DevFlow.Agent 等 NuGet 包并在 MauiProgram.cs 的 #if DEBUG 中注册。构建前用 grep 检测 TFM,再执行 dotnet build -f $TFM-ios -t:Run -p:_DeviceName=:v2:udid=<UDID> 等命令,随后必须运行 maui devflow wait 等待连接,不要用 sleep。Android 需 adb reverse 端口转发。
适用场景:iOS/Android/Mac Catalyst/macOS AppKit/Linux GTK 上的 MAUI 应用调试,多项目并行时可为每个项目分配独立模拟器。
限制:maui devflow list 只反映运行时连接状态,不代表项目集成情况;模拟器需匹配 TFM 最低版本;网络监控仅覆盖 IHttpClientFactory 流量,非 DI 的 HttpClient 需用 DevFlowHttp.CreateClient();录制同一时间仅一个;Windows/Linux 录制依赖 ffmpeg。部分细节(如偏好键说明)资料未完整提供。