rdp-cli · 0.3.1

rdp-cli 在线命令参考

109 个命令,用于远程桌面、Linux 应用和 Android:连接、观察、操作、交换文件与交接控制。

按任务查找命令

第一次使用 rdp-cli?从安装和首次连接开始。 →

connect
连接持久的 RDP、VNC 或 Android ADB 会话。
screenshot
获取一致的 PNG 截图与观察令牌
click
点击远端坐标
type
不改写剪贴板直接输入;Android 支持可打印 ASCII、换行和制表符,Unicode 粘贴请用 android text。
files upload
上传到会话文件根目录,并核对完成的传输。
files download
从 RDP 交换盘或稳定的 Android 文件快照下载。
watch
打开或激活人类查看器
list
列出可见会话

命令目录已按 Windows、macOS 和 Linux 的 2026110701 构建核对。请用 --version 和 --help-json 核对已安装文件。

观察、操作、验证

USER、SESSION、OBSERVATION、X 和 Y 均为占位符。通过标准输入提供密码后关闭输入流;--password-stdin 不会显示交互式密码提示。保存 data.session,读取 before.png,从图中选取坐标,再检查 after.png。输入已发送不等于任务已完成。

rdp-cli connect --host desktop.example.net --user USER --password-stdin
rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

--version 显示版本与构建能力;--help-json 返回机器可读目录;COMMAND --help 可离线查看该命令的完整参数说明,不会启动会话。

rdp-cli --version
rdp-cli --help-json
rdp-cli connect --help

JSON 与通用参数

普通命令在 stdout 输出一个 UTF-8 JSON 对象:成功为 ok: true 与 data,失败为 ok: false 与 error。stderr 仅供诊断;退出码 0 表示成功,1 表示运行失败,2 表示命令或参数错误。

帮助输出纯文本。events --follow 流式输出 NDJSON;普通 events 返回一个 JSON 结果,其中含 data.events 与 data.ndjson。 Windows PowerShell 5.1 处理非 ASCII 文本时,应将 [Console]::OutputEncoding 与 $OutputEncoding 都设为 UTF-8。

data.session
保存 connect 返回的会话 ID,后续命令使用同一值。
data.observation
输入须使用截图返回的观察令牌;重连、控制权或布局变化后重新截图。
data.capabilities
先检查协商能力,再决定是否使用文件、音频、剪贴板或显示器操作。
data.state / data.remote_outcome
queued、sent、partial、unknown、cancelled、failed 表示输入进度。remote_outcome: not_confirmed 仍需查看远端结果。
data.transfer_id
把传输 ID 交给 files status 或 files cancel;等待终态并检查已完成文件的摘要。
error.code / error.message / error.retryable
使用稳定错误码决策,消息提供上下文;retryable 只是提示,不能据此盲目重复操作。
data.activity
当前或最近的活动、Agent/人工来源、发生时间及传输进度。不含输入正文或剪贴板内容,也不代表远端任务已经完成。

所有命令支持 --request-id 与 --timeout-ms。只有在保留窗口内,以完全相同的命令和参数重试时才复用请求 ID。本地超时不能证明输入未发送,应先查询 operations status。

--request-id ID · --timeout-ms MILLISECONDS

会话

RDP/VNC 的 connect 需要 --host,RDP 还需要 --user;默认端口分别为 3389 和 5900。需要认证时选择一种密码来源;--vnc-security none 不使用密码。ADB 改用 --device 和 --transport,Wi-Fi 可明确指定地址与连接端口。--domain、--size 和 --layout 仅用于 RDP。reconnect 后保持暂停;disconnect 不注销远端用户。

rdp-cli connect#

连接持久的 RDP、VNC 或 Android ADB 会话。

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--profile

已保存的连接配置

文本可选
--host

RDP/VNC 地址,或明确指定的 Android Wi-Fi 端点。

文本可选
--protocol

协议为 RDP、VNC、ADB 或 X11;各自使用明确的目标及认证规则。

枚举
rdp | vnc | adb | x11
默认值: rdp
可选
--mode

X11 模式:已有桌面或转发应用。

枚举
desktop | application
可选
--display

已有且获授权的 X11 display,仅桌面模式。

文本可选
--xauthority

已有远端 Xauthority 文件的绝对路径,仅桌面模式。

文本可选
--ssh-known-hosts

本机 OpenSSH 格式的已知主机文件,不需要外部 SSH 程序。

路径可选
--ssh-key

本机 SSH 私钥;密码输入用于提供其口令。

路径可选
--ssh-host-key

