Type something to search...
to navigateto selectESC to close

OverRec CLI 参考

OverRec 内置无界面 CLI 模式，支持脚本化和自动化操作。

OverRec.exe cli <命令> [选项]

monitors — 列出显示器

OverRec.exe cli monitors [--all]

不带 --all 时，输出精简的 ID/分辨率列表。 带 --all 时，输出完整详情：分辨率、绝对位置、缩放比例、刷新率、旋转角度及是否为主显示器。

示例输出（--all）：

ID    Resolution      Abs Position      Scale   Hz        Rot    Primary
0     1920x1080       (0, 0)            1       60        0°     yes
1     2560x1440       (1920, 0)         1       144       0°

window — 按标题关键词查找窗口

OverRec.exe cli window [--all] [<关键词...>]

列出标题包含所有给定关键词的可见窗口（不区分大小写）。输出的 WindowID 用于 snap 命令。

不带 --all 时，输出精简的 ID/标题列表。 带 --all 时，还会显示显示器编号、位置和尺寸。最大化或最小化的窗口位置显示为 max 或 min。

示例：

OverRec.exe cli window chrome
OverRec.exe cli window visual studio
OverRec.exe cli window --all note

默认输出示例：

WindowID        Title
------------------------------------------------------------
657846          Google Chrome
329812          Visual Studio Code

--all 输出示例：

WindowID        Mon   Location          Size          Title
--------------------------------------------------------------------------------
657846          0     0,0               1920x1080     Google Chrome
329812          0     max               1920x1080     Visual Studio Code
131070          1     1920,0            1280x720      Notepad

提示：不带关键词运行 OverRec.exe cli window 可列出所有可见窗口。

snap — 移动并调整窗口大小

OverRec.exe cli snap --windowid ID --location X,Y --size WxH [--monitor ID]

将 --windowid 指定的窗口移动并调整至给定位置和尺寸。DWM 阴影边距会自动修正，确保可见窗口框架精确落在指定坐标处。

选项说明
--windowid ID来自 OverRec.exe cli window 的窗口句柄
--location X,Y左上角像素坐标
--size WxH宽度 × 高度（像素）
--monitor ID可选。以指定显示器左上角为原点偏移 --location

示例：

# 对齐到屏幕绝对坐标
OverRec.exe cli snap --windowid 657846 --location 0,0 --size 1920x1080

# 对齐到显示器 1 的左上四分之一区域
OverRec.exe cli snap --windowid 657846 --location 0,0 --size 1280x720 --monitor 1

draw — 显示覆盖矩形

OverRec.exe cli draw --location X,Y --size WxH [--color COLOR] [--timeout SECS] [--monitor ID] [--grid SIZE] [--grid-line dotted|dashed|solid]

打开全屏透明覆盖层并绘制矩形。持续显示直至窗口关闭或超时。

选项说明
--location X,Y相对于显示器的左上角坐标
--size WxH宽度 × 高度（像素）
--color COLOR边框颜色：red、green、blue、yellow、white、black 或 #RRGGBB（默认：blue）
--timeout SECSN 秒后自动关闭
--monitor ID绘制所在显示器（默认：0）
--grid SIZE叠加带标签的测量网格，单元格为 SIZE 像素（最小 10）
--grid-line 样式网格线样式：dotted（点状，默认）、dashed（虚线）或 solid（实线）

示例：

OverRec.exe cli draw --location 100,100 --size 800x600
OverRec.exe cli draw --location 0,0 --size 1920x1080 --color "#FF4400" --timeout 3
OverRec.exe cli draw --location 200,200 --size 400x300 --monitor 1
OverRec.exe cli draw --location 256,211 --size 955x692 --grid 200 --color red
OverRec.exe cli draw --location 0,0 --size 1920x1080 --grid 100 --grid-line solid

screenshot — 截取区域到文件或剪贴板

OverRec.exe cli screenshot --location X,Y --size WxH [--output path.png] [--no-clipboard] [--monitor ID]

