核心用法
本 Skill 是火山引擎豆包（Doubao）ARK 平台多模态 API 的 Shell 脚本实现，提供 img、edit、vid、status 四大核心 Action：
- img：文本生成图片，支持自然语言描述，自动下载到
data/img_YYYYMMDD_HHMMSS.jpeg。 - edit：图片智能编辑，默认提示词为去除水印并保留主体，支持自定义编辑指令。
- vid：文本或图生视频，支持
async（快速返回 task_id）与sync（轮询等待至完成，耗时 1-3 分钟）两种模式。 - status：查询异步视频任务状态（pending/running/succeeded/failed）。
调用方式极为轻量：cd scripts && ./doubao.sh <action> <args>，依赖仅 curl + jq（可选），适合嵌入式、CI/CD 或受限环境。
显著优点
1. 零 Python 依赖：纯 Bash 实现，避免 Python 环境冲突与依赖地狱。
2. 双模式视频生成：async 模式节省 Token 消耗（不占用轮询成本），sync 模式一键阻塞等待结果，降低用户心智负担。
3. 自动化文件管理：自动生成时间戳文件名，统一归档至 data/ 目录，避免覆盖与混乱。
4. 内置错误处理与重试：脚本包含状态码检查、JSON 解析容错、最大轮询次数限制，提升稳定性。
5. 符合 OpenClaw/ClawHub 标准：目录结构规范（SKILL.md、references/、scripts/），易于集成与分发。
潜在缺点与局限性
1. 视频下载受限：生成的视频 URL 含时效签名，直接 curl 可能 403，需浏览器手动下载，自动化流水线需额外处理。
2. 同步模式阻塞风险：视频生成耗时 1-3 分钟，sync 模式长时间占用终端，不适合高并发场景。
3. 无内置限流与配额管理：未集成 ARK 平台的 RPM/TPM 限流逻辑，高频调用可能触发 429。
4. 依赖外部环境变量：ARK_API_KEY 未设置时脚本直接退出，无交互式配置引导，新手体验稍逊。
5. Shell 可移植性：虽要求 Bash 4.0+，但部分高级语法（如关联数组）在 macOS 默认 Bash 3.x 不可用，需用户升级或改用 zsh。
适合人群
- 运维/DevOps 工程师：需要在服务器、容器或无 Python 环境中快速生成素材。
- 自动化流水线开发者：将文生图/视频集成到 Shell 脚本或 CI/CD 流程。
- 轻量级桌面用户：追求最小依赖、快速上手，不愿配置 Python 虚拟环境。
- 教育/演示场景：展示 API 调用原理，脚本逻辑透明易读。
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **API Key 泄露** | 环境变量或历史命令中明文存储 | 使用专用 secret 管理工具（如 `pass`、`1password-cli`），避免 `export` 写入 `.bashrc` 后误提交 |
| **成本失控** | 视频生成单价高，同步模式反复轮询可能意外消耗 Token | 优先使用 async 模式，结合 `status` 按需查询；设置账户消费告警 |
| **生成内容合规** | 文生视频/图可能触发平台内容审核，导致任务失败 | 前置过滤提示词，避免敏感、政治、侵权描述 |
| **URL 时效性** | 视频/图片 URL 含短期签名，未及时下载会失效 | 脚本已自动下载图片，视频需用户及时手动处理或扩展脚本支持带签名的持久化存储 |
| **依赖可用性** | curl/jq 未安装或版本过旧 | 脚本启动前检测依赖，文档已提供多平台安装命令 |
总结
本 Skill 以极简依赖、透明脚本、自动化文件管理为核心卖点，填补了「无 Python 环境下的豆包多模态 API 调用」空白。适合追求轻量、可控、可嵌入的开发者，但需注意视频下载限制与同步阻塞问题，合理选择 async/sync 模式。