核心用法
本技能为豆包（Volcengine ARK）API 的纯 Bash 脚本封装，提供三大核心能力：
1. 文生图 (img)：输入提示词生成图片，自动下载至 data/ 目录
2. 图生图编辑 (edit)：智能去除水印、Logo，支持自定义编辑指令
3. 文生视频 (vid)：支持异步（快速返回任务ID）与同步（等待完成自动下载）两种模式，以及任务状态查询
典型调用示例：
./doubao.sh img "一只可爱的小猫" ./doubao.sh edit "https://..." "remove watermark" ./doubao.sh vid "一个人在跳舞" sync
---
显著优点
| 维度 | 优势 |
|------|------|
| **部署轻量** | 纯 Bash 实现，仅需 `curl` + `jq`，无 Python/Node 依赖，嵌入式环境友好 |
| **使用便捷** | 单行命令即调即用，自动文件命名与下载，结果本地化存储 |
| **模式灵活** | 视频生成支持异步/同步双模式，异步适合批量任务，同步适合即时获取 |
| **开箱即用** | 符合 OpenClaw/ClawHub 标准目录结构，集成示例与故障排查文档完备 |
---
潜在缺点与局限性
- API 依赖风险：需自行申请火山引擎 ARK API Key，服务可用性受限于豆包平台
- 视频下载限制：生成视频 URL 带有时效签名，部分情况下 curl 直接下载会 403，需浏览器环境手动获取
- 无交互界面：纯命令行工具，非技术用户上手门槛较高
- Shell 兼容性：虽要求 Bash 4.0+，但部分高级语法在老旧系统（如默认 macOS Bash 3.x）可能不兼容
- 错误恢复有限：网络中断或 API 限流时需手动重试，无内置指数退避机制
---
适合人群
- DevOps/运维工程师：需要轻量级、无运行时依赖的自动化图像/视频生成工具
- 后端开发者：快速集成 AI 生成能力至 CI/CD 或批处理脚本
- 嵌入式/IoT 开发者：资源受限环境下（如边缘服务器）部署 AIGC 功能
- 技术型创作者：偏好命令行工作流、追求脚本化自动化的内容生产者
---
常规风险
| 风险类型 | 说明 |
|---------|------|
| **API Key 泄露** | 脚本依赖 `ARK_API_KEY` 环境变量，误提交至代码仓库会导致密钥泄露与费用滥用 |
| **成本不可控** | 视频生成按量计费，同步模式长轮询可能产生意外费用，建议生产环境优先使用异步模式 |
| **内容合规** | 生成内容需遵守火山引擎 AUP 及中国生成式 AI 监管要求，存在审核失败风险 |
| **数据本地留存** | 自动生成文件保存于本地 `data/` 目录，需自行管理存储空间与敏感内容清理 |