實戰手冊 · Field Manual 2026 春季號 · 第 04 期
github.com/degausai/wonda · v1.18.0
w
第 04 期 · 開源工程 / AI Creative CLI

wonda:
終端機驅動的
AI 內容生產線

Degaus AI 的 Wonda 把生圖、生影片、配音、譯文、寫腳本、發 IG、發 TikTok 全部包成一條 CLI。支援 JSON 輸出、jq 串接、credits 計費。對工程師而言,它是一條 AI 內容生產線;對 agent 而言,它是一個能跑、能算錢、能交付結果的後端。

v1.18
最新版本
26+
影片編輯指令
5
社群平台直發
Active
官方維護
01
工具定位

給 pipeline 用的
AI 創作 CLI。

多數 AI 創作工具提供網頁拖拉介面,操作直覺,但不可程式化。Wonda 把整個 AI 創作流程做成 CLI:從生圖、生影片、配音樂、做語音、剪輯、轉場、字幕,一路到 Instagram、TikTok、LinkedIn、X、Reddit 直接發布,全部在終端機裡跑完。支援 JSON 輸出、可被 jq 串接、可被 agent 接管。

Wonda 是 Degaus AI 的官方 CLI,用 credits 計費。一次 wonda topup 加值,後續所有指令都從同一個帳號扣 credits。你可以隨時 wonda balance 查餘額,wonda pricing estimate 預估一次任務的費用。對工作室與 agent 來說,「能 estimate」比「能 generate」更重要,因為可以事先排預算。

命名脈絡很直接:wonda generate 是創作族群、wonda audio 是配音與譯文、wonda imagewonda video 是各自的編輯指令、wonda skill 管擴充技能、wonda publish 把成品直接送上 5 個社群平台。設計目標是 pipeline 優先,CI、cron、agent 都能直接接管。

wonda · 內容工作流
wonda auth login wonda topup wonda generate wonda video edit wonda audio wonda publish
The CLI for AI content creation.
Generate, edit, and publish — all from your terminal.
— degausai/wonda README
02
三種裝法

npm 或 Homebrew
全域安裝,三步完成設定。

Wonda 主要走 npm 與 Homebrew 兩種裝法。npm 路徑最快:一條 npm i -g @degausai/wonda 就裝好,接著 wonda auth login 開瀏覽器走 OAuth、加值 credits,即可使用。Mac 用 Homebrew 也行。

# 全域裝(推薦),裝完直接有 wonda 指令 npm install -g @degausai/wonda # 確認版本 wonda --version

Mac 偏好 Homebrew?

Degaus AI 維護自家 tap。先 brew tap 把來源加進來,再裝。升級走 brew upgrade wonda,版本鎖在你想要的點。

brew tap degausai/tap brew install wonda

登入、加值、跑第一支指令

所有指令都吃 credits。第一次必須 wonda auth login 走 OAuth,接著 wonda topup 加值,再 wonda balance 確認餘額。餘額查得到即代表帳號通了,後面可讓 agent 或 pipeline 自己跑。

wonda auth login wonda topup wonda balance
credits 是統一貨幣。不論你呼叫的是圖像、影片、配音、譯文,所有任務都從同一個 credits 餘額扣。你可以 wonda pricing estimate 事前預估、可以 wonda balance 隨時查餘額。對 agent 來說這代表「成本可以被程式化判斷」,跑前先估、超過上限就 fail-fast,不會偷偷燒錢。
03
六大群組 · 一條 CLI

六大指令群,
涵蓋 AI 內容生產的完整流程

Wonda 的指令拆成六大群:認證、生成、編輯、音訊、發佈、技能。下面 12 張卡片把每群的代表入口列出來。所有指令都吃 credits,都能加 --quiet --fields --jq 走 JSON 流水線。

Auth · 01
wonda auth login
OAuth 登入
瀏覽器走 OAuth 拿 token,後續所有指令都靠這個身份。wonda auth status 隨時查目前帳號。
Auth · 02
wonda balance / topup
Credits 錢包
統一 credits 計費。topup 加值、balance 查餘額、pricing estimate 跑任務前估價,適合接 budget guardrail。
Generate · 03
wonda generate image
出圖主管
從文字 prompt 出圖。支援風格、長寬比、批次量,輸出檔在當前工作目錄。社群素材、產品圖、Hero 圖都走這條。
Generate · 04
wonda generate video
出影片主管
文字、圖片、或影片參考都行。短片場景全包,適合做產品 reel、社群短片、產品宣傳影片。
Generate · 05
wonda generate music
配樂合成
輸入 prompt 與時長就生背景音樂。可以為影片配上節奏匹配的曲子,適合 reel、廣告 30 秒卡點素材。
Generate · 06
wonda generate text
文案引擎
為腳本、字幕、貼文文案、譯文做文字生成。可以接在影片合成前面寫旁白稿,跟 audio speech 串起來變語音稿。
Audio · 07
wonda audio speech
TTS 配音
把文字轉語音,可選聲線。配上 audio dialogue 還能做多角色對白,podcast、配音、短片旁白都能跑。
Audio · 08
wonda audio transcribe
語音轉逐字稿
把影片或音檔轉逐字稿,輸出有時碼。接在影片發佈前自動生字幕,做為 SRT 寫入再 burn-in。
Edit · 09
wonda video edit
26+ 影片操作
trim、concat、crop、resize、burn 字幕、加背景音樂、調速度、貼浮水印。做完輸出新檔,純 CLI,不需開啟剪輯軟體。
Edit · 10
wonda image edit
圖像後製
調尺寸、加文字、合成、去背、放大。配合 generate image 把素材修到能直接上社群、不用再進 Photoshop。
Publish · 11
wonda publish
5 平台直發
Instagram、TikTok、LinkedIn、X、Reddit 直接從 CLI 發布。先綁帳號、再丟檔案、加文案,送出排程或立即發。
Skill · 12
wonda skill install
技能擴充
官方 skill 市集。第三方技能裝進來即新增指令,擴充方式類似 IDE 外掛系統。

