用途:把正在运行的 Flutter 应用当作真实用户来驱动,用于 UI 交互与快速迭代。主要能力包括:按语义引用点击/长按控件,向输入框填字并提交表单,滚动、滑动、拖拽、悬停(桌面/Web),让控件获得键盘焦点后按键,程序化导航(push/pop/popUntil),关闭对话框与底部弹层,以及热重载、热重启,或一次调用完成热重载加截图、语义快照与错误收集。
用法:多数交互工具以 semantic_snapshot 返回的 ref(如 "s_0")定位控件,需先快照、按 identifier、label、value、hint、type、actions 等字段扫描找到目标,再传入 ref 与 snapshotId;ref 仅对最近一次快照有效,树变化会返回 stale_snapshot。屏幕外目标可用 reveal_search 做有界快照、匹配、滚动循环,或先 scroll、swipe。多字段表单建议用 fill_form 一次填写,失败即停。等待可用 wait_for,支持 text、noText、time、stable 谓词。导航需应用设置 MCPToolkitBinding.instance.navigatorKey;对话框关闭仅支持 dismiss。热重载用 hot_reload_flutter(保留状态),热重启用 hot_restart_flutter(不保留状态),或 hot_reload_and_capture。
限制:ref 只在最新快照内有效;identifier 为整串区分大小写匹配,其他模式为不区分大小写子串匹配;press_key 不接受 Back 键,返回操作需用 navigate pop,桌面可用 Escape;hover 仅限桌面/Web,移动端无悬停概念;部分滚动或手势在无法测量偏移时会返回 verified: false;导航与对话框功能依赖 navigatorKey 配置,否则报未配置错误。未提供平台的完整支持范围、安装方式、收费与价格信息。