文件：指令、工具與檔案格式

文件

大多數時候，您只要和代理對話，它就會替您執行這些操作。想了解實際發生了什麼，或想自己完成某個步驟時，可以參考這一頁。

安裝與登入

npx -y motionkit-skills@latest setup

將這段內容貼到 Claude Code、Codex 或終端機中。瀏覽器會開啟；請用 Google 登入並按下「授權」。第一次使用時，需要在該頁面貼上一次您的授權金鑰，帳號之後就會記住。在 Mac 上，金鑰會存放在鑰匙圈中。套件會安裝到所有偵測到的代理：Claude Code、Codex、Cursor、OpenCode、Antigravity 和 Kimi。

在沒有瀏覽器的電腦上，請改為傳入金鑰：setup --key - 會從標準輸入讀取。

指令

指令	功能
`setup`	安裝或更新套件，並讓這台電腦登入
`doctor`	檢查 Node.js、FFmpeg、Chrome、HyperFrames 和您的訂閱
`voices` / `credits`	列出可用的聲音，以及本月剩餘的旁白點數
`voice <project> --script <file> --voice <id>`	為每個場景或投影片生成旁白。`--tone "warm teacher"`可指定富有表現力的聲音
`music <project> --bed calm\|focus\|bright\|lofi`	加入內建的背景音樂
`share <project> [--deck] [--password …] [--public]`	上傳影片或簡報並取得連結
`shares` / `unshare <id>`	列出或移除連結；Studio 也會顯示觀看次數和練習答案
`logout`	讓這台電腦登出並釋出其授權名額

每個指令都以 npx -y motionkit-skills@latest <command> 執行。

你的代理程式會執行的工具

工具	功能
`ingest`	可讀取 Word、PowerPoint、PDF、Markdown、純文字、網頁連結或共用的 Google 文件，整理成章節、重點、數字和表格，並標示每一項在原始內容中的位置
`panel`	本機四步驟頁面：選擇風格、觀看製作過程、在時間軸上檢視與編輯、播放並分享
`start`	以指定風格建立專案，並下載該風格
`images`	依場景需求繪製圖片，並符合該風格的外觀
`music`	依描述製作純音樂曲目，長度與影片相同
`compose`	依據 `video.json` 製作影片：包含時間安排、動態、旁白和音樂
`check`	將畫面上的每個數字與原始內容比對；檢查時間安排和練習題答案
`frames`	為每個場景儲存一張圖片，供你檢視
`render`	使用 HyperFrames 在你的電腦上算繪 MP4
`build-deck`	製作含旁白、可互動的簡報，來源為 `deck.json`
`deck-to-pptx`	將簡報匯出為 PowerPoint 檔案

每個工具在執行前都會向我們的伺服器確認你的訂閱，因此需要連線。

場景

影片是 video.json 中的一份場景清單；簡報則是 deck.json 中的清單。兩者都有這些：title、section、stat、chart（長條圖或折線圖）、steps、cards、compare、figure、quote、takeaway。簡報另外還有 tabs、expand、quiz、match、sort、group、滑鼠停留提示，以及另外五種圖表：圓餅圖、漏斗圖、雷達圖、散佈圖，以及依國家填色的世界地圖。

在重點文字前後加上星號；為場景加上 image 可繪製圖片，加上 picture 可顯示你自己的檔案，加上 narration 則可加入語音朗讀。

專屬於你的風格

風格決定版面配置和動態。在專案檔中加入 design，即可換成你自己的色彩和字型：

"style": "ledger",
"design": { "bg": "#0b1f3a", "ink": "#ffffff", "accent": "#ffb703", "type": "newsprint" }

bg，ink 和 accent 分別是你的背景色、文字色和強調色。"palette": "forest-night" 則改用 36 種現成配色之一。type 會沿用其他風格的字型，radius 用來設定圓角。如果設計的文字難以閱讀，工具會拒絕執行，並告訴你該更改哪個顏色。圖片會以你的色彩繪製。

音樂與語音

music 依「緩慢溫暖的鋼琴，充滿希望」這類描述製作純音樂曲目，長度與影片相同。內建的四首背景音樂不計入任何額度。語音分為兩種：14 種針對九種語言調校的語音，以及 11 種富有表現力的語音，可朗讀任何語言，並依據 --tone 給定的指示來表達。

各方案的限制

	Creator	Studio
電腦	2	10
每月語音旁白額度	80,000	240,000
每月圖片數量	60	200
每月音樂曲目數量	10	40
分享連結	10	100 個，附統計資料

發生錯誤時

工具顯示訂閱未啟用。請前往價格頁面續訂，然後再次執行設定。
算繪失敗。執行 doctor。它會告訴你缺少什麼，以及如何安裝。
數字被拒絕。該數字不在你的來源資料中，或在來源中的寫法不同。請修正來源或場景，不要動檢查。
在 Proxy 後方。設定 HTTPS_PROXY，工具會自動套用。

其他問題：support@motionforclaude.com。

文件