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流程，並在 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/月，「專業版」） | 雲端孿生以外的所有功能：生成（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 "哈囉世界" \
--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 註冊流程"
# 查看最近事件（建立/使用/輪換/更新）以進行稽核
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> 或 Web 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 分支）的單一命令。它有兩個面向：
- 已驗證的工作階段。 每個角色一個持久的頭部 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 連接器。
**原生登入...