独立核实的 SSH SHA256 指纹。

文本可选
--linux-file-root

获授权的 SFTP 绝对目录;默认在 SSH 用户主目录内创建私有会话目录。

文本可选
--application

已安装远端 X11 应用的绝对路径。

文本可选
--app-args

JSON 格式的字面参数数组,不经过 shell 解释。

文本可选
--device

android devices 返回的明确设备 ID;ADB 必填。

文本可选
--transport

明确选择 USB 或 Wi-Fi;ADB 必填。

枚举
usb | wifi
可选
--device-auth-ref

复用明确保存在系统凭据库中的身份。

文本可选
--save-device-auth

明确将获授权身份保存到此本机引用。

文本可选
--device-file-root

获授权的 Android 目录,默认 /sdcard/Download/rdp-cli/<session-id>。

路径可选
--android-display

手机主屏或会话专用虚拟屏

枚举
main | virtual
可选
--android-virtual-size

虚拟屏尺寸,宽x高

文本可选
--android-virtual-dpi

虚拟屏 DPI

正整数可选
--android-start-app

在新虚拟屏启动的已安装应用

文本可选
--vnc-security

VNC 认证方式;无认证需显式选择 none

枚举
vnc-auth | none | x509-plain | ard
可选
--vnc-tls-pin

VNC X509Plain 已核实的叶证书 SHA256 指纹。

文本可选
--port

TCP 端口:RDP 为 3389,VNC 为 5900。android pair 使用手机显示的配对端口;ADB connect 使用独立的连接端口。

正整数
默认值: RDP 3389 · VNC 5900
可选
--user

本地或域账号;RDP 必填

文本可选
--domain

Windows 域

文本可选
--password

密码;经典 VNC 只用前 8 个 UTF-8 字节

文本可选
--password-stdin

从标准输入读取密码直到 EOF

开关可选
--cert-policy

RDP 服务器证书策略,与 Web HTTPS 无关

枚举
ignore | strict
默认值: ignore
可选
--tls-profile

modern 要求 TLS 1.2 和现代密码算法;legacy 仅为本会话允许旧签名/算法(包括 TLS 1.2 的 SHA-1)及 TLS 1.0,不强制降级

枚举
modern | legacy
默认值: modern
可选
--credential-ref

已有的平台凭据存储引用

文本可选
--audio-mode

RDP 声音去向:查看器(client)、被控电脑(host)或关闭(off)

枚举
client | host | off
默认值: client
可选
--microphone-mode

RDP 麦克风来源:已授权查看器(client)、被控电脑上匹配的帮助程序(host)或关闭(off)

枚举
client | host | off
默认值: client
可选
--save-credential

成功连接后以此引用保存密码

文本可选
--name

可读的会话名称

文本可选
--size

桌面尺寸 WIDTHxHEIGHT

文本可选
--layout

显示器布局 JSON 或 @file

文本可选
--connect-timeout-ms

连接截止时间,单位毫秒

正整数可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli connect --help

rdp-cli list#

列出可见会话

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli list --help

rdp-cli status#

查询一致的会话状态

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli status --help

rdp-cli reconnect#

重连未关闭的会话并保持暂停

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli reconnect --help

rdp-cli disconnect#

关闭远程会话;RDP 不会注销 Windows 用户。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli disconnect --help

查看器与桌面状态

watch 为人打开只读查看器,Agent 命令无需先打开窗口。--viewer 可选 window 或 web。presence show/hide 控制本机状态入口;--floating 添加悬浮控件,--panel 打开 macOS 或 Linux 会话面板。关闭只读窗口不会断开连接。

rdp-cli watch#

打开或激活人类查看器

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--viewer

查看器实现

枚举
window | web
默认值: window
可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli watch --help

rdp-cli presence show#

显示桌面会话状态入口

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--floating

同时显示可选的悬浮会话控件

开关可选
--panel

同时打开 macOS 或 Linux 会话面板

开关可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli presence show --help

rdp-cli presence hide#

隐藏状态入口但保留会话

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli presence hide --help

控制与交接

pause 指定 --session 或 --all,并撤销人类控制;resume 将暂停会话交回 Agent。control take 需要已连接的 viewer ID;release 可指定该查看者或目标 Agent。尊重人类暂停,交还后重新截图。

rdp-cli pause#

暂停普通输入并撤销人类控制

必须二选一:--session SESSION 或 --all。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli pause --help

rdp-cli resume#

将暂停会话交还 Agent

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli resume --help

rdp-cli control take#

把控制权交给已连接的查看器

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--viewer-id

