happy-dreamina

happy-dreamina

通过字节跳动官方的 dreamina CLI 生成图像和视频。此技能只是一个精简的指令层，不会封装任何 SDK。每项操作都会映射到用户的 shell 中已有的 dreamina 子命令。

何时调用此技能

满足以下任一条件时，请使用此技能：

• 用户提到 即梦、Jimeng 或 Dreamina（任何语言均可）。
• 用户明确提到 dreamina CLI 或其子命令。
• 用户询问即梦任务历史、账户积分或登录状态。

如果用户只是说“生成一张图”或“画张图”，但没有提到即梦，则优先使用 happy-image-gen / happy-video-gen，不要触发此技能。原因是即梦使用浏览器登录，且只是一个特定服务提供商；其他技能允许用户通过 EXTEND.md 默认设置，从多个服务提供商中进行选择。

步骤 0：预检（阻塞性 — 在执行其他操作前运行这两项检查）

并行运行以下命令：

1. command -v dreamina — 检查是否已安装该二进制文件。
2. dreamina user_credit — 检查登录是否有效。正常响应应为包含积分信息的 JSON。

如果未安装 dreamina

告知用户缺少 dreamina CLI，并询问是否要安装。官方安装程序为：

curl -fsSL https://jimeng.jianying.com/cli | bash

这是一个会向用户机器写入内容的 shell 安装操作，不得静默运行。先征求确认，然后运行安装程序，再次检查 command -v dreamina。平台说明（macOS、Linux x86_64/arm64）请参阅 references/install-and-login.md。对于其他平台（例如 Windows）或安装程序发生变化时，请引导用户访问官方安装页面：https://jimeng.jianying.com/ai-tool/install。

如果 user_credit 失败（退出码非零，或 JSON 中缺少积分信息）

用户尚未登录，或令牌已过期。请让他们运行：

dreamina login

这会打开默认浏览器进行即梦授权。凭据会自动写入 ~/.dreamina_cli/credential.json，用户无需处理该文件。如果浏览器没有打开，或授权流程卡住，请进一步排查：运行 dreamina login --debug（参阅 references/troubleshooting.md）。

在 dreamina user_credit 成功之前，不要继续生成。

步骤 1：选择正确的子命令

将用户意图映射到唯一一个子命令：

用户想要……	命令
根据文本生成图像	dreamina text2image
转换或重新设计现有图像的风格	dreamina image2image
根据文本生成视频	dreamina text2video
为静态图像添加动画（i2v）	dreamina image2video
获取较早提交的异步结果	dreamina query_result
浏览过往任务	dreamina list_task

步骤 2：根据用户意图填写参数

使用 references/ratio-resolution-map.md 将自然语言（“竖屏 / 1080P / 高清 / 方图 / 横屏”）转换为标志。注意用户没有说明的内容——填入安全的默认值，不要让用户重复说明显而易见的事项。

图像生成 — text2image / image2image

• --prompt="..." — 始终使用双引号，以免 shell 元字符（中文引号、逗号）造成问题。
• --ratio — 1:1 / 16:9 / 9:16 / 3:4 / 4:3。默认值为 1:1。
• --resolution_type — 1k / 2k / 4k。默认值为 2k；快速草稿使用 1k，仅在用户要求超清或适合印刷时使用 4k。
• 仅适用于 image2image：--images <path>（复数形式 — 接受参考图合集，可用空格分隔多个路径）。
• 始终包含 --poll=30。

视频生成 — text2video / image2video

• --prompt="..." — 使用相同的引号规则。
• --duration — 整数秒。默认值为 5。
• --ratio — 横屏意图的默认值为 16:9，竖屏为 9:16，方形为 1:1。
• --video_resolution — 480P / 720P / 1080P。默认值为 720P。
• 仅适用于 image2video：--image <path>（单数形式 — 单张关键帧）。
• 始终包含 --poll=60（视频生成耗时比图像更长）。

⚠ 容易混淆：image2image 使用 --images（复数形式，参考图合集）。image2video 使用 --image（单数形式，一张关键帧）。混淆二者会导致“unknown flag”错误。

步骤 3：提交并读取结果

通过 Bash 运行命令。成功后，CLI 会将 JSON 输出到 stdout，其中包含结果 URL 或本地文件路径（如果传入了 --download_dir）。将路径或 URL 返回给用户。

示例——文本生成图像：

dreamina text2image \
  --prompt="一只戴墨镜的橘猫,背光,电影感" \
  --ratio=1:1 \
  --resolution_type=2k \
  --poll=30

示例——图像生成视频：

dreamina image2video \
  --image=./keyframe.png \
  --prompt="镜头缓缓推近,橘猫眼神闪动" \
  --duration=5 \
  --ratio=16:9 \
  --video_resolution=720P \
  --poll=60

如果用户希望将结果下载到本地，而不是获取 URL，请添加 --download_dir=./out（先创建目录）。

步骤 4：处理异步超时

如果 --poll 超时，CLI 会返回状态为 querying 且包含 submit_id 的 JSON。告知用户你会重试，然后：

dreamina query_result --submit_id=<submit_id> --download_dir=./out

如果任务仍在进行中，请等待后重试。如果任务失败，请从 query_result 响应中提取错误消息并原样转达——不要猜测。

高级用法：历史记录和会话

• dreamina list_task --gen_status=success — 列出已完成的任务。
• dreamina list_task --submit_id=<id> — 获取指定任务。
• 会话（v1.3.5+）允许用户为不同项目使用独立工作区。只有在用户明确要求“切换会话”、“在会话 X 中工作”或“列出会话”时，才操作会话。否则，使用默认会话即可。

参考资料

按需加载这些资料——不要一开始就全部阅读：

• references/cli-commands.md — dreamina 每个子命令的完整标志表。
• references/install-and-login.md — 安装程序详情、浏览器登录、凭据文件位置和版本升级。
• references/ratio-resolution-map.md — 用户表述与 --ratio / --resolution_type / --video_resolution 的对应关系。
• references/troubleshooting.md — 登录过期、队列超时、submit_id 恢复和账号切换。