既有實測任務
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，檢查畫面後再決定重試。回應不明不表示修改未發生。