已连接查看器 ID;适用时必须是控制租约持有者

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli control take --help

rdp-cli control release#

将控制权交还 Agent

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--viewer-id

已连接查看器 ID;适用时必须是控制租约持有者

文本可选
--agent-id

接收控制的 Agent

文本可选
--to-agent

目标 Agent 身份

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli control release --help

截图、输入与剪贴板

screenshot 通过 --out 保存 PNG,可用 --monitor 选屏。坐标输入需要 observation,使用屏内坐标或 --desktop 桌面坐标,不能混用。drag 使用起止坐标及可选屏幕 ID。type 的 --text 与 --text-stdin 二选一;--sensitive 只改变提示,不遮挡截图。key 使用 --keys 或 --key 配合 --state。剪贴板写入会明确替换远端文本。

rdp-cli screenshot#

获取一致的 PNG 截图与观察令牌

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--monitor

显示器 ID;screenshot 还可使用 all

文本
默认值: all
可选
--region

远端像素区域 x,y,width,height

文本可选
--max-width

图像最大宽度,不改变输入坐标

正整数可选
--since

先前截图的比较引用

文本可选
--out

目标 PNG 文件

路径可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli screenshot --help

rdp-cli move#

移动远端指针

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--x

远端 x 坐标

整数必填
--y

远端 y 坐标

整数必填
--monitor

显示器 ID;screenshot 还可使用 all

文本可选
--desktop

使用桌面坐标而非显示器内部坐标

开关可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli move --help

rdp-cli click#

点击远端坐标

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--x

远端 x 坐标

整数必填
--y

远端 y 坐标

整数必填
--button

鼠标按键

枚举
left | right | middle
默认值: left
可选
--count

点击次数

正整数可选
--monitor

显示器 ID;screenshot 还可使用 all

文本可选
--desktop

使用桌面坐标而非显示器内部坐标

开关可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli click --help

rdp-cli scroll#

在远端坐标滚动

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--x

远端 x 坐标

整数必填
--y

远端 y 坐标

整数必填
--delta-x

带正负号的水平滚轮单位

整数可选
--delta-y

带正负号的垂直滚轮单位

整数可选
--monitor

显示器 ID;screenshot 还可使用 all

文本可选
--desktop

使用桌面坐标而非显示器内部坐标

开关可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli scroll --help

rdp-cli drag#

在远端坐标之间拖动

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--from-x

起点 x 坐标

整数必填
--from-y

起点 y 坐标

整数必填
--to-x

终点 x 坐标

整数必填
--to-y

终点 y 坐标

整数必填
--from-monitor

起点显示器 ID

文本可选
--to-monitor

终点显示器 ID

文本可选
--desktop

使用桌面坐标而非显示器内部坐标

开关可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli drag --help

rdp-cli type#

不改写剪贴板直接输入;Android 支持可打印 ASCII、换行和制表符,Unicode 粘贴请用 android text。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--text

Unicode 输入或剪贴板文字

文本可选
--text-stdin

从标准输入读取输入或剪贴板文字直到 EOF

开关可选
--sensitive

在可观察事件中隐藏文字;截图仍包含桌面内容

开关可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli type --help

rdp-cli key#

发送组合键或按键状态

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--keys

组合键,例如 CTRL+S

文本可选
--key

按键名称;android key 使用其列出的系统键。

文本可选
--state

按所列值指定按键状态或音频静音状态

枚举
down | up
可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli key --help

rdp-cli clipboard get#

读取远端文本剪贴板

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli clipboard get --help

rdp-cli clipboard set#

写入远端文本剪贴板

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--text

Unicode 输入或剪贴板文字

文本可选
--text-stdin

从标准输入读取输入或剪贴板文字直到 EOF

开关可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli clipboard set --help

文件

--path 相对于授权的 RDP 交换盘、Android 目录或 X11 SFTP 根目录;--local 为本机文件或文件夹。替换文件须带 --overwrite。检查传输状态与完成摘要,结果未知时不要重复操作。

rdp-cli files list#

列出 RDP 交换盘或获授权 Android 目录中的文件。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--path

相对于 RDP 交换盘或获授权 Android 目录的路径。

路径可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli files list --help

rdp-cli files upload#

上传到会话文件根目录,并核对完成的传输。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--local

上传的本地文件/目录或下载的本地目标

路径必填
--path

相对于 RDP 交换盘或获授权 Android 目录的路径。

路径必填
--overwrite

允许替换已有目标

开关可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli files upload --help

rdp-cli files download#

从 RDP 交换盘或稳定的 Android 文件快照下载。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--path

