rdp-cli
通过 RDP 在 Shotcut 剪切并导出视频
适用版本与平台: macOS · Windows 11 RDP · Shotcut 26.8.1
本教程的目标
用 rdp-cli 将八秒素材发送到 Windows,在 Shotcut 中剪成四秒,再下载导出的 MP4。剪辑由远端应用完成,Agent 通过截图和输入命令操作。

准备并上传素材
使用文末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并查看画面后再决定重试,响应未知不能证明修改未发生。