screenshot

# 屏幕截图捕获 每次请遵循以下保存位置规则： 1) 如果用户指定了路径，则保存到该路径。 2) 如果用户要求截图但未指定路径，则保存到操作系统默认的截图位置。 3) 如果智能体（Codex）需要截图进行自我检查，则保存到临时目录。 ## 工具优先级 - 优先使用特定工具的截图功能（例如：用于 Figma 文件的 Figma MCP/技能，或用于浏览器和 Electron 应用的 Playwright/智能体浏览器工具）。 - 在用户明确要求、需要全系统桌面捕获，或特定工具无法获取所需内容时，使用此技能。 - 否则，将此技能视为没有更好集成捕获工具的桌面应用的默认选择。 ## macOS 权限预检（减少重复提示） 在 macOS 上，在窗口/应用捕获前运行一次预检助手。它会检查“屏幕录制”权限，解释其必要性，并在一个地方请求授权。 助手会将 Swift 的模块缓存路由到 `$TMPDIR/codex-swift-module-cache`，以避免额外的沙盒模块缓存提示。 bash bash /scripts/ensure_macos_permissions.sh 为避免多次沙盒批准提示，请尽可能将预检和捕获合并为一个命令： bash bash /scripts/ensure_macos_permissions.sh && python3 /scripts/take_screenshot.py --app "Codex" 对于智能体（Codex）的检查运行，将输出保留在临时目录中： bash bash /scripts/ensure_macos_permissions.sh && python3 /scripts/take_screenshot.py --app "" --mode temp 使用捆绑的脚本以避免重新推导特定于操作系统的命令。 ## macOS 和 Linux (Python 助手) 从仓库根目录运行助手： bash python3 /scripts/take_screenshot.py 常见模式： - 默认位置（用户要求“截个图”）： bash python3 /scripts/take_screenshot.py - 临时位置（智能体视觉检查）： bash python3 /scripts/take_screenshot.py --mode temp - 指定位置（用户提供了路径或文件名）： bash python3 /scripts/take_screenshot.py --path output/screen.png - 按应用名称捕获应用/窗口（仅限 macOS；支持子字符串匹配；捕获所有匹配的窗口）： bash python3 /scripts/take_screenshot.py --app "Codex" - 应用内的特定窗口标题（仅限 macOS）： bash python3 /scripts/take_screenshot.py --app "Codex" --wi