Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/full-aigc-skills/dreamina-skills --skill dreamina-canvas-cliAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
即梦画布 CLI 公共操作
When to use
跨模式的公共命令和排障使用本技能。安装由 dreamina-canvas-cli-setup 负责,账户由 dreamina-canvas-cli-auth 负责。六个生成技能各自负责自己的模式和参数,不再建立辅助技能。
操作契约
| 项目 | 标准 |
|---|---|
| 输入与前置 | 已选择的公共命令与其所需身份 |
| 副作用 | 模型查询只读;画布/上传/编辑写入;运行可能计费 |
| 输出交接 | JSON data / error、projectId、nodeId、resourceId、submitId |
| 恢复规则 | 未知写入先核对身份,不能用新 ID 绕过结果不明 |
Workflow
Step 1:运行 dreamina-canvas --help、dreamina-canvas version、dreamina-canvas schema,读取当前操作对应的契约。
Step 2:按需读取下表一个操作文档;核对输入、输出和副作用,再构造 argv。
Step 3:保存草稿和上传不代表批准生成;付费前读取 execution,已有任务读取 recovery。
Step 4:按 --format json 分离 stdout/stderr,依据 requiredAction 恢复。exit code 20 使用原 submitId 续查。
Step 5:记录终态与产物校验;未运行的阶段明确报告。
Progressive disclosure(按需读取):原子操作索引
- 构造 argv、判定 stdout/stderr、持久化身份或交付前核对时,读取 参数构造、输出、身份与验收。
- 选模型/音色、查比例、分辨率、时长白名单时,读取 模型、音色及能力发现。
- 新建画布、切换当前画布或按 projectId 跨进程续作时,读取 画布创建与列表。
- 上传本地素材、查询产物或下载并校验哈希时,读取 素材上传、查询与下载。
- 编辑图片节点或处理 node:/res: 引用时,读取 图片节点共享机制与编辑。
- 编辑视频节点或处理模式与引用时,读取 视频节点共享机制与编辑。
- 创建/编辑音频节点(tts、music 字段互斥)时,读取 音频节点共享机制与编辑。
- 需要 Text/Element 节点、节点查找或 DAG 依赖顺序时,读取 Text、Element、节点查找及依赖顺序。
- 排时间轴、替换轨道或装配音视频时,读取 时间轴及轨道替换。
- 需要报价、用户批准、提交生成或批量身份时,读取 报价、确认、运行与批次身份。
- 任务在跑、本地等待超时或需要按原身份恢复时,读取 查询、等待与恢复。
- 一次要串联“查模型→建画布→传素材→引节点”时,读取 准备画布和素材的组合场景。
- 命令非零退出、需要判定下一步动作时,读取 退出码与 requiredAction。
场景示例
Rules
- 一个命令的规范只维护在对应 references;示例用于组合,不定义第二套参数契约。
- 安装缺失的同包技能:
npx skills add full-aigc-skills/dreamina-skills --skill <skill-name>。按名称交接,不读取相邻安装目录。 - 不存储凭据,不代替用户批准积分,不把不确定提交当作失败重新提交。
Validation checklist
- [ ] 参数与当前 schema 一致;projectId/nodeId/submitId 各自正确。
- [ ] 草稿、已提交、成功完成和已下载分别有证据。
- [ ] 异常恢复复用身份,文件字节数与 SHA-256 验证。
Gotchas
- 等待超时不取消服务端任务。
- 编辑生成参数可能清除未传的引用;时间轴替换会重建轨道,先检查现有内容。
--yes不能替代具体请求的积分批准。
Progressive disclosure(按需读取):补充契约与清单
- 需要 audio 字段与模式互斥的完整契约时,读取 audio-node-audio-node-contract。
- 多 profile 下画布上下文与身份归属不清时,读取 canvas-canvas-context。
- 需要 CLI 全量命令族的种子契约(版本、flag、退出码)时,读取 cli-contract。
- 需要节点依赖顺序与 DAG 调度细节时,读取 composition-composition-dag。
- 需要完整能力发现字段与边界说明时,读取 discovery-capability-discovery。
- 错误难以归类或需要恢复剧本时,读取 error-recovery。
- 需要积分上限、批准语义与批次身份细节时,读取 execution-credit-approval。
- 需要 image 节点字段与引用机制的完整契约时,读取 image-node-image-node-contract。
- 需要任务恢复状态机的完整转移时,读取 recovery-recovery-state-machine。
- 需要产物字节数与 SHA-256 验证细则时,读取 resources-artifact-verification。
- 需要 resource upload 标志位与幂等细节时,读取 resources-resource-upload。
- 需要时间轴轨道与剪辑参数完整契约时,读取 timeline-timeline-contract。
- 交付前逐项核对时,读取 validation-checklist。
- 需要 video 节点模式与引用机制的完整契约时,读取 video-node-video-node-contract。
- 需要本技能级工作流契约(状态、交接、授权)时,读取 workflow-contract。
不适用与边界
具体生成模式不适用本入口作为第二套参数规范;请选择六个对应任务技能。安装与登录分别交给 setup/auth,不因一次只读命令失败就自动重装或切换账户。
只读取当前操作必要的账户与素材信息;不存储、记录或输出访问令牌、cookie 和临时签名链接。