你想做什麼,用哪一條?

場景 該跑的指令 主要旗標
出圖 · 社群素材 wonda generate image --prompt · --aspect-ratio
短片 · reel wonda generate video --prompt · --reference
旁白配音 wonda audio speech --text · --voice
影片字幕 wonda audio transcribe --input · --format srt
影片剪輯 · 串接 wonda video edit 26+ 子指令
排程社群貼文 wonda publish --platform · --schedule
跑 pipeline · 接 jq 任何指令 --quiet · --fields · --jq
04
進階密技 · POWER PATTERNS

六個高頻進階用法
來自 README 子指令結構。

以下六條均來自 README 與 wonda 的子指令結構,對應安裝後最容易被忽略的細節。掌握這些細節,可讓內容生產線從「能跑」提升到「能規模化」。所有 flag 與指令都對得上 README,沒有任何一條是推測。

TIP 01

用 --quiet --fields 接 jq 寫腳本

所有指令都吃 --quiet 關掉互動輸出、--fields 指定要哪些欄位、--jq 直接套 jq 過濾。跑完直接拿 ID 當下一條指令的輸入,寫 shell 腳本不用解析 prompt。

來源 · README · Output formatting
TIP 02

跑任務前先 pricing estimate

wonda pricing estimate 在實際跑指令前回傳預估 credits。把它包成 budget guard,超過 X credits 就 abort,可避免 agent 在無人看管時超支。production pipeline 建議必加這道閘門。

來源 · README · Pricing
TIP 03

video edit 26+ 子指令串成一條流

trim、concat、burn 字幕、加音樂、調速度都各是一條子指令。Pipeline 把它們串成「生影片 → trim → burn 字幕 → 加 BGM → publish」,比 GUI 剪輯軟體更可重複、更容易回頭 debug。

來源 · README · video edit
TIP 04

audio dialogue 多角色配音

單一聲線用 audio speech,多角色對白用 audio dialogue。給 podcast 訪談、教學影片、廣告對白都行。可以跟 generate text 串起來:AI 寫稿、AI 配音,人工只需審核節奏。

來源 · README · audio commands
TIP 05

publish --schedule 排程社群矩陣

wonda publish 支援排程,5 個平台都可以指定發佈時間。寫一段腳本一次生 7 天的素材、一次排好整週的時間表,小團隊不用再請社群排程工具。

來源 · README · publish
TIP 06

wonda skill install 擴充指令

不夠用?wonda skill install 從官方 skill 市集裝新指令。第三方 skill 進來就多新指令,適合把 Wonda 套到不在預設 6 群裡的工作流。安裝後可 wonda skill list 查看已裝項目。

來源 · README · skills
05
實際走一輪

完整 pipeline 範例
生影片到 IG 排程上線。

假設你要做一支 30 秒的產品宣傳 Reel,中文配音、燒進字幕,接著直接發 Instagram 與 TikTok。下面是真實情境改寫,跑在已經 wonda auth login 過、有 credits 餘額的 Mac 上。所有指令都用 --quiet --jq 拿 JSON,接給下一步,示範 Wonda 設計給 pipeline 使用的標準模式。

~/projects/spring-reel · zsh · wonda v1.18.0
~/projects/spring-reel › wonda pricing estimate generate.video --duration 30
→ estimated: 18 credits · ok to run
~/projects/spring-reel › VID=$(wonda generate video --prompt "spring product reel" \ --duration 30 --quiet --jq '.id')
[generate video] → rendering · 30s · 1080×1920 → saved id $VID · video.mp4
~/projects/spring-reel › SCRIPT=$(wonda generate text --prompt "30s voiceover, zh-Hant" --quiet) wonda audio speech --text "$SCRIPT" --voice mei --out vo.mp3
[audio speech] → vo.mp3 · 30.4s
~/projects/spring-reel › wonda audio transcribe --input vo.mp3 --format srt --out captions.srt
[audio transcribe] → captions.srt · 12 段時碼
~/projects/spring-reel › wonda video edit add-audio --input video.mp4 --audio vo.mp3 --out v2.mp4 wonda video edit burn-subtitles --input v2.mp4 --srt captions.srt --out final.mp4
[video edit] → final.mp4 · 配音與字幕已燒入
~/projects/spring-reel › wonda publish --platform instagram,tiktok --file final.mp4 \ --caption "春季新品 · ✨" --schedule "tomorrow 09:00"
→ scheduled · IG 09:00 · TikTok 09:00 (UTC+8)
~/projects/spring-reel › wonda balance
→ remaining: 282 credits · spent: 22
六條指令,一個 shell 腳本。
生影片、配音、字幕、剪輯,
到 IG/TikTok 排程均在終端機完成。
— Wonda pipeline 範例示範

