Screenshot

核心用法

本技能提供多平台截图解决方案，覆盖命令行原生工具、编程接口及自动化场景：

macOS：screencapture 为内置首选，-x 静默模式适合脚本，-i 支持交互选区。Retina 屏幕需注意 2x 分辨率输出，可用 -R 指定精确像素区域。iOS 模拟器推荐 xcrun simctl io booted screenshot，比 screencapture 更稳定。

Linux：桌面环境各有专精工具（GNOME 用 gnome-screenshot，KDE 用 spectacle）。无头环境用 xvfb-run scrot 创建虚拟显示。Wayland 生态需特别注意：X11 工具会静默失效，应切换至 grim+slurp 组合。

Windows：避免冗长的 PowerShell API 调用，推荐 nircmd savescreenshot 单命令方案。跨平台脚本可用 Python PIL/Pillow 的 ImageGrab。

网页自动化：Playwright 和 Puppeteer 处理 JavaScript 渲染页面，务必设置 networkidle 等待避免捕获不完整内容。超长页面建议分块截屏，避免全页截图的像素化问题。

格式与优化：UI/文本用 PNG 保无损，照片用 JPEG（质量 85-92 为甜点区）。WebP 可省 25-35% 空间，但需考虑旧版 Safari 兼容性。CI 场景用 pngquant/jpegoptim 预压缩以节省存储传输。

显著优点

• 平台覆盖完整，命令可直接复制执行
• 针对 Retina、Wayland 等现代特性给出具体对策
• 自动化细节（时间戳命名、视口一致性、压缩优化）实用

潜在局限

• 部分工具（nircmd、Playwright）需额外安装
• Wayland 生态工具链仍在演进，兼容性需注意
• 未涉及移动端真机 screenshot 方案

适合人群

DevOps 工程师、QA 自动化测试人员、技术文档写作者、需要批量截图处理的开发者。

常规风险

• 截图可能意外包含敏感信息（窗口标题、通知内容），自动化脚本需审查输出
• 网页截图工具执行外部 JavaScript，需信任目标 URL
• xvfb-run 等虚拟显示方案在共享 CI 环境可能有资源竞争

核心用法

本 Skill 是一份纯粹的跨平台截图工具使用指南，按操作系统分类整理：

• macOS：推荐使用内置 screencapture 命令，支持静默截图（-x）、交互选区（-i）、指定窗口捕获（结合 AppleScript 获取窗口 ID），Retina 屏幕需注意 2x 分辨率输出。iOS 模拟器开发场景优先使用 xcrun simctl io booted screenshot。

• Linux：桌面环境差异大——GNOME 用 gnome-screenshot，KDE 用 spectacle，极简环境用 scrot。关键提示：Wayland 会话会导致传统 X11 工具失效，必须切换至 grim + slurp 组合。CI/无头环境可用 xvfb-run 创建虚拟显示器。

• Windows：避开冗长的 PowerShell 原生方案，推荐使用 nircmd savescreenshot 一键捕获。Python 开发者可用 PIL.ImageGrab 实现跨平台程序化截图。

• 网页截图：Playwright 和 Puppeteer 为现代首选，支持 JavaScript 渲染与全页滚动捕获。关键参数：--wait-for-timeout 避免动态内容截断，长页面建议分块而非强制全页以防像素化。

• 格式优化：UI/文本用 PNG（无损），照片用 JPEG（质量 85-92 为甜点），WebP 可省 25-35% 体积但需考虑 Safari 兼容性。

• 自动化模式：时间戳命名防覆盖、统一视口尺寸保对比测试一致性、CI 产物用 pngquant/jpegoptim 压缩减存传成本。

显著优点

1. 全平台覆盖：从开发者日常到 CI 流水线，从桌面应用到移动模拟器，场景完整
2. 工具选型务实：明确区分"可用"与"推荐"，如 Windows 直接否定 PowerShell 冗长写法
3. 细节陷阱预警：Retina 2x 分辨率、Wayland 兼容性、JPEG 质量甜点区间等经验性知识密度高
4. 零依赖零风险：纯 Markdown 文档，无代码执行，无供应链攻击面

潜在局限

1. 纯文档性质：无封装脚本或统一 CLI，用户需手动拼接命令
2. 无交互界面：不适合非技术用户直接使用
3. 许可状态模糊：安全报告提示未检测明确开源许可证
4. 工具版本差异：如 nircmd 在部分企业环境可能被安全软件拦截

适合人群

• 开发者、测试工程师、DevOps 运维（CI 截图调试）
• 技术写作者、UI 设计师（批量界面归档）
• 自动化测试场景下的截图需求方

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 隐私泄露 | 低 | 用户自行执行截图，工具本身不传输数据 |

| 恶意代码 | 极低 | 纯文档无执行代码，供应链风险为零 |

| 误操作 | 中 | 命令行工具可能捕获敏感界面，需用户自行注意 |

| 第三方工具 | 低 | `nircmd` 等外置工具需从官方渠道获取 |

> 认证结论：CLS-Certify v2.1.0 全维度扫描 100 分，安全等级 S+，来源可信度 T3（个人/社区项目）。