flutter-skill

flutter-skill

让任何 AI Agent 都能在任何正在运行的应用中看见并操作。
10 个平台。无需编写测试代码。一个 MCP 服务。

演示 • 快速开始 • AI 平台 • 平台 • 与其他方案对比 • 文档

🚀 无需配置。无需编写测试代码。只需与 AI 对话。

_{如果它为你节省了时间，请考虑为仓库点个星 ⭐ — 这能帮助更多人发现它！}

30 秒演示

https://github.com/user-attachments/assets/d4617c73-043f-424c-9a9a-1a61d4c2d3c6

一句提示词。28 个 AI 驱动的操作。无需编写测试代码。 AI 自主探索 TikTok 克隆应用、切换标签页、滚动信息流、测试搜索、填写表单。

为什么要做这个

编写 E2E 测试很痛苦。维护测试更痛苦。flutter-skill 采用了另一种方式：

• 🔌 通过 MCP 将任何 AI Agent（Claude、Cursor、Windsurf、Copilot、OpenClaw）直接连接到正在运行的应用
• 👀 Agent 可以看到你的屏幕 — 点击按钮、输入文字、滚动、导航，就像永不休息的人类测试人员
• ✅ 无需编写测试代码 — 不需要 Page Object、XPath 或脆弱的选择器，只需使用日常语言
• ⚡ 无需配置 — 只需 2 行代码，适用于全部 10 个平台

You: "Test the checkout flow with an empty cart, then add 3 items and complete purchase"

Your AI agent handles the rest — screenshots, taps, text entry, assertions, navigation.
No Page Objects. No XPath. No brittle selectors. Just plain English.

快速开始

1. 安装（30 秒）

npm install -g flutter-skill

2. 添加到 AI（复制并粘贴到 MCP 配置中）

{
  "mcpServers": {
    "flutter-skill": {
      "command": "flutter-skill",
      "args": ["server"]
    }
  }
}

适用于 Claude Desktop、Cursor、Windsurf、Copilot、Cline、OpenClaw — 以及任何兼容 MCP 的 Agent。

3. 添加到应用（Flutter 只需 2 行代码）

import 'package:flutter_skill/flutter_skill.dart';

void main() {
  if (kDebugMode) FlutterSkillBinding.ensureInitialized();
  runApp(MyApp());
}

4. 测试 — 只需与 AI 对话：

“启动我的应用，探索每个屏幕，并报告任何错误。”

就是这么简单。无需配置，无需编写测试代码，60 秒内即可运行。

与 AI 平台搭配使用

MCP 服务模式（IDE 集成）

兼容任何支持 MCP 的 AI 工具。只需一行配置：

{
  "mcpServers": {
    "flutter-skill": {
      "command": "flutter-skill",
      "args": ["server"]
    }
  }
}

HTTP 服务模式（命令行与自动化）

适用于独立的浏览器自动化、CI/CD 流水线或远程访问：

# Start server
flutter-skill serve https://your-app.com

# Use CLI client commands
flutter-skill nav https://google.com
flutter-skill snap                    # Accessibility tree (99% fewer tokens)
flutter-skill screenshot /tmp/ss.jpg
flutter-skill tap "Login"
flutter-skill type "[email protected]"
flutter-skill eval "document.title"
flutter-skill tools                   # List all available tools

支持 --port=N、--host=H 标志和 FS_PORT/FS_HOST 环境变量。

两种模式对比

CLI 客户端完整参考： docs/CLI_CLIENT.md

10 个平台，一个工具

大多数测试工具只能用于 1–2 个平台。flutter-skill 可用于 10 个平台。

总计：通过 656/664 项测试（98.8%）——每个平台均在一个包含 50 多个元素的复杂社交媒体应用上进行了测试。

⚡ 性能

针对复杂社交媒体应用的自动化测试运行所得的真实基准数据：

Token 效率： snapshot() 返回结构化的元素树，而不是图像——与向 AI Agent 发送屏幕截图相比，Token 数量减少 87–99%。

