核心用法
windows-screenshot 是一个基于纯 PowerShell 的 Windows 屏幕截图工具,利用系统内置的 GDI+ 图像库实现高效捕获。无需安装任何第三方依赖,直接调用 .NET Framework 的 System.Drawing 命名空间完成屏幕位图抓取。支持通过环境变量 OPENCLAW_MEDIA_DIR 自定义输出目录,默认保存至 $USERPROFILE\.openclaw\media,文件名带时间戳避免冲突。
执行方式灵活:可直接运行 powershell -File screenshot.ps1,也可通过 OpenClaw 框架调用。输出格式为 PNG 24-bit,文件大小通常 50-200 KB,分辨率自动适配屏幕 DPI 缩放设置。多显示器环境下默认捕获主屏幕。
显著优点
- 零依赖部署:纯 PowerShell 脚本,Windows 10/11 及 Server 系统原生支持
- 源码完全透明:MIT-0 许可证,GitHub 完整开源,可逐行审计无隐藏逻辑
- 轻量高效:相比第三方截图工具,无后台驻留、无配置界面,调用即执行
- OpenClaw 集成:支持
MEDIA:前缀路径输出,便于自动化工作流串联
局限与风险
- 单屏限制:当前版本仅支持主屏幕捕获,多屏用户需手动选择显示器
- 无交互界面:纯命令行工具,不支持区域选择、延时截图等高级功能
- DPI 边缘情况:极少数自定义缩放比例下可能出现 1px 偏差
- 权限要求:部分企业环境可能限制 PowerShell 执行策略(
ExecutionPolicy)
适合人群
Windows 开发者、系统管理员、需要自动化截图工作流的技术用户,以及对第三方闭源截图软件有安全顾虑的隐私敏感型用户。
安全建议
建议从官方 GitHub 仓库获取源码,避免使用未经验证的副本。企业环境可预先将脚本加入防病毒白名单,或转换为 .ps1 后签名执行。