| name | jimeng-cli |
| description | Use when the user needs AI image or video generation via the Dreamina (即梦) CLI tool `dreamina`. This includes text-to-image, text-to-video, image-to-image, image-to-video, multi-frame video, and multimodal video generation. Trigger this skill whenever the user mentions 即梦, jimeng, Dreamina, 文生图, 文生视频, 图生图, 图生视频, AI生图, AI生视频, wants to generate images or videos with AI, asks about dreamina commands, or references the dreamina CLI in any way — even if they just say something like "help me make a picture of a cat" or "generate a short video clip" without naming the tool explicitly, as long as the dreamina CLI is installed or relevant. |
Dreamina (即梦) CLI
dreamina 是即梦 AI 图片/视频生成的本地命令行工具。「即梦」和「Dreamina」可互换使用。
前提条件：用户必须是即梦高级会员才能使用 dreamina CLI。 如果用户尚未订阅，提示其在即梦 Web 端完成会员升级后再使用。
每个子命令的完整参数说明见 references/ 目录下的对应文件。运行 dreamina <subcommand> -h 可获取最新的参数列表。
工作流程
1. 检查安装 → which dreamina（未安装则参考下方说明安装）
2. 检查登录 → dreamina user_credit（失败则 dreamina login）
3. 查看帮助 → dreamina <subcommand> -h
4. 提交任务 → dreamina <subcommand> ... --poll=30
5. 跟踪结果 → dreamina query_result --submit_id=<id>
复用已有的登录会话——仅在用户明确要求时才执行 login、relogin 或 logout。生成命令会消耗积分，提交前先与用户确认。
安装
curl -fsSL https://jimeng.jianying.com/cli | bash
安装目录为 ~/.local/bin。若 shell 找不到 dreamina，执行 export PATH="$HOME/.local/bin:$PATH" 或重启终端。
登录
详见 references/login.md。快速参考：
dreamina login
dreamina user_credit
dreamina relogin
无浏览器环境下 dreamina login 会引导手动导入凭据。
命令选择
使用具体命令前，先阅读对应的参考文件了解参数和模型/分辨率组合。
--poll 参数
生成命令默认异步执行。添加 --poll=<秒数> 可让 CLI 每秒轮询直到任务完成或超时。
- 按时完成 → 直接返回最终结果
- 超时 → 返回
querying 状态和 submit_id，用 dreamina query_result --submit_id=<id> 跟踪
默认使用 --poll=30。
判断任务是否成功
不要仅依赖退出码。提交成功的标志是 JSON 输出中包含：
submit_id — 存在gen_status — querying（进行中）或 success（完成）
如果 gen_status 为 fail，读取 fail_reason 并向用户报告具体错误。
模型选择
不同子命令支持的模型、比例、时长和分辨率各不相同——不要假设它们通用。使用前先查看对应的参考文件或运行 dreamina <subcommand> -h。
seedance2.0 系列质量最高，但可能较慢且容量受限。除非用户明确要求高质量或指定 seedance2.0，否则默认选择更快的模型。
常见错误处理
| 现象 | 解决方法 |
|---|
AigcComplianceConfirmationRequired | 部分模型首次使用需在即梦 Web 端完成授权确认，完成后重试 |
| 登录后权限不足 | 检查 ~/.dreamina_cli/config.toml 是否存在；运行 dreamina user_credit 验证 |
| 登录挂起/浏览器无法打开 | 用 dreamina login --debug 重试 |
| 异步任务无结果 | 用 --poll=30 重新提交；超时后用 query_result 跟踪 |
| 切换账号 | dreamina relogin |
本地文件
| 路径 | 用途 |
|---|
~/.dreamina_cli/config.toml | 环境配置 |
~/.dreamina_cli/credential.json | 登录凭据 |
~/.dreamina_cli/tasks.db | 任务提交历史 |
~/.dreamina_cli/logs/ | 运行日志 |
