企业官网建设流程全解析

这篇指南拆解skills仓库中 Blender 预演与故事板技能（scenario-blender-previs-storyboard）的资料来源索引 sources.md，说明七场专家讲座各自解决什么问题、关键时间戳对应哪条可执行规则，以及这些"人的经验"如何被翻译成 bx_previs.py 里可自动判定的门禁。读完你可以按时间戳精准回看原始讲座、判断某条规则是专家原话还是本技能的补充，并在 Blender 5.2.1 上复现对应的检查。

这份文档为什么不是普通参考文献列表

sources.md只有一页，但它承担的是整条证据链的源头：

七场讲座（2.8x 到 5.0 alpha 的界面） → notes/previs/ 笔记与摘要 _digest_previs_storyboard.md → references/expert-notes.md（按专家整理的原则、分歧、时间戳） → SKILL.md（姿态、数字表、摄像机语言表、质量门禁） → scripts/bx_previs.py（shot_list / build_shots / audit / animatic） → references/procedures.md（可直接运行的分阶段代码）

因此sources.md的价值不在"列了哪些视频"，而在三件更严格的事：

1. 可回查：每一行都给出"最适合什么"和精确到秒的时间戳，任何一条规则都能定位到讲座里的具体一分钟。
2. 可判定版本：文档明确写出"屏幕上出现的 Blender 版本从 2.8x（Spitfire）到 5.0 alpha（Story Tools），而本技能用到的每一个 API 事实都在 5.2.1 上重新校验过"。这把"专家在旧界面里的操作"和"当前可执行的 API"分成了两层。
3. 可区分归属：expert-notes.md用[added]标记本技能自己的补充（尺寸表、距离公式、0.15 m 眼高容差、70° 边缘阈值等），避免把工程推导说成专家原话。

需要说明证据边界：文档提到的notes/previs/摘要目录和procedures.md里引用的tests/code/blender-previs-storyboard/测试目录，在当前仓库快照中并未包含（tests/下是按技能划分的测试集）。本文只引用仓库中实际存在的 references/ 与 scripts/bx_previs.py 作为可核验层；复现测试套件需要从构建工程取得该目录。

七场来源总览

下表是sources.md原始索引的完整继承（去掉了外部跳转，仅保留可检索的视频 ID 作为定位线索）。

七场里有两场同属 Hjalti（一场长工作坊 + 一场 7 分钟的配方复盘），它们不是重复：工作坊给判断标准，短片给可脚本化的顺序。这一点直接决定了SKILL.md的写法——先有"姿态"，再有"工作流"。

逐场精读：时间戳到底教了什么

1. BCON24 工作坊：整套方法论的锚点

这场是expert-notes.md里的 "anchor"，因为它把同一份半页剧本拍了两遍：一次锁定机位的剧场式，一次分镜的电影式。关键时间戳与其结论：

这里最容易被忽略的是 00:48:40 的那句"不管你做得多好，总会有制片人说你还能更便宜"。它不是为了自嘲，而是audit里"成本门禁"的理论依据：预演是一次性美术，最便宜的版本只要还能被判断就够。

2. Charge 复盘：把方法压成可脚本化的配方

7 分钟的cTx-n4OZXYE是整条工具链的"施工图"，因为它的每一个动作都能对应到一个函数：

注意 00:02:11 的"不透明 passepartout"是一个视口显示设置。procedures.md专门标注它不影响渲染，所以它的价值只存在于实时会话里；这也解释了为什么audit要把它当成问题项而不是渲染项。

3. Dillon Gu：构图与焦距是两个独立决定

Dillon 的实验设计很干脆：动画不动，只换摄像机，为三种情绪各给一套镜头，并且每条选择都要说出理由。这把"镜头语言"从审美偏好变成了可复述的映射表。

技术实现上，handheld()在摄像机 X/Z 旋转上挂 NOISE 修改器，默认REPLACE把噪声居中在曲线上，ADD会整体偏移约 strength/2；key_lens()默认线性插值，正好对应"快速推近"和"移轴变焦"。

4. Story Tools：让"一个动作、多机位"变成剪辑结构

这场讲座的价值不在美术，而在时间线结构。历史阻塞点是"你能编辑序列，但不能同时做两件事"（00:02:21）；5.0 的答案很克制：Sequencer 的场景选择器 + 场景时间同步。

