Wonda CLI
在终端中用 AI 生成、剪辑并发布图片、视频、音乐和社交内容,你的 AI 助手无需学习即可直接调用。
- 源仓库
- degausai/wonda (已不可访问)
- Star 数(最后可见)
- ★ 162
- 最近更新
- 23 天前
- 主语言
- TypeScript
- FA 评分
- 44/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex · Claude Code
- 费用
- 需要付费订阅或许可
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 独立电商卖家让 Claude Code 用一张产品图生成 sora2 产品视频,配上音乐和动态字幕后一键发到 TikTok。
- 不适合
- 需要完全本地离线运行、不愿把媒体上传到云端的用户
- 不打算注册 wonda.sh 账户或购买积分的个人
- 需要自托管或修改源码的团队(许可为专有)
这个 Agent 能做什么,适合哪些场景?
Wonda 是一个专有的命令行工具,把 AI 内容生成能力带入终端,覆盖图片、视频、音乐、语音以及社交平台发布。所有命令输出 JSON 到 stdout,方便脚本和 AI 编码代理(如 Claude Code、Codex)直接消费;它还提供 skill 文件和插件机制,让代理自动学会全部命令与工作流。生成任务通过 wonda.sh 云端完成,按积分计费;发布功能直接对接 TikTok、Instagram、X、Reddit 和 LinkedIn。编辑能力面向 TikTok/Reels 式短视频,包括 animatedCaptions、splitScreen、lipsync、背景移除和视频升档等 20 多种操作。安装方式包括 npm、Homebrew 以及面向各代理的原生插件。
Wonda 通过子命令组织能力:generate image|video|text|music 从文本提示或参考图生成内容(示例模型有 nano-banana-2、sora2、suno-music);audio speech|transcribe|dialogue 处理语音;edit video --operation ... 提供 animatedCaptions、textOverlay、merge、splitScreen、trim、speed、skipSilence、birefnet-bg-removal、topaz-video-upscale、sync-lipsync-v2-pro 等剪辑操作;analyze video 输出帧网格加音频转写以供视频理解;publish instagram|tiktok(含 carousel 变体)直接发布;linkedin、x、reddit 命令族支持搜索、浏览、发帖、点赞、私信等;scrape social|ads 抓取竞品资料与 Meta 广告库;blueprint 管理可复用工作流。所有输出为 JSON,内置 --jq 字段选择,--quiet 只返回任务 ID 便于管道组合,且当 stdout 被管道时自动启用 JSON 模式。
- 独立电商卖家让 Claude Code 用一张产品图生成 sora2 产品视频,配上音乐和动态字幕后一键发到 TikTok。
- 社交媒体运营批量制作 Reels 风格短视频:合并片段、burn 动态字幕、去静音、调速度。
- 营销团队用
scrape ads搜索 Meta 广告库中的竞品广告,制定投放创意。 - 个人品牌运营者通过 CLI 直接管理 LinkedIn 和 X 的发帖、回复、点赞与私信。
- 播客/短视频制作者用 transcribe、enhanceAudio、voiceExtractor 处理音轨并提取片段。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm i -g @degausai/wondanpx skills add degausai/wonda
- 安装说明涉及
- macOS
如何安装或部署这个 Agent?
通过 npm 或 Homebrew 安装:
bash
npm i -g @degausai/wonda或:
bash
brew tap degausai/tap && brew install wonda然后认证并安装代理 skill 文件(需要 wonda.sh 账户):
bash
wonda auth loginwonda skill install -o .
面向特定 AI 代理的插件安装:
bash
npx skills add degausai/wondaClaude Code:
bash
/plugin marketplace add degausai/wonda
/plugin install wonda@degausaiGemini CLI:
bash
gemini extensions install https://github.com/degausai/wonda如何使用这个 Agent?
先认证并充值(账户在 wonda.sh 注册,生成消耗积分):
bash
wonda auth login
wonda topup
wonda balance生成一张图片:
bash
wonda generate image \
--model nano-banana-2 \
--prompt "Product photo of headphones on marble" \
--wait -o photo.png从参考图生成视频:
bash
MEDIA=$(wonda media upload ./product.jpg --quiet)
wonda generate video --model sora2 \
--prompt "Slow orbit, dramatic lighting" \
--attach "$MEDIA" --duration 8 --wait -o video.mp4添加 TikTok 风格动态字幕:
bash
wonda edit video --operation animatedCaptions --media "$VID_MEDIA" \
--params '{"fontFamily":"TikTok Sans","position":"bottom-center","highlightColor":"#FFD700"}' \
--wait -o captioned.mp4发布到 Instagram:
bash
wonda publish instagram \
--media med_abc123 \
--account ig_acct_456 \
--caption "New drop. Link in bio."用内置 jq 提取字段:
bash
wonda generate image --model nano-banana-2 --prompt "A cat" --wait \
--jq '.outputs[0].media.url'这个 Agent 有哪些优点和局限?
- AI 代理原生集成:skill 文件自动同步,代理读取 --help 即可自主完成模型选择与完整工作流,无需人学习 CLI。
- 全 JSON 输出加内置 --jq 与 --quiet 模式,天然适合脚本管道和多步内容流水线(生成→配乐→字幕→发布)。
- 从生成到剪辑到直接发布 TikTok/Instagram/X/Reddit/LinkedIn 的一站式闭环,含竞品广告抓取与分析。
- 专有许可且强依赖 wonda.sh 云端:生成必须消耗积分,无法自托管或本地运行模型。
- 使用前必须注册账户并充值,成本结构需通过
wonda pricing estimate自行预估。 - 社交发布与 LinkedIn/X/Reddit 操作依赖存储的会话凭据,存在账户凭据管理与平台合规风险。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Wonda CLI 当前 | 44 · 缺口较多 | 命令行工具付费 | ★ 162 | 23 天前 | TypeScript | Codex · Claude Code |
| Publora 社交发布技能 | 66 · 存在缺口 | Agent 插件 / 技能免费版 + 付费版 | ★ 70 | 2 天前 | Python | Codex · Claude Code · Claude.ai |
| md2wechat:AI Agent 公众号创作与发布 CLI | 70 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 3.8k | 1 个月前 | Go | Codex · Claude Code |
| SuperCMO 创意制作技能 | 71 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 324 | 9 天前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
提供本地与远端模式、API 密钥和 OAuth 认证说明,并明确禁止代理处理登录凭据;但产品支持读取、发布、删除、点赞、私信等广泛账户操作,文档中的确认要求有限,最小权限和撤销/回滚机制也未充分说明。资源与工具代码表明会读取余额、能力和账户技能,并可经 HTTPS 调用服务;凭据在本地 Keychain 等说明有帮助,但依赖安全证据、来源署名及外部操作的统一确认保障不足,故未给高分。
README、技能文件和 MCP 代码大体一致地描述生成、社交平台操作及本地/远端模式;但技能材料在角色说明处截断,且不同文件对安装渠道和集成范围的覆盖不完全一致。API 错误有 JSON 返回或 MCP 错误码,README 说明错误输出到 stderr,但缺少系统性的故障排查、依赖可用性或恢复证据。
面向能运行 shell 命令的 AI 助手和终端用户,列出生成、编辑、研究、发布等场景;MCP 说明 local/remote 边界、账号选择及 relay 离线策略,适配信息较具体。但技能描述覆盖范围较广,触发条件和部分能力边界未逐项明确。README 声称支持 macOS、Linux、Windows,技能另说明部分桌面功能偏向 macOS,环境说明有一定细节。
README 有安装、命令分类、示例、输出格式、定价和许可证说明,插件清单与 Gemini 扩展元数据补充了集成信息。扣分原因是命令清单与技能中描述的能力不完全相同,版本只见插件元数据且未提供变更历史;局限和维护责任也缺少清晰说明。许可证明确标为专有,但具体条款需到外部网站查看。
JSON 输出、quiet、字段筛选和内置 jq 适合脚本与代理使用;示例展示从生成到编辑再发布的端到端流程,且有价格估算和余额命令。可见的价值覆盖多种内容与社交任务;但操作产生信用费用且可能直接对外发布或改动账户状态,收益成本控制与发布前审阅说明较薄。
README、技能文件、插件元数据和 MCP 源码分别支持产品范围、集成方式及部分模式说明,因此存在有限的交叉印证。多数能力与安全描述仍是产品文档陈述,未有来源级证明或逐项代码佐证;版本、变更和维护信息不足,事实与营销性主张的区分也不完整。
- 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 生成会消耗账户额度;发布、发消息、点赞、关注或删除等操作可能直接影响真实账户。执行前应核对账号、内容和目标平台。
- 本地 relay 与云端 twin 的路由取决于模式和在线状态;技能文件所述部分桌面能力仅覆盖 macOS,且样本在角色说明处截断。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
WAB prepares spare browser copies while the Mac is locked and reuses them for new personas. Until a spare is ready, a new persona's first launch still needs a locked screen. Anonymous screenshots, recordings and brand extraction use temporary headed WAB sessions. When WAB_PROXY_URL or WAB_PROXY_SERVER is set, anonymous capture refuses the standalone headless path instead of bypassing that proxy. Brand images and fonts use the headed browser context's request client. …在 GitHub 查看 ↗ -
v1.72.6 Wonda 1.72.6
发布说明摘录
Wonda 1.72.6 improves commands in hidden browser windows on a busy Mac. It disables Chrome's background renderer deprioritization while preserving normal idle page-timer throttling. Set WAB_REUSE_ONLY=1 to reuse a healthy matching driver and refuse implicit browser starts or restarts. The show/focus guard can revalidate a persona's last known browser PIDs when a full process scan times out. These changes need CLI and driver 1.72.6. Update the runtime through the normal WAB updater when personas are safely stopped, coordinating existing sessions with their owners. …在 GitHub 查看 ↗ -
v1.72.5 Wonda 1.72.5
发布说明摘录
Wonda 1.72.5 fixes browser commands that kept running after timing out or losing their client. Queued commands now respect deadlines, cancelled input releases its keys/buttons, closing a stuck tab cancels its work, and late tab setup cannot replace a newer tab. Focus fallback and tab-title reads are bounded. Snapshots wake background content with a lingering focus lease; get stays read-only. The release also includes personal invite links with nullable limits and the authenticated download path. …在 GitHub 查看 ↗
常见问题
使用 Wonda 需要花钱吗?
wonda topup 充值、wonda balance 查余额、wonda pricing estimate 在生成前估算成本。我的 AI 代理需要额外配置吗?
wonda skill install 后 skill 文件会在后台自动同步,代理读取 --help 和内置 skill 即可自行掌握命令、模型与工作流。支持哪些操作系统?
生成的内容发布到社交平台需要什么凭据?
auth set 存储会话凭据,并可用 auth check 验证有效性。可以直接把多个命令串成流水线吗?
--quiet 只输出 ID,--jq 内置字段提取,stdout 被管道时自动进入 JSON 模式,README 给出了完整的生成→配乐→字幕→发布示例。Wonda CLI 安全吗?
谢谢反馈,我们会据此改进页面。