SuperAPI AI 工具集

openai-screenshot

智能体与模型

查看项目

更新于 10-16 01:12

技能介绍

用途:当用户明确要求桌面或系统截图(全屏、指定应用或窗口、像素区域),或工具专用截图无法满足需求时使用。优先使用工具自带的截图能力(如 Figma MCP、Playwright/agent-browser),否则以本技能作为桌面应用的默认截图方案。

保存规则:用户指定路径则存到该路径;未指定则存到操作系统默认截图位置;若为智能体自身检查用,则存到临时目录。

主要能力:提供跨平台辅助脚本。macOS/Linux 使用 python3 {baseDir}/scripts/take_screenshot.py,支持 --mode temp、--path、--app、--window-name、--list-windows、--region、--active-window、--window-id 等参数;Windows 使用 powershell -ExecutionPolicy Bypass -File {baseDir}/scripts/take_screenshot.ps1,支持 -Mode、-Path、-Region、-ActiveWindow、-WindowHandle。脚本每次截图打印一个路径,多窗口或多显示器时逐行输出并带 -w<windowId> 或 -d<display> 后缀。

macOS 权限预检:窗口/应用截图前先运行 bash {baseDir}/scripts/ensure_macos_permissions.sh,检查并请求屏幕录制权限,可将预检与截图合并为一条命令以减少沙箱提示。

平台差异:macOS 全屏截图在多显示器时每个显示器保存一个文件;Linux 和 Windows 全屏使用虚拟桌面(所有显示器合成一张图),可用 --region 隔离单个显示器。Linux 自动选择 scrot、gnome-screenshot 或 ImageMagick import,均不可用时需用户安装;--app、--window-name、--list-windows 仅限 macOS。

限制与错误处理:沙箱中若出现截图被阻止、无法从显示器创建图像或 Swift ModuleCache 权限错误,需以提升权限重跑;macOS 应用/窗口无匹配时用 --list-windows 查 id 后重试并确保应用可见;Linux 区域/窗口截图失败时检查工具是否可用;保存到系统默认位置失败时同样提升权限重跑。始终在回复中报告保存的文件路径。