PRINTFILM upstream chat_storyboard source; use its directing rules with the host model. Provider calls are replaced by host media tools.

async def chat_storyboard(
        self,
        source_text: str,
        source_type: str,
        style_prefix: str,
        llm_system_addon: str,
        duration_min: int,
        duration_max: int,
        max_shot_duration: int,
        *,
        pipeline_mode: str = "full",
        character_hint: str = "",
        extra_requirements: str = "",
        consistency_mode: str = "character",
        output_ratio: str = "16:9",
        shot_range_override: tuple[int, int] | None = None,
        allow_source_names: bool = False,
    ) -> StoryboardResult:
        if self.mock:
            resolve_upstream_model("text", None)
            return await asyncio.to_thread(
                self._mock_storyboard,
                source_text,
                source_type,
                style_prefix,
                duration_min,
                duration_max,
                pipeline_mode,
                shot_range_override,
            )

        user_constraints = ""
        if (character_hint or "").strip():
            user_constraints += (
                f"用户指定人物设定（必须严格遵守，写入 character_bible）：{(character_hint or '').strip()}。"
            )
        if (extra_requirements or "").strip():
            user_constraints += f"用户其他画面要求：{(extra_requirements or '').strip()}。"

        mode = (consistency_mode or "character").strip().lower()
        if mode not in {"character", "style", "diverse"}:
            mode = "character"

        if mode == "diverse":
            if (character_hint or "").strip():
                person_rule = (
                    "character_bible：概括用户人物设定（可换具体个人，但须同类）。"
                    "【人物硬性】每镜必须出现符合用户人物设定的真人，面容清晰可见"
                    "（三分之四侧脸或浅景深半身），禁止只拍手部、后脑勺、过肩无脸或空界面无人。"
                    "img_prompt 须写清该镜人物族裔/发型/服装与可见面容角度，以及面前界面类型；各镜可换人。"
                )
            else:
                person_rule = (
                    "character_bible：根据主题与模板系统规则决定是否出人物，不要默认全片必须有人或必须无人。"
                    "模板要求人在场则写清操作者类型（可不锁同一张脸）；主题以界面/场景/示意图为主则可写「无固定人物」。"
                    "img_prompt 写清本镜主体与构图，禁止与模板系统附加规则对着干。"
                )
            consistency = (
                "必须输出严格 JSON 对象（不要数组、不要 markdown、不要代码围栏）："
                '{"character_bible":"...","shots":[...]}。'
                f"{person_rule}"
                f"视觉气质仅作底线参考（不要被其颜色绑架）：{style_prefix}。"
                f"{user_constraints}"
                "【动态规划】先分析用户内容的领域、产品形态与使用场景，再决定色板与界面类型，"
                "再拆镜；每镜对应不同操作或能力（总览、接入、工作台、流程、结果、部署、生态等）。"
                "配色与材质必须贴合内容（浅色SaaS、文档站、深色IDE、终端、架构图、白板均可），"
                "禁止默认霓虹蓝/赛博大屏/蓝紫渐变HUD，禁止各镜画面雷同，禁止待办任务清单，"
                "禁止同一仪表盘复制粘贴换字。"
            )
        elif mode == "style":
            consistency = (
                "必须输出严格 JSON 对象（不要数组、不要 markdown、不要代码围栏）："
                '{"character_bible":"...","shots":[...]}。'
                "character_bible：可简写「无固定主角」或留空说明；不要强行统一人物外形。"
                f"画风气质统一：{style_prefix}。"
                f"{user_constraints}"
                "各镜场景与构图应随内容变化，只需保持同类画风，禁止镜头间画面几乎一样。"
                "每镜 img_prompt 只写本镜场景与构图。"
            )
        else:
            consistency = (
                "必须输出严格 JSON 对象（不要数组、不要 markdown、不要代码围栏）："
                '{"character_bible":"...","shots":[...]}。'
                "character_bible：80-160字，固定描述本片反复出现的人物/主体外形"
                "（年龄感、发型发色、五官气质、体型、服装配色与辨识物），全片唯一设定，禁止每镜改人设。"
                f"画风要求（全片强制统一）：{style_prefix}。"
                f"{user_constraints}"
                "禁止镜头间混用写实摄影/真人脸与插画或动漫；禁止换脸换装换发型。"
                "每镜 img_prompt 只写本镜场景与构图（景物、动作、光影），不要重复粘贴大段画风/人物锁定原文；"
                "出现人物时用短句点出与 character_bible 一致的关键特征即可。"
            )
        # shot_cap 单镜 duration 上限（秒）；shot_lo/shot_hi 按文案字数或模板锁定
        shot_cap = min(duration_max, max_shot_duration)
        if shot_range_override:
            shot_lo, shot_hi = shot_range_override
        else:
            shot_lo, shot_hi = segplan.suggested_kepu_shot_range(source_text, pipeline_mode=pipeline_mode)
        shot_range = f"{shot_lo}-{shot_hi}"
        # name_rule 获客模板保留用户文案中的店名；其它模板改用泛称以免商标入画
        name_rule = storyboard_name_policy(allow_source_names)
        # segment_rules 科普逐段脚本生产约束（对齐漫剧 cue，无 @asset）
        segment_rules = (
            "【segments 生产规范】"
            "segments 必填；系统会落成 @duration +【字幕：后期叠旁白字幕】/【BGM：后期混音】/"
            "【旁白·自然语速·同步字幕】生产脚本，成片字幕与配乐由后期合成，不由视频模型烧录。"
            "因此 kind/text/duration 必须可直接消费。"
            "段序优先「画面→旁白」交替，首段尽量 kind=visual（保证首帧有料）；"
            "visual/action 的 text 必须含景别+主体动作+场景/界面类型，禁止空镜与模糊氛围词堆砌；"
            "narration 的 text 为一句一事、可朗读口播，按约 5 字/秒估 duration（语速自然偏快）；"
            "旁白 duration 严格跟字数，最多多 1 秒呼吸，禁止把短句拉满到镜长上限或拖腔注水；"
            "单段 duration 3-12 秒，镜内各段之和约等于本镜 duration，且不超过 "
            f"{shot_cap} 秒。"
            f"{name_rule}"
            "character_bible 与 bgm_lock 全片唯一，各镜不得改人设或漂移 BGM 氛围。"
        )
        if pipeline_mode == "image_text":
            diversity_note = (
                f"拆成 {shot_range} 个分镜，每镜一个独立视觉场景；"
                + (
                    "画风气质可统一，但界面/场景构图必须明显不同。"
                    if mode != "character"
                    else "但画风与人物必须一致。"
                )
            )
            ratio = (output_ratio or "16:9").strip() or "16:9"
            orient = "竖屏" if ratio == "9:16" else ("方形" if ratio == "1:1" else "横屏")
            system = (
                f"你是{orient}图文短视频编剧。所有字段必须使用简体中文。"
                f"{consistency}{llm_system_addon}"
                f"每镜 duration 在 {duration_min}-{shot_cap} 秒。"
                "这是「静图+叠字+配音」模式：不生成 AI 视频，但需要旁白配音；"
                "画面禁止出现任何文字/水印/字幕。"
                "shots 字段说明："
                "shot(序号)、duration(秒)、"
                "title(对本镜内容的概括短标题，2-8字，语义完整有力；"
                "必须是总结提炼，禁止从 text 截取前几个字，禁止截断专有名词如 ERP→ER)、"
                "subtitle(对本镜卖点/要点的一句概括，8-22字，同样禁止原文截取前缀)、"
                "text(旁白台词，口语化，约匹配该镜时长，可供 TTS 朗读，一般 20-60 字)、"
                "segments(数组，精确到每一段：每项含 duration 秒、kind=visual|narration、text；"
                "visual 写景别与画面动作，narration 写口播)、"
                f"img_prompt({orient} {ratio} 构图画面提示词，留出边缘给文字叠层，主体居中，"
                f"禁止要求画面内写字；{name_rule})、"
                "video_prompt(可留空或写轻微推拉)、camera(如：缓慢推近/轻拉远)、bgm(情绪，全片尽量同一氛围)。"
                "另输出顶层 bgm_lock(全片统一 BGM 氛围一句)。"
                f"{segment_rules}"
                f"{diversity_note}"
            )
        else:
            diversity_note = (
                f"拆成 {shot_range} 个分镜，短镜快切，各镜场景随内容变化，禁止雷同空镜。"
                if mode != "character"
                else f"画风与人物必须全片一致；拆成 {shot_range} 镜，短镜快切。"
            )
            system = (
                "你是短视频分镜编剧。所有字段必须使用简体中文"
                "（包括 title、text、img_prompt、video_prompt、camera、bgm、segments）。"
                f"{consistency}{llm_system_addon}"
                f"每镜 duration 在 {duration_min}-{shot_cap} 秒，不要为凑满上限而注水。"
                "shots 字段说明："
                "shot(序号)、duration(秒)、"
                "title(对本镜旁白的概括短标题，2-8字，语义完整；"
                "必须是总结提炼，禁止从 text 截取前缀，禁止截断专有名词如 ERP→ER)、"
                "subtitle(可选，一句要点概括 8-22字)、"
                "text(旁白台词，与 segments 中 narration 文案一致或为其摘要)、"
                "segments(必填数组，精确到每一段：每项 duration、kind=visual|narration|action、text)、"
                "img_prompt(与首段 visual 一致的中文首帧提示词，含具体景物与构图)、"
                "video_prompt(可与 segments 画面摘要一致)、"
                "camera(运镜，如：缓慢上摇/轻推/横移)、bgm(情绪，全片同一氛围)。"
                "顶层另输出 bgm_lock(全片统一 BGM 氛围一句，与各镜 bgm 一致)。"
                "img_prompt 与 video_prompt 禁止英文句子，专有名词可保留原文。"
                f"{segment_rules}"
                f"{diversity_note}"
            )
        user = (
            f"输入类型：{source_type}。请先理解内容与应用场景，再拆成精确到每一段的分镜"
            f"（{shot_range} 镜，短镜快切，禁止拖腔注水）：\n{source_text}"
        )
        json_format = {"type": "json_object"}
        try:
            content = await chat_completions(
                system,
                user,
                temperature=0.6,
                timeout=120.0,
                response_format=json_format,
            )
        except RuntimeError as exc:
            if "response_format" not in str(exc).lower():
                raise
            logger.warning("分镜 LLM 不支持 response_format，降级普通调用: %s", exc)
            content = await chat_completions(system, user, temperature=0.6, timeout=120.0)

        if not (content or "").strip():
            logger.warning("分镜 LLM 返回空内容，重试一次 source_type=%s", source_type)
            retry_user = (
                f"{user}\n\n"
                "【重要】请只输出一个完整 JSON 对象，顶层含 character_bible、bgm_lock、shots 数组；"
                "不要 markdown、不要代码围栏、字符串内不要未转义换行。"
            )
            try:
                content = await chat_completions(
                    system,
                    retry_user,
                    temperature=0.6,
                    timeout=120.0,
                    response_format=json_format,
                )
            except RuntimeError as exc:
                if "response_format" not in str(exc).lower():
                    raise
                content = await chat_completions(
                    system, retry_user, temperature=0.6, timeout=120.0
                )

        if not (content or "").strip():
            raise RuntimeError("分镜模型返回空内容，请检查文字模型渠道配置或稍后重试")

        return self._parse_storyboard(
            content,
            style_prefix,
            duration_min,
            duration_max,
            max_shot_duration,
        )