速度有多快？ 一次 tap 的端到端耗时为 1–2 ms。Playwright 和 Selenium 等浏览器自动化工具执行相同操作通常需要 50–100 ms。速度快 50–100 倍，因为 flutter-skill 直接与应用运行时通信，无需经过 WebDriver 或 CDP 间接转接。

高负载 DOM 网站（真实场景）

在生产网站上测试了 15 个 MCP 工具——75/75 全部通过，零超时：

总耗时包含页面加载时间。即使在 DOM 复杂的网站上，工具执行时间也稳定低于 100 ms。

为什么不选 Playwright / Appium / Detox？

| AI 页面理解 | ✅ AX Tree | ❌ 仅截图 | ❌ | ❌ | | 边界 / 安全测试 | ✅ 13 个载荷 | ❌ | ❌ | ❌ | | 批量操作 | ✅ 每次调用 5 项以上 | 每次调用 1 项 | 每次调用 1 项 | 每次调用 1 项 |

flutter-skill 是唯一一款原生支持 AI、可跨移动端、Web 和桌面平台运行的端到端测试工具，工具数量是最接近的竞争者的 7 倍。

CLI 命令

# 🤖 AI autonomous exploration — finds bugs automatically
flutter-skill explore https://my-app.com --depth=3

# 🐒 Monkey/fuzz testing — random actions, crash detection
flutter-skill monkey https://my-app.com --actions=100 --seed=42

# 🚀 Parallel multi-platform testing
flutter-skill test --url https://my-app.com --platforms web,electron,android

# 🌐 Zero-config WebMCP server — any website becomes testable
flutter-skill serve https://my-app.com

🧠 原生支持 AI：减少 95% 的令牌用量

大多数 AI 测试工具会向大模型发送截图——每张截图约消耗 4,000 个令牌。

flutter-skill 使用 Chrome 的无障碍树，为 AI 提供任意页面的精简语义摘要：

// page_summary → ~200 tokens (vs ~4,000 for a screenshot)
{
  "title": "Shopping Cart",
  "nav": ["Home", "Products", "Cart", "Account"],
  "forms": [{"input:Coupon Code": "text"}],
  "buttons": ["Apply", "Checkout", "Continue Shopping"],
  "features": {"search": true, "pagination": true},
  "links": 47, "inputs": 3
}

然后，在一次调用中批量执行多个操作：

// explore_actions → 5 actions per call (vs 5 separate tool calls)
{"actions": [
  {"type": "fill", "target": "input:Coupon Code", "value": "SAVE20"},
  {"type": "tap", "target": "button:Apply"},
  {"type": "tap", "target": "button:Checkout"},
  {"type": "fill", "target": "input:Email", "value": "[email protected]"},
  {"type": "tap", "target": "button:Continue"}
]}

结果： 与基于截图的工具相比，AI Agent 测试速度更快、成本更低，还能更好地理解页面。

功能

平台设置

dependencies:
  flutter_skill: ^0.9.37

import 'package:flutter_skill/flutter_skill.dart';

void main() {
  if (kDebugMode) FlutterSkillBinding.ensureInitialized();
  runApp(MyApp());
}

npm install flutter-skill-react-native

import FlutterSkill from 'flutter-skill-react-native';
FlutterSkill.start();

npm install flutter-skill-electron

const { FlutterSkillBridge } = require('flutter-skill-electron');
FlutterSkillBridge.start(mainWindow);

// Swift Package Manager: FlutterSkillSDK
import FlutterSkill
FlutterSkillBridge.shared.start()

Text("Hello").flutterSkillId("greeting")

implementation("com.flutterskill:flutter-skill:0.8.0")

FlutterSkillBridge.start(this)

[dependencies]
flutter-skill-tauri = "0.8.0"

示例提示词

只需告诉你的 AI 要测试什么：

贡献

请参阅 CONTRIBUTING.md 了解指南。

git clone https://github.com/ai-dashboad/flutter-skill
cd flutter-skill
dart pub get
dart run bin/flutter_skill.dart server  # Start MCP server

链接

⭐ 如果 flutter-skill 为你节省了时间，请为它点亮星标，让更多人也能发现它！

MIT 许可证 © 2025