相对于 RDP 交换盘或获授权 Android 目录的路径。

路径必填
--local

上传的本地文件/目录或下载的本地目标

路径必填
--overwrite

允许替换已有目标

开关可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli files download --help

rdp-cli files status#

查询一个或全部文件传输

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--transfer-id

传输 ID;files status 省略时列出会话传输

文本可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli files status --help

rdp-cli files cancel#

取消文件传输

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--transfer-id

传输 ID;files status 省略时列出会话传输

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli files cancel --help

rdp-cli files cleanup#

删除指定交换内容

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--path

相对于 RDP 交换盘或获授权 Android 目录的路径。

路径必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli files cleanup --help

声音与麦克风

RDP 的 --audio-mode client|host|off 和 --microphone-mode client|host|off 分别选择新连接的播放去向和麦克风来源,不会开始录音。host 方向需要被控 Windows 上的对应服务,在 Linux 上不可用。X11/VNC 没有本产品音频通道。

rdp-cli host-microphone install#

在这台 Windows 电脑上安装并启动被控电脑麦克风帮助程序

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli host-microphone install --help

rdp-cli host-microphone status#

检查这台 Windows 电脑是否已安装被控电脑麦克风帮助程序

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli host-microphone status --help

rdp-cli host-microphone uninstall#

停止并删除这台 Windows 电脑上的被控电脑麦克风帮助程序

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli host-microphone uninstall --help

rdp-cli audio status#

查询音频能力与来源

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli audio status --help

rdp-cli audio mute#

为一个查看器静音或解除静音

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--viewer-id

已连接查看器 ID;适用时必须是控制租约持有者

文本必填
--state

按所列值指定按键状态或音频静音状态

枚举
on | off
必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli audio mute --help

rdp-cli audio volume#

设置一个查看器的播放音量

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--viewer-id

已连接查看器 ID;适用时必须是控制租约持有者

文本必填
--percent

播放增益百分比

正整数必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli audio volume --help

rdp-cli audio microphone#

查询或停止当前麦克风

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--action

查询或停止麦克风;开启需要人工查看器

枚举
status | stop
默认值: status
可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli audio microphone --help

rdp-cli audio android#

明确选择手机播放、手机麦克风或关闭。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--source

手机音源:off 关闭,output 需系统共享授权,microphone 需控制权及新的 --observation。

枚举
off | output | microphone
必填
--observation

最新截图返回的观察令牌

文本可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli audio android --help

rdp-cli audio poll#

读取数量受限的最近 PCM 音频样本。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--after

返回此序号之后的事件或 PCM 样本。

正整数可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli audio poll --help

显示器

monitors 返回协商布局。monitors set 接受布局 JSON 或 @file;--allow-reconnect 允许在不能动态调整时重连。按返回布局重新截图后再输入。VNC 可报告帧缓冲区,但不接受主动布局变更。

rdp-cli monitors#

查询协商后的显示器布局

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli monitors --help

rdp-cli monitors set#

更改显示器布局

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--layout

显示器布局 JSON 或 @file

文本必填
--allow-reconnect

不支持动态布局时允许重连

开关可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli monitors set --help

浏览器访问

web start 配置监听地址与 TLS 证书/私钥或受信代理,--ice-server 可重复。非回环访问限局域网/VPN,并需要 HTTPS 和授权。access grant 必须指定可重复的 --permission 与以秒计的 --expires-in。权限含 session.observe/control、clipboard.read/write、files.read/write、audio.listen/send。撤销授权会关闭其流。

rdp-cli web start#

启动内嵌授权 Web 服务

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--listen

监听地址

文本可选
--tls-cert

HTTPS 证书文件

路径可选
--tls-key

HTTPS 私钥文件

路径可选
--trust-proxy

信任已配置的代理

开关可选
--ice-server

WebRTC 使用的 STUN/TURN URL

文本可选 · 可重复
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli web start --help

rdp-cli web status#

查询 Web 服务状态

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli web status --help

rdp-cli web stop#

停止浏览器访问,保留远程会话连接。

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli web stop --help

rdp-cli access grant#

创建有限范围的 Web 授权

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--permission

授予此访问令牌的权限

文本必填 · 可重复
--expires-in

授权有效期,单位秒

正整数必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli access grant --help

rdp-cli access list#

列出 Web 授权

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli access list --help

rdp-cli access revoke#

撤销授权及其流

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--grant-id

授权标识符

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli access revoke --help

Android 手机