這條流程值得拆解的點

每一步都是可被 jq 接住的 JSON。--quiet --jq 直接把回應裡的 ID 抽出來,變成下一條指令的輸入。整段在 shell 腳本就跑完,cron、CI、agent、人工都能接管同一段。

credits 是事前預估、事後扣帳。跑指令前 pricing estimate、跑完 balance。對工作室來說代表「能算成本」,對 agent 來說代表「能踩剎車」:超過預算就 abort。

publish 是流程的一個環節,而非收尾動作。排程在指令尾巴,表示可一次性產 7 天素材、一次性排好整週時間表,無需額外的排程 SaaS。

06
先看清楚這些

使用前需了解的
限制與注意事項

  • 需要 Degaus AI 帳號 + 線上連線。Wonda 是 CLI,但運算都在雲端跑。沒有 Degaus AI 帳號跑不了,離線環境也跑不了。這是 SaaS-backed CLI,非本地推論。
  • 所有指令都吃 credits。從生圖、影片到配音都是計費任務。production 流程建議先 wonda pricing estimate、再 balance 設上限,否則 agent 在無人看管時可能把整月預算耗盡。
  • 授權是 Proprietary,不是開源。Wonda CLI 本身免費裝、開源 repo 可看,但底下的模型權重與算力是 Degaus AI 自家服務,授權條款照 Degaus AI 服務條款走,不是 MIT/Apache 那種可改可商用。
  • 社群平台 API 有自己的政策。wonda publish 走 Instagram、TikTok、LinkedIn、X、Reddit 各家官方 API。大量自動發文前先確認各平台對自動化的最新規範,以及所綁帳號的等級。遭平台封鎖時 Wonda 無法介入。
  • 影片合成成本明顯比文字高。30 秒影片可能是文字生成的 10x credits。先在 dev 環境用短秒數、低解析度跑通流程,production 上量前最好寫個 budget guard。
  • JSON schema 跟著版本走。Wonda v1.18 的 --fields 名稱不見得跟 v1.20 一樣。寫 pipeline 時記得鎖版本,或者在 CI 加一條「升級版本後跑回歸測試」的步驟。
  • 不要把 auth token commit 進 repo。wonda auth login 會在本機存 token。.gitignore 先檢查、CI 上跑 wonda 時用環境變數注入,別把整個 home 目錄打包進 Docker image。
  • skill 市集是第三方擴充。wonda skill install 裝外掛時要看清楚發佈者。第三方 skill 不一定有 Degaus AI 的安全審核,公司專案裝外掛前先確認來源與權限。
07
進階路徑

整合至 cron、CI
agent 工作流的五條路徑。

Wonda 是一條 stateless 的 CLI。每條指令的輸出可被下一條讀取,所有指令都接受 JSON 輸入輸出,因此可漸進式整合至 cron、GitHub Actions、Make、Zapier、Claude Code 等任何能執行 shell 的環境。

進階玩法地圖

1. 接 cron 自動發週報。每週一早上 9 點,cron 跑一條 wonda 腳本:抓資料、生統計圖、配旁白、合成影片、發 IG 與 LinkedIn。人工只需決定是否回應留言。

2. 把 Wonda 包進 Claude Code agent。Claude Code 對話裡 agent 直接呼叫 wonda,你下達意圖、它跑指令、回傳結果。Wonda 變成你 agent 的「能力包」,跟 inference-sh、其他 MCP 工具併存。

3. 把 publish 接進審稿流程。--schedule 排到明天,中間給人審。沒問題就放出去,有問題在後台修改。人工保留審核權,但不需主動操作。

4. CI 跑回歸測試。GitHub Actions 每週跑一次 wonda generate image 的 fixed prompt,比對輸出 hash 或視覺差異,用以偵測 Degaus AI 上游模型是否有異動。

5. credits 預算閘門當 SRE 護欄。pricing estimate 包進 wrapper script,設一個月度上限。超過就 fail-fast,任何 agent 或 cron 都被同一條邊界鎖住。

最該讀的三份延伸閱讀

github.com/degausai/wonda:README 是入口,包含完整指令清單與旗標。
degaus.ai:產品官網,含計費規則、credits 換算與服務條款。
npm @degausai/wonda:最新版本與發佈頻率,鎖版本時需確認此處。

Wonda 把內容生產線的全部環節,
生成、剪輯、配音、發佈,
整合進一條可被腳本接管的 CLI。
— Wonda 設計定位