[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"$f1cm76vibi8djk":3},{"code":4,"message":5,"data":6,"timestamp":33},10000,"success",{"full_name":7,"position":8,"description":9,"language":10,"stars":11,"forks":12,"stars_gained":12,"age_days":13,"hn_threads":14,"one_liner":15,"summary_md":16,"topic":17,"github_topics":20,"license":29,"homepage":30,"updated_at":31,"history":32},"kitlangton\u002Fscrawl",11,"Show an agent a problem: mark up, record, send","Rust",728,72,10,[],"把带口述和标注的录屏整理成编程 Agent 能读的结构化材料。","Scrawl 的核心主张很简单：Agent 卡住时，直接让它“看”问题，比用文字描述更省事。如果你平时用编程 Agent，又经常反复解释界面上的异常，这个工具值得在 Mac 上试一次。\n\n## 解决什么问题\n\n你在开发页面或应用时碰到一个 bug，需要让编程 Agent 理解它。靠打字说“点这里，然后这里不对，那个间距很怪”既慢又容易丢信息，截图又丢掉操作顺序和你的口述。Scrawl 改的是采集这一步：按一次快捷键开始录屏，一边说一边点击、在画面上标注，再按一次结束。得到的不是一段原始视频，而是一个包含标注关键帧、转写文本和结构化时间线的材料包，装好技能后 Agent 可以直接读取。Agent 拿到的是现场证据，而不是你事后的复述。\n\n## 有什么不同\n\nScrawl 不把视频文件直接丢进对话，而是把录制整理成面向 Agent 的产物：带标注关键帧的 contact sheet、全分辨率单帧、按时间对齐的转写与交互时间线 `summary.md`，以及 `scrawl.json` 清单。因为转写和屏幕操作在时间上对齐，Agent 可以把“按钮会跳”和“你点下去的那一刻”对应起来。CLI 暴露的是同一批材料：`inspect` 输出摘要或 JSON，`frames --from\u002F--to` 按时间段取帧，让 Agent 聚焦某一瞬间。\n\nScrawl 还试图缩短投递环节。如果一次录制结束时，前台浏览器正显示某个项目的开发站点，它可以直接发到该项目的 OpenCode 会话；`route --url` 可以只查看会发往哪里而不实际发送。自动裁剪是另一个关键机制：录制整个屏幕，由 Scrawl 推断你主要在哪个区域操作，再裁剪每张关键帧，而不是让你事先框选。[README](https:\u002F\u002Fgithub.com\u002Fkitlangton\u002Fscrawl\u002Fblob\u002Fmain\u002FREADME.md) 说裁剪参数是在模拟录制和人工标注的理想裁剪上调出来的——这是作者对调参过程的说明，不是独立准确率测试。自动裁剪是启发式方法，代价是手势不明确或窗口重叠时，裁剪结果可能不符合预期；审阅窗口和 `autocrop` 调试面板就是用来检查和调整的。\n\n## 谁值得试\n\n适合已经在用 Claude Code、OpenCode、Codex 等 Agent，且问题偏视觉或交互的开发者：布局错乱、悬停状态异常、要点好几下才复现的流程。反过来，如果你主要做终端或后端问题，一段文字报错本来就更清楚，就不太需要它；如果你的机器不在支持范围内，也不合适——主力版本面向 Apple silicon Mac 和 macOS 15 及以上，部分功能需要 macOS 26。Windows 有[预览版](https:\u002F\u002Fgithub.com\u002Fkitlangton\u002Fscrawl\u002Freleases\u002Flatest)，但未签名、暂不支持自更新，投入程度完全不同。\n\n## 使用条件与边界\n\nMac 用户需要 Apple silicon 机器和 macOS 15 或更新版本；实时转写和 Liquid Glass 需要 macOS 26。首次启动有四个引导页，其中包括 Scrawl 需要的全部权限，屏幕录制等授权不齐就不会继续，这是正常但真实的准备成本。Windows 明确是预览版、未签名，会遇到 SmartScreen 提示，更新也要手动。\n\nAgent 工作流本身也有维护成本。要让 Agent 读取材料包，需要安装技能，并把 `scrawl` 命令链接到 PATH——Homebrew cask 会做这件事，或者用设置里的 Agents 页面安装。开发站点自动投递目前面向 OpenCode 会话和一组特定浏览器。如果投递失败，README 特别提醒：决定收件人的是原始顶层目标字段，而不是 `context.session`，并且重发前应先确认录制是否已经送达。\n\n## HotRepo 点评\n\nHotRepo 从 2026-10-24 开始跟踪这个仓库，唯一存储的榜单记录是 2026-10-25 在 Rust 新项目榜（新项目榜，并非总榜\u002F日榜）排 #11、总星数 728。这只是一个 10 天新项目的单日快照，不是每日增长曲线，无法据此判断热度能否持续。在长期依赖它之前，先拿一次真实录制，看看 contact sheet 和 `summary.md`，确认自动裁剪在你的布局下是否好用、你的 Agent 是否真的按预期读取材料包。",{"slug":18,"name":19},"developer-tools","开发工具",[21,22,23,18,24,25,26,27,28],"ai-agents","claude-code","coding-agents","gpui","macos","opencode","rust","screen-recording","MIT","https:\u002F\u002Fscrawl.kitlangton.com","2026-10-25T02:49:12Z",[],1792906294]