用途:驱动 ComfyUI 的 LTXDirector(LTX Director 时间线)视频时间线编辑节点。该节点画布上的 Add Image、Add Text、Add Audio 按钮由原始 DOM 元素和 JS 处理器构建,不是节点输入,面板/MCP 工具无法调用任意 DOM 处理器,因此“点击 Add Text”不可能实现,这是硬性限制而非偶发问题。
主要能力:所有按钮操作最终序列化进一个字符串控件 timeline_data,包自身代码视其为绝对事实来源。它列在 HIDDEN_WIDGET_NAMES 中,不出现在可见控件列表,但仍是普通输入,可通过 create_workflow(action="modify", operations=[{op:"set_input", node_id:"42", input_name:"timeline_data", value:"<json string>"}]) 设置。值为 JSON 字符串而非对象,空状态为 "{}"。同级隐藏控件还有 local_prompts、segment_lengths、guide_strength、audio_data、use_custom_audio、inpaint_audio、use_custom_motion、override_audio。
使用方式:先用 get_workflow(action:"query") 以 types:["LTXDirector"] 定位节点,读取并 JSON.parse 当前 timeline_data,修改解析后的对象(追加片段、切换轨道门、重定时),再以字符串写回并重读确认,最后 create_workflow(action:"validate")。schema 含轨道门 mainTrackEnabled/audioTrackEnabled/motionTrackEnabled、normalStartFrame/normalDurationFrames、global_prompt、retake 相关字段、segments/motionSegments/audioSegments。文本片段形如 {"id":"seg1","start":0,"length":48,"prompt":"...","type":"text"};图像片段含 imageFile 与 imageB64(实为 /api/view URL,非 base64),需先 upload_image 上传到输入目录;音频片段含 audioFile、fileName、waveformPeaks(仅装饰,可省略或传 [])。
限制与注意:轨道门为 false 时对应片段被忽略,需在同一次编辑中开启;normalDurationFrames 必须与 duration_frames、segment_lengths 控件一致,normalStartFrame 与 start_frame 一致;start/length 是像素空间帧,可为小数;global_prompt 同时存在于 timeline_data 和 forceInput 插槽,建议以接线来源为准并保持一致;guide_data 必须接到 LTXDirectorGuide 伙伴节点。该控件官方标注“自动管理,请勿手动编辑”,格式错误会破坏编辑器,写入后需往返重读并告知用户此为非官方用法。PromptRelayEncodeTimeline 也有相同模式,可套用此方法。