关于影线的镜头调度赋能，请大佬赐教斧正方向

范志刚

影线：镜头调度与镜头语言赋能系统能力列表

基于 AGENTS.md 中的 HOOK 树、MATRIX 坐标及 master_advisor 注入逻辑整理。

说明

所有 HOOK 前必须走 gate::run(type, request) 获取放行（type 必须是 gate|narrative|craft|render|post|export|quality|internet）。

master_advisor::* 表示大师顾问的细粒度决策（如 master_advisor::lens、master_advisor::camera、master_advisor::block、master_advisor::refine、master_advisor::light、master_advisor::color），在相应 HOOK 内部自动注入评分/批注/建议。

调度：场景/镜头的布局、运动、机位选择；语言赋能：为镜头提供结构化、可优化的文本描述（提示词、关键词、批注等）。

1. 镜头调度能力列表（craft 阶段：空间、运动与场面调度决策）

HOOK (路径)	功能简述	依赖 master_advisor 维度
`craft::lens(shot, intent)`	景别/焦距/景深决策（如广角、特写、景深层次）	`master_advisor::lens`
`craft::camera(shot, mode)`	运镜/机位/角度决策（如推拉、上下移动、俯仰）	`master_advisor::camera`
`craft::block(shot, characters)`	场面调度/走位（角色路径、道具布置、走向）	`master_advisor::block`
`narrative::storyboard`	在 JSON 输出中生成 `lens` 字段（type, camera_move, angle, dof）以及 `space_type`，提供调度参考	—（提供数据输入给调度）
`render::dispatch`（I2V/T2V 双分支）	按调度输出镜头（双分支自动走 L4+L5 门禁，不过审不送），确保镜头实现与调度一致	—（执行渲染）

调度流程简要：gate::run → narrative::parse/brief/storyboard → craft::lens/camera/block → render::dispatch。storyboard 中的 lens 字段直接供 craft::lens/camera/block 使用，render::dispatch 捕获并实现。

2. 镜头语言赋能能力列表（narrative + craft：结构化、可优化的语言描述）

HOOK (路径)	功能简述	依赖 master_advisor 维度
`craft::refine(prompt)`	提示词优化（7 层结构 + 权重）：`(masterpiece:1.2)`，主体 → 服饰 → 场景 → 光影 → 运镜 → 动作，输出可直接填入 `comfy_prompt_hint`	`master_advisor::refine`
`gate::artistic(text, context)`	LLM 大师判断 → 输出 `(分数, 批注, 建议)`，针对文本/图像给出镜头语言的质量评估与优化建议	`master_advisor::artistic`（L4 大师判断）
`narrative::parse(text)`	原文 → 叙事分析：提取主题、人物、情节，生成关键描述用于镜头语言基础	—（提供语义输入）
`narrative::brief(scene_ids)`	场景简报：提取场景核心动作、关键道具、情绪，输出简洁描述用于镜头提示	—（提供描述输入）
`narrative::storyboard`	生成包含 `comfy_prompt_hint`（7 层提示词结构）的 JSON，含 `lens`、`lighting`、`mood`、`narrative_function` 等字段，可直接用于 `craft::refine` 或渲染	—（提供结构化输出）
`master_advisor::*`（lens, camera, block, refine, light, color）	在调度和语言决策中提供风格/光影/色彩建议（如 `lens` 给出最佳焦距组合，`light` 给出光源分布，`color` 给出色温/饱和度范围）	所属维度
`post::artistic(video, grade, grain, vignette, aspect)`	后期调色/颗粒/暗角/画幅，完成镜头语言的视觉表现，支持 East Asian facial features、年代服饰约束等规范	`master_advisor::look`（风格指导）

语言赋能流程简要：gate::run → narrative::parse/brief/storyboard → craft::refine（生成 7 层提示词）→（可选）gate::artistic（大师批评 & 建议）→ render::dispatch（使用提示词渲染）→ post::artistic（后期细化语言表现）。storyboard 中的 comfy_prompt_hint 已结构化，直接可供 craft::refine 使用；gate::artistic 在评审阶段提供分数/批注，帮助迭代提示词。

3. 关键对应关系（任务树 / 决策记录）

步骤	HOOK 调用顺序（必须走 gate 放行）	输出 / 决策产物	用途
1. 文本/创意输入	`gate::run(type='narrative', text=…)`	放行 token	开始叙事/调度流程
2. 叙事分析 & 简报	`narrative::parse` → `narrative::brief` → `narrative::storyboard`	JSON（含 `lens`、`lighting`、`comfy_prompt_hint`）	提供镜头语言基础 + 调度参考
3. 镜头调度决策	`craft::lens`、`craft::camera`、`craft::block`（可组合调用）	决策记录（镜头类型、机位、场面布局）	指导渲染的空间/运动
4. 提示词优化（语言赋能）	`craft::refine`（使用 storyboard 的 `comfy_prompt_hint` 作为输入）	优化后的 7 层提示词（含权重）	提高渲染质量，便于大师批评
5. 大师评审（可选优化）	`gate::artistic`（在 `gate::run` 后或 `craft::refine` 之后调用）	`(分数, 批注, 建议)`	快速反馈，调整提示词或调度细节
6. 渲染执行	`render::dispatch`（I2V 或 T2V 双分支）	视频/图像 + seed 记录	按调度生成镜头
7. 后期语言表现	`post::artistic`（调色/颗粒/暗角）	最终画面 + look 风格一致性	完成镜头语言的视觉呈现
8. 质量闭环	`quality::critique`（失败或低分时）→ 记录并调整 `craft::refine`/`gate::artistic`	质量报告 + 改进建议	反馈给下一次调度/语言优化

使用提示

每次调用 HOOK 前先执行 gate::run（持有 60s 放行），确保符合五层门控（protocol → rag → token → artistic → image）。
决策记录（decisions.jsonl）中必须写入：hook、inputs、outputs、master_advisor_feedback（如果有），便于后续追踪与质量反思。
若连续 3 次 HOOK 调用失败，自动触发 state::check_all 做全量巡检，并切换至 ️ 吃饭模式。

以上列表清晰区分了「决策/调度」类 HOOK（craft）与「描述/优化/评审」类 HOOK（narrative + gate），并标注了 master_advisor 的细粒度支持，可直接用于任务树、决策日志或后续能力扩展（如新增 clay 调度或专用语言模型）。

terry

下次让AI整理成markdown，下不为例

抡锤者