用途:在需要桌面或操作系统级截图、而专用工具(如 Figma 或浏览器/Playwright 工具)无法取得正确画面时使用。适合截取桌面应用、应用窗口、指定区域或整个桌面。
主要能力与规则:
- 保存位置规则:用户指定路径则保存到该路径;未指定路径时保存到系统默认截图位置;若为自身检查用途,保存到临时目录。
- 选择与任务匹配的最小捕获范围,不擅自切换焦点、前置其它应用或打断用户当前工作,除非用户明确要求。
- 用户点名某应用时优先用 --app 捕获;指向对话框、设置面板或具名窗口时尽量加 --window-name;应用有多个候选窗口时先 --list-windows 再用 --window-id 重试;仅当用户明确要当前/最前窗口时才用 --active-window;仅当明确要桌面、全部显示器或多应用画面时才用全屏捕获。
使用方式(命令保持原样): macOS 上先做权限预检:bash <path-to-skill>/scripts/ensure_macos_permissions.sh 主要辅助脚本:python3 <path-to-skill>/scripts/take_screenshot.py 示例:python3 <path-to-skill>/scripts/take_screenshot.py --app "Figma" --mode temp python3 <path-to-skill>/scripts/take_screenshot.py --app "Rudder" --restore-minimized --mode temp python3 <path-to-skill>/scripts/take_screenshot.py --app "Codex" --window-name "Settings" --mode temp python3 <path-to-skill>/scripts/take_screenshot.py --list-windows --app "Codex" python3 <path-to-skill>/scripts/take_screenshot.py --window-id 12345 --mode temp python3 <path-to-skill>/scripts/take_screenshot.py --active-window --mode temp python3 <path-to-skill>/scripts/take_screenshot.py --mode temp --region 100,200,800,600 python3 <path-to-skill>/scripts/take_screenshot.py --path output/screen.png Windows 使用 scripts/take_screenshot.ps1,可用 -ActiveWindow、-Region、-Path。
平台限制:--app、--window-name、--list-windows 仅限 macOS;Linux 可用 --active-window、--window-id 或 --region,全屏通常用虚拟桌面,脚本优先 scrot、再 gnome-screenshot、再 ImageMagick import;macOS 全屏可能每显示器生成一个文件。
错误处理:macOS 无匹配时用 --list-windows 配合 --window-id 重试并确保应用可见;应用最小化且用户允许焦点变化时可用 --restore-minimized;最前窗口若是自身、终端或无关应用时不要用 --active-window。若目标应用隐藏或在屏幕外,应请用户使其可见。始终在回复中报告保存的文件路径。
资料未提供:具体安装方式、收费与价格、额外平台细节暂未提供。