Scrawl：录屏+语音标注，一键把问题讲给

22次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 scrawl

Scrawl 中文版下载|macOS（录屏+语音标注，一键把问题讲给 AI Agent 听）

30 秒速读：给 AI 编程助手报 bug 最痛苦的不是写代码，是”说不清楚”——”那个按钮点了没反应”配三张截图，agent 照样一脸懵。Scrawl 换了个思路：按 ⌥⇧S 开始录屏，你一边操作一边语音讲解、一边在屏幕上圈画，结束后再按一次，它打包成一个”证据包”：标注关键帧联系表、全分辨率帧、带时间轴的语音转写和结构化清单，直接喂给 Claude Code / OpenCode / Codex。Rust 写的 macOS 应用（有 Windows 预览版），MIT 开源。本篇讲清版本怎么选、权限四件套一次过、装完必调的 5 个设置，以及证据包四件套怎么用。

软件信息表

软件名称	Scrawl（面向 AI Agent 的屏幕问题记录工具）
技术栈	Rust；macOS 端用 ScreenCaptureKit / AppKit / Carbon 热键
许可证	MIT
录制方式	全局快捷键 ⌥⇧S 开始/结束；同时录屏幕、语音、点击/拖动/滚动轨迹、屏幕圈画标注
输出物（证据包）	contact-sheet.png（标注关键帧联系表）、frames/（全分辨率帧）、summary.md（时间对齐转写+交互时间线）、scrawl.json（结构化清单）
Agent 集成	配套 skill：bunx skills add kitlangton/scrawl；命令行 scrawl zoom / frames / send / export / inspect
系统要求	Apple Silicon Mac，macOS 15 或更高（实时转写需 macOS 26）；Windows 10 2004+ 有预览版
安装方式	官网 DMG 或 Homebrew：brew install –cask kitlangton/tap/scrawl；应用内 Sparkle 自动更新

三个版本怎么选：结论先行

版本	适合谁	说明
macOS 正式版（推荐）	用 Mac 写代码、调 AI agent 的人	官网 DMG 或 Homebrew cask 安装，功能完整，Sparkle 自动更新，是作者的主力平台
Windows 预览版	只有 Windows 的人	官网或 GitHub Releases 下 zip，解压运行 scrawl.exe；未签名（”更多信息 → 仍要运行”），暂不支持自动更新
源码构建	想改录制逻辑的人	cargo 构建，README 里给了 app / demo / preview / export 等完整命令，改快捷键、改打包规则自己来

明确取舍：主力在 Mac 上就用 macOS 版，别等 Windows 版转正。Windows 版明确标注 preview，连自动更新都没有，适合尝鲜不适合当生产力工具。Intel Mac 也别试了，硬门槛就是 Apple Silicon + macOS 15。

安装步骤（只写卡点）

确认硬件：Apple Silicon（M1 及以后）+ macOS 15+。Intel Mac 装不上，这是第一个也是最大的卡点，先看”关于本机”别白折腾。
安装二选一：官网下 DMG 拖进 Applications，或终端跑 brew install --cask kitlangton/tap/scrawl。Homebrew 装完应用自己接管更新，不用再管 cask。
权限四件套一次过：首次启动有 onboarding 向导——屏幕录制与系统音频、麦克风、辅助功能三个必须项，外加摄像头（只在用有线 iPhone 镜像时要）。屏幕录制和辅助功能要在”系统设置”里把 Scrawl 拖进允许列表，拖完可能要按提示重新打开应用。
装 agent skill：在终端跑 bunx skills add kitlangton/scrawl，给 Claude Code / OpenCode / Codex 装上配套 skill，agent 才能读懂证据包。
装命令行工具：设置 → Agents → Command-line tool 点 Install，把 scrawl 链到 PATH（/opt/homebrew/bin 或 ~/.local/bin），之后才能用 scrawl zoom / export 等命令。

装完必调的 5 个设置

转写语言设中文：设置 → Recording → 转写器 → 选 Apple Speech 并把语言设为中文。你讲解用中文，转写语言不对的话 summary.md 里全是乱猜的英文，agent 读不懂。
麦克风选对设备：同一页选输入设备，系统默认会跟随 macOS 切换。用外接麦的人手动锁定设备 UID，录到一半系统切了输入源，讲解就丢了。
快捷键确认不冲突：设置 → General → 录制 ⌥⇧S、粘贴上一次捕获 ⌥⇧V。如果 ⌥⇧S 被别的 App 占了，在这里点一下重设，录制时 Scrawl 自己的快捷键会暂停让路。
存储保留时长：设置 → Storage → 录制保留天数。证据包是本地文件，默认定期清理；重要的 bug 复现包用 pin 留住，别等自动清理了才想起来。
开机自启动：设置 → General → Launch at login。报 bug 的时机都是突发的，菜单栏常驻才能做到”出问题立刻 ⌥⇧S”，现装现录来不及。

独家整理：Scrawl vs 普通录屏 vs Loom

维度	Scrawl	QuickTime / 剪映录屏	Loom 类云录屏
为谁设计	AI Agent（结构化证据包）	人看的视频	人看的视频+链接分享
输出	关键帧联系表 + 转写时间线 + JSON 清单	一段 MP4	云端视频链接
交互轨迹	点击/拖动/滚动自动记录进时间线	无，要靠嘴说	无
agent 可直接用	是，skill + CLI 一套	否，得自己看	否
隐私	本地文件，不上传	本地	上传云端

一句话：要给 AI agent 讲清楚一个 bug，选 Scrawl；要给人录一段操作教程，用剪映/QuickTime；要发链接给同事异步看，Loom。三者不是替代关系，是”观众”不同。

注意事项与常见问题

权限没给全，⌥⇧S 按了没反应：这是最常见的”坏了”。回设置 → Permissions 看 onboarding 清单，哪项没勾去系统设置里补。注意屏幕录制授权后 macOS 可能要求退出重进，Scrawl 会自己处理 relaunch，按提示走就行。
实时转写要 macOS 26：macOS 15 能录能转写，但边录边出字幕的实时转写要 macOS 26。系统版本不够就录完再看 summary.md，别纠结。
证据包别直接扔群里：contact-sheet.png + summary.md 是给 agent 读的，给人看的话用 scrawl export 导成 MP4（实验性视频导出，带圈画烧录和音频），人看起来更直观。
iPhone 镜像要线连：README 里说的有线 iPhone 镜像走的是摄像头权限，无线投屏不行。录 App 问题时先把线插好再开始。
Windows 版不自动更新：预览版要自己去 Releases 页下新版覆盖。macOS 版走 Sparkle 自动更新，两边别搞混。
快捷键冲突先查全局：⌥⇧S 如果被输入法/截图工具占了，Scrawl 里改键比去卸载别的软件快。改键要点中快捷键再按新组合，Esc 取消。