Reihantt6/sns-myagent

Wonda CLI

Wonda CLI 是一個專為終端機代理程式設計的內容創作工具包。您可以使用它來生成圖片、影片、音樂和音訊；編輯和合成媒體；發布到社交平台；以及在 LinkedIn、Reddit 和 X/Twitter 上進行研究和自動化操作。

安裝

如果系統 PATH 中找不到 wonda，請先進行安裝。推薦安裝簽署過的桌面安裝程式 (CLI + 托盤圖標 + 永遠在線的中繼，零額外步驟)：macOS 使用 brew install --cask degausai/tap/wonda-app (或從 releases 下載 wonda-macos.pkg)，Windows 使用 winget/wonda-windows-setup.exe。以下僅 CLI 的通道可在任何環境下運作，並可稍後使用 wonda app install 添加桌面應用程式：

# 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 令牌。伺服器會將這些令牌交換為帳戶的內部 API 金鑰 (僅在 Wonda 內部進行)，因此代理程式和連接器主機永遠不會看到 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 設定：

1. 在登入狀態下開啟 https://wonda.sh/download，並安裝經過公證的 Mac 套件。
2. 使用 wonda relay pair 或首次執行的瀏覽器交握來配對中繼。這會使用現有的 cli-auth 流程，並將中繼範圍的 wrelay_... 憑證儲存在 macOS 鑰匙圈中。不要要求使用者貼上 API 金鑰或裝置代碼。
3. 開啟 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 是純付費服務：每個產品表面都需要付費方案，包括 API 呼叫、本地平台讀取、瀏覽器自動化、媒體合成、檔案編輯、診斷、生成、發布、抓取、分析、技能、中繼操作和雲端分身。在任何產品命令執行工作之前，CLI 會對 Wonda 進行即時權利檢查。當無法驗證存取權限時，檢查會以失敗告終。新帳戶在訂閱前無法獲得任何產品存取權限，且正的信用額度不能取代方案。

層級	存取權限
匿名 (未登入)	無產品存取權限。驗證、設定、定價、組織探索/選擇、Shell 補全和本地關機命令仍可使用，以便使用者訂閱、恢復或停止背景服務。請執行 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)。

如果命令返回 403 (paid_plan_required)，請在 https://wonda.sh/account 訂閱。

這也適用於本地 stdio MCP 路徑，因為 MCP 執行相同的 CLI。平台 Cookie 和資料仍在裝置上，但命令必須先從 GET /api/v1/auth/access 收到成功的付費存取決定。僅中繼安裝可以使用其範圍限定的 wrelay_... 憑證來進行該權利探測。範圍限定的憑證仍然無法呼叫一般帳戶 API。

語音複製

從 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 自動化瀏覽器 (WAB) 是一個高級隱形反偵測瀏覽器，經過強化以防止平台將其識別為自動化。wonda wab 是用於反偵測 Chromium 堆疊 (一個未偵測的 Playwright fork) 的單一命令。它有兩個面向：

• 已驗證的工作階段。 每個角色一個持續的、有頭的 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 外殼。在一個…

…[因翻譯而截斷]