rdp-cli
如何將樹莓派用作 Windows 的 AI Agent RDP 用戶端
Raspberry Pi 體積小、成本低，適合執行命令列自動化。它可以作為 AI Agent 的專用 RDP 用戶端，連線並操作遠端 Windows 桌面。
實際架構是：
AI Agent → Raspberry Pi → rdp-cli → Windows RDP 工作階段
樹莓派不會取代 Windows，而是執行遠端桌面用戶端，讓 Agent 能觀察和控制 Windows 畫面。
為什麼使用樹莓派作為 RDP 用戶端？
樹莓派可以長時間在線、靠近本機網路，並將遠端自動化任務與個人電腦分開。它可以透過 LAN 或 VPN 連線 Windows，操作沒有 API 或 SDK 的舊式應用程式，例如財務軟體、倉庫系統、ERP、報表工具和內部桌面程式。
環境要求
目前 ARM64 版本建議使用 Raspberry Pi 4、64 位 Raspberry Pi OS 或 Debian、可存取 Windows 的網路、已啟用 RDP 的 Windows，以及具備 RDP 權限的帳戶。
官方平台說明列出 Raspberry Pi 4 和 64 位 Debian 13.7 的測試配置。32 位 Raspberry Pi OS 不支援，其他樹莓派型號需要自行驗證。
安裝與連線
下載 Linux ARM64 程式並執行：
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
連線 Windows 時，使用安全的密碼輸入方式：
printf '%s' "$RDP_PASSWORD" |
./rdp-cli-linux-arm64 connect --host WINDOWS_IP --user WINDOWS_USER --password-stdin
儲存回傳的工作階段 ID，不要將密碼硬編碼或寫入日誌。
使用「觀察—操作—驗證」循環
AI Agent 在每個重要操作前都應擷取新的螢幕畫面：
./rdp-cli-linux-arm64 screenshot --session SESSION --out before.png
./rdp-cli-linux-arm64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out after.png
例如，Agent 可以開啟庫存軟體、登入、選擇倉庫、輸入 SKU、確認彈窗、儲存記錄，再確認狀態是否更新。快速入門指南說明這種截圖—操作—截圖流程。
傳輸專案檔案
如果 RDP 伺服器允許磁碟機重新導向，rdp-cli 可以將檔案或完整資料夾上傳到工作階段交換磁碟機，完成後再下載結果。資料夾結構會保留，適合試算表、PDF、測試資料、報告和專案資料夾。
檔案傳輸功能支援查看進度、取消傳輸、明確確認覆蓋並驗證傳輸內容。
人工接管與限制
使用者可以透過原生視窗或授權瀏覽器開啟相同工作階段，暫停 Agent、手動修正，再將控制權交還。VNC 可以查看和控制，但不提供相同的 RDP 資料夾傳輸流程。
rdp-cli 不會讓所有 Windows 應用程式自動擁有 API，也不取代單元測試、後端測試、資料庫驗證或效能分析。
常見問題
需要桌面環境嗎？ 不需要，rdp-cli 是命令列用戶端。
支援所有樹莓派型號嗎？ 官方測試的是 Raspberry Pi 4 64 位 ARM64；32 位系統不支援，其他型號需要自行驗證。
rdp-cli 本身會執行 AI Agent 嗎？ 不會。AI Agent 或自動化框架負責呼叫 rdp-cli 命令。
總結
在樹莓派上執行 rdp-cli，透過 RDP 連線 Windows，取得畫面、執行一個操作，再取得畫面驗證結果。這是從輕量 Linux ARM64 裝置自動化舊式 Windows GUI 流程的實用方式。