Agent Skills
返回列表
OverRec 屏幕与窗口

OverRec 屏幕与窗口

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_889c59d9/overrec-screen。

技能介绍

要解决什么问题

在 Windows 或 WSL 里做自动化演示、排障或布局整理时,你往往需要:看清多显示器坐标、对某块区域截图、临时在屏幕上标出矩形,以及按窗口标题找到句柄并把窗口贴到指定像素矩形。纯靠鼠标很难复现同一布局,脚本里又缺少一套统一的 CLI 约定。本技能把 Agent 引导到 OverRec CLI,用同一套命令完成显示器查询、叠加层、截图与窗口对齐。

技能如何工作

运行前应先确认环境里能调用 OverRec(Windows 下 OverRec.exe;WSL 下通过 pwsh.exe -C 或 powershell.exe -C 转发)。核心能力包括:

  • cli monitors:列出显示器;需要绝对坐标或多屏相对定位时,配合 --all 查看每台显示器的 Abs Position 与尺寸。
  • cli draw:在指定 x,y,width,height 上绘制置顶矩形叠加层,可选颜色与 --timeout;未关闭前会一直盖住该区域。
  • cli screenshot:按区域截图;默认进剪贴板,可用 --output 落盘、--no-clipboard 跳过剪贴板。
  • cli window:按标题关键词(不区分大小写、需同时包含所有关键词)枚举可见窗口,解析输出中的 WindowID 与标题。
  • cli snap:用 --windowid 配合 --location / --size(或 --monitor 下的相对坐标)恢复并前置窗口;说明中提到会对 DWM 阴影边距 做校正,使可见边框落在目标矩形上。

常见请求会走固定流程:未知布局时先查显示器;截图或标区域时先算坐标再执行;贴靠窗口时先 window 再 snap;左右分屏则按显示器尺寸切分矩形后对每个窗口 snap。若用户要「监视某区域」,技能会按间隔循环截图并落盘,并询问区域、间隔与停止条件。

适用边界与注意点

  • 平台:仅 Windows 或 WSL;OverRec 必须已安装且在 PATH(或提供完整路径)。
  • 坐标:主屏左上角为 (0,0);副屏请用 monitors --all 再决定 --monitor 与相对坐标,模糊描述(如「右上角四分之一」)需要先换算。
  • 窗口匹配:标题关键词无匹配或多条匹配时,应明确告知并让用户选定 WindowID,避免误 snap 到错误窗口。

使用场景

  • 多显示器环境排障时,先列出各屏 Abs Position,再对副屏指定矩形区域截图并保存到文件。
  • 录制或讲解桌面操作时,在目标坐标绘制置顶叠加框,用颜色与超时标出点击或关注区域。
  • 演示或直播前按窗口标题关键词查找 WindowID,将两个应用 snap 到主屏左右两半的固定像素矩形。
  • 需要对比界面是否变化时,对固定屏幕区域按间隔循环截图,将帧序列写入指定目录直至达到停止条件。

适合人员

  • 在 Windows 上维护内部运维面板、需要把日志窗口与浏览器按固定布局并排贴靠的 SRE
  • 编写桌面回归脚本、需按标题解析 WindowID 并将窗口对齐到多屏坐标的自动化测试工程师
  • 远程协助排障时、要区域截图并在屏幕上标出故障位置发给同事的技术支持
  • 在 WSL 里开发脚本、通过 pwsh 调用 OverRec 做截图与窗口定位的后端或工具链工程师