核心用法
AnyGen Storybook 是一个专门用于生成故事书风格视觉内容的 AI 技能，通过与用户的多轮对话深入理解叙事需求、视觉风格和目标受众，然后调用 AnyGen OpenAPI 自动生成完整的故事书或视觉叙事材料。
工作流程分为四个阶段：
1. 需求理解（Phase 1）：通过 prepare 命令与用户进行多轮对话，收集故事主题、视觉风格、受众群体等关键信息。支持上传参考文件（PDF、图片等），系统会读取并提取关键内容辅助生成。
2. 方案确认（Phase 2）：当对话状态达到 ready 时，向用户展示系统建议的叙事结构、视觉风格和页面规划，必须获得用户明确确认后才能进入生成阶段。
3. 任务创建（Phase 3）：调用 create 命令提交任务，获取在线编辑链接。此时需立即告知用户生成已开始、提供预览链接，并说明预计耗时 10-15 分钟。
4. 后台监控与交付（Phase 4）：通过 sessions_spawn 启动后台进程持续轮询任务状态（最长 20 分钟），完成后自动下载缩略图并推送至用户。用户可主动请求下载完整文件。
输出格式：默认为 PPTX 演示文稿，可选图片集或纯缩略图。支持 16:9 和 4:3 两种比例。
显著优点
- 对话式智能理解：不同于单轮提示词生成，通过结构化对话深度挖掘用户需求，降低提示词工程门槛
- 文件参考支持：可上传现有文档、脚本或参考资料，AI 会提取关键信息融入创作
- Nano Banana 系列模型：搭载 Nano Banana pro 和 Nano Banana 2，在视觉叙事和一致性方面表现优异
- 非阻塞体验：后台监控机制确保用户无需等待，可继续其他对话
- 在线协作编辑：生成过程中提供实时预览链接，支持在线调整
潜在缺点与局限性
- 执行时间较长：完整生成需 10-20 分钟，不适合即时性需求
- 依赖外部服务：完全依赖 AnyGen API 可用性，存在单点故障风险
- 文件大小限制：参考文件限 50MB，大文档需预处理
- 需要 Python 环境：本地需安装 Python3 和 requests 库
- 后台监控必需 `sessions_spawn`：若该功能不可用，体验降级为手动轮询
- 24小时下载限制：生成文件链接有效期较短
适合人群
- 内容创作者：需要快速将文字脚本转化为视觉故事板
- 营销/运营团队：制作产品演示、品牌故事、培训材料
- 教育工作者：生成教学故事书、课件视觉内容
- 独立设计师：作为视觉叙事初稿生成工具，后续人工精修
- 非设计专业用户：通过对话而非专业技能完成视觉内容创作
常规风险
| 风险类别 | 具体描述 | 缓释措施 |
|---------|---------|---------|
| API 密钥安全 | 需存储 `sk-xxx` 格式密钥于本地配置文件 | 明确限制仅发送至 `anygen.io`，禁止其他端点 |
| 文件上传隐私 | 用户文件上传至第三方服务 | 必须获得明确 consent，禁止静默上传 |
| 后台进程超时 | 轮询可能阻塞长达 20 分钟 | 强制要求 25 分钟 timeout 的 `sessions_spawn` |
| 技术术语暴露 | 内部实现细节泄露影响体验 | 严格禁止 `task_id`、`API`、`poll` 等术语输出 |
| 生成失败 | 网络中断或服务异常导致任务失败 | 完善错误处理，提供任务链接供用户自查 |
| 版权合规 | AI 生成内容的知识产权归属 | 用户需自行确认 AnyGen 服务条款 |
技术实现要点
- 脚本位置：
scripts/anygen.py（Python） - 配置文件：
~/.config/anygen/config.json - 工作目录：
~/.openclaw/workspace/ - 核心命令：
prepare、create、poll、thumbnail、download - 轮询间隔：3 秒，最大执行 20 分钟