用途:当用户希望在当前对话中检查或驱动一个正在运行的 Flutter 应用时使用本技能,例如点击登录按钮、排查首页空白、截图分析问题,或通过 MCP 向智能体暴露应用内部状态。若问题与运行中应用无关(如架构、选包),则不适用。
使用方式:第一步先做预检,运行 flutter-mcp-toolkit doctor --json 并解析输出:status 为 ok 则进入下一步;若为 error 且 error.code 为 binary_not_found 或 vm_not_connected,则加载 flutter-mcp-toolkit-setup 按其说明安装或排障;其他错误则加载 flutter-mcp-toolkit-debug 查看错误信封处理手册。第二步按用户意图选择技能:读取状态加载 inspect,驱动 UI 加载 control,诊断加载 debug,注册应用专属 MCP 工具/资源加载 custom-tools,迁移旧版调用入口 API 加载 intentcall-migration。任务跨多个意图时可同时加载,技能是叠加的。
主要能力:工具分为只读检查类(如 discover_debug_apps、get_app_errors、get_screenshots、get_view_details、get_vm、semantic_snapshot 等)、变更交互类(如 tap_widget、enter_text、fill_form、scroll、hot_reload_flutter 等)、调试类(get_recent_logs、evaluate_dart_expression)以及应用自定义的动态注册表工具(fmt_list_client_tools_and_resources、fmt_client_tool、fmt_client_resource)。
限制:动态工具需应用内注册后使用;通过 CLI 调用时命令名仅作为 exec --name 的值,不能直接作为 MCP 工具调用。Harness 脚本、Maestro、促销或视频捕获由各自仓库负责,不在本插件内。工具调用失败时应查看返回的 error.code 与 error.recovery,完整恢复表见 flutter-mcp-toolkit-debug。