dreamina-cli

Dreamina CLI

⚠️ 停止维护公告：旧版 Dreamina CLI（dreamina，v1.4.18）将于 2026 年 11 月 起停止维护。新任务请改用 Canvas 替代技能 dreamina-canvas-cli（安装：npx skills add full-aigc-skills/dreamina-skills --skill dreamina-canvas-cli）。本技能内容保留作历史契约参考。

当你需要通过 dreamina 使用 Dreamina（即梦）进行图像或视频生成、登录、会话管理或任务历史相关操作时，请使用此技能。

即梦是 Dreamina 的中文产品名称。对于一般的即梦请求，请选择 dreamina-canvas-cli；只有在明确要求使用经典 CLI 时，才使用此冻结技能。

此技能特意保持简短。详细标志和支持的值以 CLI 本身为准，因此请始终将 dreamina -h 和 dreamina <subcommand> -h 作为首要参考。

逐步阅读参考文档：

• 有关安装、身份验证、账户检查、所有公开命令类别、会话 CRUD、更新和日志故障排查，请阅读 references/official-cli-install-to-use.md。
• 有关 v1.4.18 的模型、分辨率、时长和比例限制，请阅读 references/dreamina-cli-v1.4.18-contract.md。

适用场景与边界

从首次安装到故障排查，或当登录、会话、任务历史、异步后续操作或命令路由涉及多种模态时，请使用此综合技能。不要用它替代四种执行技能各自针对特定模式的工作流，也不要将其用于仅编写提示词的场景。

此工具的用途

dreamina 是本地 CLI 入口，用于所有当前开放的 Dreamina（即梦）图像和视频生成工作流，以及相关的账户和会话操作。

适用于：

• 检查或复用现有的 Dreamina 登录会话
• 检查账户点数
• 使用 dreamina session 管理会话
• 使用 dreamina logout 清除本地 OAuth 登录状态
• 提交图像生成任务
• 提交视频生成任务
• 查询异步任务结果并下载生成的媒体文件
• 查看已保存的任务历史

默认工作流

将此 CLI 用作 Agent 时：

步骤 1：验证环境

如果缺少 dreamina，请阅读安装到使用参考文档，并在安装或更新软件前取得明确授权。否则，先运行 dreamina version 和 dreamina -h，然后在实际使用前运行 dreamina <subcommand> -h。

步骤 2：完成认证与路由

除非用户要求更改登录状态，否则复用现有登录。使用 user_credit 作为登录后的就绪检查。将生成任务路由到对应的执行技能。

步骤 3：提交与终态闭环

提醒用户任务会消耗点数，区分帮助信息查看和实际提交，并跟进每个已受理的任务，直到状态变为 success 或 fail。

验证

• 在更改模型或分辨率相关假设前，根据已审阅的契约验证已安装 CLI 的帮助信息。
• 运行时通过 dreamina <subcommand> --help 确认视频比例支持情况：四个视频命令提供 --ratio，而 multiframe2video 会根据第一张图像推断比例。
• 上传前验证本地文件，并保留每个返回的 submit_id。
• 从 query_result 验证终态，不要仅凭 shell 退出码判断。

注意事项

1. 帮助信息变更：发行说明不能替代当前子命令的帮助信息。
2. 事实来源重复：参数矩阵应保存在 v1.4.18 契约参考文档中。
3. 已受理不等于成功：querying 不是终态成功。
4. 付费操作：实际提交任何生成任务前都要提醒用户。
5. OAuth 暂停：始终说明登录是成功、复用还是失败。
6. 故障排查顺序：记录确切命令、错误、dreamina version 以及相关的 ~/.dreamina_cli/logs/ 日志片段；对机密信息进行脱敏，在获得授权后更新 CLI，然后使用相同命令重试一次。

登录完成：必须向用户明确确认

dreamina login / dreamina relogin 会输出 OAuth Device Flow 说明，然后等待授权。命令成功完成后，必须明确告知用户登录成功，或已复用本地 OAuth 状态。

• 不要等用户问“登录好了吗”。
• 不要只发送设备代码后就停止：让登录命令继续运行，读取 stdout 直到结束，然后确认成功、已复用状态或失败。
• 失败时仍须报告具体错误和下一步操作。

选择合适的命令

总体而言：

• 使用 user_credit 检查预算。
• 使用 session 创建、列出、搜索、重命名或删除会话；所有生成命令都接受 --session=<id>，默认会话为 0。
• 已有 submit_id 时使用 query_result；想将生成的媒体保存到本地时，添加 --download_dir。
• 使用 list_task 查看最近保存的任务，尤其是在需要按状态或任务类型筛选时。
• 使用 text2image 根据提示词生成图像，使用 image2image 进行图像引导编辑，使用 image_upscale 放大图像。
• 使用 text2video 根据提示词生成视频。
• 一张主图就足够时使用 image2video；如果用户有多张图，希望讲述连贯的故事，则优先使用 multiframe2video。
• 使用 frames2video 通过首帧和尾帧生成视频。
• 使用 multiframe2video 调用 Dreamina 的智能多帧工作流：输入多张图像，输出一个连贯的故事视频。
• 当任务需要跨图像、视频和音频的全方位参考时，使用 multimodal2video 调用 Dreamina 的旗舰视频模式；该模式支持 seedance2.0 系列。如果出现旧名称 ref2video，请以 dreamina -h 显示的当前命令为准。

具体标志和支持的组合，请参考各子命令的 -h。

模型选择规则

不要根据此技能硬编码模型支持情况。