明确指定设备 ID 和 usb 或 wifi 传输方式。发现设备不等于授权;配对使用手机的配对端口,连接使用另一个连接端口。配对码通过标准输入发送并结束输入流。仅在明确请求时保存身份。输入和应用变更需要控制权及最新观察;结果不确定时先查询应用任务,不盲目重试。

rdp-cli android devices#

发现 USB 和 Wi-Fi 候选设备,不自动授权。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android devices --help

rdp-cli android pair#

通过配对端口及标准输入中的配对码完成无线配对。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--host

RDP/VNC 地址,或明确指定的 Android Wi-Fi 端点。

文本必填
--port

TCP 端口:RDP 为 3389,VNC 为 5900。android pair 使用手机显示的配对端口;ADB connect 使用独立的连接端口。

正整数必填
--code-stdin

从标准输入读取六位配对码。

开关可选
--device-auth-ref

复用明确保存在系统凭据库中的身份。

文本可选
--save-device-auth

明确将获授权身份保存到此本机引用。

文本可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android pair --help

rdp-cli android forget#

删除一个本机保存的 Android 身份;手机端撤销另行处理。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--device-auth-ref

复用明确保存在系统凭据库中的身份。

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android forget --help

rdp-cli android apps list#

列出已安装的 Android 应用包。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android apps list --help

rdp-cli android apps info#

查询应用实际安装路径。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--package

Android 应用包名。

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android apps info --help

rdp-cli android apps install#

提交授权目录中的单个 APK,并跟踪任务结果。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--path

相对于 RDP 交换盘或获授权 Android 目录的路径。

路径必填
--replace

明确替换已安装应用。

开关可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android apps install --help

rdp-cli android apps launch#

启动指定应用并核对画面。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--package

Android 应用包名。

文本必填
--activity

活动类名;未指定时查找启动入口。

文本可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android apps launch --help

rdp-cli android apps stop#

强制停止明确指定的 Android 应用包。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--package

Android 应用包名。

文本必填
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android apps stop --help

rdp-cli android apps status#

查询应用任务,不重复执行原操作。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--job

安装、启动或停止返回的任务 ID。

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android apps status --help

rdp-cli android touch#

依据最新截图发送完整的定时触摸手势。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--kind

触摸手势类型。

枚举
tap | double-tap | long-press | swipe | drag | pinch | gesture
必填
--x

远端 x 坐标

整数可选
--y

远端 y 坐标

整数可选
--to-x

终点 x 坐标

整数可选
--to-y

终点 y 坐标

整数可选
--second-x

第二根手指起点 X 坐标。

整数可选
--second-y

第二根手指起点 Y 坐标。

整数可选
--second-to-x

第二根手指终点 X 坐标。

整数可选
--second-to-y

第二根手指终点 Y 坐标。

整数可选
--duration-ms

手势时长为 1–10000 毫秒;拖动额外保持 400 毫秒。

正整数可选
--events-stdin

从标准输入读取 JSON 数组 [{at_ms,contact,phase,x,y}, …];仅限 --kind gesture。

开关可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android touch --help

rdp-cli android key#

持有控制权并使用最新观察按下 Android 系统键。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--key

按键名称;android key 使用其列出的系统键。

枚举
back | home | recent | enter | backspace
必填
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android key --help

rdp-cli android text#

明确通过手机剪贴板粘贴 Unicode 文本。

需要当前支持 Android 的下载:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--method

明确的文本方式:clipboard 粘贴。

枚举
clipboard
必填
--text

Unicode 输入或剪贴板文字

文本可选
--text-stdin

从标准输入读取输入或剪贴板文字直到 EOF

开关可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli android text --help

Linux 桌面与应用

使用 --protocol x11,明确选择 desktop 或 application 模式并核验 SSH 身份。SSH 客户端和应用显示器已内置。已有 Wayland 桌面使用其已配置的 RDP/VNC 端点。X11 没有音频或麦克风通道。SFTP 文件限定在授权目录内,不安装远端服务。

rdp-cli linux targets#

发现已有 Linux 显示和兼容端点,不启动服务。

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--host

RDP/VNC 地址,或明确指定的 Android Wi-Fi 端点。

文本必填
--user

本地或域账号;RDP 必填

文本必填
--port

TCP 端口:RDP 为 3389,VNC 为 5900。android pair 使用手机显示的配对端口;ADB connect 使用独立的连接端口。

正整数
默认值: 22
可选
--ssh-known-hosts

本机 OpenSSH 格式的已知主机文件,不需要外部 SSH 程序。

路径可选
--ssh-host-key

独立核实的 SSH SHA256 指纹。

