安裝 Mografy。

系統需求

Mografy 目前從原始碼工作區執行。開始之前，請先備妥以下工具。

從 GitHub 安裝

使用 git clone 下載 Mografy 儲存庫，進入資料夾後執行下方安裝步驟。若已安裝 pnpm，可略過 npm install -g pnpm 這個指令。

git clone https://github.com/zz41354899/mografy.git
cd mografy
npm install -g pnpm
pnpm install

啟動 Mografy

在 Mografy 資料夾中執行指令。若播放器顯示 16 種內建動畫，代表安裝成功。

mografy dev

首次啟動時，Mografy 會初始化 16 個獨立的內建元件，並開啟逐字進場文字場景。

建立或開啟專案

在原始碼專案庫中建立可編輯專案，或開啟隨附的 12 秒介紹影片。

mografy dev ./projects/my-animation --yes
mografy dev ./examples/mografy-intro

設定 MOGRAFY_HOME 可將專案庫放到其他目錄。其餘設定請參閱 設定指南.

搭配程式代理使用

共用的 Mografy Skill 為 Claude 與 Codex 提供一致的分鏡規劃、場景編寫、影格審閱與匯出流程。

1. 用簡單英文描述訊息、片長、格式與視覺限制。
2. 讓代理挑選內建元件，或規劃簡短分鏡。
3. 保持 mografy dev 開啟，讓代理編輯場景模組。
4. 匯出成品前，先檢查影格與時間節奏。

匯出

使用播放器的 匯出 按鈕，或從命令列匯出。MP4 採用 H.264/AAC；WebM 採用 VP9/Opus。兩者皆支援 720p／1080p 橫式與直式匯出、音訊及輸出效果。Lottie 與 SVGA 則以影格圖片封裝，供網頁與行動播放器使用。

mografy export ./projects/my-animation --format mp4
mografy export ./projects/my-animation --format webm
mografy export ./projects/my-animation --format lottie
mografy export ./projects/my-animation --format svga

完成的檔案會寫入專案的 renders/ 資料夾。

更新 Mografy

在你要更新的 Mografy 工作副本中執行以下指令。 --check 會讀取更新資訊，不會修改工作檔案或重新啟動播放器。 mografy update 會安裝目前分支所追蹤上游的最新提交。

mografy update --check
mografy update

更新程式會檢查本機修改、等待進行中的匯出完成、停止播放器、更新原始碼、安裝相依套件、重新建置並同步共用 Skill。完成後，會以相同連接埠重新開啟原本的專案。 重新整理瀏覽器 即可載入新版介面。

若有本機修改或 Git 歷史分歧，更新會停止並顯示操作說明。被 Git 忽略的動畫專案會保留。若安裝失敗，播放器會維持停止狀態，指令會說明如何完成安裝。

舊版沒有 update 指令？

按 Ctrl+C 停止播放器。在原本的 Mografy 工作副本中執行一次以下指令，取得最新原始碼與更新工具：

git pull --ff-only
pnpm install
mografy dev

全新安裝請依照上方 GitHub 複製步驟操作。各個工作副本需分別更新；在工作副本以外執行時，PATH 啟動器會選擇安裝它的那份副本。最新變更請參閱 更新紀錄 。

疑難排解