本文以 scenario-blender-sculpting 技能的来源清单references/sources.md为主线，讲清这份索引为什么按“工作室/会议 → 课程 → 其他输入”分级、每条记录的五个字段（视频 ID、专家与资质、Blender 版本、适用场景、最佳时间戳）各自怎么用，以及它如何对应到技能里可执行的代码与量化闸门。读完后你能做到两件事：面对一个具体的雕塑故障，按索引在几十秒内找到对应专家的对应分钟；面对两个专家说法冲突时，有一套可复现的裁决条件，而不是凭印象选边。

一、来源索引在这套技能里扮演什么角色

references/sources.md不是“参考链接收藏夹”，而是这套技能的证据账本。整套技能的知识由三层构成：

1. 来源层（references/sources.md）：27 个视频，每条一句一句话的定位，标注专家资质、Blender 版本、适用场景、最密集的几分钟。
2. 原则层（expert-notes.md）：把同一专家的多段讲话归纳成条目，每条带[video_id hh:mm:ss]回溯标记。
3. 可执行层（SKILL.md、procedures.md、scripts/bx_sculpt.py）：把原则落成参数、函数和闸门数值。

因此这份文档处理的问题不是“去哪里学雕塑”，而是“这条结论凭什么可信、在哪一分钟说过、在当前 Blender 版本还成不成立”。它同时也是技能内部“禁止凭感觉调参”的执行依据：SKILL.md 的 Numbers 表每一行都写着来源（Morren、Abbitt、Thelen、Yan……），而来源的具体出处就锚定在这份索引的时间戳上。

文档开头写明了两条约定，值得先记住：

• 一条视频一条笔记，笔记放在notes/sculpting/，转写放在transcripts/<id>.txt（注意：这两个目录在当前仓库快照中没有随技能打包，索引本身才是随技能分发的部分）。
• “Best for” 回答的是“什么时候该打开这条笔记”，而不是“这条视频讲了什么”；时间戳指向密度最高的几分钟，用于跳读而不是全片观看。

二、权威分级：为什么工作室与会议演讲排在最前

索引把来源分成两档主表加一节“其他输入”，分级标准是资质可核验程度 + 是否在制作环境里被验证过，而不是播放量。

• Studio and conference（最高权威）：Blender Studio 在职角色艺术家（参与过 Spring、Coffee Run、Sprite Fright 等已发布作品）、商业工作室的角色主管、《Anatomy for Sculptors》作者。这类来源的特点是有交付物背书，讲的是流程顺序与判断标准。
• Courses by experienced instructors：长期教学的作者、教程机构创始人、外包/手游公司的在职艺术家。这类来源信息密度高、可复现性强，但需要自己判断哪些结论来自特定项目约束。
• Other inputs：版本差异文档、蒸馏测试代码、基线答案。这类不是“人的经验”，而是可重跑的测量，权重体现在校准数字上。

这个分级不是为了排座次，而是为了在冲突时有一个默认倾向：当课程作者的简化说法与工作室流程冲突时，先假设工作室版本包含了你没看到的约束（例如烘焙、交付、团队协作），再去找“裁决条件”（见第六节）。

2.1 工作室与会议级来源（最高权威）

下表完整保留索引中的七条记录，去掉了外部播放地址，保留视频 ID 以便与笔记、转写文件互相对应。

这七条对整套技能的支撑方式各不相同，值得逐条说明它们在代码里留下了什么痕迹：

• Kaspar 的时间戳是“阶段顺序”的证据。00:09:44（在基础级别做表情、用 multires + shrinkwrap 重投影）与00:11:55（remesh 变细之后跑一次全局 Smooth，而不是拿笔刷逐处修补）分别对应到 procedures 里的 P11（shape key 表情 + quadriflow/multires/shrinkwrap 重投影）和 P3（remesh_stage(..., relax=2)）。relax参数的存在理由就写在bx_sculpt.py的remesh_stage文档字符串里：voxel remesh 之后用保体积的松弛去掉体素锯齿。
• Thelen 的时间戳是“平面可量化”的证据。00:05:43与00:36:42–00:37:15反复强调“用 Draw Sharp 切平面、脸看着不对就重切”，这条原则直接催生了plane_cut/corner_cut/planarity三个可测量接口（P14）。而00:24:17的“一次只平滑一个形体”和内眼角的 8 度倾角则分别落到代码的空值与head_guides的canthal_tilt_deg = 8.0。
• Zarins 的00:28:46（下颌角是年龄与性别的旋钮）是唯一一条让“下颌”从审美词变成几何约束的输入。在 P15 的形式检查里，下颌是否被“一个球拟合”用lower_face_report的ball布尔值判定，而它的几何实现（下颌块 + 经过 gonion 的 ramus 平面）来自这一条加 Thelen 的比例。
• 版本标注不是装饰。2.79、2.81、2.8x、3.0–3.1、4.1 alpha、5.0混在同一份索引里，等于提醒读者：笔刷名、默认值、算子行为在不同大版本间会变。技能本体锁定 Blender 5.2（见 SKILL.md 的 “Blender 5.2 notes”），因此索引里 2.x/3.x 条目的方法与比例可用，界面与笔刷默认值必须按 5.2 重新核对——这正是sources/blender-version-deltas.md那一节存在的意义。

