用途:该技能让所有 dreamina-canvas-* 技能在生成前先向 CLI 查询当前支持的能力,避免调用方硬编码模型名、语音名、比例、分辨率、时长或批量上限。参考细节见 references/capability-discovery.md。
适用时机:任何带 --model、--voice-name、--ratio、--resolution、--duration 或 --count 的工作流首次生成前;音频音乐生成前(须确认当前环境的音频模型,且未缓存其他环境的名称);当生成报错“model not found”或 --voice-name 被拒时,应重新发现而非用记忆值重试。不适用于替代 dreamina-canvas-cli 的 argv 构造规则,也不能绕过 --credit-ceiling 决策。
主要能力与用法:先运行 version 和 schema,再据其声明选择发现命令。若 schema 声明 model search,用 model search --detail full;若声明 model list,则用 model list。示例命令:dreamina-canvas --format json model search --type image;dreamina-canvas --format json model search --type image --detail full;dreamina-canvas --format json model <model-id> --type image;dreamina-canvas --format json voice list --offset 0 --count 50;dreamina-canvas --format json schema "node create image"。仅在实时 schema 声明时才传可选标志,例如 voice list 在公开 1.0.0 只接受 --offset 和 --count。
读取内容:实时完整载荷是 --model 标识与别名、各模型合法 --ratio 与 --resolution、--duration、--count 上限(generation.maxBatchGenCount)、必需引用、VIP/权益标志及每模型约束的唯一权威来源。TTS 的 --voice-name 须来自 voice list 或 model search --type audio --detail full;音乐 --model 须来自 model search --type audio --detail full 且 MODE=music,缺失时 CLI 报 cli.audio_music_model_required 并以退出码 2 结束。
限制:发现载荷按环境(distribution × edition × profile)区分,不可跨环境缓存;profile 或环境变化、CLI 升级导致 commit/buildTime 变化后须重新发现。该技能不推荐具体模型、比例、分辨率或语音,不把记忆名称等同于重新发现,也不得将原始发现载荷保存到公开日志、fixture 或示例中,应使用 <model>、<voice-name>、<ratio> 等占位符。调用前提是已安装 dreamina-canvas 并通过 dreamina-canvas version 确认活动 profile 与环境。