用途:该技能负责 Dreamina Canvas 的时间线节点,用于在画布上组装含视觉轨(--clip)与音频轨(--audio-clip)的视频,或对单个片段做裁剪、速度、音量等编辑,也可仅修改标题、标签等元数据。
主要能力:创建时间线时至少提供 --clip 或 --audio-clip 之一,纯音频时间线也有效,服务器会补一个空视觉轨。片段选项以逗号分隔:duration=<ms>(图片片段,毫秒)、trim=<start>-<len>(视频/音频,毫秒)、speed=<factor>(倍率,默认1)、volume=<0-1> 或 muted、start=<ms>(音频,默认0)。未提供的选项由服务器从源素材填充,不要本地猜测。
使用方式:创建示例为 dreamina-canvas --format json node create timeline --title "<title>" --clip <visualNodeId1> --clip <visualNodeId2>,trim=1000-4000,speed=2 --audio-clip <musicResourceId>,start=0,volume=0.5。仅改元数据时用 node edit timeline --node-id <nodeId> --title "<new title>",不传轨道参数。清空轨道用 --clear-tracks,与 --clip、--audio-clip 互斥。引用需用裸节点 ID(node_xxx)或小写规范 UUID,不能加 node: 或 res: 前缀,否则报 cli.invalid_resource_reference(退出码2)。
限制:向 node edit timeline 传 --clip 或 --audio-clip 会重建对应轨道,删除原有片段并生成新标识,未保存的逐片段编辑会丢失,属不可逆操作,调用前必须确认用户接受完整替换与标识变更,并构建完整新列表,不能新旧混用。本技能不负责视频生成参数、音频生成参数与付费执行,付费需交由 dreamina-canvas-quote-and-run,本技能不调用 --run,也不持久化令牌、签名 URL、Cookie 或会话材料。失败时按提示处理:ID 被拒则检查裸 ID;两帧比例不一致则确认裁剪/时长单位为毫秒;误传轨道参数则需人工介入告知用户轨道已重建。