wonda-cli
概覽
使用 Wonda CLI 從終端機產生圖片、影片、音樂和音訊，同時支援 LinkedIn、Reddit 和 X/Twitter 的研究與自動化。
工作流程
name: wonda-cli description: 使用 Wonda CLI 從終端機產生圖片、影片、音樂和音訊，並支援 LinkedIn、Reddit 和 X/Twitter 的研究與自動化
Wonda CLI
Wonda CLI 是一個專為終端機代理打造的內容創作工具包。您可以使用它來生成圖像、影片、音樂和音訊；編輯和合成媒體；發佈到社交平台；以及在 LinkedIn、Reddit 和 X/Twitter 上進行研究與自動化。
安裝
如果系統 PATH 中找不到 wonda，請先安裝：
# npm
npm i -g @degausai/wonda
# Homebrew
brew tap degausai/tap && brew install wonda
設定
- 驗證：
wonda auth login（建議，會開啟瀏覽器）或設定WONDA_API_KEY環境變數 - 驗證檢查：
wonda auth check
OAuth 連接器驗證
Claude 網頁版和 Cowork 連接器使用 Wonda 的 OAuth 2.1 流程，而非 CLI API 金鑰欄位。連接器會透過 Wonda 在瀏覽器中登入，授予所請求的帳戶存取權限，並接收綁定至 Wonda API 資源的 OAuth 令牌。伺服器只會在 Wonda 內部將這些令牌兌換成帳戶的內部 API 金鑰，因此代理和連接器主機永遠不會看到 sk_... 金鑰。對於 CLI 和本機 stdio MCP 路徑，請繼續使用 wonda auth login 或 WONDA_API_KEY。
Claude Cowork 本機中繼
Claude Cowork（桌面應用程式）會在主機上執行本機 MCP 伺服器，因此可以直接載入 .mcpb 套件或本機 stdio wonda-mcp 設定（包含 WAB 寫入功能，已於 2026-07-07 驗證）。Claude 網頁版則無法做到。Wonda 本機中繼是替代路徑：它允許遠端連接器（網頁版或 Cowork）在使用者自己的 Mac 和住宅 IP 上執行動作，無需任何本機 MCP 設定：
- 在登入狀態下開啟
https://wonda.sh/download，然後安裝經過公證的 Mac 套件。 - 使用
wonda relay pair或首次執行的瀏覽器交接來配對中繼。這會使用現有的cli-auth流程，並在 macOS 鑰匙圈中儲存中繼範圍的wrelay_...憑證。請不要要求使用者貼上 API 金鑰或裝置代碼。 - 開啟
https://wonda.sh/setup，透過本機 WAB 連接 LinkedIn、X 和 Reddit，然後在 Claude 中批准 Wonda 連接器。
引擎策略為 auto | my_machine | cloud。auto 在中繼在線時使用本機中繼，否則使用雲端。my_machine 不得靜默回退：如果中繼離線，請詢問是否要切換到雲端。
組織與花費情境
Wondercat 組織是共享錢包，擁有自己的席位和帳單。成員可以透過切換情境來從組織錢包（而非個人點數）消費：
wonda organizations list（別名：wonda orgs list、wonda org list）— 查看您所屬的每個組織，以及您在其中的角色和席位方案。wonda use --org <slug>— 在此機器上設定固定的組織情境。會在每個請求上設定X-Wonda-Org標頭；所有扣款、請款和wonda balance都會透過組織錢包進行。wonda use --personal— 切換回個人情境。wonda usage— 僅顯示花費的使用量摘要（總計 + 每個模型 + 每個專案的細項），可指定時間範圍（--month 2026-05，或--from/--to；預設為當月 UTC）。--project <name>可將報告限制在單一專案。在組織情境下，它會回報組織範圍的使用量，包含每位成員的細項 — 需要管理員/擁有者角色。管理員也可以在網頁的組織頁面下載完整的 Excel 報告。
專案（花費標記）
專案會將花費歸因到指定的工作流程以供監控。代理應在任務開始時檢查活動中的專案（wonda use 會顯示），並在操作者按專案監控花費時為每個任務設定一個：
wonda use --project <name>— 固定設定：後續的每次扣款都會帶有該專案（在wonda usage、API 和組織 Excel 報告中）。wonda use --no-project會停止標記；切換組織/個人情境會自動清除專案（專案是根據範圍而定）。- 在任何命令上加上
--project <name>— 該次呼叫的一次性覆蓋。 wonda project list|create|delete— 管理活動範圍內的註冊表。組織專案僅能由組織管理員/擁有者建立；個人專案則可自助服務。針對不存在的名稱進行標記會失敗並顯示unknown_project（不會靜默建立新的儲存桶，因此輸入錯誤不會分割監控資料）。
wonda topup 總是為您的個人錢包充值，無論情境為何。為組織錢包充值（以及設定自動充值）僅限管理員操作，需在網頁的 /organizations/<slug> 進行。如果成員的組織點數用完，錯誤訊息會要求他們詢問管理員或切換回個人情境 — 他們無法從 CLI 為組織錢包充值。
組織內的角色與席位方案是分開的：
- 擁有者：原始創建者。不能被降級或踢出。可以從組織頁面將擁有權轉移給另一位成員（較少見）。
- 管理員：可以邀請（單一或大量貼上）、踢出、變更角色、變更席位、充值、設定自動充值、變更每月上限。
- 使用者：只能在組織錢包內消費（如果管理員設定了每月上限，則需遵守該限制）。
付費的組織席位（WONDA / WONDA_PREMIUM）授予與個人付費方案相同的付費功能存取權限（技能等），但僅限於組織情境下。wonda use --personal 會回退到使用者的個人帳戶方案。
存取層級
Wonda 僅限付費：每個產品功能（生成、媒體、發佈、爬取、分析、技能、雲端分身）都需要付費方案。新帳戶沒有點數，也沒有產品存取權限，直到訂閱為止。
| 層級 | 存取權限 |
|---|---|
| 匿名（臨時帳戶，未登入） | 無產品存取權限。CLI 在首次執行時會建立一個臨時帳戶，但只能存取以下本機命令以及驗證/帳單端點。請執行 wonda auth login，然後訂閱。 |
| 免費（已登入，無付費方案） | 無產品存取權限。請在 https://wonda.sh/account 訂閱以使用產品。 |
| WONDA（每月 $19.99 美元，「Pro」方案） | 除雲端分身外的所有功能：生成（image/generate、video/generate...）、媒體上傳/下載、發佈、爬取、分析、影片分析、技能（wonda skill install/list/get）、轉場、剪輯、電子郵件、Reddit/LinkedIn 帳戶建立、樣式、品牌。 |
| WONDA_PREMIUM（每月 $49.99 美元，「Premium」方案） | WONDA 方案的所有功能，加上雲端分身（wonda twin：佈建、排程執行、串流登入）具備反偵測/影子禁令保護、無上限，以及美國帳戶建立功能。 |
| 已標記（每個帳戶的 PostHog 關閉開關） | 包含在付費方案中，但仍可透過每個帳戶的標記進行閘控：wonda reddit signup（redditAccountCreationEnabled）、wonda email（emailServerApiEnabled）、公開 LinkedIn 個人資料豐富化（linkedinProfileEnrichmentEnabled）。 |
| 本機（無 API 呼叫、無點數、無方案） | 完全在您的機器上執行，因此無需方案即可使用：wonda brand extract <url>（無 --save）、wonda compose motion/wonda compose text、wonda wab record <url>、wonda edit ...（對本機檔案進行 ffmpeg 基本轉換），以及 wonda doctor。需要 Chromium 的命令需要一次性執行 wonda wab install。 |
如果命令回傳 403（paid_plan_required），請在 https://wonda.sh/account 訂閱。
語音克隆
從 10 秒以上的音訊片段克隆語音，並在 TTS 中使用。硬性限制：每個帳戶 20 個克隆語音。費用：每個克隆 $1.50 美元。
# 從本機檔案克隆（會先自動上傳到媒體庫）
wonda voice create "Andu" --file ./sample.mp3 --description "我的聲音"
# 從現有的 wonda 媒體克隆
wonda voice create "品牌" --media-id <uuid>
# 可選的來源音訊預處理
wonda voice create "乾淨" --file ./raw.wav --noise-reduction --normalize-volume
# 列出克隆語音（每一行會回報 isExpired 和 expiresInDays）
wonda voice list
# 取得單一語音
wonda voice get <voice-id>
# 重新命名 / 重新描述（僅本機，不會呼叫提供者）
wonda voice update <voice-id> --name "新名稱" --description "..."
# 刪除
wonda voice delete <voice-id>
在 TTS 中使用克隆語音：將 voice get 傳回的 providerVoiceId 作為 voiceId 傳遞給 /audio/speech：
wonda audio speech "哈囉世界" \
--model minimax-speech-2-8-hd \
--params '{"voiceId":"<providerVoiceId>"}'
7 天到期：如果在 7 天內未在 TTS 中使用，克隆語音會自動到期。使用克隆語音執行 TTS 會自動刷新其到期時間。閒置過期的語音必須重新克隆（再次花費 $1.50 美元）。
憑證儲存庫
保留在外部平台（Instagram、TikTok、Twitter 等）建立的登入資訊，以便在下次執行時重複使用。密碼使用伺服器端的 AES-256-GCM 金鑰加密，僅在 get 時解密。
# 建立
wonda credentials create --website instagram.com --username myhandle \
--email [email protected] --password-stdin <<< "hunter2" \
--metadata '{"signup_source":"wonda-email"}'
# 列出（密碼已省略）
wonda credentials list --website instagram.com
# 取得完整記錄（包含解密後的密碼）
wonda credentials get <id>
# 更新任何欄位（使用 --password-stdin 來輪換；使用 --username "" 來清除）
wonda credentials update <id> --username newhandle
# 刪除
wonda credentials delete <id>
# 在一次呼叫中取得憑證並記錄使用原因 — 使用 POST 而非 GET，因為它會寫入一個帶有原因的 'used' 事件。只要能夠說明原因，請優先使用此方法而非 `get`。
wonda credentials use <id> --reason "instagram signup flow"
# 查看近期事件（建立 / 使用 / 輪換 / 更新）以進行稽核
wonda credentials events <id>
欄位：website（必要 — 輸入如 insta 等文字會標準化為 instagram.com）、username、email、password（必要）、metadata（任意 JSON）。username / email 至少需要提供一個。允許同一個 (website, username) 有多筆記錄 — 如果您需要，請自行處理重複資料。
事件日誌：每次 credentials get/use、create、密碼輪換和其他更新都會記錄為憑證上的事件（行為者：cli | web | system）。使用 credentials events <id> 或網頁 UI 的歷史記錄圖示來進行稽核。事件日誌是僅附加的，並在憑證刪除時級聯刪除。
全域輸出標記
所有命令都支援這些輸出控制標記：
--json— 強制輸出 JSON（當 stdout 被 pipe 時會自動啟用）--quiet— 僅輸出主要識別碼（任務 ID、媒體 ID 等）— 非常適合腳本化使用-o <path>— 將輸出下載到檔案（隱含--wait）--fields status,outputs— 選擇特定的 JSON 欄位--jq '.outputs[0].media.url'— 使用 jq 表達式過濾 JSON 輸出
CLI 公告與棄用警告
每次執行命令時，CLI 會輪詢 GET /api/v1/updates（匿名，在 ~/.wonda/state.json 中快取 1 小時）以取得有效的公告：棄用通知、事件預警、升級提示。訊息只會輸出到 stderr，因此 stdout/JSON 可以保持乾淨以利 pipe。
每個請求的棄用提示會以標準的 Warning: 299 - "<message>" HTTP 標頭形式送達，並由 CLI 的 HTTP 用戶端以 [deprecated METHOD /path] <message> 的形式輸出到 stderr。
使用 WONDA_QUIET=1（環境變數）或 --quiet（標記）可以靜默這兩個管道。使用 WONDA_NO_UPDATE_CHECK=1 則可停用網路檢查。
WAB / Wonda 自動化瀏覽器 (wonda wab)
Wonda 自動化瀏覽器 (WAB) 是一個高級隱形反偵測瀏覽器，經過強化以防平台將其識別為自動化工具。wonda wab 是反偵測 Chromium 堆疊（一個未偵測到的 Playwright 分支）的單一命令。它有兩種用途：
- 已驗證的會話。 每個身份有一個持久的 headful Chromium，用於保存 LinkedIn、X、Reddit 等平台的已登入會話。CLI 會按需啟動它，讓其閒置超時，並在命令執行
--via wab時透過它路由平台讀/寫操作。Cookie 儲存在身份的 Chromium 設定檔中，而非~/.wonda/config.json。 - 匿名擷取。
wonda wab record <url>（和wonda brand extract）會驅動一個具有全新指紋的臨時 Chromium，沒有身份，沒有 Cookie。請參閱下面的record區塊。
心智模型：您擁有帳戶（每個平台一個身份）。每個平台命令會透過平面 JSON 儲存庫（--via cookies，快速，無需 Chromium）或帳戶的身份（--via wab，即時反偵測 Chromium）來路由到該帳戶的 Cookie。身份是可以持有多個帳戶的 Chromium 外殼，所有帳戶共用一個指紋。在大多數情況下，身份是自動建立的……