前言¶

在 Agent 工作流里接入即梦（Dreamina）时，常见做法是手写脚本或反复查文档拼参数。生成任务往往是异步的，还要区分登录态、积分、提交与轮询结果，容易在子命令和模型约束上踩坑。Dreamina CLI 是 SkillHub 上的一条社区 Skill，把「何时用哪条 dreamina 子命令、如何判成功、如何跟进任务」写进 SKILL.md，供 Cursor、Claude Code、Codex 等客户端里的 Agent 按同一套约定执行。

这是什么¶

Dreamina CLI（坐标 @user_236f3544/dreamina-cli，版本 1.0.0）由社区发布者 user_236f3544 维护，分类为 design-media，来源为 community。官方简介为：当 Agent 需要通过 dreamina CLI 完成 Dreamina（即梦）图片或视频生成时使用本 Skill。

Skill 本身不替代 dreamina 可执行文件，而是指导 Agent：dreamina 是本地 CLI 入口，覆盖当前开放的即梦图文/视频生成流程及账号与会话相关操作。SkillHub 页面标注 requires_api_key=false，表示 Skill 元数据不要求单独配置 API Key（实际生成仍依赖本机已安装的 dreamina 与即梦账号登录态）。

SkillHub 统计（以页面展示为准）：评分 100000，下载 1698，安装 97。

核心功能¶

依据 Skill 包内 SKILL.md，本 Skill 覆盖的能力边界如下。

账号与任务管理

• 检查或复用已有 Dreamina 登录会话（login / relogin / logout 仅在用户明确要求时使用）。
• 通过 user_credit 查看账户积分/额度。
• 通过 query_result 按 submit_id 查询异步任务结果。
• 通过 list_task 浏览近期已保存任务。

生成类工作流

• 图片生成相关子命令（以图片输入或输出为主时使用）。
• 视频生成相关子命令（输出为视频时使用）。
• image2video：单张主图即可时选用。
• multiframe2video：多图输入、一条连贯故事视频输出（即梦多帧智能流程）。
• multimodal2video：需要图片、视频、音频等多模态参考的旗舰视频模式，支持 seedance2.0 系列（具体参数以子命令 -h 为准）。

Agent 行为约定

• 详细 flag 与支持取值以 CLI 为准，优先查阅 dreamina -h 与 dreamina <subcommand> -h，Skill 不硬编码模型列表。
• 异步提交成功条件：submit_id 存在且 gen_status 为 querying 或 success；fail 时需查看 fail_reason。
• 可能消耗积分的命令执行前需提醒用户；部分模型需在 Dreamina Web 完成一次性授权（如返回 AigcComplianceConfirmationRequired）。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

先检查是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

说明来源：SkillHub 安装与优先源配置。

2. 安装 Dreamina CLI Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。官方页面给出的安装提示为：参照上述安装文档，安装 @user_236f3544/dreamina-cli。

命令行等价形式为：

skillhub install dreamina-cli --namespace user_236f3544 --dir <skills 目录>

常用客户端 skills 目录（同样来自 SkillHub 安装文档）：

• Claude Code：~/.claude/skills/
• Cursor：~/.cursor/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后按各客户端要求刷新或重启，使 Agent 能加载新 Skill。

3. 本机 dreamina CLI¶

本 Skill 假定环境中已存在可执行的 dreamina 命令。若尚未安装或版本过旧，需在即梦/Dreamina 官方渠道自行安装 CLI；Skill 包内未提供独立安装脚本，具体步骤不在本文核实范围内。

典型用法¶

下面步骤复现 Skill 文档中的默认工作流，便于 Agent 或人工对照。

1. 先读帮助，再执行真实任务

dreamina -h
dreamina <subcommand> -h

每次使用新子命令前运行对应 -h，确认模型、时长、比例、分辨率等是否支持。

2. 提交前看额度

dreamina user_credit

3. 提交生成任务（示例子命令名，参数以 -h 为准）

图片或视频类子命令因任务类型而异；用户指定模型时，必须先在该子命令的 -h 中确认是否支持。

4. 异步跟进

提交后若 gen_status 为 querying：

dreamina query_result --submit_id=<id>

需要批量回顾历史任务时：

dreamina list_task

5. 多图 / 多模态选型（概念层）

• 单图转视频：倾向 image2video。
• 多图叙事：倾向 multiframe2video。
• 强依赖多模态参考或 seedance2.0：倾向 multimodal2video，并注意该系列可能容量紧张、速度较慢。

用户口头说「即梦」时，Skill 要求 Agent 将其视为 Dreamina，走同一套 CLI 流程。

适用场景与注意¶

适合谁

• 已在开发环境安装 dreamina CLI，并希望 Coding Agent 按统一规则调用即梦图文/视频能力。
• 需要 Agent 区分「仅查帮助」「真实提交」「轮询结果」，并记录 submit_id 与积分消耗提醒的团队。

限制与注意

• Skill 刻意保持简短，不枚举全部 flag；模型与参数组合以各子命令 -h 为唯一权威，不同子命令支持的模型、比例、时长可能不一致。
• 不要仅凭 shell 退出码判断异步提交是否成功，必须检查 submit_id 与 gen_status。
• 真实生成会产生积分消耗；Skill 建议小批量、可审查的测试，并保留命令、submit_id 与最终状态。
• 若更在意速度，除非用户明确要求质量或 seedance2.0，不宜默认使用该系列模型。

结尾¶

Dreamina CLI 把即梦本地 CLI 的会话、额度、图文视频提交与异步查询流程固化成 Agent 可读的 Skill 约定，减少在子命令与模型约束上的反复试错。安装与元数据以 SkillHub 为准：

• API 入口：https://api.skillhub.cn/user_236f3544/dreamina-cli
• 浏览页：https://www.skillhub.cn/skills/user_236f3544/dreamina-cli