SuperAPI AI 工具集

screenshot

通用与其它

查看项目

更新于 10-15 21:46

技能介绍

用途:当用户明确要求桌面或系统截图(全屏、指定应用/窗口或像素区域)时使用;也可用于工具专属截图能力无法满足需求,或需要对无更好集成方案的桌面应用截图时。若 Figma 文件可用 Figma MCP/技能,浏览器和 Electron 应用可用 Playwright/agent-browser 工具,则优先使用对应工具。

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

主要能力与用法: macOS/Linux 使用 Python 辅助脚本:python3 <path-to-skill>/scripts/take_screenshot.py,支持 --mode temp、--path、--app、--window-name、--list-windows、--region、--active-window、--window-id 等参数。macOS 应用/窗口捕获前先运行 bash <path-to-skill>/scripts/ensure_macos_permissions.sh 预检屏幕录制权限。示例:bash <path-to-skill>/scripts/ensure_macos_permissions.sh && python3 <path-to-skill>/scripts/take_screenshot.py --app "Codex"。 Windows 使用 PowerShell 辅助脚本:powershell -ExecutionPolicy Bypass -File <path-to-skill>/scripts/take_screenshot.ps1,支持 -Mode、-Path、-Region、-ActiveWindow、-WindowHandle 等参数。 无法运行辅助脚本时,可用系统命令回退,例如 macOS 的 screencapture -x output/screen.png,Linux 的 scrot output/screen.png 或 import -window root output/screen.png。

多显示器:macOS 全屏截图在多个显示器时每屏保存一个文件;Linux 和 Windows 全屏使用虚拟桌面(所有显示器合成一张图),需要单屏时用 --region 隔离。

限制:--app、--window-name、--list-windows 仅限 macOS,Linux 使用 --active-window 或提供 --window-id;Linux 辅助脚本按 scrot、gnome-screenshot、ImageMagick import 的顺序自动选择,均不可用时需用户安装后再试,坐标区域需要 scrot 或 ImageMagick import。沙箱中出现权限错误或 Swift ModuleCache 权限错误时需用提升权限重跑。每次捕获脚本每张截图打印一个路径,多窗口或多显示器会打印多行路径,应逐张查看,仅在需要或要求时处理图像。始终在回复中报告保存的文件路径。