凤希AI - 分镜数据解析器

FxaiStoryBoardLoad ("凤希AI - 分镜数据解析器") is the reader half of the storyboard pair. The generator hands you a LIST of shots; this node indexes into that list at a given 行索引, pulls out the current shot's prompt, and assembles the final text: your 通用提示词 (global prefix) + the shot's prompt + your 尾部通用提示词 (global suffix). It also hands back the shot's scene props as a comma-separated string. In a storyboard loop, this is the node that produces the actual prompt for this iteration.

How it works

Give it the 分镜数据 LIST (from FxaiStoryBoard or FxaiStoryBoardV2) and a 行索引 (from your loop counter, ideally fed through FxAiStartEndIndex so it stays in range). The node:

• Builds the final prompt as 通用提示词 + shot["提示词"] + 尾部通用提示词. If you keep style/quality keywords in the two globals, you don't have to repeat them in every shot.
• Converts the shot's 场景道具 field into a comma-separated string (its convert_to_comma helper normalizes separators). If the shot has no props, it falls back to 默认场景序号 - a comma-separated list like "1,2,3" that downstream asset nodes can interpret as default scene indices.
• 循环复用 (default 0) is the loop-reuse trick: set it to N and the row index wraps as index % N, so a single shot repeats every N iterations - useful for a recurring establishing shot or a looping background.

Outputs:

• 提示词 - STRING, the fully assembled prompt for this iteration. Straight into a CLIP/LLM text encoder.
• 行索引 - INT, echoes back the index you used.
• 场景道具 - STRING, the comma-joined props for this shot.

The inputs that matter

The two globals are the ones to understand first: 通用提示词 is the prefix applied to every shot, 尾部通用提示词 the suffix. It's a clean "global style + per-shot content" pattern that keeps your storyboard rows short and your style consistent - which is exactly the kind of thing that keeps character/scene consistency across a long segmented video from falling apart.

The gotchas

• If 行索引 is out of range, or 分镜数据 is empty, it returns the globals with no shot content and the default props - no error. A loop that runs past the end of your storyboard silently starts producing prompt-less frames instead of stopping. Guard the index with FxAiStartEndIndex.
• The props output is a string, not a list. Don't try to wire it into a LIST socket expecting structured data - the comma string is meant for the pack's own comma-separated asset conventions.

Install

Part of fxai-toolkit:

cd ComfyUI/custom_nodes
git clone https://github.com/fxai666/fxai-toolkit

Restart ComfyUI, or use ComfyUI Manager and search "fxai-toolkit". No models or downloads - it's re and dict lookups under the hood.