OverRec 屏幕与窗口
将以下提示词粘贴到你的 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 做截图与窗口定位的后端或工具链工程师