文本可选
--ssh-key

本机 SSH 私钥;密码输入用于提供其口令。

路径可选
--password

密码;经典 VNC 只用前 8 个 UTF-8 字节

文本可选
--password-stdin

从标准输入读取密码直到 EOF

开关可选
--credential-ref

已有的平台凭据存储引用

文本可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli linux targets --help

rdp-cli linux text#

输入文字,或明确通过远端剪贴板粘贴。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--method

明确的文本方式:clipboard 粘贴。

枚举
clipboard
必填
--keys

组合键,例如 CTRL+S

枚举
CTRL+V | CTRL+SHIFT+V | SHIFT+INSERT
默认值: CTRL+V
可选
--text

Unicode 输入或剪贴板文字

文本可选
--text-stdin

从标准输入读取输入或剪贴板文字直到 EOF

开关可选
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli linux text --help

rdp-cli linux apps list#

列出本会话转发的 X11 应用实例。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli linux apps list --help

rdp-cli linux apps stop#

明确选择并停止一个应用实例。

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--instance

linux apps list 返回的精确应用实例 ID。

文本必填
--observation

最新截图返回的观察令牌

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli linux apps stop --help

操作与事件

结果不确定时,operations status 按 operation ID 或原 request ID 查询,不重新发送输入。events 读取事件,--follow 持续订阅,--after 从游标续读。sent 后仍须另行验证应用实际结果。

rdp-cli operations status#

查询保留的操作结果

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--operation-id

操作标识符

文本可选
--request-id

请求关联/幂等 ID;operations status 用它查询原请求

文本可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli operations status --help

rdp-cli events#

读取或持续订阅事件

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--follow

持续跟随新事件

开关可选
--after

返回此序号之后的事件或 PCM 样本。

文本可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli events --help

信任、凭据与安装

trust 为严格证书模式保存精确 RDP 目标与指纹;credentials remove 仅删除指定产品凭据。macOS 和 Linux 的 install-cli/uninstall-cli 管理命令入口,--prefix 选择安装位置;Windows 直接运行下载的程序。presence show --panel 可在 macOS 和 Linux 打开会话面板。licenses 输出第三方版本与许可声明。

rdp-cli trust list#

列出 RDP 证书信任记录

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli trust list --help

rdp-cli trust add#

信任指定目标的证书指纹

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--target

RDP 信任目标

文本必填
--fingerprint

证书指纹

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli trust add --help

rdp-cli trust remove#

删除指定目标的信任记录

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--target

RDP 信任目标

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli trust remove --help

rdp-cli credentials remove#

删除指定产品凭据

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--reference

要移除的凭据存储引用

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli credentials remove --help

rdp-cli install-cli#

在 macOS 或 Linux 安装命令入口

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--prefix

用户可控的安装前缀

路径可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli install-cli --help

rdp-cli uninstall-cli#

移除 rdp-cli 创建的命令入口

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli uninstall-cli --help

rdp-cli licenses#

查看第三方版本与许可声明

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli licenses --help

Agent 任务与自动化

新增区域截图与画面对比、条件等待、批量操作、持久任务报告、多 Agent 协作、MCP 与连接配置及诊断,以及 Android 虚拟屏。

rdp-cli tasks create#

创建持久任务

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--title

任务标题

文本必填
--session

明确的会话 ID

文本可选
--record-frames

明确保存截图关键帧

开关可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks create --help

rdp-cli tasks list#

列出有权访问的任务

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks list --help

rdp-cli tasks status#

查看任务进度与历史

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--task

持久任务 ID

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks status --help

rdp-cli tasks attach#

为任务关联已授权会话

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--task

持久任务 ID

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks attach --help

rdp-cli tasks checkpoint#

保存检查点,不重放输入

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--task

持久任务 ID

文本必填
--note

不含秘密的进度备注

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks checkpoint --help

rdp-cli tasks new-run#

从检查点开始新一轮任务

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--task

持久任务 ID

文本必填
--from-checkpoint

现有检查点 ID

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks new-run --help

rdp-cli tasks grants list#

列出任务权限

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--task

持久任务 ID

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks grants list --help

rdp-cli tasks grants grant#

授予任务权限

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--task

持久任务 ID

文本必填
--to-agent

目标 Agent 身份

文本必填
--permission

授予此访问令牌的权限

文本必填 · 可重复
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks grants grant --help

rdp-cli tasks grants revoke#

撤销后续任务访问

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--task

持久任务 ID

文本必填
--to-agent

