前言¶

在 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