如果用户指定了模型，运行前务必检查相关子命令的帮助信息：

dreamina <subcommand> -h

使用子命令的帮助信息确认：

• 该命令是否提供模型选择选项
• 该命令是否支持用户指定的模型
• 该模型还有哪些限制，例如时长、比例、分辨率，或该命令是否支持 model_version

其他建议：

• 有些命令完全不提供模型选择选项。
• 有些模型，尤其是 seedance2.0 系列，可能受容量限制。
• 如果用户更看重速度而非最高质量，除非用户明确要求，否则不要默认使用 seedance2.0。

如何判断提交是否已受理及任务是否最终成功

不要只依据 shell 退出代码判断。

对于异步生成命令，submit_id 和 gen_status=querying 仅表示提交已受理。只有在 gen_status=success 时，才将生成视为最终成功。如果 gen_status=fail，请检查 fail_reason 并主动回复用户。

异步任务的后续处理方式

提交返回 querying 后：

1. 保存 submit_id。
2. 使用 query_result --submit_id=<id> 跟进。
3. 想要批量查看已保存的任务时，使用 list_task。
4. 持续跟进，直到任务状态变为 success 或 fail。

如果正在运行测试批次，请以机器可读格式保存结果，以便之后查询返回的 submit_id 值。

Important user-facing rules

• Some generation commands are asynchronous; submit and query are separate steps.
• Some models may require a one-time authorization on Dreamina Web. If the CLI returns AigcComplianceConfirmationRequired, reply proactively: ask them to complete that web-side confirmation first, then retry.
• Do not assume that different commands support the same models, ratios, durations, or resolutions. Check each subcommand's -h before use.
• In v1.4.18, text2video and multimodal2video accept explicit --ratio; image2video and frames2video expose the flag but reject it with seedance2.5; multiframe2video has no ratio flag. Re-discover these rules at runtime instead of generalizing across commands.

Good agent behavior

• Relay OAuth Device Flow instructions exactly enough for the user to complete login.
• Always close the loop when the login command finishes with a user-visible confirmation.
• Prefer small, reviewable batches when running real generation tasks.
• Keep a record of the command, arguments, submit_id, and final status for every paid test you run.
• When the user cares about generation speed, do not default to the seedance2.0 family unless they explicitly ask for it or clearly prioritize output quality.
• If you are preparing a report, separate:
  • help-only inspection
  • submit-stage validation
  • later async result follow-up

When to use（什么时候使用）

当用户需要 为当前请求选择并执行可验证、可恢复的专业工作流 时加载本技能。先从请求中提取目标、输入、约束、交付格式和验收标准；描述摘要为：Use when an agent needs to install, update, authenticate, troubleshoot, or operate Dreamina（即梦） CLI across account, session, image, video, task-query, and download workflows.。

Rules

• 先读后写：先确认当前状态与真实能力，再执行会改变外部状态的动作。
• 权限最小化：只使用完成当前步骤所需的文件、工具、账户与网络范围。
• 证据优先：运行结果、资源 ID、版本、哈希或测试输出缺失时，明确标记为 NOT_VERIFIED。
• 幂等优先：保留请求标识与阶段状态；结果不明确时先查询，不进行盲目重试。
• 隐私安全：日志、示例、回执和错误信息不得包含 token、cookie、密钥或个人敏感数据。

Workflow

Step 1：澄清意图

确认本技能是否匹配目标；若只是相邻需求，交给更精确的技能。

Step 2：执行预检

确认目标、输入、约束、可用工具、成功标准和失败边界；任一关键条件未知时停止在只读阶段。

Step 3：形成计划

列出将调用的工具、会改变的对象、成功标准以及失败后的安全退出方式。

Step 4：执行动作

按最小充分步骤执行，并在关键状态变化处记录证据；每个外部调用均保留可关联的状态或回执。

Step 5：验证交付

输出结果、验证证据、未完成项、风险和明确的下一步，并把事实、推断和未验证项分开陈述。

Validation checklist

• 技能触发条件与用户意图一致，没有把相邻任务误路由到本技能。
• 输入、目标对象、版本和输出位置均已明确，且没有使用猜测值替代必填值。
• 所有写入、付费、发布或不可逆动作都在用户授权范围内。
• 结果已用独立检查验证；仅有“命令成功”或“文件存在”不算完整验收。
• 输出包含实际证据、失败/跳过项、剩余风险和可执行的下一步。

Gotchas

1. 把计划当结果：文档或提示词不等于真实执行；必须标明实际运行层级。
2. 错误重试：超时或响应丢失可能已经产生远端状态，先查询再决定是否重试。
3. 隐式扩大范围：批量、全量、发布、覆盖和付费不是普通读写的自然延伸。
4. 版本漂移：引用外部资源时记录版本、tag 或提交；不要把可变分支当发布证据。
5. 证据过期：缓存、旧截图和历史测试不能证明当前环境；在交付前刷新关键证据。

不适用与边界

不超出用户给定范围；写入、付费、发布和不可逆动作需要明确授权。 如果请求需要别的技能，不复制其正文；按技能名称进行交接，并保留当前任务上下文。

Progressive disclosure

• 需要确定输入/输出、状态和授权点时，读取 references/workflow-contract.md。
• 需要交付前自检时，读取 references/validation-checklist.md。
• 遇到超时、部分成功或恢复场景时，读取 references/error-recovery.md。
• 首次运行、拒绝越权和失败恢复分别参考 examples/happy-path.md、examples/boundary-refusal.md、examples/failure-recovery.md。