目标 Agent 身份

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks grants revoke --help

rdp-cli tasks evidence#

保存选定的本地证据

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--task

持久任务 ID

文本必填
--file

本地证据文件,最多 4 MiB

路径必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks evidence --help

rdp-cli tasks export#

导出离线 JSON 或 HTML 报告

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--task

持久任务 ID

文本必填
--out

目标 PNG 文件

路径必填
--format

输出格式,见本命令允许值

枚举
json | html
默认值: json
可选
--include-evidence

包含明确保存的证据

开关可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks export --help

rdp-cli tasks purge#

清理选定的本地任务历史

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--task

持久任务 ID

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli tasks purge --help

rdp-cli agents register#

注册 Agent 身份

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--name

可读的会话名称

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli agents register --help

rdp-cli agents list#

列出 Agent 身份,不显示密钥

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli agents list --help

rdp-cli agents show#

查看 Agent 身份与权限

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--id

目标身份

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli agents show --help

rdp-cli agents revoke#

撤销 Agent 身份及控制权

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--id

目标身份

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli agents revoke --help

rdp-cli agents grant#

授权 Agent 访问会话

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--id

目标身份

文本必填
--permission

授予此访问令牌的权限

文本必填 · 可重复
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli agents grant --help

rdp-cli agents revoke-access#

撤销 Agent 的会话权限

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--id

目标身份

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli agents revoke-access --help

rdp-cli control claim#

以指定 Agent 身份领取已暂停的会话

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--lease-seconds

控制权有效秒数

正整数
默认值: 60
可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli control claim --help

rdp-cli control renew#

续期仍有效的控制权

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--lease-seconds

控制权有效秒数

正整数
默认值: 60
可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli control renew --help

rdp-cli control unclaim#

释放控制权并暂停会话

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli control unclaim --help

rdp-cli control claim-status#

查看当前控制权

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli control claim-status --help

rdp-cli control handoff#

将控制权交给已授权 Agent

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--to-agent

目标 Agent 身份

文本必填
--lease-seconds

控制权有效秒数

正整数
默认值: 60
可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli control handoff --help

rdp-cli profiles list#

列出连接配置

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli profiles list --help

rdp-cli profiles show#

查看配置及参数来源

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--name

可读的会话名称

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli profiles show --help

rdp-cli profiles save#

保存仅含凭据引用的配置

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--json

本命令的带版本 JSON 输入

文本必填
--replace

明确替换已安装应用。

开关可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli profiles save --help

rdp-cli profiles remove#

删除配置,保留凭据

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--name

可读的会话名称

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli profiles remove --help

rdp-cli profiles export#

导出不含密钥的配置

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--name

可读的会话名称

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli profiles export --help

rdp-cli profiles import#

导入配置,不自动连接

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--json

本命令的带版本 JSON 输入

文本必填
--replace

明确替换已安装应用。

开关可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli profiles import --help

rdp-cli doctor#

诊断能力;连接探测需明确开启

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--session

明确的会话 ID

文本可选
--profile

已保存的连接配置

文本可选
--probe

明确建立临时配置连接

开关可选
--redact

省略目标名称、地址和会话 ID

开关可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli doctor --help

rdp-cli doctor status#

查看诊断结果

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--diagnostic-id

原诊断请求 ID

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli doctor status --help

rdp-cli doctor cancel#

取消后续诊断

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--diagnostic-id

原诊断请求 ID

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli doctor cancel --help

rdp-cli wait#

等待画面或状态满足条件

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--condition

等待条件

枚举
changed | stable | connection | transfer | operation
必填
--region

远端像素区域 x,y,width,height

文本可选
--state

按所列值指定按键状态或音频静音状态

文本可选
--transfer-id

传输 ID;files status 省略时列出会话传输

文本可选
--operation-id

操作标识符

文本可选
--sample-ms

采样间隔,毫秒

正整数
默认值: 100
可选
--stable-ms

要求连续稳定的时长,毫秒

正整数
默认值: 1000
可选
--threshold-permille

变化像素比例,千分数

整数
默认值: 10
可选
--pixel-delta

忽略的 RGB 通道差值

整数
默认值: 8
可选
--max-frame-age-ms

允许的画面最大年龄,毫秒

正整数
默认值: 5000
可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli wait --help

rdp-cli wait status#

查看等待结果

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--wait-id

原等待请求 ID

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli wait status --help

rdp-cli wait cancel#

取消等待,不取消目标操作

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--wait-id

原等待请求 ID

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli wait cancel --help

rdp-cli batch#