• 设置三件套（00:15:16）：页脚开启 Sync，"否则什么都不会工作"；钉住 Edit 场景，否则导出错东西；镜头场景开自动关键帧、Edit 里关掉——"两种自动关键帧"。
• 场景资产（00:18:35）：放在自己的文件里（同一文件内复制会坏），需要设置库路径；对场景条Shift+D是全拷贝，Alt+D是链接拷贝。
• 覆盖（00:23:03）：一个场景、一个动作、两台机位——把场景条拆开，每段一颗机位；拖剪辑点移动换机位的位置，滑移改变动作相位，"两个快捷键"完成重定时，而不是去搬关键帧。
• 2.5D 画板（00:26:33）：Grease Pencil 笔画画在绑到角色的绑定上，笔画跟着走而不用给位置做动画。
• 删除语义（00:39:37）：删掉场景条永远不会删掉场景，因为"场景没有用户"；场景条内部仍尊重合成与 NLA；切换场景后首次播放慢（依赖图重建）。

在技能里，这套东西变成coverage()与animatic()的软切分：一个live镜头加若干cover=True镜头组成一条场景条，按剪辑点Strip.split(frame, split_method='SOFT')，每片各自scene_camera；retime_cut移动剪辑点的同时把标记和表格一起搬走，于是静帧、审计与场景播放保持一致。procedures.md还提醒：覆盖run 内每段的剪辑长度必须等于预演块长，否则动作在切点处会断。

5. Renato Roldan：画板要能承受"别人来动机位"

Renato 的两句信条被反复引用："只要对摄像机成立，就成立"（00:16:19）、"越快越好"；"没人会去动机位看你所有的小把戏"（00:24:32）。具体手法：

• 00:12:17 一张平面画稿拆成不同深度的 Grease Pencil 物体，加一点摄像机运动就有视差，成本极低。
• 00:17:28 灰色里只留一个跳色——红色。
• 00:18:41 画板必须承载时间、构图和摄像机运动，即使剪辑师之后会改。
• 00:25:10–00:28:38 把画稿绑到移动的 3D 平面代理上，从摄像机反推代理的运动：当代理转到边缘朝向，就说明这个镜头对 2D 动画很难——画板已经提前告诉你了。
• 00:29:06 用可摆姿势的人体模型透过真实镜头拍，解决极端广角的绘制问题，并给 2D 画师一份对得上的布局。

"边缘朝向"这条被量化成本技能自己的阈值：EDGE_ON_DEG = 70.0，由facing_report()逐帧计算平面朝向轴与"指向摄像机"方向的夹角，超过就进flagged。

6. Paul Coulthard（Spitfire）：2.8x 时代的工作顺序，以及 API 翻译

这场是文档里"版本跨度"的实证：界面是 2.x/2.8x 的，但顺序至今有效。

1. 00:15:58 先在地面画路径（Surface 放置，抬高偏移避免穿插）；00:14:43 沿路径打关键帧（演示里约 40 帧一个）。
2. 00:18:09 在新图层上用洋葱皮画粗略姿势。
3. 00:19:47先确定摄像机，再细化。
4. 00:32:23 脚接触地面用常量插值，只有飞行或滑行才用线性。
5. 00:34:10 用 3D 代理人体承载困难路径（地形、飞行），父子关系用 Keep Transform；代理旋转到让平面画看起来不对时就得重画；代理还能跨软件交接。
6. 00:41:44 Track To（-Z，上轴 Y）让被跟随对象在路径编辑时保持居中。
7. 00:44:46 用绑定到摄像机的标记切镜。
8. 00:26:33 镜头语言：24 mm 广角、近距离畸变、长焦压缩并强化两人对峙、广角拍远景。

"Track To" 在 5.2 的脚本等价物就是look_at()：

d = Vector(target) - obj.location obj.rotation_euler = d.to_track_quat("-Z", "Y").to_euler()

标记切镜的等价物是build_shots里的sc.timeline_markers.new(id, frame=...).camera = cam。文档说"API 已翻译"，指的就是这类映射：界面动作会变，数据结构（标记、摄像机、父子、插值）不变。

7. BouncyBrain：玻璃机位架与 6 fps

几乎无解说的延时，但两个机制很实用：

• 00:09:45 "画在玻璃上"：主角画稿与摄像机都是圆环空物体的子级，圆环位于主体上方。绕主体转 = 旋转圆环（画稿在画面里位置不变）；推拉 = 让摄像机沿自身局部 Z 移动（画稿在屏幕上变大变小）。
• 00:11:27 世界特效（爆炸）留在世界空间，不跟着玻璃走。
• 00:08:03 故事板按 6 fps 画，再在剪辑器里重定时；镜头用复制场景实现。

