rdp-cli

通过 RDP 在 Shotcut 剪切并导出视频

适用版本与平台: macOS · Windows 11 RDP · Shotcut 26.8.1

本教程的目标

用 rdp-cli 将八秒素材发送到 Windows,在 Shotcut 中剪成四秒,再下载导出的 MP4。剪辑由远端应用完成,Agent 通过截图和输入命令操作。

下载八秒源视频 · 下载四秒参考视频

Shotcut原始窗口显示四秒片段与时间线,Jobs中导出任务为绿色完成状态

查看原始截图 — 亮色 ↗ · 查看原始截图 — 暗色 ↗

下载截图对应的成果: 亮色主题 · 暗色主题

准备并上传素材

使用文末Mac下载与快速上手。获授权的Windows RDP服务端须已安装Shotcut并允许驱动器重定向,调用者需要输入与文件权限。把源视频保存为本机当前目录的 source-motion.mp4,以自己的 data.session 替换 SESSION。

rdp-cli files upload --session SESSION --local ./source-motion.mp4 --path source-motion.mp4

将返回的 data.transfer_id 保存为 TRANSFER_ID,查询至 data.state 为 completed。源视频共3,319,412字节;queued 只表示受理。路径相对于本会话交换盘,不是任意Windows磁盘路径。

rdp-cli files status --session SESSION --transfer-id TRANSFER_ID

把远端时间线剪至四秒

rdp-cli screenshot --session SESSION

截图后读取 data.path 指向的PNG,保留 data.observation。在远端打开Shotcut,从重定向驱动器打开 source-motion.mp4 并加入时间线,确认源视频为八秒、960 × 540、24 fps。根据新截图寻找真实控件,不使用文章图片中的固定坐标。

选中时间线片段,打开Properties。聚焦Duration字段,选中原值,再截图确认所选字段。将当前令牌填入 OBSERVATION,输入四秒时长:

对可能需要恢复的输入,操作前为每个不同动作指定并保存唯一 --request-id,示例请求 ID 应替换为你自己的值。若收到错误 JSON,可取顶层 request_id;若响应完全丢失且未保存原 ID,不能事后新建 ID 查询旧操作或盲目重发。

rdp-cli type --session SESSION --text "00:00:04.000" --observation OBSERVATION --request-id TYPE_REQUEST_ID
rdp-cli screenshot --session SESSION

读取新PNG,确认时长文字,以其 data.observation 替换 NEW_OBSERVATION 后提交:

rdp-cli key --session SESSION --keys ENTER --observation NEW_OBSERVATION --request-id COMMIT_REQUEST_ID
rdp-cli screenshot --session SESSION

检查新画面,片段和时间线均应变为四秒。输入响应成功只证明已发送,不证明Shotcut已接受修改;坐标、焦点和令牌都必须来自自己的会话。

导出并取回自己的成果

使用Shotcut的Export面板,将已编辑时间线按H.264 MP4、960 × 540、24 fps导出至会话重定向驱动器中的 edited-motion.mp4,等待Jobs显示绿色完成标记。下载的参考文件文件单独保留,本次远端成果在本机保存为 edited-motion-reproduced.mp4:

rdp-cli files download --session SESSION --path edited-motion.mp4 --local ./edited-motion-reproduced.mp4

以本次下载的新 data.transfer_id 查询 files status,只有 completed 后才打开本机视频。出现文件名或排队响应都不等于完成。

核验视频与处理失败

播放取回的视频,检查剪切结果。本机若已安装FFmpeg,还可以用可选的 ffprobe 统计解码视频帧;运行rdp-cli本身不要求安装它:

ffprobe -v error -count_frames -select_streams v:0 -show_entries stream=codec_name,width,height,r_frame_rate,nb_read_frames,duration -of json ./edited-motion-reproduced.mp4

播放导出的视频,确认格式为 H.264、分辨率为 960 × 540、帧率为 24 fps,视频内容长四秒,共 96 帧。编码设置和元数据可能导致容器时长及文件大小略有差异。

  • 字段选错或观察令牌过期:停止输入,重新截图检查。暂停、接管或重连后更新令牌,获授权交还后才恢复。
  • 导出未完成或 FILE_BUSY:等待Shotcut完成,检查Jobs并查询传输。确认导出路径位于交换盘,而不只是远端桌面。
  • 目标已存在:选择新的本机文件名,或明确需要替换时使用 --overwrite,不要误覆盖参考文件。
  • 输入超时:用原始请求ID查询 operations status 并查看画面后再决定重试,响应未知不能证明修改未发生。

Mac下载 · 快速上手 · 命令参考 · 文件传输教程