截取指定屏幕区域。默认将图像复制到剪贴板；使用 --output 可保存为文件（也可同时保存）。

选项说明
--location X,Y相对于显示器的左上角坐标
--size WxH宽度 × 高度（像素）
--output path.png保存为文件（必须以 .png 结尾）
--no-clipboard不复制到剪贴板
--monitor ID截取所在显示器（默认：0）

示例：

# 复制到剪贴板
OverRec.exe cli screenshot --location 0,0 --size 1920x1080

# 仅保存到文件
OverRec.exe cli screenshot --location 100,200 --size 800x600 --output capture.png --no-clipboard

# 保存并复制
OverRec.exe cli screenshot --location 0,0 --size 1280x720 --output shot.png

record — 将区域录制为 GIF 或 MP4

OverRec.exe cli record --location X,Y --size WxH --output file.gif|file.mp4 --timeout SECS [--fps N] [--monitor ID] [--ffmpeg PATH] [--async]

将指定屏幕区域录制为动态 GIF 或 H.264 MP4。默认情况下，命令会等待至超时结束并完成文件写入；使用 --async 可启动后台进程并立即返回。

GIF 编码为内置功能。MP4 需要 FFmpeg（默认使用 PATH 中的 ffmpeg，或通过 --ffmpeg PATH 指定）。在 Windows 上，MP4 捕获使用 Desktop Duplication，且录制区域必须位于单个未旋转的显示器内。

选项说明
--location X,Y相对于显示器的左上角坐标
--size WxH宽度 × 高度（像素）
--output FILE输出路径，须以 .gif 或 .mp4 结尾
--timeout SECS必填。N 秒后停止并完成录制
--fps N帧率，1 到 240（默认：10）
--monitor ID以该显示器的左上角作为坐标原点
--ffmpeg PATH仅 MP4。FFmpeg 可执行文件路径
--async在后台进程中录制并立即返回

示例：

# 将区域录制为 GIF，时长 10 秒
OverRec.exe cli record --location 0,0 --size 1280x720 --output demo.gif --timeout 10

# 以 30 fps 录制为 H.264 MP4
OverRec.exe cli record --location 0,0 --size 1920x1080 --output demo.mp4 --timeout 15 --fps 30

# 启动后台录制并立即返回
OverRec.exe cli record --location 0,0 --size 1280x720 --output demo.mp4 --timeout 20 --fps 30 --async

mcp — 运行 MCP 服务器

OverRec.exe cli mcp [--host ADDR] [--port PORT] [--stdio]

启动一个 Model Context Protocol 服务器，将每个 CLI 命令暴露为工具，让 AI 代理（Claude Code、Claude Desktop 等）可直接截图、绘制覆盖层、录屏并对齐窗口。

选项说明
--host ADDR仅 HTTP。绑定地址（默认：127.0.0.1）
--port PORT仅 HTTP。TCP 端口（默认：7820）
--stdio使用 stdio 传输方式而非 HTTP

提供两种传输方式：可流式 HTTP（默认），端点为 POST http://HOST:PORT/mcp；以及 stdio（--stdio），适用于将服务器作为子进程启动的客户端。

在 Claude Code 中注册：

# HTTP — 先启动服务器，再添加
OverRec.exe cli mcp
claude mcp add --transport http overrec http://127.0.0.1:7820/mcp

# stdio — 由 Claude Code 启动并管理进程
claude mcp add overrec -- OverRec.exe cli mcp --stdio

典型工作流

# 1. 列出显示器
OverRec.exe cli monitors --all

# 2. 查找要对齐的窗口
OverRec.exe cli window chrome

# 3. 将其对齐到显示器 0 的左半部分
OverRec.exe cli snap --windowid 657846 --location 0,0 --size 960x1080

# 4. 可选：绘制参考矩形以验证区域
OverRec.exe cli draw --location 0,0 --size 960x1080 --timeout 2

# 5. 截取该区域截图
OverRec.exe cli screenshot --location 0,0 --size 960x1080 --output left-half.png