Rive 推出的新 CLI，讓程式代理能以專案檔案的形式製作互動式圖形。代理可以撰寫 Rive 標記語言（RML）、Luau 腳本與著色器，再透過 CLI 編譯、檢查、測試及算繪結果。使用者可以觀看本機預覽並調整設計。Rive 團隊於 9 月 11 日將 CLI 介紹為技術預覽版；Rive 下載頁面截至 9 月 27 日的頁面將它列在搶先體驗類別下。

本檢查清單依據Rive 官方文件。BIG CHANGE 僅檢視文件，沒有安裝 CLI、建立檔案或測試代理產生的圖形。Rive 的影片導覽展示了預期的人機協作流程。

重大變化

  • 有哪些改變：Rive 場景現在有一條以文字檔為基礎、供程式代理使用的工作路徑。代理可在專案資料夾編輯 RML，再由 CLI 編譯成.riv執行環境使用的檔案，或編譯成.rev可在 Editor 中繼續編輯的檔案。
  • 為何重要：設計師、前端與遊戲開發者可以像檢視其他專案檔案一樣審閱原始碼變更，並在反覆修改時使用 CLI 檢查。不過，在產品中使用素材前，仍須自行判斷算繪結果與互動效果是否符合需求。
  • 接下來觀察什麼：將本機原型移到網頁上是另一項決策。含有腳本的檔案必須使用已簽署的--publish建置版本；要產生不含浮水印的.riv檔案，也必須將專案綁定至帳戶檔案，並使用 Cadet 或更高級別的工作區。部署前請確認這些條件與最終圖形。

文件列出的操作清單

  1. 確認存取權並安裝。Rive 列出的支援平台包括 Apple Silicon 的 macOS、x86_64 Linux 與 Windows。其入門指南分別提供 Windows 與 macOS／Linux 的安裝說明；Windows 使用者請依照頁面上最新的 Windows 指示操作。安裝後執行rive doctor。命令參考文件也列出rive --version；由於這仍是預覽軟體，請記下實際安裝的版本。Rive 於 9 月 11 日發布的公告曾表示，預覽期間 CLI 不限次數免費使用。這項有日期的說明不代表 CLI 永久免費。目前的方案表談的是 Rive 帳戶與內建 Editor Agent；發布前請確認現行條款。
  2. 建立文字專案並開啟預覽。 rive create myproject會建立scene.rml、rive.yaml、位於AGENTS.md和CLAUDE.md中的代理指示，以及.gitignore。在一個終端機視窗執行rive myproject。Rive 表示，該命令會監看資料夾、在檔案儲存時重新建置，並輸出myproject/build/myproject.riv。初始場景已有畫板、時間軸與狀態機，但尚未繪製任何內容，預覽畫面是一個深色矩形。
  3. 把專案資料夾和明確的設計任務交給程式代理。Rive 的AI 代理指南列出 Claude Code、Cursor，以及其他能讀寫檔案並執行 Shell 命令的代理。產生的指示會教代理如何使用rive docs和rive schema查找支援的物件與屬性。RML 是 XML：元素代表 Rive 類型，屬性代表其設定值，巢狀結構則用來連結物件。代理也能編輯.luau腳本、.wgsl著色器和專案素材。請代理分階段處理，這樣你就能趁預覽更新時調整版面與行為。
  4. 檢查建置結果及其內容。請代理執行rive myproject --verify；此命令會編譯，但不會寫出.riv，以及rive inspect myproject --summary；後者會回報問題與物件數量。若要查看解析後的完整場景，可使用文件列出的rive inspect myproject --json。若需要可散布的本機檔案、又不想開啟預覽，可用rive myproject --once輸出未簽署的.riv。這些檢查能找出編譯錯誤，以及場景物件缺失或不符預期等問題。Rive 的 RML 指南提醒，建置成功並不能證明圖形的外觀或行為符合預期。
  5. 擷取重要狀態。 rive myproject --screenshot=out.png可在不開啟視窗的情況下算繪 PNG。Rive 的範例使用--advance=1s擷取動畫開始後的畫格，使用--viewport=390x844指定版面尺寸，使用--data=battery/level=100設定綁定資料，並使用--pointer=click@120,60 --advance=20模擬點擊。請依照自己的場景選擇資料值與座標。比較不同狀態及視窗大小的畫面，再親自檢視。若未指定--advance，擷取到的是作者設定的靜止姿勢，不一定是動畫的起始畫格。
  6. 若專案包含腳本測試，請執行測試。 rive myproject --test會執行專案中的 LuauTests腳本。Rive 記載了--verify --format=json和--test --format=json等自動檢查方式；建置或測試失敗時，命令會以非零狀態碼結束。代理可依據報告修改原始碼。測試只涵蓋實際寫入的斷言，因此也要檢查測試未涵蓋的互動。
  7. 本機原型準備就緒後，再選擇帳戶工作流程。一個.riv是執行環境使用的素材；一個.rev則可在 Rive Editor 中開啟編輯。Rive 表示，即使登出且離線，仍可建立本機檔案、預覽、驗證、測試並擷取畫面。rive login登入後才能使用--publish、--rev、rive push、rive pull及匯入遠端帳戶檔案。若要從 Editor 匯出的備份開始，rive create myproject --from-rev=myfile.rev不必登入即可使用。若要從帳戶檔案開始，請先登入，再使用rive create myproject --from-remote-file登入後，這會將專案連結至該檔案：rive push myproject會上傳一個修訂版本；rive pull myproject會下載 Editor 中的變更，而會在確認後覆寫本機場景、腳本與素材。拉取變更前，請先檢查本機修改。
  8. 發布前確認簽署與匯出限制。 rive myproject --publish會輸出已簽署的.riv，而且必須登入。Rive 表示，網頁執行環境及其 CDN 會拒絕未簽署的腳本，因此供網頁使用且含腳本的檔案必須走這個流程。--publish可能會加上浮水印。Rive 的命令參考文件指出，要產生不含浮水印的.riv，專案必須透過rive push綁定至帳戶檔案，而且該檔案必須位於 Cadet 或更高級別的工作區。即使場景不含腳本，浮水印條件依然適用。--rev=<path>也必須登入，並可搭配--once或--publish使用；它輸出的是 Editor 檔案，不能取代執行環境素材。部署前請確認目前的帳戶方案與實際匯出結果。

Rive 也在Editor 內建了 AI Agent。可從 Editor 側邊欄開啟，使用條件依 Editor 方案與 AI 點數規定而定。本指南介紹的是在資料夾與終端機中使用程式代理搭配 CLI 的流程；兩種代理的介面與計費方式不同。

資料來源與延伸閱讀