Windows Screenshot

核心用法

windows-screenshot 是一个自包含的 PowerShell 脚本，利用 Windows 内置的 System.Drawing (GDI+) 库实现屏幕捕获。用户可通过 powershell -File screenshot.ps1 直接执行，或通过 OpenClaw 框架调用。脚本支持通过 OPENCLAW_MEDIA_DIR 环境变量自定义输出路径，默认保存至 $USERPROFILE\.openclaw\media，文件名带时间戳避免冲突。

显著优点

• 零依赖部署：无需安装第三方软件或模块，依赖 Windows 原生 .NET Framework 4.x+
• 源码完全透明：MIT-0 许可证，GitHub 开源可审查，非黑盒工具
• 系统级捕获：GDI+ 直接调用显卡帧缓冲，兼容性优于部分截图 API
• 自动化友好：输出 MEDIA: 前缀路径，便于流水线集成（如 Telegram Bot 推送）
• 高 DPI 适配：自动感知屏幕缩放比例，避免模糊或裁切问题

潜在局限

• 仅支持主屏幕：多显示器环境下无法指定副屏捕获
• Windows 独占：依赖 .NET Framework，无跨平台能力
• 无交互界面：纯命令行工具，不适合需要选区截图的场景
• 24-bit 色深：无透明度通道，专业设计场景可能受限

适合人群

DevOps 工程师、自动化测试开发者、需要无 GUI 截图方案的技术用户，以及重视源码可审计性的安全敏感场景。

常规风险

• 权限要求：需用户级权限访问屏幕缓冲区，企业环境可能有组策略限制
• 数据本地性：虽无网络传输，但截图文件落盘需关注磁盘加密状态
• 时间戳依赖：快速连续调用可能因秒级精度产生文件名竞争（概率极低）

核心用法

windows-screenshot 是一个基于纯 PowerShell 的 Windows 屏幕截图工具，利用系统内置的 GDI+ 图形库（System.Drawing）实现高效屏幕捕获。用户可通过命令行直接执行 powershell -File screenshot.ps1 获取主屏幕截图，输出为带时间戳的 PNG 文件（24-bit 彩色）。脚本支持通过 OPENCLAW_MEDIA_DIR 环境变量自定义输出目录，默认保存至 $USERPROFILE\.openclaw\media。对于 OpenClaw 用户，可通过 openclaw exec 调用，并配合消息发送功能实现截图-传输自动化。

显著优点

1. 零外部依赖：仅需 Windows 系统自带的 .NET Framework 4.x+，无需安装任何第三方软件或库。
2. 代码完全透明：完整源码托管于 GitHub（MIT-0 许可证），支持公开审查，杜绝黑箱操作。
3. 高 DPI 自适应：自动识别屏幕缩放设置，输出分辨率与实际显示一致。
4. 资源管理规范：显式调用 Dispose() 释放 GDI 对象，避免内存泄漏。
5. 合规性优秀：通过 GDPR 数据最小化、本地化处理等多项合规检查，无第三方数据传输。

潜在缺点或局限性

• 功能边界有限：仅支持主屏幕截图（PrimaryScreen），暂不支持多显示器选择、区域截图或滚动长截图。
• 平台锁定：完全依赖 Windows GDI+ API，无法跨平台运行。
• T3 来源可信度：由个人开发者维护，虽代码开源可审，但缺乏企业级维护背书。
• 无实时预览：执行前无法预览截图范围，依赖后处理筛选。

适合人群

• 需要轻量级、可脚本化截图方案的 Windows 开发者与运维人员
• 对安全敏感、要求源码可审计的企业环境用户
• 希望避免安装 Greenshot、ShareX 等重型工具的效率用户
• OpenClaw 生态用户，需要与自动化工作流集成的场景

常规风险

• 屏幕内容泄露：截图可能包含敏感信息（密码、令牌等），保存路径需妥善管理。
• 路径遍历风险：虽脚本使用 Join-Path 安全拼接路径，但若环境变量被恶意篡改，理论上可能指向非预期目录（建议运行前校验环境变量）。
• GDI+ 兼容性：极罕见情况下，特定显卡驱动或远程桌面会话可能导致全黑截图。