已有实测任务
2026年9月21日，Agent 使用 macOS 版 rdp-cli 0.1.0、构建号2026092001，通过RDP在1440 × 900远端画面操作Windows 11上的Shotcut 26.8.1。本机提供自行制作的Mandelbrot动画，剪切与导出由远端Shotcut完成。本文整理既有成果，不代表本轮新实测，也不证明任意视频编辑软件均可完成相同任务。
这是2026年9月21日记录的英文界面原图，未翻译或修饰；周围教程使用当前语言。
准备并上传素材
使用文末Mac下载与快速上手。获授权的Windows RDP服务端须已安装Shotcut并允许驱动器重定向，调用者需要输入与文件权限。把源视频保存为本机当前目录的 source-motion.mp4，以自己的 data.session 替换 SESSION。本次历史视频实测的客户端是macOS，不涵盖其他客户端平台。
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视频帧，视频时长4.000秒。容器时长4.010秒来自编码音轨填充。文件1,442,310字节，SHA-256为 4c05d91108ee9afaae77aa6a76896f03ee35c9b61de91a3a0b332e905be2ddc5。此摘要标识归档下载，不要求每次复现都相同；编码参数和元数据可改变字节。该案例未验证实际音频收听或复杂项目性能。
- 字段选错或观察令牌过期：停止输入，重新截图检查。暂停、接管或重连后更新令牌，获授权交还后才恢复。
- 导出未完成或
FILE_BUSY：等待Shotcut完成，检查Jobs并查询传输。确认导出路径位于交换盘，而不只是远端桌面。 - 目标已存在：选择新的本机文件名，或明确需要替换时使用
--overwrite，不要误覆盖归档参考。 - 输入超时：用原始请求ID查询
operations status并查看画面后再决定重试，响应未知不能证明修改未发生。