glass_rig()实现了这个父子结构，facing_report()负责在"画稿被带得转过 70°"时报警。6 fps 则是一个真实的坑：一个 12 帧、6 fps 的场景条放进 24 fps 剪辑里，时长仍是 12 帧——播放快 4 倍。procedures.md的陷阱复现里专门断言了duration == 12，所以规则是"导出静帧或重定时"，而不是"直接把板场景当场景条塞进去"。

从时间戳到代码：三类转换路径

sources.md的时间戳不是装饰，它们落到代码里只有三种命运：

SKILL.md的数字表把可编码量固定下来，并标注来源：10 帧块与"十位命名"来自 Charge/Hjalti；35 mm 剧场、约 60 mm 隔离、F5.6、裁剪 0.01–200 m 来自 Hjalti；13/22/25 s 对 47/40 s 来自幻灯片 00:46:01；三姿势怒气来自 Hjalti；6 fps 来自 BouncyBrain；手持噪声 0.010–0.018 rad、18–26 帧尺度来自视频指南（峰值实测约为强度的 0.66 倍）。

而尺寸表（可见高度 = 主体高度 × 4 / 2 / 1.15 / 0.8 / 0.6 / 0.4 / 0.25 / 0.12）、距离公式d = 可见高度 × 焦距 / 传感器高、0.15 m 眼高容差、70° 阈值、5% 屏幕宽度阈值，全部标[added]——它们是标准构图语法加 S6 接触表校准的结果，不是专家说过的数字。在bx_previs.py里它们就是常量：

SENSOR_W = 36.0 SIZES = {"ews": 4.0, "wide": 2.0, "full": 1.15, "mws": 0.8, "medium": 0.6, "mcu": 0.4, "cu": 0.25, "ecu": 0.12} EYE_TOL = 0.15 EDGE_ON_DEG = 70.0 POP = (0.85, 0.1, 0.08, 1) # Renato: red as the one popping colour

见 bx_previs.py。

版本考古：屏幕上是 2.8x，执行要按 5.2.1

sources.md开篇那句"每个 API 事实都在 5.2.1 上重新校验"是整页最工程化的一句。它意味着讲座里的操作不能照抄，必须换成当前的数据层写法。SKILL.md的 "Blender 5.2 notes" 给出了这些替换：

• bpy.ops.render.opengl在--background下直接失败；无头要么用 Workbench 的render.render，要么在实时会话里用锁定摄像机的视图。
• keyframe_insert()不受"新建关键帧插值"偏好的影响（偏好设为 CONSTANT，键仍是 BEZIER），所以必须调用make_stepped()遍历 F-Curve 强制修改——5.x 还要先通过bpy_extras.anim_utils.action_get_channelbag_for_slot拿到 channelbag，因为action.fcurves已经不存在。
• 在非窗口场景上frame_set后变换是陈旧的，此时write_still还会用窗口场景的帧；所以测量前必须activate()。
• VSE 用strips、left_handle/right_handle、content_start；SceneStrip.frame_start与frame_final_*已弃用（6.0 移除）。Strip.split(frame, split_method='SOFT')从数据层拆分。
• 新建场景默认 AgX，剪辑场景要与源场景统一视图变换，否则动画从静帧上"漂移"。
• marker.camera = cam无头可用；bpy.ops.marker.camera_bind需要时间轴上下文。
• --factory-startup下 Rigify 是关的，armature_basic_human_metarig_add会报 "could not be found"，必须先ensure_rigify()。
• Selection Sets、Storypencil、Grease Pencil Tools 不再随包；用名为layout的骨骼集合替代"布局选择集"。
• GP v3 笔画可以在无头 Workbench 静帧里渲染。

这十条里至少四条能直接对应到讲座的原操作：Ctrl+B 绑机位、Track To、6 fps 板场景、Rigify 代理。sources.md声称"回检"，procedures.md的 P16 则把坑复现成断言（例如bpy.ops.render.opengl抛出的错误信息里必须含background mode）。这就是从"看过视频"到"证据可执行"的分界。

分歧处理：什么时候听谁的

七位专家并非观点一致。expert-notes.md用一张分歧表把"选 A 还是选 B"变成"由什么决定"，这比罗列原则有用得多：

最后一行是理解整页边界的钥匙。

边界：这七场讲座不负责"给视频模型的引导片"