2.2 经验讲师课程级来源

有两点使用细节容易被忽略：

• [?]是诚实的存疑标记。标注4.1 [?]、4.2 [?]、约 2.92 [?]的条目，意思是版本只能从界面特征推断、没有在片头明确声明。当你要引用某个默认值（例如 Smooth 强度、Draw Sharp 的默认方向）时，带[?]的来源不能作为唯一依据，必须回到 5.2 的实际环境里测一遍。
• 跨软件的条目是刻意保留的。oY9XybQRxzQ标的是 ZBrush 而非 Blender，因为这条讲的是可迁移的比例规则（鼻底在眉线与下巴的中点、唇裂线在鼻底向下三分之一），与软件无关。技能把这类条目当作比例来源写进head_guides，而不是当作操作来源。

2.3 其他输入与二手证据

索引末尾列出的“其他输入”只有三条，但它们是整套技能把“专家说法”变成“可测数字”的桥梁：

这一节的价值在于它给出了负面清单：基线版本的做法恰恰是本技能要避开的五种偷懒（只用融球、只用一个体素比、不知道哪些算子会崩、没有地标依据、折痕画在错误位置）。任何新写的雕塑脚本，如果落进这五条，就等于回到了基线水平。对应的实现分布在bx_sculpt.py的lower_face_report（判“球脸”）、remesh_stage（体素阶梯 + 对称化）、probe_headless_ops系列的崩溃矩阵（记录在 procedures 的 P12）、head_guides（地标）、Sculptor.on_surface（视线投射）与crease_line(project=...)（折痕只在朝向投影的面上）。

三、时间戳即检索键：把 27 条视频变成按需调用的方法库

索引真正的用法不是顺序看，而是反向检索：先有症状，再定位来源。下表把 SKILL.md 与 critique.md 里的典型故障映射回索引记录，可以直接当查表用。

这张映射表也解释了为什么索引只给“最密集的几分钟”而不是全片时间轴：它服务于诊断式跳读。critique.md 的评审顺序（剪影 → 平面 → 仰俯视 → 长焦 → 线条 → 缩小看）本质上就是这条跳读路径的可视化版本，两张表配合使用效率最高。

四、从来源到可执行代码：索引如何改变实际行为

索引的方法论之所以不是“读书笔记”，是因为它的结论被写进了函数签名和默认参数。举三处最直接的对应关系。

4.1 比例：head_guides把散落的时间戳收成一个字典

bx_sculpt.py的head_guides(H, brow=0.60)返回眼线、鼻底、发际线、嘴线、耳上/下缘、头宽、眼宽、嘴角 x、眼角倾角、颈部前倾角。每个键旁边都带着来源注释，例如：

"eye_z": 0.50, # Abbitt K7AJVx0H3Ec 00:11:45; Naydenov oY9XybQRxzQ 00:03:23; Thelen gC3FG8-4lsU 00:07:22 "nose_base_z": brow / 2, # Naydenov 00:05:49（眉线到下巴的中点）= Thelen 00:20:46 三等分 "mouth_z": brow / 2 * 2 / 3, # Naydenov 00:09:06、Yan 00:08:35：唇裂线在鼻底向下 1/3 "ear_top_z": brow, # Naydenov 00:10:37（眉线）；Thelen、Yan：眼线；Abbitt：眼中

注意brow被明确标为唯一的自由参数，注释写着“专家给的是比例，不是绝对眉高；0.60 来自发际线在 0.9 H 时的三等分，属于技能自己的假设，必须对参考图核验”。这正是索引纪律的体现：能从来源确认的写来源，不能确认的标[added]。

