Wonda CLI
Wonda CLI 是一個為終端機代理設計的內容創作工具包。可用於生成圖片、影片、音樂和音訊;編輯與合成媒體;發布到社群平台;以及在 LinkedIn、Reddit 和 X/Twitter 上進行研究與自動化操作。
安裝
如果 wonda 不在 PATH 中,請先安裝:
# 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 web 和 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 web 則無法。Wonda 本機中繼是替代路徑:它讓遠端連接器(web 或 Cowork)在使用者自己的 Mac 和住宅 IP 上執行動作,而無需任何本機 MCP 設定:
- 登入後開啟
https://wonda.sh/download,安裝公證過的 Mac 套件。 - 使用
wonda relay pair或首次執行的瀏覽器交接來配對中繼。這會使用現有的cli-auth流程,搭配一個作用域為中繼的wrelay_...憑證,儲存在 macOS 鑰匙圈中。請勿要求使用者貼上 API 金鑰或裝置代碼。 - 開啟
https://wonda.sh/setup,透過具有完整 UI 的本機 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/月,「專業版」) | 除雲端分身外的一切:生成(image/generate、video/generate、...)、媒體上傳/下載、發布、爬取、分析、影片分析、技能(wonda skill install/list/get)、轉場、剪輯、電子郵件、reddit/linkedin 帳號建立、樣式、品牌。 |
| WONDA_PREMIUM($49.99/月,「高級版」) | 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 "Brand" --media-id <uuid>
# 可選的來源音頻預處理
wonda voice create "Clean" --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 "Hello world" \
--model minimax-speech-2-8-hd \
--params '{"voiceId":"<providerVoiceId>"}'
7 天有效期:未在 TTS 中使用超過 7 天的克隆語音會自動過期。使用克隆語音執行 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 註冊流程"
# 查看最近事件(建立/使用/輪換/更新)以進行稽核
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 Automation Browser (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 信封,共用一個指紋。在幾乎所有情況下,角色會在首次使用 --via wab 時自動建立,並以帳號命名,因此您永遠不需要輸入角色名稱。
本機 wonda.mcpb 桌面擴充功能從 Claude Desktop 或 Claude Code 使用此相同的本機 WAB 路徑:平台 Cookie 留在裝置上,讀取使用本機 Cookie,寫入使用本機 WAB。Claude web 和 Cowork 則需要遠端 MCP 連接器。
**原生登入...
[已截斷以進行翻譯]