跨平台屏幕截图助手
按应用、窗口、区域或显示器捕获桌面截图并保存到指定位置。
脚本按用户路径、默认位置或临时目录保存截图,并在 macOS 预检时解释并请求屏幕录制权限;但截图可能包含敏感屏幕内容,Linux/Windows 缺少同等的用户确认、敏感数据提示、访问范围说明和回滚/清理指导,且会调用系统命令,故扣分。
Python 脚本有参数互斥校验、平台分支、工具探测和较明确的失败消息,内置测试模式也提供一定可复现性;但静态材料未包含其引用的 macOS Swift 文件或 Windows PowerShell helper,也没有提交的覆盖性测试或 CI 证据,故按静态上限保守扣分。
SKILL.md 明确了桌面截图、应用/窗口、区域和工具优先级,并区分 macOS、Linux、Windows;但非适用范围、触发边界、中文使用说明和环境前置条件仍不完整。核心为本地 OS 能力,不依赖海外在线服务,因此未因大陆网络额外扣分。
文档结构清晰,包含安装路径占位、命令示例、平台限制、多显示器行为和错误处理;但单技能许可证未知,缺少版本、变更记录、明确维护责任和更新路径,且 README 明确仓库已弃用,故扣分。
功能目标明确,默认位置、临时目录、显式路径、窗口和区域等输出模式基本覆盖常见截图任务;但关键辅助文件缺失于所给材料,依赖可用性和代表性结果未静态验证,直接可用性只能部分确认,故扣分。
源码、参数校验、平台选择逻辑和测试模式可审计,属于有限的一手证据;但没有独立执行记录、完整测试套件、CI 或第三方复核,不能达到更高静态分数。
- 所给材料未包含 take_screenshot.py 引用的 macos_permissions.swift、macos_window_info.swift、macos_display_info.swift 或 Windows PowerShell helper;安装后应确认这些文件实际存在。
- 截图可能泄露屏幕上的凭据、个人信息或内部数据;使用前应确认捕获范围和保存位置,并避免将输出放入不受信任目录。
- README 标明仓库已弃用;应确认该修订仍是预期的维护来源。
它能做什么 & 适用场景
该技能用于用户明确要求桌面或系统截图的场景,也可在缺少专用工具时执行操作系统级截图。它支持整屏、活动窗口、指定应用或窗口、像素区域等捕获方式。macOS、Linux 和 Windows 分别提供辅助脚本,并规定了用户指定路径、系统默认位置和临时目录的保存规则。它适合需要可重复截图流程的桌面操作,但实际可用性取决于操作系统权限和本机截图工具。
根据用户指定的路径、默认位置或临时模式保存截图;在 macOS 上可按应用名、窗口标题或窗口 ID 捕获,也可捕获指定区域或活动窗口;在 Linux 上使用 scrot、gnome-screenshot 或 ImageMagick import,并支持区域和活动窗口捕获;在 Windows 上通过 PowerShell helper 执行整屏、区域、活动窗口或指定窗口句柄截图;完成后报告生成的文件路径。
- 需要记录整个桌面或多显示器状态的用户,可执行整屏截图。
- 需要检查某个桌面应用界面的用户,可在 macOS 上按应用名或窗口标题捕获。
- 只需保存界面局部的用户,可使用像素区域参数截图。
- 需要让代理检查当前界面的用户,可将截图保存到临时目录后查看。
- 在浏览器或 Electron 应用缺少专用截图能力时,可使用操作系统级捕获。
优缺点一览
- 覆盖 macOS、Linux 和 Windows。
- 支持整屏、应用、窗口、活动窗口、窗口句柄和像素区域等捕获范围。
- 明确区分用户指定路径、系统默认位置和代理临时检查目录。
- 提供 macOS 权限预检和 Linux 工具选择逻辑。
- macOS 应用或窗口捕获需要 Screen Recording 权限。
- Linux 必须安装 scrot、gnome-screenshot 或 ImageMagick import 之一。
- 资料未提供测试套件、版本要求或各平台验证记录。
- 单个技能的许可证内容未提供,无法从资料确认具体授权条款。
如何安装
该技能位于仓库的 skills/.curated/screenshot/。README 说明可在 Codex 中使用 $skill-installer screenshot 安装 curated skill,安装后重启 Codex。README 未说明单独的费用;单个技能的许可证应查看其目录内的 LICENSE.txt,但本资料未提供该文件内容。
如何使用
直接提出“截取屏幕截图”即可使用默认保存位置。指定路径时,可使用:python3 <path-to-skill>/scripts/take_screenshot.py --path output/screen.png。代理自检可使用:python3 <path-to-skill>/scripts/take_screenshot.py --mode temp;像素区域可使用:python3 <path-to-skill>/scripts/take_screenshot.py --mode temp --region 100,200,800,600。macOS 应用捕获支持 --app 和 --window-name;Linux 支持 --active-window;Windows 使用 PowerShell helper。实际技能目录路径需由安装环境提供。
对比同类
该技能明确建议优先使用专用截图能力,例如 Figma MCP/skill 或 Playwright/agent-browser;只有在这些能力不可用、用户要求系统截图或桌面应用没有更好集成工具时使用本技能。