重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
npx skills add https://github.com/xiaolai/vmark --skill tauri-mcp-testing重要提示: 对于 Tauri 应用程序的端到端测试,始终使用 tauri_* MCP 工具。切勿使用 Chrome DevTools MCP——那仅适用于浏览器页面。
| 任务 | MCP 工具 |
|---|---|
| 连接到应用 | tauri_driver_session |
| 截图 | tauri_webview_screenshot |
| 查找元素 | tauri_webview_find_element |
| 点击/滚动/滑动 | tauri_webview_interact |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 输入文本 | tauri_webview_keyboard |
| 等待元素 | tauri_webview_wait_for |
| 执行 JS | tauri_webview_execute_js |
| 获取 CSS 样式 | tauri_webview_get_styles |
| 测试 IPC 命令 | tauri_ipc_execute_command |
| 监控 IPC 调用 | tauri_ipc_monitor |
| 读取控制台日志 | tauri_read_logs |
| 管理窗口 | tauri_manage_window |
pnpm tauri dev)如果连接失败,请运行 tauri_get_setup_instructions 获取插件安装指南。
1. 启动会话 → 连接到正在运行的 Tauri 应用
2. 验证状态 → 截图 + 查找元素
3. 交互 → 点击、输入、滚动
4. 等待 → 等待预期结果
5. 验证 → 检查 IPC、日志、DOM 状态
6. 清理 → 完成后停止会话
// 连接到默认端口的应用
tauri_driver_session({ action: 'start' })
// 连接到特定端口
tauri_driver_session({ action: 'start', port: 9224 })
// 连接到远程主机(移动端测试)
tauri_driver_session({ action: 'start', host: '<device-ip>', port: 9223 })
tauri_driver_session({ action: 'status' })
// 返回:已连接的应用、默认应用、标识符
// 停止所有会话
tauri_driver_session({ action: 'stop' })
// 停止特定应用
tauri_driver_session({ action: 'stop', appIdentifier: 9223 })
// 1. 截图以查看当前状态
tauri_webview_screenshot()
// 2. 截取特定元素的图
tauri_webview_screenshot({ uid: 'editor-content' })
// 3. 保存到文件以便比较
tauri_webview_screenshot({ filePath: 'dev-docs/archive/test-screenshots/test-screenshot.png' })
// 1. 先查找元素
tauri_webview_find_element({ selector: '.save-button' })
// 2. 点击元素
tauri_webview_interact({ action: 'click', selector: '.save-button' })
// 3. 双击
tauri_webview_interact({ action: 'double-click', selector: '.editor' })
// 4. 长按(模拟触摸)
tauri_webview_interact({ action: 'long-press', selector: '.item', duration: 500 })
// 5. 滚动
tauri_webview_interact({ action: 'scroll', selector: '.content', scrollY: 500 })
// 6. 滑动
tauri_webview_interact({
action: 'swipe',
fromX: 300, fromY: 400,
toX: 100, toY: 400,
duration: 300
})
// 在聚焦的元素中输入
tauri_webview_keyboard({
action: 'type',
selector: '.editor-input',
text: '# Hello World'
})
// 按键
tauri_webview_keyboard({ action: 'press', key: 'Enter' })
// 带修饰键的按键
tauri_webview_keyboard({
action: 'press',
key: 's',
modifiers: ['Control'] // Ctrl+S
})
// 组合键
tauri_webview_keyboard({
action: 'press',
key: 'z',
modifiers: ['Meta', 'Shift'] // Cmd+Shift+Z (macOS 上的重做)
})
// 等待元素出现
tauri_webview_wait_for({
type: 'selector',
value: '.success-toast',
timeout: 5000
})
// 等待文本出现
tauri_webview_wait_for({
type: 'text',
value: 'File saved successfully',
timeout: 3000
})
// 等待 IPC 事件
tauri_webview_wait_for({
type: 'ipc-event',
value: 'file-saved',
timeout: 5000
})
// 开始监控 IPC 调用
tauri_ipc_monitor({ action: 'start' })
// 执行触发 IPC 的操作
tauri_webview_interact({ action: 'click', selector: '.save-button' })
// 获取捕获的 IPC 调用
tauri_ipc_get_captured({ filter: 'save_file' })
// 直接执行 IPC 命令
tauri_ipc_execute_command({
command: 'get_document_state',
args: { id: 'doc-123' }
})
// 发出事件以测试处理程序
tauri_ipc_emit_event({
eventName: 'file-changed',
payload: { path: '/test/file.md' }
})
// 停止监控
tauri_ipc_monitor({ action: 'stop' })
// 从 DOM 获取值(返回值必须使用 IIFE)
tauri_webview_execute_js({
script: '(() => { return document.querySelector(".editor").textContent; })()'
})
// 检查 Tauri API 是否可用
tauri_webview_execute_js({
script: '(() => { return typeof window.__TAURI__ !== "undefined"; })()'
})
// 获取计算样式
tauri_webview_execute_js({
script: '(() => { return getComputedStyle(document.body).backgroundColor; })()'
})
// 触发自定义事件
tauri_webview_execute_js({
script: 'document.dispatchEvent(new CustomEvent("test-event", { detail: { test: true } }))'
})
// 获取最近的控制台日志
tauri_read_logs({ source: 'console', lines: 50 })
// 过滤日志
tauri_read_logs({ source: 'console', filter: 'error', lines: 100 })
// 特定时间之后的日志
tauri_read_logs({
source: 'console',
since: '2024-01-01T10:00:00Z',
lines: 50
})
// 桌面系统日志
tauri_read_logs({ source: 'system', lines: 100 })
// Android logcat
tauri_read_logs({ source: 'android', filter: 'vmark', lines: 100 })
// iOS 模拟器日志
tauri_read_logs({ source: 'ios', lines: 100 })
// 列出所有窗口
tauri_manage_window({ action: 'list' })
// 获取窗口信息
tauri_manage_window({ action: 'info', windowId: 'main' })
// 调整窗口大小以进行响应式测试
tauri_manage_window({ action: 'resize', width: 800, height: 600 })
// 调整特定窗口大小
tauri_manage_window({
action: 'resize',
windowId: 'settings',
width: 400,
height: 300
})
// 获取所有计算样式
tauri_webview_get_styles({ selector: '.editor' })
// 获取特定属性
tauri_webview_get_styles({
selector: '.editor',
properties: ['font-size', 'color', 'background-color']
})
// 从多个元素获取样式
tauri_webview_get_styles({
selector: '.toolbar button',
multiple: true,
properties: ['opacity', 'visibility']
})
// 1. 连接
tauri_driver_session({ action: 'start' })
// 2. 打开文件对话框
tauri_webview_keyboard({ action: 'press', key: 'o', modifiers: ['Control'] })
// 3. 等待内容加载(使用 IPC)
tauri_ipc_monitor({ action: 'start' })
// ... 文件选择通过外部或模拟对话框发生 ...
tauri_ipc_get_captured({ filter: 'read_file' })
// 4. 验证内容已加载
tauri_webview_find_element({ selector: '.editor-content' })
tauri_webview_execute_js({
script: '(() => { return document.querySelector(".editor-content").textContent.length > 0; })()'
})
// 1. 聚焦编辑器
tauri_webview_interact({ action: 'click', selector: '.editor' })
// 2. 输入内容
tauri_webview_keyboard({
action: 'type',
selector: '.editor [contenteditable]',
text: '# Test Document\n\nThis is a test.'
})
// 3. 验证脏状态
tauri_webview_find_element({ selector: '[data-dirty="true"]' })
// 4. 使用 Ctrl+S 保存
tauri_webview_keyboard({ action: 'press', key: 's', modifiers: ['Control'] })
// 5. 验证已保存
tauri_webview_wait_for({ type: 'selector', value: '[data-dirty="false"]' })
// 测试移动端视口
tauri_manage_window({ action: 'resize', width: 375, height: 667 })
tauri_webview_screenshot({ filePath: 'dev-docs/archive/test-screenshots/mobile.png' })
tauri_webview_find_element({ selector: '.mobile-menu-button' })
// 测试平板视口
tauri_manage_window({ action: 'resize', width: 768, height: 1024 })
tauri_webview_screenshot({ filePath: 'dev-docs/archive/test-screenshots/tablet.png' })
// 测试桌面视口
tauri_manage_window({ action: 'resize', width: 1920, height: 1080 })
tauri_webview_screenshot({ filePath: 'dev-docs/archive/test-screenshots/desktop.png' })
| 问题 | 解决方案 |
|---|---|
| 连接被拒绝 | 确保应用正在运行 pnpm tauri dev |
| 未找到元素 | 检查选择器,截图验证 DOM |
| IPC 未捕获 | 在操作之前启动监控 |
| 等待超时 | 增加超时时间,检查元素是否会出现 |
| JS 返回 undefined | 使用 IIFE 语法:(() => { return value; })() |
| 未找到插件 | 运行 tauri_get_setup_instructions |
tauri-app-dev — 通用 Tauri 2.0 模式(命令、状态、插件、安全性)tauri-v2-integration — VMark 特定的 IPC 模式(调用/发出桥接、菜单加速器)rust-tauri-backend — VMark Rust 后端实现每周安装次数
59
仓库
GitHub 星标数
172
首次出现
2026年2月15日
安全审计
安装于
opencode59
codex59
gemini-cli59
cursor59
github-copilot58
amp58
CRITICAL: For E2E testing of Tauri applications, ALWAYS use tauri_* MCP tools. NEVER use Chrome DevTools MCP - that's for browser pages only.
| Task | MCP Tool |
|---|---|
| Connect to app | tauri_driver_session |
| Take screenshot | tauri_webview_screenshot |
| Find elements | tauri_webview_find_element |
| Click/scroll/swipe | tauri_webview_interact |
| Type text | tauri_webview_keyboard |
| Wait for element | tauri_webview_wait_for |
| Execute JS | tauri_webview_execute_js |
| Get CSS styles | tauri_webview_get_styles |
| Test IPC commands | tauri_ipc_execute_command |
| Monitor IPC calls | tauri_ipc_monitor |
| Read console logs | tauri_read_logs |
| Manage windows | tauri_manage_window |
pnpm tauri dev)If connection fails, run tauri_get_setup_instructions to get plugin installation guide.
1. START SESSION → Connect to running Tauri app
2. VERIFY STATE → Screenshot + find elements
3. INTERACT → Click, type, scroll
4. WAIT → Wait for expected results
5. VERIFY → Check IPC, logs, DOM state
6. CLEANUP → Stop session when done
// Connect to app on default port
tauri_driver_session({ action: 'start' })
// Connect to specific port
tauri_driver_session({ action: 'start', port: 9224 })
// Connect to remote host (mobile testing)
tauri_driver_session({ action: 'start', host: '<device-ip>', port: 9223 })
tauri_driver_session({ action: 'status' })
// Returns: connected apps, default app, identifiers
// Stop all sessions
tauri_driver_session({ action: 'stop' })
// Stop specific app
tauri_driver_session({ action: 'stop', appIdentifier: 9223 })
// 1. Take screenshot to see current state
tauri_webview_screenshot()
// 2. Take screenshot of specific element
tauri_webview_screenshot({ uid: 'editor-content' })
// 3. Save to file for comparison
tauri_webview_screenshot({ filePath: 'dev-docs/archive/test-screenshots/test-screenshot.png' })
// 1. Find element first
tauri_webview_find_element({ selector: '.save-button' })
// 2. Click element
tauri_webview_interact({ action: 'click', selector: '.save-button' })
// 3. Double-click
tauri_webview_interact({ action: 'double-click', selector: '.editor' })
// 4. Long-press (touch simulation)
tauri_webview_interact({ action: 'long-press', selector: '.item', duration: 500 })
// 5. Scroll
tauri_webview_interact({ action: 'scroll', selector: '.content', scrollY: 500 })
// 6. Swipe
tauri_webview_interact({
action: 'swipe',
fromX: 300, fromY: 400,
toX: 100, toY: 400,
duration: 300
})
// Type into focused element
tauri_webview_keyboard({
action: 'type',
selector: '.editor-input',
text: '# Hello World'
})
// Press key
tauri_webview_keyboard({ action: 'press', key: 'Enter' })
// Key with modifiers
tauri_webview_keyboard({
action: 'press',
key: 's',
modifiers: ['Control'] // Ctrl+S
})
// Key combinations
tauri_webview_keyboard({
action: 'press',
key: 'z',
modifiers: ['Meta', 'Shift'] // Cmd+Shift+Z (redo on macOS)
})
// Wait for element to appear
tauri_webview_wait_for({
type: 'selector',
value: '.success-toast',
timeout: 5000
})
// Wait for text to appear
tauri_webview_wait_for({
type: 'text',
value: 'File saved successfully',
timeout: 3000
})
// Wait for IPC event
tauri_webview_wait_for({
type: 'ipc-event',
value: 'file-saved',
timeout: 5000
})
// Start monitoring IPC calls
tauri_ipc_monitor({ action: 'start' })
// Perform action that triggers IPC
tauri_webview_interact({ action: 'click', selector: '.save-button' })
// Get captured IPC calls
tauri_ipc_get_captured({ filter: 'save_file' })
// Execute IPC command directly
tauri_ipc_execute_command({
command: 'get_document_state',
args: { id: 'doc-123' }
})
// Emit event to test handlers
tauri_ipc_emit_event({
eventName: 'file-changed',
payload: { path: '/test/file.md' }
})
// Stop monitoring
tauri_ipc_monitor({ action: 'stop' })
// Get value from DOM (MUST use IIFE for return values)
tauri_webview_execute_js({
script: '(() => { return document.querySelector(".editor").textContent; })()'
})
// Check Tauri API available
tauri_webview_execute_js({
script: '(() => { return typeof window.__TAURI__ !== "undefined"; })()'
})
// Get computed style
tauri_webview_execute_js({
script: '(() => { return getComputedStyle(document.body).backgroundColor; })()'
})
// Trigger custom event
tauri_webview_execute_js({
script: 'document.dispatchEvent(new CustomEvent("test-event", { detail: { test: true } }))'
})
// Get recent console logs
tauri_read_logs({ source: 'console', lines: 50 })
// Filter logs
tauri_read_logs({ source: 'console', filter: 'error', lines: 100 })
// Logs since specific time
tauri_read_logs({
source: 'console',
since: '2024-01-01T10:00:00Z',
lines: 50
})
// Desktop system logs
tauri_read_logs({ source: 'system', lines: 100 })
// Android logcat
tauri_read_logs({ source: 'android', filter: 'vmark', lines: 100 })
// iOS simulator logs
tauri_read_logs({ source: 'ios', lines: 100 })
// List all windows
tauri_manage_window({ action: 'list' })
// Get window info
tauri_manage_window({ action: 'info', windowId: 'main' })
// Resize window for responsive testing
tauri_manage_window({ action: 'resize', width: 800, height: 600 })
// Resize specific window
tauri_manage_window({
action: 'resize',
windowId: 'settings',
width: 400,
height: 300
})
// Get all computed styles
tauri_webview_get_styles({ selector: '.editor' })
// Get specific properties
tauri_webview_get_styles({
selector: '.editor',
properties: ['font-size', 'color', 'background-color']
})
// Get styles from multiple elements
tauri_webview_get_styles({
selector: '.toolbar button',
multiple: true,
properties: ['opacity', 'visibility']
})
// 1. Connect
tauri_driver_session({ action: 'start' })
// 2. Open file dialog
tauri_webview_keyboard({ action: 'press', key: 'o', modifiers: ['Control'] })
// 3. Wait for content to load (using IPC)
tauri_ipc_monitor({ action: 'start' })
// ... file selection happens externally or via mocked dialog ...
tauri_ipc_get_captured({ filter: 'read_file' })
// 4. Verify content loaded
tauri_webview_find_element({ selector: '.editor-content' })
tauri_webview_execute_js({
script: '(() => { return document.querySelector(".editor-content").textContent.length > 0; })()'
})
// 1. Focus editor
tauri_webview_interact({ action: 'click', selector: '.editor' })
// 2. Type content
tauri_webview_keyboard({
action: 'type',
selector: '.editor [contenteditable]',
text: '# Test Document\n\nThis is a test.'
})
// 3. Verify dirty state
tauri_webview_find_element({ selector: '[data-dirty="true"]' })
// 4. Save with Ctrl+S
tauri_webview_keyboard({ action: 'press', key: 's', modifiers: ['Control'] })
// 5. Verify saved
tauri_webview_wait_for({ type: 'selector', value: '[data-dirty="false"]' })
// Test mobile viewport
tauri_manage_window({ action: 'resize', width: 375, height: 667 })
tauri_webview_screenshot({ filePath: 'dev-docs/archive/test-screenshots/mobile.png' })
tauri_webview_find_element({ selector: '.mobile-menu-button' })
// Test tablet viewport
tauri_manage_window({ action: 'resize', width: 768, height: 1024 })
tauri_webview_screenshot({ filePath: 'dev-docs/archive/test-screenshots/tablet.png' })
// Test desktop viewport
tauri_manage_window({ action: 'resize', width: 1920, height: 1080 })
tauri_webview_screenshot({ filePath: 'dev-docs/archive/test-screenshots/desktop.png' })
| Issue | Solution |
|---|---|
| Connection refused | Ensure app is running with pnpm tauri dev |
| No elements found | Check selector, take screenshot to verify DOM |
| IPC not captured | Start monitor BEFORE the action |
| Timeout on wait | Increase timeout, check if element ever appears |
| JS returns undefined | Use IIFE syntax: (() => { return value; })() |
| Plugin not found | Run tauri_get_setup_instructions |
| Topic | File |
|---|---|
| Session management | references/session-management.md |
| Webview testing | references/webview-testing.md |
| IPC testing | references/ipc-testing.md |
| Debugging | references/debugging.md |
tauri-app-dev — General Tauri 2.0 patterns (commands, state, plugins, security)tauri-v2-integration — VMark-specific IPC patterns (invoke/emit bridges, menu accelerators)rust-tauri-backend — VMark Rust backend implementationWeekly Installs
59
Repository
GitHub Stars
172
First Seen
Feb 15, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode59
codex59
gemini-cli59
cursor59
github-copilot58
amp58
通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南
48,700 周安装