Windows Screenshot

📸 零依赖 PowerShell 屏幕捕获专家

纯 PowerShell 实现的 Windows 屏幕截图工具,零外部依赖,利用 GDI+ 高效捕获多屏并自适应 DPI 缩放,输出高质量 PNG。

收藏
14.1k
安装
2.8k
版本
1.0.1
CLS 安全性认证2026-05-18
点击查看完整报告 >

使用说明

核心用法

windows-screenshot 是一个基于纯 PowerShell 的 Windows 屏幕截图工具,核心功能通过调用系统内置的 System.Drawing (GDI+) 库实现屏幕捕获。

执行方式:

  • 直接运行:powershell -File screenshot.ps1
  • 通过 OpenClaw 调用:openclaw exec powershell -File screenshot.ps1
  • 支持与其他工具链整合(如 Telegram 发送)

输出特性:

  • 自动保存至 .openclaw/media/screenshot_YYYYMMDD_HHMMSS.png
  • 输出带 MEDIA: 前缀的路径,便于下游自动化处理
  • PNG 24-bit 格式,文件大小通常 50-200 KB

显著优点

1. 零依赖部署:纯 PowerShell 实现,无需安装第三方工具(如 Snipping Tool、ShareX、Greenshot)
2. 系统级捕获:GDI+ 为 Windows 原生图像库,性能稳定,兼容性好

3. DPI 自适应:自动处理高分辨率屏幕的缩放问题,避免截图模糊

4. 完全开源可审计:MIT-0 许可证,源码托管于 GitHub,可逐行审查

5. 轻量集成:适合自动化脚本、CI/CD 流程、远程服务器截图等场景

潜在缺点与局限性

1. 仅支持主屏幕:明确标注"多屏支持 - 捕获主屏幕",实际多显示器场景需手动指定屏幕
2. Windows 独占:依赖 .NET Framework 4.x+ 和 GDI+,无法跨平台运行

3. 无交互功能:纯命令行工具,不支持区域选择、延迟截图、标注编辑等高级功能

4. GPU 状态敏感:锁屏或特定 GPU 状态下可能出现全黑截图

5. 无内置传输:Telegram 发送需额外配置环境变量和独立步骤

适合人群

  • 自动化运维人员:需要在脚本中集成截图功能(如错误现场留存)
  • 开发者/测试人员:轻量级 bug 截图反馈,不依赖 GUI 工具
  • 远程服务器管理员:通过 PowerShell 远程会话捕获屏幕状态
  • 隐私敏感用户:拒绝闭源商业截图工具,偏好可审计的开源方案

常规风险

| 风险类型 | 评估 | 说明 |
|---------|------|------|
| 恶意代码 | 极低 | 完全开源,MIT-0 许可,可逐行审查 |
| 数据泄露 | 低 | 仅本地保存,无隐式网络传输 |
| 权限问题 | 中 | 需 PowerShell 执行权限,企业环境可能受限 |
| 误用风险 | 低 | 仅在显式调用时执行,无后台驻留 |
| 兼容性 | 低 | 依赖 Windows 内置 .NET,老旧系统可能缺失 GDI+ |

总体安全建议:适用于可信环境的标准自动化任务,敏感场景建议预先审查 GitHub 源码并限制执行权限。

安全解读

核心用法

windows-screenshot 是一款基于 Windows GDI+ 的纯 PowerShell 屏幕截图工具。用户将附带的 screenshot.txt 重命名为 .ps1 后,通过 powershell -File screenshot.ps1 执行,即可捕获主屏幕并输出 24-bit PNG 到 .openclaw/media 目录。脚本支持自动 DPI 缩放适应,无需手动指定分辨率。

显著优点

  • 零外部依赖:仅依赖 Windows 内置的 .NET Framework 4.x+,无需安装第三方库或工具
  • 源码完全透明:MIT-0 许可证开源,GitHub 可审查全部代码,非「下载执行」黑箱模式
  • 本地化安全:截图仅保存至本地目录,无内置网络上传功能,隐私可控
  • 多屏基础支持:自动识别主屏幕,适应高 DPI 环境
  • 格式通用:标准 PNG 输出,兼容性强

潜在局限

  • 仅支持 Windows:依赖 .NET Framework GDI+,不跨平台
  • 主屏幕限制:当前版本仅捕获主显示器,多屏扩展场景需手动修改脚本
  • T3 来源风险:由个人开发者维护,缺乏组织背书,长期维护持续性不确定
  • 无 GUI:纯命令行交互,对非技术用户门槛较高
  • 锁屏/安全软件干扰:部分安全软件可能拦截 GDI+ 截屏行为

适合人群

  • Windows 系统管理员、DevOps 工程师
  • 需要自动化截图集成到脚本/工作流的技术用户
  • 重视源码可审查、拒绝闭源截屏工具的安全敏感用户

常规风险

  • 来源可信度:T3 级别(个人开发者),虽经安全扫描无恶意,但仍建议自行审查 GitHub 源码
  • 权限需求:PowerShell 执行策略可能需调整(建议 RemoteSigned 而非 Unrestricted
  • 数据泄露误操作:用户若手动配置 Telegram 等外发集成,需自行承担密钥管理和传输风险
  • GPU/驱动兼容:极少数情况下可能出现黑屏截图,与显卡驱动或远程会话状态相关

Windows Screenshot 内容

手动下载zip · 2.9 kB
README.mdtext/markdown
请选择文件