远程协同(经 Reeve)
Reeve 是一款远程运维工具。它可以经已有的 SSH 连接在一台 Windows 电脑上运行 AgileShot 的 MCP 程序, 把截图、读界面、按控件点击、输入这些能力交给它的 AI 助手,也交给 Claude Code 等连上 Reeve 的 AI 客户端。 不用开远程桌面(Win11 家庭版本来也没有),也不用在那台电脑上装 AI 客户端。
你的电脑:Reeve(审批 / 审计) ──SSH──▶ 那台 Windows 电脑:AgileShot(门控 / 让路 / 审计)
审批和审计在 Reeve 那边做;AgileShot 这边的开关、敏感窗口拒绝和调用审计照样生效,两边各管一层。 在 Reeve 里怎么接入、怎么复核工具,见 Reeve 文档的远程桌面协同。本页只讲被操作的这台电脑。
这台电脑要做的准备
- 安装 AgileShot,建议用最新版(至少 3.9.1,见下表),并让它开机自启、常驻托盘。AI 调用时主程序必须在运行。
- 「MCP 接入」里打开 截屏、鼠键 两项能力。
- 「MCP 接入 · 鼠键自动化」里把授权设为 始终允许(不限时)。限时授权到点就收回,远程的 AI 会被拒绝,它也没法替你点「立即授权」。
- 保持登录。Reeve 要用桌面上登录的那个账号连接,AgileShot 只认这个用户。
| 版本 | 对远程协同的影响 |
|---|---|
| 3.9.0 起 | 锁屏时可以后台操作(要自己打开开关,见下文);远程看画面不进截图历史;审计分得清远程和本机 |
| 3.9.1 起 | 锁屏时远程点击、输入不再报超时、不再卡住主程序 |
| 3.9.3 起 | AI 列控件的返回只有原来的约 1/4,省 token |
锁屏时也能干活(3.9.0 起)
电脑锁屏时,AgileShot 默认拒绝一切操作。要让远程的 AI 锁屏后继续干活,在这台电脑上的「MCP 接入 · 鼠键自动化」里打开 锁屏时允许后台操作(远程协同用)。默认关闭,只能在本机界面里打开,Reeve 和 AI 都改不了。
| 锁屏时 | 工具 |
|---|---|
| 可以 | 按控件点击 / 填写(click_element_by_id、type_into_element 等)、启动程序、操作后台模式里的程序 |
| 拒绝,并告诉 AI 改用什么 | 移动鼠标、按坐标点击、打字、按键这类需要真实键鼠的操作 |
| 永远不碰 | 锁屏界面本身、UAC、密码框;不会替你输密码解锁 |
- 只对远程调用生效(经 SSH 启动的连接程序)。这台电脑本机上的 AI 客户端,锁屏时照旧被拒绝。
- 锁屏时截全屏只能截到锁屏画面;用显卡绘制的窗口可能截出空白,AI 会改用读窗口文字核对。
事后怎么查
- 调用审计的「来源」列:每条调用标「远程」或「本机」,锁屏时发生的再标「· 锁屏」。可以按来源筛选,导出的 CSV 也带这一列。 来源由系统按调用方所在的 Windows 会话判定,不靠调用方自己报。
- 解锁提醒:锁屏期间有远程调用(成功或被拒都算),解锁回到桌面时会提示「锁屏期间有远程操作」和「远程执行了 N 个操作(M 个被拒绝),点击查看」, 点开直接定位到审计里这段时间的记录。有人远程看过画面,会单独写一句「锁屏期间有人远程查看了画面」。没有就不提示。
远程看画面不占截图历史
Reeve 工作台的「桌面」页每隔几秒刷新一次画面,用的是 screen_preview:返回低清 JPEG,不落盘、不进截图历史,
同一条连接上连续的预览在审计里合并成一条,记下起止时间和帧数。它受「允许 AI 截屏」开关控制。
AI 自己要看屏幕、判断或核对操作时,仍然用 screenshot_* 系列。那些截图会进历史,方便你事后逐步核对。
升级 AgileShot 后要在 Reeve 里复核一次
工具清单(名称、说明、参数)一变,Reeve 会把这台电脑的 AgileShot 服务整个暂停,等你在 Reeve 里重新复核, 免得程序被换掉之后 AI 照用不误。复核窗口会标出新增和改过的工具,改过的会自动取消勾选,看过新说明后记得勾回去, 否则 AI 就用不了那个工具。这是 Reeve 的安全设计,不是出错。
常见问题
| 现象 | 处理 |
|---|---|
| Reeve 提示工具清单与上次复核时不一致,已暂停 | AgileShot 升级过。到 Reeve「AI 助手 → 外部工具」复核,把改过的工具勾回去 |
| AI 说「Automation is not armed」 | 鼠键授权过期了,改成「始终允许(不限时)」 |
| AI 说「via AI is disabled」 | 对应能力(截屏 / 鼠键)没打开,在「MCP 接入」里打开 |
| AI 说「screen is locked」 | 电脑锁屏了:请人解锁,或打开上文的锁屏开关(3.9.0 起) |
| 锁屏时远程点击报超时,之后主程序一阵子没反应 | 升级到 3.9.1 或更新版本 |
结果以 UNCONFIRMED 开头 |
动作已经发出,但目标程序没及时回应,多半已经生效。AI 应先回读(list_ui_elements / get_element_state / read_window_text)确认,别直接重发 |
| AI 说「Yielded」 | 有人正在用这台电脑的鼠标键盘,AI 临时让路,等人停手后再继续 |
安全边界
- 鼠键授权和各项能力开关只能在这台电脑上改,远程改不了。
- 密码框、UAC、锁屏界面这类敏感窗口一律拒绝操作。
- 有人在用鼠标键盘时 AI 让路;按 Ctrl+Alt+Esc 可以随时收回全部自动化权限。
- 每次调用都记进 AgileShot 的调用审计,Reeve 那边另有一份审计。