SuperAPI AI 工具集

screenshot

通用与其它

查看项目

更新于 10-16 03:47

技能介绍

用途:在用户明确要求桌面或系统截图(全屏、指定应用/窗口、像素区域)时,或代理需要为自身视觉检查抓取屏幕时使用。若存在更集成的工具(如图形设计文件的 MCP/技能、浏览器类工具),应优先使用那些能力;否则将本技能作为桌面应用的默认截图方式。

主要能力:支持全屏、指定应用/窗口、指定窗口标题、指定窗口 ID、像素区域和当前活动窗口截图;提供 macOS/Linux 的 Python 辅助脚本与 Windows 的 PowerShell 辅助脚本;在 macOS 上提供权限预检脚本以减少重复授权提示。

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

使用方式: 默认位置:python3 <path-to-skill>/scripts/take_screenshot.py 临时位置:python3 <path-to-skill>/scripts/take_screenshot.py --mode temp 指定路径:python3 <path-to-skill>/scripts/take_screenshot.py --path output/screen.png 按应用捕获(macOS):python3 <path-to-skill>/scripts/take_screenshot.py --app "Codex" 指定窗口标题(macOS):python3 <path-to-skill>/scripts/take_screenshot.py --app "Codex" --window-name "Settings" 列出窗口 ID(macOS):python3 <path-to-skill>/scripts/take_screenshot.py --list-windows --app "Codex" 像素区域:python3 <path-to-skill>/scripts/take_screenshot.py --mode temp --region 100,200,800,600 活动窗口:python3 <path-to-skill>/scripts/take_screenshot.py --mode temp --active-window 指定窗口 ID:python3 <path-to-skill>/scripts/take_screenshot.py --window-id 12345 macOS 权限预检:bash <path-to-skill>/scripts/ensure_macos_permissions.sh Windows:powershell -ExecutionPolicy Bypass -File <path-to-skill>/scripts/take_screenshot.ps1,可加 -Mode temp、-Path、-Region、-ActiveWindow、-WindowHandle。

Linux 需先具备 scrot、gnome-screenshot 或 ImageMagick import 之一;坐标区域需 scrot 或 ImageMagick import。--app、--window-name、--list-windows 仅限 macOS。多显示器:macOS 全屏每个显示器一个文件,Linux 与 Windows 使用虚拟桌面单图,可用 --region 隔离单显示器。

限制与注意:沙箱内截图检查可能被阻止,可提升权限重试;始终在回复中报告保存的文件路径;不声称使用了宿主未暴露的 MCP 操作;截图输出每条路径各一行,多个匹配时会加 -w<windowId> 或 -d<display> 后缀。