Skip to content

AI Debug

LeonXu edited this page Apr 4, 2026 · 2 revisions

AI 一键调试

v1.7.0 新增 | ⚡超能力 Tab

为 AI Coding 而生 — 按住快捷键截屏+语音描述 bug,松开后自动发送到绑定的 AI 编程工具窗口。

使用场景

开发者在测试 App 时发现 bug:

  1. 按住快捷键 → 瞬间截屏(保存"犯罪现场")
  2. 对着屏幕说:"这个按钮点了没反应,应该弹出下拉菜单"
  3. 松开快捷键 → ASR 识别 → AI 润色
  4. SpeakOut 自动切换到绑定的 AI 工具窗口(如 Claude Code)
  5. 粘贴完整报告(截图路径 + 文字描述 + 环境信息)

全程眼睛不用离开正在测试的 App,嘴巴说完就搞定。

设置方法

  1. 打开 ⚡超能力 Tab → AI 一键调试 → 开启
  2. 设置基础按键(如 Right Shift)
  3. 点击添加窗口 → 点 🔭 图标 → 弹窗提示后切换到目标窗口 → 自动绑定

多窗口支持

最多绑定 5 个目标窗口。

操作 效果
按住基础按键 发送到第 1 个窗口(默认)
按住基础按键 + 1 发送到第 1 个窗口
按住基础按键 + 2 发送到第 2 个窗口
按住基础按键 + 3 发送到第 3 个窗口

单窗口时无需数字键,直接按住基础按键即可。

报告格式

请看截图 ~/.speakout/screenshots/2026-04-04T143022.png

这个按钮点了没反应,应该弹出下拉菜单。

[来源: SpeakOut AI 一键调试 | 前台: MyApp]

Claude Code / Cursor 会自动读取本地截图文件路径。

截图存储

截图默认保存在 ~/.speakout/screenshots/,文件名为时间戳(如 20260404T143022.png)。

权限要求

  • ✅ 辅助功能(已有)
  • ✅ 麦克风(已有)
  • 🆕 屏幕录制 — 截屏功能需要,首次使用时 macOS 会弹窗请求授权

兼容的 AI 工具

工具 说明
Claude Code (Ghostty/Terminal) 报告包含本地截图路径,Claude Code 自动读取
Cursor Chat 支持读取本地文件路径
Windsurf 同 Cursor
其他终端 AI 工具 任何支持本地文件路径的 AI 工具

Clone this wiki locally