预检查后顺序执行最多 64 步

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--json

本命令的带版本 JSON 输入

文本可选
--steps-stdin

从标准输入读取批次 JSON

开关可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli batch --help

rdp-cli batch status#

查看批次结果,不重放操作

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--batch-id

原批次请求 ID

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli batch status --help

rdp-cli batch cancel#

取消尚未执行的批次步骤

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--batch-id

原批次请求 ID

文本必填
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli batch cancel --help

rdp-cli operations cancel#

取消剩余输入,已发送的输入不会撤销

必须指定 --session SESSION。

命令参数
参数格式与取值要求
--operation-id

操作标识符

文本可选
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli operations cancel --help

rdp-cli mcp stdio#

通过标准输入输出提供 MCP 服务

不强制要求会话;支持可选会话的命令在下表列出相应参数。

命令参数
参数格式与取值要求
--agent-id

接收控制的 Agent

文本可选
--agent-ref

调用方 Agent 的凭据引用

文本可选
--claim-ref

当前控制权的引用

文本可选
--task

持久任务 ID

文本可选
--run

任务执行轮次 ID

文本可选

rdp-cli mcp stdio --help

协议与平台条件

  • RDP 默认 --cert-policy ignore 与 --tls-profile modern。TLS 1.2 服务器也可能需要旧签名或算法。对已知旧式目标,可显式添加 --tls-profile legacy 重试一次,保留凭据和证书策略,使用新的请求 ID。reconnect 保留所选配置,不会自动降级。strict 核验证书信任及名称;Web HTTPS 不受影响。
  • VNC 的安全性取决于所选模式。传统 VNC 不加密,应在可信网络或 VPN 中使用;VeNCrypt X509Plain 使用 TLS,并要求验证证书。 加密 VNC:--vnc-security x509-plain 需要 --user、密码来源和独立核验的 --vnc-tls-pin。传统 VNC 不接受 --user。--domain、--size、--layout 等 RDP 选项不适用。
  • VNC 不提供文件、声音、麦克风与主动显示布局调整。剪贴板 UTF-8 取决于协商,否则仅接受 Latin-1。
  • RDP 文件需要驱动器重定向;音频、剪贴板、麦克风、多屏也受服务端策略与协商能力影响。
  • Windows/macOS 提供原生查看器及状态入口。Linux 原生窗口依赖桌面显示服务,音频依赖主机音频服务,保存凭据依赖 Secret Service;无桌面主机仍可使用支持的 CLI 操作。
  • Unicode 输入会按远端应用兼容性节奏发送。为长文本设置合适超时并核对结果;切换输入法或打开查看器不能保证任意服务端接受所有字符。
  • Android 最低版本为 12,已测试手机为 Pixel 3 / Android 12。粘贴会明确改写手机剪贴板。手机播放声音需要系统共享授权,并遵守应用录制限制;手机麦克风是独立音源。连接不会开始录音,重连也不会自动恢复录音。
  • 连接 macOS 屏幕共享时,使用 --user 指定 Mac 账户名并提供账户密码,自动选择 ARD 认证,也可显式使用 --vnc-security ard。使用单独设置的 VNC 密码时,选择 --vnc-security vnc-auth,不传 --user。ARD 不加密桌面数据流,请在可信网络或 VPN 中使用。

错误恢复

OBSERVATION_REQUIRED / INVALID_COORDINATES
重新截图,检查屏幕布局并选择有效远端坐标。
SESSION_PAUSED / CONTROL_HELD_BY_HUMAN
停止输入,尊重人类控制;仅在明确交还 Agent 后继续。
AUTH_FAILED / VNC_AUTH_FAILED
检查账号、密码来源及远端认证策略。
RDP_TLS_HANDSHAKE_FAILED / CERTIFICATE_UNTRUSTED
RDP_TLS_HANDSHAKE_FAILED:检查所选配置和服务器算法,不能仅凭此错误断定 TLS 版本旧或密码错误。对已知旧式目标,用 --tls-profile legacy 和新请求 ID 重新 connect 一次。CERTIFICATE_UNTRUSTED:核验证书信任、名称及实际指纹;修改 TLS 配置不能解决证书信任问题。
CAPABILITY_UNAVAILABLE / CLIPBOARD_ENCODING_UNSUPPORTED
检查协议能力或文本编码,选择支持的操作。
REQUEST_TIMEOUT / REQUEST_ID_CONFLICT / REQUEST_WINDOW_EXPIRED
重试前查询原操作和当前画面;不同参数不能复用 ID,保留窗口过期后也不能假定仍可去重。