用途:当用户明确要求桌面或系统截图(全屏、指定应用或窗口、像素区域),或工具专用截图无法满足需求时使用。优先使用工具专用截图能力(如 Figma MCP、Playwright 等浏览器工具),否则作为桌面应用的默认截图方案。
保存规则:用户指定路径则保存到该路径;未指定路径则保存到操作系统默认截图位置;若为 Codex 自身检查需要,则保存到临时目录。
主要能力:全屏截图、按应用名或窗口标题截图(macOS)、像素区域截图、活动窗口截图、按窗口 ID 截图、多显示器处理。脚本每次截图打印一个路径,多窗口或多显示器时逐行输出并带 -w<windowId> 或 -d<display> 后缀。
使用方式:macOS/Linux 使用 Python 辅助脚本,如 python3 <path-to-skill>/scripts/take_screenshot.py,支持 --mode temp、--path、--app、--window-name、--list-windows、--region、--active-window、--window-id 等参数。Windows 使用 PowerShell 脚本 take_screenshot.ps1,支持 -Mode、-Path、-Region、-ActiveWindow、-WindowHandle。macOS 窗口/应用截图前先运行 bash <path-to-skill>/scripts/ensure_macos_permissions.sh 检查屏幕录制权限。
限制:--app、--window-name、--list-windows 仅限 macOS;Linux 需 scrot、gnome-screenshot 或 ImageMagick import,坐标区域需 scrot 或 import;沙箱中权限被阻止时需提升权限重跑;macOS 多显示器全屏每屏一个文件,Linux/Windows 全屏为虚拟桌面单图。始终在回复中报告保存的文件路径。