sources.md的末段专门划了一条线：给 render-to-real 视频模型（如 Seedance）做引导用的 playblast，其机位语法、手持幅度和"主角在框内"的审计来自这类引导片的生产测试，并且只在和上面这些专家一致的地方才保留。

不一致的地方在SKILL.md里写得更直白：引导片遵循另一套规则——饱和色身份、切点不跳焦距、缓入缓出的运动、交接表——这些既不在本工作流里，也不被P.audit检查。所以不要把导演看的动画分镜直接丢给视频模型，而要用scenario-blender-blockout重建，在那里角色通常变成彩色胶囊，由模型自己动。

同理，"颜色"这条也有归属：灰度加一个跳色（红色）跟随 Charge 与 Renato；饱和身份色板是给视频模型的，不是给导演的。

如何用这份索引做一次可复现的检查

技能安装后，两个技能目录是并排的（实际仓库中位于skills/dcc/blender/），bx_previs依赖 lead 技能的scripts/：

npx skills add scenario-labs/skills --skill scenario-blender-previs-storyboard

导入并按来源建一份最小验证：

import os, sys SKILLS = "/abs/path/to/skills/dcc/blender" # 同时含 scenario-blender-previs-storyboard 与 scenario-blender-expert OUT = "/abs/path/to/output" sys.path += [os.path.join(SKILLS, "scenario-blender-previs-storyboard", "scripts"), os.path.join(SKILLS, "scenario-blender-expert", "scripts")] import bpy import bx_previs as P BEATS = ["店主背对店面。", "小机器人悄悄靠近零食。", "店主转身。", "机器人像玩具一样僵住。"] SHOTS = [ dict(id="sh010", beats=[1, 2], subjects=["robot", "keeper"], loc=(-1.5, -1.4, 0.55), aim=(1.2, 0.9, 0.75), lens=28, size="wide", dur=3.0, intent="机器人高度的反讽双人镜"), dict(id="sh020", beats=[3], subjects=["keeper"], size="mcu", lens=50, height="eye", azimuth=-35, dur=1.5, intent="他眼线上的中性 MCU"), dict(id="sh030", beats=[4], subjects=["robot"], loc=(2.0, 0.55, 1.72), aim="robot", lens=35, dur=2.0, block=48, live=True, pov=True, intent="他的 POV，快速推近：他盯上了"), ] table = P.shot_list(BEATS, SHOTS, start=10) # 缺失/重复/乱序会直接 ValueError

这段对应的是来源 1 的 00:07:26 与来源 2 的 00:03:24：shot_list会校验 beats 完整性，并把镜头起点对齐到十位（一个更长的live块会把下一镜推到下一个十年）。随后：

sc = P.setup_scene("01_blend procedures", res=(1920, 1080), fps=24, pct=20) # 来源 2 的 00:02:11 cams = P.build_shots(sc, table, chars) # 36 mm 传感器、不透明 passepartout、clip 0.01–200、标记绑机位 rep = P.audit(sc, table, chars, line=("robot", "keeper"), stepped=MOV) assert rep["problems"] == [], rep["problems"]

audit会把来源里的判断变成字符串问题：主主体眼线出框、眼睛被blockers挡住（射线检测会报出遮挡物名字）、非眼高机位却没有intent、越过动作线、屏幕方向不符、预演块超过 10 帧、连续两个无人物镜头、实拍块之外的非常量关键帧、passepartout 不透明、静帧镜头里机位在动、渲染引擎不是 Workbench；灯光只进warnings，因为 Workbench 忽略它们。

跑无头脚本用文档给的标准形式：

blender --background --factory-startup --python-exit-code 1 --python <test>.py

procedures.md声明test_03_procedures.py会把该文档的代码块逐字抽取执行（只替换 P0 的两个路径），另有test_01（完整搭建一个场景，27 项检查）、test_02（API 陷阱、覆盖、混合，27 项）、test_04（passepartout、雾、覆盖重定时、成本门禁、Rigify 代理，22 项）。如前述，该测试目录不在当前仓库快照内，这条声明属于文档事实而非可当场运行的事实——引用时应标注清楚。

相关文件索引

把sources.md当成一张地图来用：想在某个判断上较真，就按时间戳回到那一分钟；想知道这条判断有没有被工程化，就去bx_previs.py找同名函数；想确认它是不是专家原话，就看expert-notes.md里有没有[added]。这三步走完，一条预演规则才算真正"有据可依"。