SuperAPI AI 工具集

capture-screen

通用与其它

查看项目

更新于 10-15 20:34

技能介绍

用途:在 macOS 上以程序化方式完成截图,流程为“找窗口—控制视图—截图”三步,适合需要批量或自动化抓取应用窗口画面的场景。

主要能力:用 Swift 的 CGWindowListCopyWindowInfo 枚举屏幕窗口,得到数字 Window ID;用 AppleScript(osascript)控制应用窗口,如激活、缩放、滚动、选择单元格或切换工作表;用 screencapture -l <WID> 按窗口 ID 输出 PNG/JPEG。

必要用法:先运行 swift scripts/get_window_id.swift Excel 获取 WID,输出格式为 WID=12345 | App=... | Title=...;再执行 screencapture -x -l 12345 output.png。控制 Excel 可用 osascript 设置 zoom、scroll row、select range、activate object sheet 等。AppleScript 命令后应加 sleep 1 等待渲染,并用 timeout 5 osascript ... 防止挂起。Retina 屏默认输出 2x,可用 sips --resampleWidth 2032 output.png --out output_1x.png 降为 1x。

适用场景:Excel 多区域截图、Chrome 等应用窗口截图、任意 macOS 应用的基础激活与截图。

限制:需授予屏幕录制权限,失败时可用 swift scripts/get_window_id.swift --permission-hint screen 查看提示;CGWindowID 在应用重启或窗口重开后失效,截图前应重新获取;System Events 取窗口 id、Python Quartz、osascript window id 等方法均不可用;AppleScript 控制深度因应用而异,Excel 支持最完整,其他应用可能仅支持基础激活。