同样，耳上缘三个专家说法不一（眉线 / 眼线 / 眼中），技能没有二选一，而是让参数可调，并在 critique.md 里把“耳上缘在眼线到眉线之间的一个带里”作为可接受区间。

4.2 笔刷：EXPERT_BRUSHES是索引的批处理形态

bx_sculpt.py顶部的EXPERT_BRUSHES字典把多个来源的设置固化成可一键激活的预设：

expert_brush(name)的实现方式是从 Essentials 资产库按brushes/essentials_brushes-mesh_sculpt.blend/Brush/<base>激活，再逐字段setattr。这意味着索引里的“某专家的设置”是可以被脚本还原的，而不是靠人手记忆。带冒号的名称（Crease Polish:landmark）表示“同一支笔刷的另一套参数变体”。

4.3 闸门：索引里的数字变成了校准过的阈值

lower_face_report(obj, H)的ball布尔判定规则是：一个球在区域尺寸 10% 以内拟合成功，并且拟合得至少比平面好两倍。索引里的来源提供了“该长什么样”，而阈值来自校准：

• 三个已知气球下颌（E2 用例）：sphere_rms0.057–0.082 → 判为球；
• 无技能的基线：0.18–0.20 → 不判球，但形态仍然错；
• v2 示例（下颌块配方）：0.23–0.26 → 通过。

这套阈值说明了索引与测量的分工：专家告诉你“气球脸是错的”，测量告诉你“多圆才算气球”。critique.md 里那句“指标通过但渲染看起来不对时，渲染优先”，正是为了防止把校准过的数字当成真理——早期版本在气球下颌上切平面，lower_face_report从 0.057 翻到 0.115（指标改善），渲染却是一个带边沿的宝石面。

五、版本列的正确读法

索引的 Blender 列有三类值，处理方式不同：

1. 明确版本（如2.81、3.1、4.4、5.0）：方法与比例可迁移，界面路径与默认值不可直接迁移。典型例子是 Draw Sharp 的默认方向、Smooth 的默认强度、笔刷以 Essentials 资产形式存在这三件事，在 5.2 里都必须重新核对。
2. 区间（如3.0–3.1、3.6–4.0）：说明该录制跨版本或作者在多个版本上维护同一套流程，引用时优先找与当前版本更近的那一段。
3. [?]与n/a：[?]表示版本是推断的，只可用于方法引用，不可用于默认值引用；n/a（如 Yan 的课程宣传片）表示没有操作内容，只能用于工作量标尺（一个风格化胸像 5 小时以上）。

技能本体在 SKILL.md 的 “Blender 5.2 notes” 里给出了必须知道的 5.2 事实，它们和索引里的旧版本条目构成互补：

• 无头模式下sculpt.symmetrize、sculpt.mesh_filter、paint.mask_flood_fill、sculpt.mask_filter、sculpt.face_sets_create、sculpt.face_sets_init，以及 Sculpt 模式下的object.voxel_remesh会段错误；sculpt.brush_stroke、sculpt.set_pivot_position、sculpt.detail_flood_fill、修剪类手势会 poll 失败。
• 可用的替代：paint_mask_extract、brush.asset_activate、编辑模式下的mesh.symmetrize、quadriflow_remesh、multires 算子。
• 笔刷是 Essentials 资产；Flatten、Fill、Scrape 同属 Plane 类型；size是直径；sculpt_tool已更名为sculpt_brush_type。
• voxel remesh 输出为平面着色（需shade_smooth()），保留属性（含遮罩），丢弃形态键。
• Blender 内置 NumPy 2：写np.ptp(a)而不是a.ptp()。

这就是为什么“其他输入”里那份版本差异文档被标为“权威的 5.2 API 与 UI 事实”：旧视频教方法，版本文档管可行性。

六、专家分歧时怎么裁决

索引本身不解决冲突，但它的分级 + expert-notes.md 末尾的“分歧与裁决条件”表配合起来，能给出可复现的选择。以下是从该表提炼的几条，加上来源级依据：

裁决表的第三条隐含了一个元规则：权威度不是绝对的，它随“你要交付什么”变化。索引把工作室来源放最高，但当你的交付物是游戏烘焙资产时，Naydenov 的“过锐是问题”（属于课程级来源）反而压过 Ryan King 的“越锐越好”（同样课程级）——因为前者的约束来自烘焙流程，后者来自静帧观感。

七、可信度标注：[added]、[eval]、[measured]各指什么

读这套技能的文档时，会反复遇到方括号标记。它们构成一条清晰的责任边界：

• 无标记：来自索引中某条来源，通常附[video_id hh:mm:ss]，可回溯。
• [added]：本技能自己的合成或测量，不是任何专家的原话。例如brow=0.60的假设、Crease Polish:landmark的 0.1 捏合值、拐角移动“约为嘴宽的 1/8”这条规则、地标 ±5% 的容差。
• [eval]：来自评估运行（文档记载为 2026-09-24，三个新 Agent 在有无技能两种条件下雕同一个“风格化冒险者胸像”简报）。这类结论写的是“渲染里看到了什么”，不是专家引语。典型发现包括：单侧倾斜的发际线半空间从侧面看像船形帽；镜像眼球没有视线；重眉下眼睑边缘 20–27 度读作瞪视、约 19 度读作放松；鼻子只靠两点连接时剪影出现漏洞而数值闸门仍然通过。
• [measured]/ 实测数字：可复算的量。例如面数公式约 1.5 × 面积 / voxel²（在球与椭球上误差 3% 内）、原始 voxel remesh 的镜像误差最大值 0.67–0.75 体素 / 均值 0.05–0.07 体素、示例胸像 H/40 约 8.2k 面、H/110 约 64k、H/150 约 103k。

这套标注的实际用途是防止把合成结论当成专家背书。当你看到“眼睑上缘高于中心 21 度”时，它可以追溯到示例参数（14 度被判定为“困倦”）；当你看到“拐角移动 1/8 嘴宽”时，它对应的是实测：65 mm 嘴宽下 8 mm 在两种取景下都能读出，2 mm 在两种取景下都读不出。把它们写成事实陈述而不标注，就是越过了文档自己划的证据边界。

八、把索引用起来的四个操作习惯

1. 先查症状表，再看视频。第三节的映射表覆盖了 SKILL.md “Common mistakes” 的大部分条目；没有对应行的故障，说明它不在已知失败模式里，应当先补一次渲染再判断。
2. 引用默认值前先测。凡是来源标[?]、版本低于 4.x、或涉及笔刷默认行为的条目，都应在 5.2 里实测一次再写进脚本。procedures 的 P13 就是这类实测的模板：6 支笔刷 6/6FINISHED，每笔移动 255–1106 个顶点，X 方向镜像生效。
3. 区分“方法来源”和“参数来源”。比例与流程可以引用 2.79 的视频；具体数值（voxel 大小、平滑强度、间距、抖动）必须来自与当前版本接近的记录或本技能的实测。
4. 每次评审都写“未验证项”。critique.md 的 Reporting 一节要求逐阶段报告：voxel/H、面数、连通分量、镜像误差、侧面节奏、看过的渲染路径、发现的最弱一环及处理、以及没有验证什么（例如“眼睑厚度未在 90 mm 下判定”“GUI 笔画未运行”）。这是索引纪律在输出侧的对应物：说清边界，比说满更有用。

九、继续深入的文件导航

• 来源清单本体（本文主体）：sources.md
• 按专家归纳的原则与时间戳：expert-notes.md
• 每个阶段可直接运行的代码（P1–P17）与笔刷对照表：procedures.md
• 阶段评审量规、观察顺序、角色级自问清单：critique.md
• 技能主文档：阶段流程、Numbers 表、质量闸门、常见错误、5.2 注意事项：SKILL.md
• 实现层：ClaySDF 体块、Sculptor笔刷与折痕、remesh_stage、stage_report、lower_face_report、profile_rhythm、head_guides、expert_brush：bx_sculpt.py
• 评审与渲染工具（bx_review.review、长焦与最终渲染）：bx_review.py
• GUI 会话中的真实笔刷与取景（set_view(frame=...)、stroke）：bx_gui.py
• 自相交审计（细耳细节在 remesh + relax 后折叠）：bx_audit.py

一句话总结：这份索引的价值不在“列了 27 个视频”，而在它把每条经验都钉在了可核验的人、可跳转的分钟、可标注的版本上，并且允许技能把其中一部分升级为可测数字、把另一部分明确标成自己的假设。按这套纪律使用它，你得到的不是一份观看清单，而是一套能解释“为什么这么调”的依据链。