Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

art: refine Qinglan facial control-cage proportions

yhha3ad44e9992b
diff --git a/art/characters/qinglan/README.md b/art/characters/qinglan/README.md
index 4cd2974b6..6560e864a 100644
--- a/art/characters/qinglan/README.md
+++ b/art/characters/qinglan/README.md
@@ -4,17 +4,20 @@
用户已否决 `face-study-v3` 的脸部效果。该版本保留用于定位变形问题和回退,不应作为后续细节制作的造型基础;见 [脸部审查记录](face-study-v3/review/art-review.json)。网格与导出检查通过不能代表人物造型合格。
-最新脸部候选位于 [face-study-v6](face-study-v6/README.md)。本版在用户打开的 Blender 中通过 MCP 调用原生 Grab 与 Smooth 笔刷,保留 V5 来源和三组可回退的局部雕刻修改,并提供同机位前后对照。当前仍需继续修正五官气质与参考接近程度。
+最新脸部比例候选位于 [face-study-v7](face-study-v7/README.md)。本轮回到约 3,700 面的控制网格,调整口裂高度、下颌、眼裂和耳位,并提供设计稿叠加、估计视角对照与真实控制网格图。五官气质、脸颊过渡和嘴唇接合仍需修改;本版尚未美术验收,也未通过严格的新增交叉检查。
+
+[face-study-v6](face-study-v6/README.md) 保留此前通过 Blender MCP 调用原生 Grab 与 Smooth 的高分辨率笔刷试改及同机位前后对照。
[face-study-v5](face-study-v5/README.md) 保留 Blender 官方 CC0 女性基网格来源、原作者的多级雕刻数据,以及 Scenario Blender、雕刻与拓扑技能的接入记录。
-此前的人体版本保留了参数化人体来源、手臂姿态、眉毛及睫毛试作。相关文件用于过程记录;最新 V5 是独立脸部候选,下方完整角色与导出说明对应此前版本。
+此前的人体版本保留了参数化人体来源、手臂姿态、眉毛及睫毛试作。相关文件用于过程记录;V7 是独立脸部候选,下方完整角色与导出说明对应此前版本。
## 文件
| 文件 | 用途 |
| --- | --- |
-| `face-study-v6/qinglan-live-face.blend` | 最新实时雕刻候选、3 个原生笔刷修订形态键及前后对照;尚未美术验收 |
+| `face-study-v7/qinglan-identity-cage.blend` | 最新控制网格比例候选、参考叠加及多视角检查;待继续修改 |
+| `face-study-v6/qinglan-live-face.blend` | 实时雕刻试改、3 个原生笔刷修订形态键及前后对照;尚未美术验收 |
| `face-study-v5/qinglan-face-candidate.blend` | V5 脸部来源、11 个分区形态键及灰模/拓扑检查;尚未美术验收 |
| `qinglan-human-study.blend` | 完整人体与独立头部检查场景;灰色区域是检查材质,不是服装网格 |
| `qinglan-highpoly.blend` | 带完整衣饰、头发、佩剑的高模,保留多级细分、曲线和来源集合 |
diff --git a/art/characters/qinglan/face-study-v7/README.md b/art/characters/qinglan/face-study-v7/README.md
new file mode 100644
index 000000000..9e49fd37e
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/README.md
@@ -0,0 +1,37 @@
+# 青岚 · V7 控制网格比例候选
+
+本轮从 V5 的原始四边面控制网格调整脸部大比例。口裂上移约 8.5 mm,缩窄嘴部,调整下颌与下巴,延展眼裂,联动眼球和虹膜,并加入眉形占位、耳位与鼻尖调整。保留的效果见 `review/reference-overlay.png` 和 `review/reference-multiview.png`。
+
+**状态:待修改、未通过脸部身份验收。** 五官位置有改善,但脸颊过渡、眼睑厚度与鼻唇体积仍未达到设计稿。眉毛是网格占位,不是最终毛发;没有用皮肤贴图或头发遮挡差异。
+
+## 打开和编辑
+
+打开 `qinglan-identity-cage.blend`,编辑 `Qinglan_Identity_Cage`。显示出的头颈控制网格有 3,771 个顶点、3,744 个面,其中 99.47% 是四边面;完整来源的 10,582 个控制顶点仍保留,以维持原作者的 Multires 数据。修改集中在脸部,身体由后置 Mask 隐藏。二级细分检查表面有 60,688 个四边面。
+
+原有 11 个形态键保留。新增键以 `V7_` 开头,7 个启用,另 4 个试改因视觉问题被静音且权重归零。`review/accepted-key-values.json` 是最终启用状态;过程编辑 JSON 中的最大位移描述试改本身,不能替代最终权重。
+
+将所有 `V7_` 键置零,可恢复 V5 的头部造型;眼球、虹膜和眉形需要另外关闭或恢复。V5、V6 原文件没有覆盖。V7 没有承接 V6 的高分辨率原生笔刷修订。
+
+脚本修改形态键前,把 Multires 的视口级别设为 0,更新后再恢复为 1。此会话在较高级别更新控制数据时出现 Blender 5.2.1 细分属性插值崩溃,已从阶段备份恢复;最终文件已多次在后台重新打开。初期编辑通过用户已打开的 Blender MCP 完成,连接中断后使用后台 Blender 继续。全程未使用 computer use,也未自动打开新的可见窗口。
+
+## 对照与检查
+
+- `review/reference-overlay.png`:设计稿、V6、V7 和叠加;按瞳距及眼线对齐。
+- `review/reference-multiview.png`:设计稿与估计视角下的正面、侧面、三分之四。参考不是标定照片;90 mm 镜头、约 72° / 25° 方向是检查用估计。
+- `review/after-*.png`:固定正交正侧面、透视三分之四及低角度原始渲染。
+- `review/cage-*.png`:真实控制网格边,不是高密度表面三角线。
+- `review/verification.json`:保存后重新求值的控制网格、二级表面及局部交叉检查。
+
+头部的 `render` 结构检查没有发现零面积面、翻转面或非流形内部边;这不能证明没有自交。控制网格的局部交叉对为来源 52、当前 52,新增对 0。二级表面的局部交叉对为来源 412、当前 412,其中 **24 对不同于来源**,位于嘴唇接合处。因此严格的“没有新增交叉对”检查仍失败,本版不能作为已清理完毕的生产网格。
+
+检查先取 BVH 候选,再在毫米尺度计算线段与三角面的交叉。范围为脸部局部;相切、共面重合及全身不在该结论内。原来源的内部接触、开口颈边、表情、骨骼、UV、游戏预算和 Estella 验收仍未完成。
+
+## 工具与过程
+
+实际使用 `scenario-blender-expert`、`scenario-blender-sculpting`、`scenario-blender-retopology` 及 `estella-character-production` 的控制网格、分阶段回退、固定视角审查和网格检查流程。本轮是参考约束下的网格数据编辑,没有新增原生雕刻笔画,也没有激活付费工具。
+
+`scripts/identity_cage.py` 提供局部编辑;其余编辑脚本保存试改与回退过程。不要不加选择地重放全部试改。`finalize_candidate.py` 明确关闭失败的脸颊填充和强制张嘴调整;最终文件和键权重记录为准。
+
+`render_review.py`、`render_cage.py` 可通过 `blender --background --factory-startup --python-exit-code 1 --python ...` 重做检查图。`audit_saved.py` 默认严格检查并因上述 24 对交叉退出失败;附加 `-- --report-only` 仅生成如实记录失败状态的报告,不代表检查通过。`compose_review.py` 用 Matplotlib 排列原始图片,没有对脸部图像进行修补。
+
+来源沿用 [V5 的授权记录](../face-study-v5/provenance.json):Blender 官方 Human Base Meshes v1.4.1,Dan Ulrich 的 CC0 女性基网格。
diff --git a/art/characters/qinglan/face-study-v7/provenance.json b/art/characters/qinglan/face-study-v7/provenance.json
new file mode 100644
index 000000000..ff176c88a
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/provenance.json
@@ -0,0 +1,167 @@
+{
+ "asset": "Qinglan V7 reference-led control-cage proportion study",
+ "status": "editable_review_candidate_not_art_or_production_approved",
+ "created": "2026-10-29",
+ "source": {
+ "publisher": "Blender",
+ "bundle": "Human Base Meshes v1.4.1",
+ "page": "https://www.blender.org/download/demo-files/",
+ "download": "https://download.blender.org/demo/asset-bundles/human-base-meshes/human-base-meshes-bundle-v1.4.1.zip",
+ "author": "Dan Ulrich",
+ "collection": "Body Female - Realistic",
+ "objects": [
+ "GEO-body_female_realistic",
+ "GEO-body_female_realistic.eye.L",
+ "GEO-body_female_realistic.eye.R"
+ ],
+ "license": "CC0-1.0",
+ "license_evidence": "Selected asset collection metadata and the bundle's Human Base Meshes README both state CC0. No Rain Rig objects were imported.",
+ "zip_sha256": "811f43accbb31a88266d932f8f5563b2d13586fca0ba2693aad1f5fe582b3515",
+ "blend_sha256": "3c121505651140ceb4d69fd1d8923f7788ffadd81672f5be14845a5f2c75c137"
+ },
+ "parent_file": "../face-study-v5/qinglan-face-candidate.blend",
+ "parent_sha256": "19f5e9271b7b51d1ed9879425b7cb9a2d5609063324f89fe10a68c848b71613d",
+ "current_file": "qinglan-identity-cage.blend",
+ "current_sha256": "f82e51a1cb6fb475adbf56d79ccc58544454201525da248a85c66adddf4823cb",
+ "reference": {
+ "file": "../references/qinglan-face-target.png",
+ "sha256": "6ab4f8b82b92dc3ccb31c8b2b4e398b016a50b72e4ee6d8efd9c4dcbf5104405",
+ "calibrated": false
+ },
+ "workflow": {
+ "blender": "5.2.1 LTS",
+ "skill_revision": "d44410f058991f677ccf733a8e86ce95110857eb",
+ "skills": [
+ "scenario-blender-expert",
+ "scenario-blender-sculpting",
+ "scenario-blender-retopology",
+ "estella-character-production"
+ ],
+ "execution": "Initial control edits over the live Blender MCP connection; after a Blender process crash, recovered from a stage copy and continued through headless CLI. No computer use, no newly launched GUI, no paid add-on activation.",
+ "native_brushes_this_version": false,
+ "comparison_images": "Unaltered reference/render pixels arranged with Matplotlib; approximate eye/eye-chin alignment."
+ },
+ "final_keys": [
+ {
+ "name": "Basis_Studio_Female",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "01_Soften_brow",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "02_Nose_width",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "03_Nose_projection",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "04_Mouth_width",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "05_Lip_projection",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "06_Jaw_taper",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "07_Chin_width",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "08_Cheek_softness",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "09_Eye_aperture",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "10_Lower_face_proportion",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "11_Nasal_tip",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_01_Mouth_Height",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_02_Mouth_Width",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_03_Jaw_Chin_Taper",
+ "value": 0.5,
+ "muted": false
+ },
+ {
+ "name": "V7_04_Orbital_Proportion",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_05_Cheek_Transition",
+ "value": 0.0,
+ "muted": true
+ },
+ {
+ "name": "V7_06_Chin_Roundness",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_07_Ear_Proportion",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_08_Nose_Profile",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_09_Upper_Lip",
+ "value": 0.0,
+ "muted": true
+ },
+ {
+ "name": "V7_10_Oral_Contact",
+ "value": 0.0,
+ "muted": true
+ },
+ {
+ "name": "V7_11_Cheek_Plane_Fairing",
+ "value": 0.0,
+ "muted": true
+ }
+ ],
+ "limits": [
+ "Facial identity needs further work",
+ "Strict new-crossing-pair check fails at Multires level 2",
+ "Internal source contacts and neck attachment unfinished",
+ "No rig, expression, UV, runtime export or Estella acceptance"
+ ]
+}
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/qinglan-identity-cage.blend b/art/characters/qinglan/face-study-v7/qinglan-identity-cage.blend
new file mode 100644
index 000000000..4dfbac5de
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/qinglan-identity-cage.blend differ
diff --git a/art/characters/qinglan/face-study-v7/review/accepted-key-values.json b/art/characters/qinglan/face-study-v7/review/accepted-key-values.json
new file mode 100644
index 000000000..3025ccf61
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/accepted-key-values.json
@@ -0,0 +1,117 @@
+[
+ {
+ "name": "Basis_Studio_Female",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "01_Soften_brow",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "02_Nose_width",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "03_Nose_projection",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "04_Mouth_width",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "05_Lip_projection",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "06_Jaw_taper",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "07_Chin_width",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "08_Cheek_softness",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "09_Eye_aperture",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "10_Lower_face_proportion",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "11_Nasal_tip",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_01_Mouth_Height",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_02_Mouth_Width",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_03_Jaw_Chin_Taper",
+ "value": 0.5,
+ "muted": false
+ },
+ {
+ "name": "V7_04_Orbital_Proportion",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_05_Cheek_Transition",
+ "value": 0.0,
+ "muted": true
+ },
+ {
+ "name": "V7_06_Chin_Roundness",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_07_Ear_Proportion",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_08_Nose_Profile",
+ "value": 1.0,
+ "muted": false
+ },
+ {
+ "name": "V7_09_Upper_Lip",
+ "value": 0.0,
+ "muted": true
+ },
+ {
+ "name": "V7_10_Oral_Contact",
+ "value": 0.0,
+ "muted": true
+ },
+ {
+ "name": "V7_11_Cheek_Plane_Fairing",
+ "value": 0.0,
+ "muted": true
+ }
+]
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/review/after-front.png b/art/characters/qinglan/face-study-v7/review/after-front.png
new file mode 100644
index 000000000..86c2415eb
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/after-front.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/after-low.png b/art/characters/qinglan/face-study-v7/review/after-low.png
new file mode 100644
index 000000000..487b28ce6
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/after-low.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/after-profile.png b/art/characters/qinglan/face-study-v7/review/after-profile.png
new file mode 100644
index 000000000..1ec6a3387
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/after-profile.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/after-threequarter.png b/art/characters/qinglan/face-study-v7/review/after-threequarter.png
new file mode 100644
index 000000000..f62c27a4b
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/after-threequarter.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/art-review.json b/art/characters/qinglan/face-study-v7/review/art-review.json
new file mode 100644
index 000000000..510cc5c32
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/art-review.json
@@ -0,0 +1,45 @@
+{
+ "status": "needs_revision",
+ "stage": "Primary facial proportion comparison complete; head-identity gate remains open",
+ "accepted_changes": [
+ "Mouth region raised toward the front reference",
+ "Reduced mouth width",
+ "Moderate jaw taper and rounded chin edge",
+ "Extended eye aperture with coordinated globe/iris changes",
+ "Raised and shortened source ears",
+ "Brow silhouette proxies"
+ ],
+ "rejected_changes": [
+ "Broad cheek fill and constrained cheek envelope produced undesirable transitions",
+ "Extra upper-lip lift and forced lip-shell separation changed the intended closed-mouth expression"
+ ],
+ "remaining_art_issues": [
+ "Cheekbone-to-jaw transition remains too angular",
+ "Lids and orbital mass remain too heavy for the reference",
+ "Nose/lip surface planes and chin still carry the base-mesh identity",
+ "Brows are simple proxies; no final hairline, lashes or groom"
+ ],
+ "technical": {
+ "render_structure_gate": true,
+ "strict_contact_check": false,
+ "cage_source_crossings": 52,
+ "cage_new_crossings": 0,
+ "level2_source_crossings": 412,
+ "level2_current_crossings": 412,
+ "level2_new_pairs": 24
+ },
+ "reviewed_views": [
+ "after-front.png",
+ "after-profile.png",
+ "after-threequarter.png",
+ "after-low.png",
+ "reference-camera-front.png",
+ "reference-camera-profile.png",
+ "reference-camera-threequarter.png",
+ "cage-front.png",
+ "cage-threequarter.png",
+ "reference-overlay.png",
+ "reference-multiview.png"
+ ],
+ "next_work": "Remain at the head-identity gate. Correct cheek planes and lid thickness in small local areas, compare fixed renders, and clean the lip contact topology before production export."
+}
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/review/cage-front.png b/art/characters/qinglan/face-study-v7/review/cage-front.png
new file mode 100644
index 000000000..f7c01199c
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/cage-front.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/cage-threequarter.png b/art/characters/qinglan/face-study-v7/review/cage-threequarter.png
new file mode 100644
index 000000000..146ea1fc1
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/cage-threequarter.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/cameras.json b/art/characters/qinglan/face-study-v7/review/cameras.json
new file mode 100644
index 000000000..862c1940a
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/cameras.json
@@ -0,0 +1,121 @@
+[
+ {
+ "name": "Reference_front",
+ "type": "PERSP",
+ "lens_mm": 90.0,
+ "ortho_scale": 6.0,
+ "location": [
+ 0.0,
+ -0.8379999995231628,
+ 1.5820000171661377
+ ],
+ "rotation_euler": [
+ 1.5707964897155762,
+ -0.0,
+ 0.0
+ ],
+ "calibrated": false
+ },
+ {
+ "name": "Reference_profile",
+ "type": "PERSP",
+ "lens_mm": 90.0,
+ "ortho_scale": 6.0,
+ "location": [
+ -0.8179086446762085,
+ -0.3397546410560608,
+ 1.5820000171661377
+ ],
+ "rotation_euler": [
+ 1.570796251296997,
+ -8.364411030470364e-08,
+ -1.2566369771957397
+ ],
+ "calibrated": false
+ },
+ {
+ "name": "Reference_threequarter",
+ "type": "PERSP",
+ "lens_mm": 90.0,
+ "ortho_scale": 6.0,
+ "location": [
+ 0.33386844396591187,
+ -0.7639831900596619,
+ 1.5820000171661377
+ ],
+ "rotation_euler": [
+ 1.5707961320877075,
+ -2.329406001422285e-09,
+ 0.43633222579956055
+ ],
+ "calibrated": false
+ },
+ {
+ "name": "Review_front",
+ "type": "ORTHO",
+ "lens_mm": 90.0,
+ "ortho_scale": 0.3089999854564667,
+ "location": [
+ 0.0,
+ -1.2029999494552612,
+ 1.5820000171661377
+ ],
+ "rotation_euler": [
+ 1.5707964897155762,
+ -0.0,
+ 0.0
+ ],
+ "calibrated": false
+ },
+ {
+ "name": "Review_low",
+ "type": "PERSP",
+ "lens_mm": 90.0,
+ "ortho_scale": 0.3089999854564667,
+ "location": [
+ 0.46411454677581787,
+ -1.0743657350540161,
+ 1.3241585493087769
+ ],
+ "rotation_euler": [
+ 1.7949458360671997,
+ -4.796226704684159e-08,
+ 0.4228539764881134
+ ],
+ "calibrated": false
+ },
+ {
+ "name": "Review_profile",
+ "type": "ORTHO",
+ "lens_mm": 90.0,
+ "ortho_scale": 0.3089999854564667,
+ "location": [
+ -1.159999966621399,
+ -0.06499999761581421,
+ 1.5820000171661377
+ ],
+ "rotation_euler": [
+ 1.5707963705062866,
+ -0.0,
+ -1.5707963705062866
+ ],
+ "calibrated": false
+ },
+ {
+ "name": "Review_threequarter",
+ "type": "PERSP",
+ "lens_mm": 90.0,
+ "ortho_scale": 0.3089999854564667,
+ "location": [
+ 0.665216326713562,
+ -0.9933090209960938,
+ 1.5820000171661377
+ ],
+ "rotation_euler": [
+ 1.5707963705062866,
+ 1.4855039864869468e-08,
+ 0.610725998878479
+ ],
+ "calibrated": false
+ }
+]
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/review/cheek-fairing.json b/art/characters/qinglan/face-study-v7/review/cheek-fairing.json
new file mode 100644
index 000000000..b4fc760b2
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/cheek-fairing.json
@@ -0,0 +1,9 @@
+{
+ "target": "Fill the hollow cheek surface to a local convex envelope; matched X/Z contour held",
+ "depth_only": true,
+ "internal_vertices_protected_by_front_visibility": true,
+ "key": "V7_11_Cheek_Plane_Fairing",
+ "moved_control_vertices": 307,
+ "max_displacement_mm": 18.000000000000004,
+ "protected_body_delta_m": 0
+}
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/review/contact-protection.json b/art/characters/qinglan/face-study-v7/review/contact-protection.json
new file mode 100644
index 000000000..eafe05314
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/contact-protection.json
@@ -0,0 +1,17 @@
+{
+ "orbital": {
+ "target": "Visible lid edits with fixed deep orbital return",
+ "key": "V7_04_Orbital_Proportion",
+ "moved_control_vertices": 662,
+ "max_displacement_mm": 5.767201229172113,
+ "protected_body_delta_m": 0
+ },
+ "oral": {
+ "target": "Separate upper/lower lip shells using geodesic surface labels",
+ "separation_each_side_m": 0.0011,
+ "key": "V7_10_Oral_Contact",
+ "moved_control_vertices": 425,
+ "max_displacement_mm": 1.100000000000101,
+ "protected_body_delta_m": 0
+ }
+}
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/review/control-edits.json b/art/characters/qinglan/face-study-v7/review/control-edits.json
new file mode 100644
index 000000000..801c33b83
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/control-edits.json
@@ -0,0 +1,36 @@
+[
+ {
+ "target": "Raise oral region toward reference lip-line height",
+ "target_lift_m": 0.0085,
+ "key": "V7_01_Mouth_Height",
+ "moved_control_vertices": 1019,
+ "max_displacement_mm": 8.499999999999952,
+ "protected_body_delta_m": 0
+ },
+ {
+ "target": "Compact lip outline",
+ "central_width_scale": 0.9,
+ "key": "V7_02_Mouth_Width",
+ "moved_control_vertices": 820,
+ "max_displacement_mm": 3.1586424794584484,
+ "protected_body_delta_m": 0
+ },
+ {
+ "target": "Oval lower-face contour; oral rings protected from jaw taper",
+ "strength": 0.65,
+ "key": "V7_03_Jaw_Chin_Taper",
+ "moved_control_vertices": 1664,
+ "max_displacement_mm": 6.620841878967831,
+ "protected_body_delta_m": 0
+ },
+ {
+ "target": "Wider almond-shaped aperture with coordinated lid tilt",
+ "outer_canthal_target_m": 0.0055,
+ "inner_canthal_target_m": -0.001,
+ "tilt_m": 0.002,
+ "key": "V7_04_Orbital_Proportion",
+ "moved_control_vertices": 662,
+ "max_displacement_mm": 5.7671600440269675,
+ "protected_body_delta_m": 0
+ }
+]
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/review/face-review.png b/art/characters/qinglan/face-study-v7/review/face-review.png
new file mode 100644
index 000000000..46478bd35
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/face-review.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/feature-edits.json b/art/characters/qinglan/face-study-v7/review/feature-edits.json
new file mode 100644
index 000000000..9feadf156
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/feature-edits.json
@@ -0,0 +1,23 @@
+[
+ {
+ "target": "Raise and shorten low source ears to the reference eye/nose-base band",
+ "key": "V7_07_Ear_Proportion",
+ "moved_control_vertices": 558,
+ "max_displacement_mm": 13.15680692571292,
+ "protected_body_delta_m": 0
+ },
+ {
+ "target": "Soften projecting nasal tip while preserving bridge and nostril topology",
+ "key": "V7_08_Nose_Profile",
+ "moved_control_vertices": 188,
+ "max_displacement_mm": 3.200000000000008,
+ "protected_body_delta_m": 0
+ },
+ {
+ "target": "Restore upper-lip volume above the raised mouth seam",
+ "key": "V7_09_Upper_Lip",
+ "moved_control_vertices": 203,
+ "max_displacement_mm": 2.4041630560342337,
+ "protected_body_delta_m": 0
+ }
+]
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/review/globe-fit.json b/art/characters/qinglan/face-study-v7/review/globe-fit.json
new file mode 100644
index 000000000..19c1a93fe
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/globe-fit.json
@@ -0,0 +1,12 @@
+[
+ {
+ "side": "L",
+ "method": "Same spatial deformation as orbital control region",
+ "max_delta_mm": 5.647635334806258
+ },
+ {
+ "side": "R",
+ "method": "Same spatial deformation as orbital control region",
+ "max_delta_mm": 5.638280084070033
+ }
+]
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/review/iris-fit.json b/art/characters/qinglan/face-study-v7/review/iris-fit.json
new file mode 100644
index 000000000..bfda54ca2
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/iris-fit.json
@@ -0,0 +1,26 @@
+[
+ {
+ "object": "Iris_L",
+ "radius_m": 0.0066,
+ "surface_offset_m": 6e-05,
+ "ray_misses": 0
+ },
+ {
+ "object": "Pupil_L",
+ "radius_m": 0.0017,
+ "surface_offset_m": 0.00012,
+ "ray_misses": 0
+ },
+ {
+ "object": "Iris_R",
+ "radius_m": 0.0066,
+ "surface_offset_m": 6e-05,
+ "ray_misses": 0
+ },
+ {
+ "object": "Pupil_R",
+ "radius_m": 0.0017,
+ "surface_offset_m": 0.00012,
+ "ray_misses": 0
+ }
+]
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/review/projected-pupils.json b/art/characters/qinglan/face-study-v7/review/projected-pupils.json
new file mode 100644
index 000000000..bed170665
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/projected-pupils.json
@@ -0,0 +1,42 @@
+{
+ "Review_front": {
+ "L": [
+ 385.07258892059326,
+ 347.17040061950684
+ ],
+ "R": [
+ 214.869886636734,
+ 347.1713066101074
+ ]
+ },
+ "Reference_front": {
+ "L": [
+ 393.6455726623535,
+ 341.84627532958984
+ ],
+ "R": [
+ 206.3164472579956,
+ 341.8630123138428
+ ]
+ },
+ "Reference_profile": {
+ "L": [
+ 459.0073227882385,
+ 353.19910049438477
+ ],
+ "R": [
+ 420.64218521118164,
+ 349.58887100219727
+ ]
+ },
+ "Reference_threequarter": {
+ "L": [
+ 278.4447491168976,
+ 341.3761615753174
+ ],
+ "R": [
+ 114.93492722511292,
+ 343.6403751373291
+ ]
+ }
+}
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/review/reference-camera-front.png b/art/characters/qinglan/face-study-v7/review/reference-camera-front.png
new file mode 100644
index 000000000..dbabc6534
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/reference-camera-front.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/reference-camera-profile.png b/art/characters/qinglan/face-study-v7/review/reference-camera-profile.png
new file mode 100644
index 000000000..bf5d7ab93
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/reference-camera-profile.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/reference-camera-threequarter.png b/art/characters/qinglan/face-study-v7/review/reference-camera-threequarter.png
new file mode 100644
index 000000000..4fd090ed8
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/reference-camera-threequarter.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/reference-multiview.png b/art/characters/qinglan/face-study-v7/review/reference-multiview.png
new file mode 100644
index 000000000..aaa7d2f17
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/reference-multiview.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/reference-overlay.png b/art/characters/qinglan/face-study-v7/review/reference-overlay.png
new file mode 100644
index 000000000..062309bf5
Binary files /dev/null and b/art/characters/qinglan/face-study-v7/review/reference-overlay.png differ
diff --git a/art/characters/qinglan/face-study-v7/review/secondary-edits.json b/art/characters/qinglan/face-study-v7/review/secondary-edits.json
new file mode 100644
index 000000000..d3cc4bbe4
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/secondary-edits.json
@@ -0,0 +1,18 @@
+[
+ {
+ "target": "Restore cheek fullness and fair cheek-to-jaw depth",
+ "cheek_fill_m": 0.006,
+ "relax_iterations": 6,
+ "key": "V7_05_Cheek_Transition",
+ "moved_control_vertices": 769,
+ "max_displacement_mm": 6.338067959714949,
+ "protected_body_delta_m": 0
+ },
+ {
+ "target": "Round the blunt chin edge while holding the central chin anchor",
+ "key": "V7_06_Chin_Roundness",
+ "moved_control_vertices": 357,
+ "max_displacement_mm": 3.1416584610686193,
+ "protected_body_delta_m": 0
+ }
+]
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/review/verification.json b/art/characters/qinglan/face-study-v7/review/verification.json
new file mode 100644
index 000000000..c5db9f9e0
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/review/verification.json
@@ -0,0 +1,890 @@
+{
+ "scope": "Editable face proportion study; no rig, engine or visual acceptance implied.",
+ "protected_body_delta_m": 0.0,
+ "source_topology_vertices": 10582,
+ "new_key_count": 11,
+ "levels": {
+ "0": {
+ "vertices": 3771,
+ "faces": 3744,
+ "audit": {
+ "object": "Audit_Only_V7",
+ "verts": 3771,
+ "edges": 7514,
+ "faces": 3744,
+ "tris_equivalent": 7468,
+ "tris": 20,
+ "quads": 3724,
+ "ngons": 0,
+ "quads_pct": 99.47,
+ "valence_hist_interior": {
+ "3": 68,
+ "4": 3547,
+ "5": 84
+ },
+ "poles_e3": 68,
+ "poles_e5plus": 84,
+ "valence_6plus": 0,
+ "non_manifold_edges": 0,
+ "boundary_loops": [
+ 72
+ ],
+ "loose_verts": 0,
+ "loose_edges": 0,
+ "zero_area_faces": 0,
+ "duplicate_verts": 0,
+ "flipped_faces": 0,
+ "self_intersections": 55,
+ "edge_len_mean": 0.006328,
+ "edge_len_cv": 0.707,
+ "symmetry_pct": 77.41,
+ "dimensions": [
+ 0.2579,
+ 0.2188,
+ 0.3036
+ ],
+ "ngon_faces_sample": [],
+ "pole_e5_sample": [
+ [
+ -0.0186,
+ -0.1402,
+ 1.5357
+ ],
+ [
+ -0.0196,
+ -0.1391,
+ 1.5367
+ ],
+ [
+ -0.0228,
+ -0.1329,
+ 1.5978
+ ],
+ [
+ -0.0214,
+ -0.1317,
+ 1.6018
+ ],
+ [
+ -0.0524,
+ -0.1261,
+ 1.6023
+ ],
+ [
+ -0.0074,
+ -0.1591,
+ 1.5595
+ ],
+ [
+ -0.0725,
+ -0.0632,
+ 1.6084
+ ],
+ [
+ -0.0492,
+ -0.1305,
+ 1.5904
+ ],
+ [
+ -0.0079,
+ -0.1481,
+ 1.5924
+ ],
+ [
+ -0.0747,
+ -0.0574,
+ 1.6259
+ ],
+ [
+ -0.0295,
+ -0.1358,
+ 1.6141
+ ],
+ [
+ -0.0192,
+ -0.141,
+ 1.522
+ ],
+ [
+ -0.0153,
+ -0.1339,
+ 1.6013
+ ],
+ [
+ -0.0143,
+ -0.1494,
+ 1.5513
+ ],
+ [
+ -0.0607,
+ -0.064,
+ 1.5404
+ ],
+ [
+ -0.0086,
+ -0.1418,
+ 1.6169
+ ],
+ [
+ -0.0199,
+ -0.1442,
+ 1.5624
+ ],
+ [
+ -0.018,
+ -0.1353,
+ 1.5927
+ ],
+ [
+ -0.0135,
+ -0.1496,
+ 1.5555
+ ],
+ [
+ -0.0613,
+ -0.0967,
+ 1.5514
+ ],
+ [
+ -0.0048,
+ -0.1535,
+ 1.5551
+ ],
+ [
+ -0.0044,
+ -0.1517,
+ 1.5596
+ ],
+ [
+ -0.0255,
+ -0.1305,
+ 1.5448
+ ],
+ [
+ -0.0138,
+ -0.1446,
+ 1.5487
+ ],
+ [
+ -0.0145,
+ -0.1348,
+ 1.5202
+ ]
+ ],
+ "pole_e3_sample": [
+ [
+ -0.0267,
+ -0.1094,
+ 1.6043
+ ],
+ [
+ -0.0286,
+ -0.1086,
+ 1.6005
+ ],
+ [
+ -0.0322,
+ -0.1078,
+ 1.6021
+ ],
+ [
+ -0.0302,
+ -0.1086,
+ 1.6063
+ ],
+ [
+ -0.0192,
+ -0.1374,
+ 1.5348
+ ],
+ [
+ -0.0201,
+ -0.1376,
+ 1.5369
+ ],
+ [
+ -0.0175,
+ -0.1328,
+ 1.5989
+ ],
+ [
+ -0.0182,
+ -0.1334,
+ 1.5969
+ ],
+ [
+ -0.0068,
+ -0.157,
+ 1.5598
+ ],
+ [
+ -0.0172,
+ -0.1465,
+ 1.5628
+ ],
+ [
+ -0.009,
+ -0.1442,
+ 1.5042
+ ],
+ [
+ -0.054,
+ -0.1253,
+ 1.604
+ ],
+ [
+ -0.0226,
+ -0.1412,
+ 1.6255
+ ],
+ [
+ -0.0278,
+ -0.136,
+ 1.5929
+ ],
+ [
+ -0.0247,
+ -0.1033,
+ 1.6965
+ ],
+ [
+ -0.0112,
+ -0.1512,
+ 1.5597
+ ],
+ [
+ -0.0064,
+ -0.1521,
+ 1.5634
+ ],
+ [
+ -0.0028,
+ -0.1558,
+ 1.5607
+ ],
+ [
+ -0.0221,
+ -0.1333,
+ 1.6057
+ ],
+ [
+ -0.009,
+ -0.15,
+ 1.561
+ ],
+ [
+ -0.0238,
+ -0.1324,
+ 1.5401
+ ],
+ [
+ -0.0236,
+ -0.1312,
+ 1.5359
+ ],
+ [
+ -0.0101,
+ -0.1462,
+ 1.5505
+ ],
+ [
+ -0.0228,
+ -0.0779,
+ 1.5195
+ ],
+ [
+ -0.0276,
+ -0.0799,
+ 1.5586
+ ]
+ ]
+ },
+ "render_gate": {
+ "profile": "render",
+ "eps": 4.5e-05,
+ "tol": 0.000909,
+ "gap": 0.004545,
+ "pass": true,
+ "errors": [],
+ "warnings": [],
+ "per_object": {
+ "Audit_Only_V7": {
+ "tris": 7468,
+ "parts": 1,
+ "errors": [],
+ "warnings": []
+ }
+ },
+ "skipped": []
+ },
+ "max_total_delta_mm": 13.753316094861326,
+ "face_patch_faces": 2407,
+ "source_bvh_candidates": 55,
+ "current_bvh_candidates": 55,
+ "source_confirmed_crossings": 52,
+ "current_confirmed_crossings": 52,
+ "new_confirmed_crossings": 0,
+ "new_crossing_pairs": [],
+ "new_crossing_centers": [],
+ "limits": "Local face patch, millimetre-scale segment/triangle tests; inherited crossings retained, tangencies and coplanar overlaps not certified."
+ },
+ "2": {
+ "vertices": 60833,
+ "faces": 60688,
+ "audit": {
+ "object": "Audit_Only_V7",
+ "verts": 60833,
+ "edges": 121520,
+ "faces": 60688,
+ "tris_equivalent": 121376,
+ "tris": 0,
+ "quads": 60688,
+ "ngons": 0,
+ "quads_pct": 100.0,
+ "valence_hist_interior": {
+ "3": 88,
+ "4": 60373,
+ "5": 84
+ },
+ "poles_e3": 88,
+ "poles_e5plus": 84,
+ "valence_6plus": 0,
+ "non_manifold_edges": 0,
+ "boundary_loops": [
+ 288
+ ],
+ "loose_verts": 0,
+ "loose_edges": 0,
+ "zero_area_faces": 0,
+ "duplicate_verts": 0,
+ "flipped_faces": 0,
+ "self_intersections": 457,
+ "edge_len_mean": 0.001615,
+ "edge_len_cv": 0.788,
+ "symmetry_pct": 79.33,
+ "dimensions": [
+ 0.2868,
+ 0.228,
+ 0.3194
+ ],
+ "ngon_faces_sample": [],
+ "pole_e5_sample": [
+ [
+ -0.0186,
+ -0.1402,
+ 1.5357
+ ],
+ [
+ -0.0196,
+ -0.1391,
+ 1.5368
+ ],
+ [
+ -0.0228,
+ -0.1329,
+ 1.5978
+ ],
+ [
+ -0.0214,
+ -0.1318,
+ 1.6018
+ ],
+ [
+ -0.0523,
+ -0.1262,
+ 1.6023
+ ],
+ [
+ -0.0076,
+ -0.1591,
+ 1.5595
+ ],
+ [
+ -0.0725,
+ -0.0632,
+ 1.6081
+ ],
+ [
+ -0.0485,
+ -0.1305,
+ 1.5903
+ ],
+ [
+ -0.0079,
+ -0.148,
+ 1.5924
+ ],
+ [
+ -0.0747,
+ -0.0574,
+ 1.6263
+ ],
+ [
+ -0.0297,
+ -0.1357,
+ 1.6141
+ ],
+ [
+ -0.0192,
+ -0.141,
+ 1.5219
+ ],
+ [
+ -0.0153,
+ -0.1339,
+ 1.6013
+ ],
+ [
+ -0.0143,
+ -0.1494,
+ 1.5515
+ ],
+ [
+ -0.0608,
+ -0.064,
+ 1.5404
+ ],
+ [
+ -0.0085,
+ -0.1419,
+ 1.6168
+ ],
+ [
+ -0.0198,
+ -0.1442,
+ 1.5625
+ ],
+ [
+ -0.018,
+ -0.1353,
+ 1.5928
+ ],
+ [
+ -0.0135,
+ -0.1495,
+ 1.5557
+ ],
+ [
+ -0.0613,
+ -0.0967,
+ 1.5519
+ ],
+ [
+ -0.0049,
+ -0.1537,
+ 1.5553
+ ],
+ [
+ -0.0044,
+ -0.1516,
+ 1.5594
+ ],
+ [
+ -0.0256,
+ -0.1305,
+ 1.5442
+ ],
+ [
+ -0.0138,
+ -0.1446,
+ 1.5487
+ ],
+ [
+ -0.0146,
+ -0.1348,
+ 1.52
+ ]
+ ],
+ "pole_e3_sample": [
+ [
+ -0.0267,
+ -0.1094,
+ 1.6043
+ ],
+ [
+ -0.0286,
+ -0.1086,
+ 1.6005
+ ],
+ [
+ -0.0322,
+ -0.1078,
+ 1.6021
+ ],
+ [
+ -0.0302,
+ -0.1086,
+ 1.6063
+ ],
+ [
+ -0.0192,
+ -0.1374,
+ 1.5348
+ ],
+ [
+ -0.0201,
+ -0.1376,
+ 1.5369
+ ],
+ [
+ -0.0175,
+ -0.1328,
+ 1.5989
+ ],
+ [
+ -0.0182,
+ -0.1334,
+ 1.597
+ ],
+ [
+ -0.0069,
+ -0.1569,
+ 1.5597
+ ],
+ [
+ -0.0172,
+ -0.1465,
+ 1.5628
+ ],
+ [
+ -0.009,
+ -0.1442,
+ 1.5042
+ ],
+ [
+ -0.054,
+ -0.1252,
+ 1.604
+ ],
+ [
+ -0.0227,
+ -0.1412,
+ 1.6255
+ ],
+ [
+ -0.0278,
+ -0.136,
+ 1.5929
+ ],
+ [
+ -0.0247,
+ -0.1033,
+ 1.6965
+ ],
+ [
+ -0.0112,
+ -0.1513,
+ 1.5597
+ ],
+ [
+ -0.0064,
+ -0.1522,
+ 1.5635
+ ],
+ [
+ -0.0027,
+ -0.156,
+ 1.5609
+ ],
+ [
+ -0.0221,
+ -0.1333,
+ 1.6058
+ ],
+ [
+ -0.0091,
+ -0.1498,
+ 1.5609
+ ],
+ [
+ -0.0238,
+ -0.1324,
+ 1.5401
+ ],
+ [
+ -0.0235,
+ -0.1312,
+ 1.536
+ ],
+ [
+ -0.0101,
+ -0.1461,
+ 1.5508
+ ],
+ [
+ -0.0228,
+ -0.0782,
+ 1.5195
+ ],
+ [
+ -0.0274,
+ -0.0799,
+ 1.5588
+ ]
+ ]
+ },
+ "render_gate": {
+ "profile": "render",
+ "eps": 4.9e-05,
+ "tol": 0.000972,
+ "gap": 0.004861,
+ "pass": true,
+ "errors": [],
+ "warnings": [],
+ "per_object": {
+ "Audit_Only_V7": {
+ "tris": 121376,
+ "parts": 1,
+ "errors": [],
+ "warnings": []
+ }
+ },
+ "skipped": []
+ },
+ "max_total_delta_mm": 13.404875736928174,
+ "face_patch_faces": 37776,
+ "source_bvh_candidates": 421,
+ "current_bvh_candidates": 423,
+ "source_confirmed_crossings": 412,
+ "current_confirmed_crossings": 412,
+ "new_confirmed_crossings": 24,
+ "new_crossing_pairs": [
+ [
+ 6682,
+ 13793
+ ],
+ [
+ 6928,
+ 13780
+ ],
+ [
+ 7076,
+ 17666
+ ],
+ [
+ 7086,
+ 10472
+ ],
+ [
+ 7086,
+ 10474
+ ],
+ [
+ 7086,
+ 10484
+ ],
+ [
+ 8577,
+ 10507
+ ],
+ [
+ 8577,
+ 10513
+ ],
+ [
+ 8584,
+ 10513
+ ],
+ [
+ 8584,
+ 10525
+ ],
+ [
+ 15192,
+ 16014
+ ],
+ [
+ 35807,
+ 39607
+ ],
+ [
+ 36063,
+ 42904
+ ],
+ [
+ 36063,
+ 45291
+ ],
+ [
+ 36202,
+ 46782
+ ],
+ [
+ 36202,
+ 46783
+ ],
+ [
+ 36202,
+ 46792
+ ],
+ [
+ 36203,
+ 39600
+ ],
+ [
+ 36203,
+ 46792
+ ],
+ [
+ 37696,
+ 39625
+ ],
+ [
+ 37696,
+ 39632
+ ],
+ [
+ 37698,
+ 39625
+ ],
+ [
+ 37707,
+ 39627
+ ],
+ [
+ 39648,
+ 44948
+ ]
+ ],
+ "new_crossing_centers": [
+ [
+ -0.013933849055320024,
+ -0.14943054504692554,
+ 1.5363970845937729
+ ],
+ [
+ -0.012274825130589306,
+ -0.1489502638578415,
+ 1.5364719480276108
+ ],
+ [
+ -0.01702784327790141,
+ -0.14386029914021492,
+ 1.5357954651117325
+ ],
+ [
+ -0.015833888668566942,
+ -0.14496950432658195,
+ 1.536106824874878
+ ],
+ [
+ -0.01601894269697368,
+ -0.1447228156030178,
+ 1.5361255705356598
+ ],
+ [
+ -0.016196890966966748,
+ -0.14448141679167747,
+ 1.5361500829458237
+ ],
+ [
+ -0.01942742126993835,
+ -0.14089735969901085,
+ 1.535470262169838
+ ],
+ [
+ -0.019527794094756246,
+ -0.1411265768110752,
+ 1.5352728068828583
+ ],
+ [
+ -0.019603338791057467,
+ -0.14134369418025017,
+ 1.5351724475622177
+ ],
+ [
+ -0.019734679022803903,
+ -0.1415418591350317,
+ 1.5350283980369568
+ ],
+ [
+ -0.016105018090456724,
+ -0.14728002808988094,
+ 1.535971000790596
+ ],
+ [
+ 0.015137860202230513,
+ -0.1461978666484356,
+ 1.5361702591180801
+ ],
+ [
+ 0.011197539628483355,
+ -0.1496316511183977,
+ 1.536720722913742
+ ],
+ [
+ 0.010931915719993412,
+ -0.14986305497586727,
+ 1.5367355048656464
+ ],
+ [
+ 0.016983462497591972,
+ -0.14342406950891018,
+ 1.5360122323036194
+ ],
+ [
+ 0.01715043978765607,
+ -0.14363949187099934,
+ 1.5356962978839874
+ ],
+ [
+ 0.016820366960018873,
+ -0.14365237578749657,
+ 1.5359944105148315
+ ],
+ [
+ 0.016403302317485213,
+ -0.14420903287827969,
+ 1.5360139906406403
+ ],
+ [
+ 0.01656227116473019,
+ -0.14397111535072327,
+ 1.5360273718833923
+ ],
+ [
+ 0.019423044519498944,
+ -0.14094420708715916,
+ 1.5354686826467514
+ ],
+ [
+ 0.019533694488927722,
+ -0.14121193438768387,
+ 1.535291850566864
+ ],
+ [
+ 0.0193657495547086,
+ -0.14105859957635403,
+ 1.5355149656534195
+ ],
+ [
+ 0.019134995993226767,
+ -0.1410205326974392,
+ 1.5356097519397736
+ ],
+ [
+ 0.020205320324748755,
+ -0.1420870628207922,
+ 1.5348308235406876
+ ]
+ ],
+ "limits": "Local face patch, millimetre-scale segment/triangle tests; inherited crossings retained, tangencies and coplanar overlaps not certified."
+ }
+ },
+ "delivery_profile": "render only",
+ "checks_passed": false,
+ "key_values": {
+ "V7_01_Mouth_Height": 1.0,
+ "V7_02_Mouth_Width": 1.0,
+ "V7_03_Jaw_Chin_Taper": 0.5,
+ "V7_04_Orbital_Proportion": 1.0,
+ "V7_05_Cheek_Transition": 0,
+ "V7_06_Chin_Roundness": 1.0,
+ "V7_07_Ear_Proportion": 1.0,
+ "V7_08_Nose_Profile": 1.0,
+ "V7_09_Upper_Lip": 0,
+ "V7_10_Oral_Contact": 0,
+ "V7_11_Cheek_Plane_Fairing": 0
+ },
+ "status": "needs_revision_contact_pairs_remain"
+}
\ No newline at end of file
diff --git a/art/characters/qinglan/face-study-v7/scripts/audit_saved.py b/art/characters/qinglan/face-study-v7/scripts/audit_saved.py
new file mode 100644
index 000000000..8bb17e718
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/audit_saved.py
@@ -0,0 +1,91 @@
+"""Compare actual evaluated cage and Multires geometry against the V5 source.
+
+New self-crossings are distinguished from inherited contacts. This is a local
+face test; it does not approve likeness, expression deformation or a game asset.
+"""
+import bpy,json,sys
+import numpy as np
+from pathlib import Path
+from mathutils import Vector
+from mathutils.bvhtree import BVHTree
+from mathutils.geometry import intersect_ray_tri
+ROOT=Path(__file__).resolve().parents[1]
+sys.path.extend([str(ROOT/'scripts'),str(Path.home()/'.codex/skills/scenario-blender-expert/scripts')])
+import identity_cage as I
+import bx_audit as A
+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))
+head=bpy.data.objects['Qinglan_Identity_Cage'];multi=next(m for m in head.modifiers if m.type=='MULTIRES')
+keys=head.data.shape_keys.key_blocks;new_keys=[k for k in keys if k.name.startswith('V7_')]
+enabled_values={k.name:(0 if k.mute else k.value) for k in new_keys}
+source=I.world_coords(head,I.mixed_coords(head))
+current=I.world_coords(head,I.mixed_coords(head,exclude_prefix='NONE'))
+protected=source[:,2]<1.47
+protected_delta=float(np.linalg.norm(current-source,axis=1)[protected].max(initial=0))
+assert protected_delta<2e-7
+assert np.isfinite(current).all()
+report={'scope':'Editable face proportion study; no rig, engine or visual acceptance implied.',
+ 'protected_body_delta_m':protected_delta,'source_topology_vertices':len(source),
+ 'new_key_count':len(new_keys),'levels':{},'delivery_profile':'render only'}
+def evaluate(level,enabled):
+ multi.levels=level
+ for key in new_keys:key.value=enabled_values[key.name] if enabled else 0
+ bpy.context.view_layer.update();dg=bpy.context.evaluated_depsgraph_get()
+ mesh=bpy.data.meshes.new_from_object(head.evaluated_get(dg),preserve_all_data_layers=True,depsgraph=dg)
+ mesh.transform(head.matrix_world)
+ return mesh
+def bvh_candidates(co,polys,face_ids):
+ tree=BVHTree.FromPolygons([Vector(p) for p in co],polys)
+ return {(face_ids[a],face_ids[b]) for a,b in tree.overlap(tree) if a<b and not set(polys[a])&set(polys[b])}
+def narrow(co,pairs,triangles):
+ points=[Vector((p-np.array((0,-.12,1.60)))*1000) for p in co]
+ def cross(ta,tb):
+ a=[points[i] for i in ta];b=[points[i] for i in tb]
+ for edges,face in ((a,b),(b,a)):
+ for i in range(3):
+ origin=edges[i];direction=edges[(i+1)%3]-origin
+ if direction.length_squared<1e-20:continue
+ hit=intersect_ray_tri(*face,direction.normalized(),origin,True)
+ if hit is not None:
+ t=(hit-origin).dot(direction)/direction.length_squared
+ if 1e-6<t<1-1e-6:return True
+ return False
+ return {p for p in pairs if any(cross(a,b) for a in triangles[p[0]] for b in triangles[p[1]])}
+probe=intersect_ray_tri(Vector((0,0,0)),Vector((1,0,0)),Vector((0,1,0)),Vector((0,0,1)),Vector((.25,.25,-1)),True)
+assert probe is not None and probe.length<1
+failed=[]
+for level in (0,2):
+ before=evaluate(level,False);after=evaluate(level,True)
+ base=I.coords(before.vertices);actual=I.coords(after.vertices)
+ assert len(base)==len(actual) and len(before.polygons)==len(after.polygons)
+ polys=[];face_ids=[]
+ for p in after.polygons:
+ idx=list(p.vertices);v=base[idx]
+ if np.any((np.abs(v[:,0])<.082)&(v[:,1]<-.065)&(v[:,2]>1.47)&(v[:,2]<1.65)):
+ polys.append(idx);face_ids.append(p.index)
+ bp=bvh_candidates(base,polys,face_ids);ap=bvh_candidates(actual,polys,face_ids)
+ after.calc_loop_triangles();triangles={}
+ for tri in after.loop_triangles:triangles.setdefault(tri.polygon_index,[]).append(tuple(tri.vertices))
+ bc=narrow(base,bp,triangles);ac=narrow(actual,ap,triangles);new=ac-bc
+ snapshot=bpy.data.objects.new('Audit_Only_V7',after)
+ audit=A.audit(snapshot)
+ gate=A.deliverable([snapshot],profile='render')
+ deltas=np.linalg.norm(actual-base,axis=1)
+ result={'vertices':len(actual),'faces':len(after.polygons),'audit':audit,'render_gate':gate,
+ 'max_total_delta_mm':float(deltas.max()*1000),'face_patch_faces':len(polys),
+ 'source_bvh_candidates':len(bp),'current_bvh_candidates':len(ap),
+ 'source_confirmed_crossings':len(bc),'current_confirmed_crossings':len(ac),
+ 'new_confirmed_crossings':len(new),
+ 'new_crossing_pairs':[list(p) for p in sorted(new)],
+ 'new_crossing_centers':[actual[list(after.polygons[a].vertices)+list(after.polygons[b].vertices)].mean(0).tolist() for a,b in sorted(new)],
+ 'limits':'Local face patch, millimetre-scale segment/triangle tests; inherited crossings retained, tangencies and coplanar overlaps not certified.'}
+ report['levels'][str(level)]=result
+ if new or not gate['pass']:failed.append(level)
+ bpy.data.objects.remove(snapshot,do_unlink=True);bpy.data.meshes.remove(after);bpy.data.meshes.remove(before)
+ print('LEVEL_AUDIT '+json.dumps({'level':level,'faces':result['faces'],'source_crossings':len(bc),'current_crossings':len(ac),'new_crossings':len(new),'render_gate':gate['pass']}),flush=True)
+report['checks_passed']=not failed
+report['key_values']=enabled_values
+report['status']='passed_local_geometry_checks' if not failed else 'needs_revision_contact_pairs_remain'
+(ROOT/'review/verification.json').write_text(json.dumps(report,indent=2))
+if '--report-only' not in sys.argv:
+ assert not failed,'New intersections or a render gate error require correction: '+str(failed)
+print('V7_AUDIT_COMPLETE',flush=True)
diff --git a/art/characters/qinglan/face-study-v7/scripts/compose_review.py b/art/characters/qinglan/face-study-v7/scripts/compose_review.py
new file mode 100644
index 000000000..b7e793373
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/compose_review.py
@@ -0,0 +1,65 @@
+"""Technical comparison of unchanged source images and Blender renders."""
+from pathlib import Path
+import numpy as np
+import matplotlib
+matplotlib.use('Agg')
+import matplotlib.pyplot as plt
+from matplotlib.font_manager import FontProperties
+from PIL import Image
+import json
+ROOT=Path(__file__).resolve().parents[1]
+REF=ROOT.parent/'references/qinglan-face-target.png'
+font=FontProperties(fname='C:/Windows/Fonts/msyh.ttc')
+ref=np.array(Image.open(REF).convert('RGB'))[:828,:592]
+v6=np.array(Image.open(ROOT.parent/'face-study-v6/review/after-front.png').convert('RGB'))
+model=np.array(Image.open(ROOT/'review/after-front.png').convert('RGB'))
+anchors=[((203.5,364.5),(377.5,364.5)),((214.5,347.0),(385.5,347.0)),((214.5,347.0),(385.5,347.0))]
+projection=json.loads((ROOT/'review/projected-pupils.json').read_text())
+anchors[2]=(projection['Review_front']['R'],projection['Review_front']['L'])
+def place(ax,im,pts,alpha=1):
+ (x1,y1),(x2,y2)=pts;d=x2-x1;cx=(x1+x2)/2;cy=(y1+y2)/2
+ h,w=im.shape[:2];ax.imshow(im,extent=(-cx/d,(w-cx)/d,(h-cy)/d,-cy/d),alpha=alpha)
+ ax.set_xlim(-1.25,1.25);ax.set_ylim(1.80,-.50);ax.axis('off')
+fig,axes=plt.subplots(1,4,figsize=(16,6.5),dpi=120,facecolor='#edf0f3')
+for ax,im,pts,title in zip(axes,(ref,v6,model),anchors,('设计稿','上一版 V6','控制网格调整 V7')):
+ place(ax,im,pts);ax.set_title(title,fontproperties=font,fontsize=15)
+ ax.axhline(0,color='#35c5e6',lw=.8);ax.axvline(0,color='white',alpha=.3,lw=.5)
+place(axes[3],ref,anchors[0]);place(axes[3],model,anchors[2],.40)
+axes[3].set_title('设计稿 / V7 叠加',fontproperties=font,fontsize=15)
+fig.suptitle('青岚 · 脸部比例检查',fontproperties=font,fontsize=20,y=.97)
+fig.text(.5,.03,'统一瞳距与眼线;手动近似锚点。参考未标定,叠加用于发现比例问题,不能作为精确重建证明。',fontproperties=font,ha='center',fontsize=10)
+fig.subplots_adjust(left=.01,right=.99,top=.90,bottom=.08,wspace=.03)
+fig.savefig(ROOT/'review/reference-overlay.png');plt.close(fig)
+fig,axes=plt.subplots(1,3,figsize=(12,6),dpi=130,facecolor='#edf0f3')
+for ax,name in zip(axes,('front','threequarter','profile')):
+ ax.imshow(plt.imread(ROOT/'review'/f'after-{name}.png'));ax.axis('off');ax.set_title(name,fontsize=12)
+fig.suptitle('QINGLAN | V7 CONTROL-CAGE STUDY',fontsize=17,y=.98)
+fig.text(.5,.025,'Editable proportions and brow proxies. Facial identity remains under review.',ha='center',fontsize=10)
+fig.subplots_adjust(left=.02,right=.98,top=.89,bottom=.065,wspace=.02)
+fig.savefig(ROOT/'review/face-review.png');plt.close(fig)
+
+sheet=np.array(Image.open(REF).convert('RGB'))
+fig,axes=plt.subplots(2,3,figsize=(12,9),dpi=140,facecolor='#edf0f3')
+for col,name in enumerate(('front','profile','threequarter')):
+ crop=sheet[:828,[0,592,1182][col]:[592,1182,1774][col]]
+ render=np.array(Image.open(ROOT/'review'/f'reference-camera-{name}.png').convert('RGB'))
+ if name=='profile':
+ # Approximate visual eye/chin anchors; the reference camera is unknown.
+ transforms=[(461,362,(634-362)/1.6),(projection['Reference_profile']['R'][0],projection['Reference_profile']['R'][1],(606-projection['Reference_profile']['R'][1])/1.6)]
+ limits=(-1.65,.67)
+ else:
+ refpts=anchors[0] if name=='front' else ((101,366),(257,361))
+ modpts=(projection['Reference_'+name]['R'],projection['Reference_'+name]['L'])
+ transforms=[((a[0]+b[0])/2,(a[1]+b[1])/2,b[0]-a[0]) for a,b in (refpts,modpts)]
+ limits=(-1.23,1.23) if name=='front' else (-1.10,1.60)
+ for row,(im,(cx,cy,d)) in enumerate(zip((crop,render),transforms)):
+ ax=axes[row,col];h,w=im.shape[:2]
+ ax.imshow(im,extent=(-cx/d,(w-cx)/d,(h-cy)/d,-cy/d))
+ ax.set_xlim(*limits);ax.set_ylim(1.85,-.60);ax.axis('off')
+ ax.axhline(0,color='#35c5e6',lw=.6,alpha=.6)
+ ax.set_title(('设计稿' if row==0 else 'V7 透视检查')+' · '+name,fontproperties=font,fontsize=12)
+fig.suptitle('青岚 · 多角度身份检查',fontproperties=font,fontsize=19,y=.985)
+fig.text(.5,.022,'90 mm 透视;侧面约 72°、三分之四约 25°。人工近似对齐,镜头未标定;保留灰模差异供继续修改。',fontproperties=font,ha='center',fontsize=10)
+fig.subplots_adjust(left=.025,right=.975,top=.90,bottom=.065,hspace=.16,wspace=.05)
+fig.savefig(ROOT/'review/reference-multiview.png');plt.close(fig)
+print('COMPARISONS_READY')
diff --git a/art/characters/qinglan/face-study-v7/scripts/fair_cheeks.py b/art/characters/qinglan/face-study-v7/scripts/fair_cheeks.py
new file mode 100644
index 000000000..9c787d0ad
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/fair_cheeks.py
@@ -0,0 +1,34 @@
+"""Fair the broad cheek plane without changing the matched front contour."""
+import bpy,sys,json
+import numpy as np
+from pathlib import Path
+from mathutils import Vector
+from mathutils.bvhtree import BVHTree
+ROOT=Path(__file__).resolve().parents[1]
+sys.path.append(str(ROOT/'scripts'))
+import identity_cage as I
+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))
+head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks
+multi=next(m for m in head.modifiers if m.type=='MULTIRES');multi.levels=0
+name='V7_11_Cheek_Plane_Fairing'
+if name in keys:keys[name].value=0
+for rejected in ('V7_09_Upper_Lip','V7_10_Oral_Contact'):
+ if rejected in keys:keys[rejected].value=0
+current=I.world_coords(head,I.mixed_coords(head,exclude_prefix='NONE'));new=current.copy()
+u=np.abs(current[:,0]);z=current[:,2];y=current[:,1]
+weight=I.band(u,.027,.038,.067,.082)*I.band(z,1.510,1.538,1.564,1.593)*I.smooth((-.045-y)/.035)
+tree=BVHTree.FromPolygons([Vector(p) for p in current],[list(p.vertices) for p in head.data.polygons])
+visible=np.zeros(len(current))
+for i in np.flatnonzero(weight>0):
+ hit,normal,index,distance=tree.ray_cast(Vector((current[i,0],-.4,current[i,2])),Vector((0,1,0)))
+ if hit is not None and current[i,1]-hit.y<.001:visible[i]=1
+# A smooth convex cheek envelope is an explicit volume guide, limited to
+# the externally visible cheek. It cannot move the oral cavity or eye return.
+target=-.04-.12*np.sqrt(np.maximum(1-(u/.074)**2,0))
+fill=np.minimum(np.maximum(y-target,0),.018)
+new[:,1]-=fill*weight*visible
+report=I.key_delta(head,name,current,new,{'target':'Fill the hollow cheek surface to a local convex envelope; matched X/Z contour held','depth_only':True,'internal_vertices_protected_by_front_visibility':True})
+(ROOT/'review/cheek-fairing.json').write_text(json.dumps(report,indent=2))
+multi.levels=1;bpy.context.view_layer.update()
+I.save_stage('05-cheek-planes');I.save_main()
+print('CHEEK_FAIRING_SAVED '+json.dumps(report),flush=True)
diff --git a/art/characters/qinglan/face-study-v7/scripts/finalize_candidate.py b/art/characters/qinglan/face-study-v7/scripts/finalize_candidate.py
new file mode 100644
index 000000000..354887b0f
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/finalize_candidate.py
@@ -0,0 +1,38 @@
+"""Keep the successful proportion edits; reject cheek patches and opened lips."""
+import bpy,sys,json,math
+from pathlib import Path
+from mathutils import Vector
+ROOT=Path(__file__).resolve().parents[1]
+sys.path.append(str(ROOT/'scripts'))
+import identity_cage as I
+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))
+head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks
+multi=next(m for m in head.modifiers if m.type=='MULTIRES');multi.levels=0
+for name in ('V7_05_Cheek_Transition','V7_09_Upper_Lip','V7_10_Oral_Contact','V7_11_Cheek_Plane_Fairing'):
+ if name in keys:keys[name].value=0;keys[name].mute=True
+keys['V7_03_Jaw_Chin_Taper'].value=.5
+multi.levels=2;bpy.context.view_layer.update();I.brow_proxies()
+multi.levels=1;multi.render_levels=2;multi.sculpt_levels=1
+head['art_status']='Proportion revision for reference review; facial identity not approved'
+head['rejected_edits']='Cheek envelope, broad cheek fill, extra upper-lip lift and forced lip opening are muted after visual review'
+head['editing_note']='Set Multires viewport level to 0 before scripted control-key changes; restore 1 after update'
+for ob in bpy.context.selected_objects:ob.select_set(False)
+head.hide_set(False);head.select_set(True);bpy.context.view_layer.objects.active=head
+head.active_shape_key_index=keys.find('V7_01_Mouth_Height')
+for screen in bpy.data.screens:
+ for area in screen.areas:
+ if area.type=='VIEW_3D':
+ space=area.spaces.active;space.clip_start=.001
+ space.region_3d.view_location=(0,-.055,1.585);space.region_3d.view_distance=.46
+ space.overlay.show_overlays=False
+scene=bpy.context.scene;scene.camera=bpy.data.objects['Review_threequarter']
+camera=bpy.data.objects['Reference_profile'];target=Vector((0,-.074,1.582));angle=math.radians(-72)
+camera.location=target+Vector((math.sin(angle),-math.cos(angle),0))*.86
+camera.rotation_euler=(target-camera.location).to_track_quat('-Z','Y').to_euler()
+camera_report=[]
+for ob in bpy.data.objects:
+ if ob.type=='CAMERA':camera_report.append({'name':ob.name,'type':ob.data.type,'lens_mm':ob.data.lens,'ortho_scale':ob.data.ortho_scale,'location':list(ob.location),'rotation_euler':list(ob.rotation_euler),'calibrated':False})
+(ROOT/'review/cameras.json').write_text(json.dumps(camera_report,indent=2))
+(ROOT/'review/accepted-key-values.json').write_text(json.dumps([{'name':k.name,'value':k.value,'muted':k.mute} for k in keys],indent=2))
+I.save_stage('06-reviewed-proportions');I.save_main()
+print('REVIEW_CANDIDATE_SAVED',flush=True)
diff --git a/art/characters/qinglan/face-study-v7/scripts/identity_cage.py b/art/characters/qinglan/face-study-v7/scripts/identity_cage.py
new file mode 100644
index 000000000..10ba47cfa
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/identity_cage.py
@@ -0,0 +1,257 @@
+"""Reference-led edits on the original face control cage in the live session.
+
+Each edit has compact anatomical bounds and its own relative shape key. The
+original topology and Multires grids stay intact; no global landmark warp.
+"""
+import bpy,json,sys
+import numpy as np
+from pathlib import Path
+from mathutils import Vector
+
+ROOT=Path(__file__).resolve().parents[1]
+OUT=ROOT.parents[3]/'output/qinglan/identity-v7'
+for path in (ROOT/'review',OUT):path.mkdir(parents=True,exist_ok=True)
+SKILLS=Path.home()/'.codex/skills'
+sys.path.append(str(SKILLS/'scenario-blender-expert/scripts'))
+import bx_gui as G
+
+def coords(data):
+ a=np.empty(len(data)*3,dtype=np.float64)
+ data.foreach_get('co',a)
+ return a.reshape(-1,3)
+
+def smooth(t):
+ t=np.clip(t,0,1);return t*t*(3-2*t)
+
+def band(z,a,b,c,d):
+ return smooth((z-a)/(b-a))*smooth((d-z)/(d-c))
+
+def piecewise(x,xp,yp):
+ out=np.full_like(x,yp[0],dtype=float)
+ for i in range(len(xp)-1):
+ t=smooth((x-xp[i])/(xp[i+1]-xp[i]))
+ out+=(yp[i+1]-yp[i])*t
+ return out
+
+def world_coords(ob,co):
+ m=np.array(ob.matrix_world)
+ return co@m[:3,:3].T+m[:3,3]
+
+def local_coords(ob,co):
+ m=np.array(ob.matrix_world.inverted())
+ return co@m[:3,:3].T+m[:3,3]
+
+def mixed_coords(ob,exclude_prefix='V7_'):
+ keys=ob.data.shape_keys.key_blocks
+ base=coords(keys[0].data);out=base.copy()
+ for k in list(keys)[1:]:
+ if not k.name.startswith(exclude_prefix) and not k.mute:out+=(coords(k.data)-base)*k.value
+ return out
+
+def prepare():
+ assert bpy.data.filepath.endswith(('qinglan-live-face.blend','qinglan-identity-cage.blend'))
+ source=bpy.data.objects['Qinglan_Head_Multires']
+ head=bpy.data.objects.get('Qinglan_Identity_Cage')
+ if head is None:
+ head=source.copy();head.data=source.data.copy();head.name='Qinglan_Identity_Cage'
+ bpy.context.scene.collection.objects.link(head)
+ for name in ('Qinglan_Head_Multires','Qinglan_Live_Sculpt'):
+ ob=bpy.data.objects.get(name)
+ if ob:ob.hide_render=True;ob.hide_set(True)
+ head.hide_render=False;head.hide_set(False)
+ multi=next(m for m in head.modifiers if m.type=='MULTIRES')
+ multi.levels=1;multi.render_levels=2;multi.sculpt_levels=1
+ head['editing_stage']='Reference identity at control-cage resolution'
+ head['source']='V5 original quad topology and Multires, with all original keys retained'
+ head['protected_body']='All new shape-key deltas below world Z 1.47 m are zero'
+ for ob in bpy.context.selected_objects:ob.select_set(False)
+ head.select_set(True);bpy.context.view_layer.objects.active=head
+ G.set_view('FRONT')
+ w,a,r,v=G.view3d();v.view_location=(0,-.055,1.585);v.view_distance=.46;v.update()
+ a.spaces.active.overlay.show_overlays=False
+ return head
+
+def eye_field(p,outer=.0055,inner=-.0010,tilt=.0020):
+ out=p.copy();u=np.abs(p[:,0]);z=p[:,2]
+ wz=band(z,1.576,1.590,1.617,1.638)
+ # The inner orbital return has pre-existing touching faces. Keep that
+ # return fixed; only deform the visible lid and the forward globe surface.
+ front=smooth((-.116-p[:,1])/.012)
+ dx=piecewise(u,[0,.008,.020,.0329,.045,.074],[0,0,inner,0,outer,0])
+ out[:,0]+=np.sign(p[:,0])*dx*wz*front
+ orbital=band(u,.010,.020,.050,.069)*front
+ tilt_weight=band(z,1.582,1.591,1.614,1.631)
+ out[:,2]+=tilt*np.clip((u-.0329)/.018,-1,1)*orbital*tilt_weight
+ upper=band(z,1.601,1.607,1.611,1.630)
+ lower=band(z,1.579,1.592,1.598,1.602)
+ mid=band(u,.014,.026,.040,.058)*front
+ out[:,2]+=(-.0011*upper+.00045*lower)*mid
+ return out
+
+def key_delta(ob,name,current,new,stage):
+ keys=ob.data.shape_keys.key_blocks;base=coords(keys[0].data)
+ delta=local_coords(ob,new)-local_coords(ob,current)
+ key=keys.get(name) or ob.shape_key_add(name=name)
+ key.data.foreach_set('co',(base+delta).astype(np.float32).ravel())
+ key.value=0;key.value=1;ob.data.update()
+ length=np.linalg.norm(new-current,axis=1)
+ assert np.max(length[current[:,2]<1.47],initial=0)==0
+ stage.update({'key':name,'moved_control_vertices':int((length>1e-8).sum()),
+ 'max_displacement_mm':float(length.max()*1000),'protected_body_delta_m':0})
+ return stage
+
+def secondary_volume(cheek_fill=.006,jaw_relax=.35):
+ head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks
+ names=('V7_05_Cheek_Transition','V7_06_Chin_Roundness')
+ for name in names:
+ if name in keys:keys[name].value=0
+ current=world_coords(head,mixed_coords(head,exclude_prefix='NONE'));new=current.copy()
+ u=np.abs(current[:,0]);z=current[:,2];y=current[:,1]
+ # Restore the soft tissue beneath the zygoma after the silhouette taper.
+ # Compact support excludes the lips, eyelids, ear canal and neck.
+ weight=band(u,.026,.043,.062,.082)*band(z,1.505,1.537,1.555,1.584)*smooth((-.025-y)/.050)
+ new[:,1]-=cheek_fill*weight
+ # Local fairing of cheek depth. X and Z remain the approved proportions.
+ edges=np.array([e.vertices[:] for e in head.data.edges]);a=edges[:,0];b=edges[:,1]
+ degree=np.bincount(edges.ravel(),minlength=len(current))
+ for _ in range(6):
+ sums=np.bincount(a,weights=new[b,1],minlength=len(current))+np.bincount(b,weights=new[a,1],minlength=len(current))
+ mean=sums/np.maximum(degree,1)
+ new[:,1]+=(mean-new[:,1])*weight*jaw_relax
+ reports=[key_delta(head,names[0],current,new,{'target':'Restore cheek fullness and fair cheek-to-jaw depth','cheek_fill_m':cheek_fill,'relax_iterations':6})]
+ current=new;new=current.copy();u=np.abs(current[:,0]);z=current[:,2]
+ w=band(z,1.472,1.488,1.505,1.525)*smooth((-.025-current[:,1])/.050)
+ w*=1-smooth((u-.028)/.025)
+ new[:,2]+=.0032*np.clip(u/.030,0,1)**2*w
+ reports.append(key_delta(head,names[1],current,new,{'target':'Round the blunt chin edge while holding the central chin anchor'}))
+ bpy.context.view_layer.update()
+ (ROOT/'review/secondary-edits.json').write_text(json.dumps(reports,indent=2))
+ print(json.dumps(reports))
+
+def rebuild(mouth_lift=.0085,mouth_width=.90,outer_eye=.0055,inner_eye=-.0010,eye_tilt=.0020,jaw_strength=1.0):
+ head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks
+ next(m for m in head.modifiers if m.type=='MULTIRES').levels=0
+ for k in keys:
+ if k.name.startswith('V7_'):k.value=0
+ current=world_coords(head,mixed_coords(head));stages=[]
+ # Nose base and chin are stationary anchors. The whole mouth region,
+ # including its internal seam, follows a smooth monotonic vertical field.
+ new=current.copy();z=current[:,2];u=np.abs(current[:,0])
+ w=band(z,1.489,1.520,1.535,1.556)
+ w*=smooth((-.035-current[:,1])/.035)*(1-smooth((u-.045)/.030))
+ new[:,2]+=mouth_lift*w
+ stages.append(key_delta(head,'V7_01_Mouth_Height',current,new,{'target':'Raise oral region toward reference lip-line height','target_lift_m':mouth_lift}))
+ current=new
+ new=current.copy();u=np.abs(current[:,0]);z=current[:,2]
+ w=band(z,1.511,1.528,1.544,1.563)*smooth((-.055-current[:,1])/.035)
+ w*=1-smooth((u-.030)/.024)
+ new[:,0]*=1-(1-mouth_width)*w
+ stages.append(key_delta(head,'V7_02_Mouth_Width',current,new,{'target':'Compact lip outline','central_width_scale':mouth_width}))
+ current=new
+ # Taper jaw outside the oral rings; avoid multiplying the mouth-width edit.
+ new=current.copy();u=np.abs(current[:,0]);z=current[:,2]
+ amount=piecewise(z,[1.474,1.490,1.508,1.536,1.555,1.576,1.602],[0,.10,.17,.16,.10,.035,0])*jaw_strength
+ outer=smooth((u-.026)/.023)
+ chin=1-smooth((z-1.510)/.016)
+ shape=np.maximum(outer,chin)
+ front=smooth((.015-current[:,1])/.035)
+ new[:,0]*=1-amount*shape*front
+ stages.append(key_delta(head,'V7_03_Jaw_Chin_Taper',current,new,{'target':'Oval lower-face contour; oral rings protected from jaw taper','strength':jaw_strength}))
+ current=new
+ new=eye_field(current,outer=outer_eye,inner=inner_eye,tilt=eye_tilt)
+ stages.append(key_delta(head,'V7_04_Orbital_Proportion',current,new,{'target':'Wider almond-shaped aperture with coordinated lid tilt','outer_canthal_target_m':outer_eye,'inner_canthal_target_m':inner_eye,'tilt_m':eye_tilt}))
+ head.active_shape_key_index=len(keys)-1
+ bpy.context.view_layer.update()
+ (ROOT/'review/control-edits.json').write_text(json.dumps(stages,indent=2))
+ print(json.dumps({'stages':stages,'total_control_vertices':len(current)}))
+
+def fit_globes(outer_eye=.0055,inner_eye=-.0010,eye_tilt=.0020):
+ report=[]
+ for side in ('L','R'):
+ ob=bpy.data.objects['GEO-body_female_realistic.eye.'+side]
+ keys=ob.data.shape_keys.key_blocks
+ for k in keys:
+ if k.name.startswith('V7_'):k.value=0
+ old_local=mixed_coords(ob);old=world_coords(ob,old_local);new=eye_field(old,outer=outer_eye,inner=inner_eye,tilt=eye_tilt)
+ key=keys.get('V7_Orbital_Fit') or ob.shape_key_add(name='V7_Orbital_Fit')
+ key.data.foreach_set('co',(coords(keys[0].data)+local_coords(ob,new)-old_local).astype(np.float32).ravel())
+ key.value=0;key.value=1;ob.data.update()
+ report.append({'side':side,'method':'Same spatial deformation as orbital control region','max_delta_mm':float(np.linalg.norm(new-old,axis=1).max()*1000)})
+ bpy.context.view_layer.update()
+ (ROOT/'review/globe-fit.json').write_text(json.dumps(report,indent=2))
+ print(json.dumps(report))
+
+def fit_irises(iris_radius=.0066,pupil_radius=.0017):
+ report=[]
+ bpy.context.view_layer.update();dg=bpy.context.evaluated_depsgraph_get()
+ for side in ('L','R'):
+ globe=bpy.data.objects['GEO-body_female_realistic.eye.'+side]
+ ev=globe.evaluated_get(dg);inv=globe.matrix_world.inverted()
+ for prefix,radius,offset in (('Iris_',iris_radius,.00006),('Pupil_',pupil_radius,.00012)):
+ ob=bpy.data.objects[prefix+side];keys=ob.data.shape_keys.key_blocks
+ for k in keys:
+ if k.name.startswith('V7_'):k.value=0
+ old_local=mixed_coords(ob);old=world_coords(ob,old_local)
+ center=old[0].copy();xz=old[:,[0,2]]-center[[0,2]]
+ old_radius=np.linalg.norm(xz,axis=1).max()
+ xz*=radius/old_radius
+ target=old.copy();target[:,[0,2]]=xz+center[[0,2]]
+ for i,p in enumerate(target):
+ origin=inv@Vector((p[0],-.4,p[2]))
+ direction=(inv.to_3x3()@Vector((0,1,0))).normalized()
+ hit,q,n,index=ev.ray_cast(origin,direction)
+ if not hit:raise RuntimeError('Iris projection missed eye globe')
+ target[i,1]=(globe.matrix_world@q).y-offset
+ key=keys.get('V7_Iris_Fit') or ob.shape_key_add(name='V7_Iris_Fit')
+ key.data.foreach_set('co',(coords(keys[0].data)+local_coords(ob,target)-old_local).astype(np.float32).ravel())
+ key.value=1;ob.data.update()
+ report.append({'object':ob.name,'radius_m':radius,'surface_offset_m':offset,'ray_misses':0})
+ bpy.context.view_layer.update()
+ (ROOT/'review/iris-fit.json').write_text(json.dumps(report,indent=2))
+ print(json.dumps(report))
+
+def brow_proxies():
+ head=bpy.data.objects['Qinglan_Identity_Cage']
+ bpy.context.view_layer.update();dg=bpy.context.evaluated_depsgraph_get();ev=head.evaluated_get(dg)
+ inv=head.matrix_world.inverted()
+ mat=bpy.data.materials.get('Qinglan_Brow_Blockout') or bpy.data.materials.new('Qinglan_Brow_Blockout')
+ mat.diffuse_color=(.045,.034,.027,1);mat.use_nodes=True
+ bs=next((n for n in mat.node_tree.nodes if n.type=='BSDF_PRINCIPLED'),None)
+ if bs is None:
+ bs=mat.node_tree.nodes.new('ShaderNodeBsdfPrincipled')
+ output=next((n for n in mat.node_tree.nodes if n.type=='OUTPUT_MATERIAL'),None) or mat.node_tree.nodes.new('ShaderNodeOutputMaterial')
+ mat.node_tree.links.new(bs.outputs['BSDF'],output.inputs['Surface'])
+ bs.inputs['Base Color'].default_value=(.045,.034,.027,1);bs.inputs['Roughness'].default_value=.75
+ controls=np.array([[.0135,1.6140,.0011],[.025,1.6188,.0019],[.039,1.6203,.0020],[.050,1.6187,.0013],[.057,1.6157,.00008]])
+ slopes=np.gradient(controls[:,1:],controls[:,0],axis=0)
+ for side in (-1,1):
+ name='Qinglan_Brow_Proxy_'+('L' if side>0 else 'R')
+ old=bpy.data.objects.get(name)
+ if old:bpy.data.objects.remove(old,do_unlink=True)
+ verts=[];faces=[]
+ for i in range(65):
+ x=controls[0,0]+i/64*(controls[-1,0]-controls[0,0])
+ seg=min(max(np.searchsorted(controls[:,0],x)-1,0),len(controls)-2)
+ dx=controls[seg+1,0]-controls[seg,0];t=(x-controls[seg,0])/dx
+ z,width=(2*t**3-3*t*t+1)*controls[seg,1:]+(t**3-2*t*t+t)*dx*slopes[seg]+(-2*t**3+3*t*t)*controls[seg+1,1:]+(t**3-t*t)*dx*slopes[seg+1]
+ for j in range(5):
+ zz=z+(j/4*2-1)*width
+ origin=inv@Vector((side*x,-.4,zz));direction=(inv.to_3x3()@Vector((0,1,0))).normalized()
+ hit,p,n,index=ev.ray_cast(origin,direction)
+ if not hit:raise RuntimeError('Brow ray missed the face')
+ q=head.matrix_world@p;q.y-=.00022;verts.append(q)
+ for i in range(64):
+ for j in range(4):
+ a=i*5+j;face=(a,a+5,a+6,a+1);faces.append(face if side>0 else tuple(reversed(face)))
+ mesh=bpy.data.meshes.new(name);mesh.from_pydata(verts,[],faces);mesh.materials.append(mat);mesh.update()
+ ob=bpy.data.objects.new(name,mesh);bpy.context.scene.collection.objects.link(ob)
+ ob['purpose']='Temporary brow silhouette for identity review, not final hair'
+ for p in mesh.polygons:p.use_smooth=True
+ print('BROW_PROXIES_READY')
+
+def save_stage(label):
+ bpy.ops.wm.save_as_mainfile(filepath=str(OUT/(label+'.blend')),copy=True,compress=True)
+
+def save_main():
+ bpy.ops.wm.save_as_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'),compress=True)
+
diff --git a/art/characters/qinglan/face-study-v7/scripts/package_review.py b/art/characters/qinglan/face-study-v7/scripts/package_review.py
new file mode 100644
index 000000000..60b66280f
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/package_review.py
@@ -0,0 +1,39 @@
+"""Record final provenance and the actual review status, including failed gates."""
+import json,hashlib
+from pathlib import Path
+ROOT=Path(__file__).resolve().parents[1]
+source=json.loads((ROOT.parent/'face-study-v5/provenance.json').read_text(encoding='utf-8'))
+verification=json.loads((ROOT/'review/verification.json').read_text())
+keys=json.loads((ROOT/'review/accepted-key-values.json').read_text())
+sha=lambda p:hashlib.sha256(p.read_bytes()).hexdigest()
+provenance={
+ 'asset':'Qinglan V7 reference-led control-cage proportion study',
+ 'status':'editable_review_candidate_not_art_or_production_approved',
+ 'created':'2026-10-29',
+ 'source':source['source'],
+ 'parent_file':'../face-study-v5/qinglan-face-candidate.blend',
+ 'parent_sha256':sha(ROOT.parent/'face-study-v5/qinglan-face-candidate.blend'),
+ 'current_file':'qinglan-identity-cage.blend','current_sha256':sha(ROOT/'qinglan-identity-cage.blend'),
+ 'reference':{'file':'../references/qinglan-face-target.png','sha256':sha(ROOT.parent/'references/qinglan-face-target.png'),'calibrated':False},
+ 'workflow':{'blender':'5.2.1 LTS','skill_revision':'d44410f058991f677ccf733a8e86ce95110857eb',
+ 'skills':['scenario-blender-expert','scenario-blender-sculpting','scenario-blender-retopology','estella-character-production'],
+ 'execution':'Initial control edits over the live Blender MCP connection; after a Blender process crash, recovered from a stage copy and continued through headless CLI. No computer use, no newly launched GUI, no paid add-on activation.',
+ 'native_brushes_this_version':False,'comparison_images':'Unaltered reference/render pixels arranged with Matplotlib; approximate eye/eye-chin alignment.'},
+ 'final_keys':keys,
+ 'limits':['Facial identity needs further work','Strict new-crossing-pair check fails at Multires level 2','Internal source contacts and neck attachment unfinished','No rig, expression, UV, runtime export or Estella acceptance']}
+(ROOT/'provenance.json').write_text(json.dumps(provenance,ensure_ascii=False,indent=2),encoding='utf-8')
+review={'status':'needs_revision','stage':'Primary facial proportion comparison complete; head-identity gate remains open',
+ 'accepted_changes':['Mouth region raised toward the front reference','Reduced mouth width','Moderate jaw taper and rounded chin edge','Extended eye aperture with coordinated globe/iris changes','Raised and shortened source ears','Brow silhouette proxies'],
+ 'rejected_changes':['Broad cheek fill and constrained cheek envelope produced undesirable transitions','Extra upper-lip lift and forced lip-shell separation changed the intended closed-mouth expression'],
+ 'remaining_art_issues':['Cheekbone-to-jaw transition remains too angular','Lids and orbital mass remain too heavy for the reference','Nose/lip surface planes and chin still carry the base-mesh identity','Brows are simple proxies; no final hairline, lashes or groom'],
+ 'technical':{'render_structure_gate':True,'strict_contact_check':verification['checks_passed'],
+ 'cage_source_crossings':verification['levels']['0']['source_confirmed_crossings'],
+ 'cage_new_crossings':verification['levels']['0']['new_confirmed_crossings'],
+ 'level2_source_crossings':verification['levels']['2']['source_confirmed_crossings'],
+ 'level2_current_crossings':verification['levels']['2']['current_confirmed_crossings'],
+ 'level2_new_pairs':verification['levels']['2']['new_confirmed_crossings']},
+ 'reviewed_views':['after-front.png','after-profile.png','after-threequarter.png','after-low.png','reference-camera-front.png','reference-camera-profile.png','reference-camera-threequarter.png','cage-front.png','cage-threequarter.png','reference-overlay.png','reference-multiview.png'],
+ 'next_work':'Remain at the head-identity gate. Correct cheek planes and lid thickness in small local areas, compare fixed renders, and clean the lip contact topology before production export.'}
+(ROOT/'review/art-review.json').write_text(json.dumps(review,ensure_ascii=False,indent=2),encoding='utf-8')
+for path in (ROOT/'review').glob('*.json'):json.loads(path.read_text(encoding='utf-8'))
+print(json.dumps({'blend_bytes':(ROOT/'qinglan-identity-cage.blend').stat().st_size,'status':review['status'],'strict_contact_check':review['technical']['strict_contact_check']}))
diff --git a/art/characters/qinglan/face-study-v7/scripts/preview_subdivision.py b/art/characters/qinglan/face-study-v7/scripts/preview_subdivision.py
new file mode 100644
index 000000000..5ef63aafb
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/preview_subdivision.py
@@ -0,0 +1,21 @@
+"""Compare the control surface with inherited sculpt displacement, without overwriting it."""
+import bpy,sys,json
+from pathlib import Path
+ROOT=Path(__file__).resolve().parents[1]
+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))
+head=bpy.data.objects['Qinglan_Identity_Cage']
+head.data.shape_keys.key_blocks['V7_10_Oral_Contact'].value=0
+head.hide_set(False);bpy.context.view_layer.objects.active=head;head.select_set(True)
+multi=next(m for m in head.modifiers if m.type=='MULTIRES')
+multi.show_viewport=False;multi.show_render=False
+sub=head.modifiers.new('Control_Surface_Subdivision','SUBSURF');sub.levels=2;sub.render_levels=2
+bpy.ops.object.modifier_move_to_index(modifier=sub.name,index=0)
+scene=bpy.context.scene;scene.render.engine='CYCLES';scene.cycles.samples=24
+prefs=bpy.context.preferences.addons['cycles'].preferences;prefs.compute_device_type='OPTIX';prefs.get_devices()
+for d in prefs.devices:d.use=d.type=='OPTIX'
+scene.cycles.device='GPU'
+out=ROOT.parents[3]/'output/qinglan/identity-v7'
+for name in ('front','threequarter','profile'):
+ scene.camera=bpy.data.objects['Review_'+name];scene.render.filepath=str(out/f'subdivision-{name}.png');bpy.ops.render.render(write_still=True)
+bpy.ops.wm.save_as_mainfile(filepath=str(out/'control-surface-preview.blend'),copy=True,compress=True)
+print('CONTROL_SURFACE_PREVIEW_COMPLETE',flush=True)
diff --git a/art/characters/qinglan/face-study-v7/scripts/protect_contacts.py b/art/characters/qinglan/face-study-v7/scripts/protect_contacts.py
new file mode 100644
index 000000000..5269fce12
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/protect_contacts.py
@@ -0,0 +1,59 @@
+"""Protect the deep orbital return and separate contacting lip shells by flow."""
+import bpy,sys,json,heapq
+import numpy as np
+from pathlib import Path
+ROOT=Path(__file__).resolve().parents[1]
+sys.path.append(str(ROOT/'scripts'))
+import identity_cage as I
+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))
+head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks
+multi=next(m for m in head.modifiers if m.type=='MULTIRES')
+multi.levels=0
+bpy.context.view_layer.update()
+print('CONTACT_START',flush=True)
+if 'V7_10_Oral_Contact' in keys:keys['V7_10_Oral_Contact'].value=0
+keys['V7_04_Orbital_Proportion'].value=0
+current=I.world_coords(head,I.mixed_coords(head,exclude_prefix='NONE'))
+new=I.eye_field(current)
+eye_report=I.key_delta(head,'V7_04_Orbital_Proportion',current,new,{'target':'Visible lid edits with fixed deep orbital return'})
+print('ORBITAL_KEY_UPDATED',flush=True)
+I.fit_globes();I.fit_irises()
+print('EYEBALLS_UPDATED',flush=True)
+source=I.world_coords(head,I.mixed_coords(head))
+edges=np.array([e.vertices[:] for e in head.data.edges]);neighbors=[[] for _ in source]
+for a,b in edges:
+ length=float(np.linalg.norm(source[a]-source[b]));neighbors[a].append((int(b),length));neighbors[b].append((int(a),length))
+u=np.abs(source[:,0]);z=source[:,2];y=source[:,1]
+def distances(seed):
+ d=np.full(len(source),np.inf);heap=[]
+ for i in np.flatnonzero(seed):d[i]=0;heapq.heappush(heap,(0,int(i)))
+ while heap:
+ v,i=heapq.heappop(heap)
+ if v>d[i]:continue
+ for j,length in neighbors[i]:
+ candidate=v+length
+ if candidate<d[j]:d[j]=candidate;heapq.heappush(heap,(candidate,j))
+ return d
+upper=distances((u<.020)&(z>1.532)&(z<1.540)&(y<-.137))
+lower=distances((u<.020)&(z>1.514)&(z<1.523)&(y<-.137))
+assert np.isfinite(upper).any() and np.isfinite(lower).any()
+current=I.world_coords(head,I.mixed_coords(head,exclude_prefix='NONE'));new=current.copy()
+weight=I.band(z,1.514,1.524,1.531,1.543)*(1-I.smooth((u-.024)/.014))*I.smooth((-.114-y)/.020)
+weight*=np.isfinite(upper)&np.isfinite(lower)
+sign=np.where(upper<lower,1,-1)
+new[:,2]+=.0011*sign*weight
+oral_report=I.key_delta(head,'V7_10_Oral_Contact',current,new,{'target':'Separate upper/lower lip shells using geodesic surface labels','separation_each_side_m':.0011})
+(ROOT/'review/contact-protection.json').write_text(json.dumps({'orbital':eye_report,'oral':oral_report},indent=2))
+# Match the framing of the fixed inspection images. Lens remains at 90 mm.
+from mathutils import Vector
+for ob in bpy.data.objects:
+ if ob.name.startswith('Reference_') and ob.type=='CAMERA':
+ target=Vector((0,-.048,1.582));ob.location=target+(ob.location-target).normalized()*.79
+multi.levels=2
+bpy.context.view_layer.update()
+I.brow_proxies()
+multi.levels=1
+for item in (cameras:=json.loads((ROOT/'review/cameras.json').read_text())):item['distance_m']=.79
+(ROOT/'review/cameras.json').write_text(json.dumps(cameras,indent=2))
+I.save_stage('04-contact-protection');I.save_main()
+print('CONTACT_PROTECTION_SAVED',flush=True)
diff --git a/art/characters/qinglan/face-study-v7/scripts/rebuild_primary.py b/art/characters/qinglan/face-study-v7/scripts/rebuild_primary.py
new file mode 100644
index 000000000..b534036ca
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/rebuild_primary.py
@@ -0,0 +1,12 @@
+"""Refine the mouth field as a rigid oral band, preserving the lip structure."""
+import bpy,sys
+from pathlib import Path
+ROOT=Path(__file__).resolve().parents[1]
+sys.path.append(str(ROOT/'scripts'))
+import identity_cage as I
+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))
+I.rebuild(jaw_strength=.65)
+I.secondary_volume(cheek_fill=.006)
+I.fit_globes();I.fit_irises()
+I.save_main()
+print('PRIMARY_FIELD_REBUILT',flush=True)
diff --git a/art/characters/qinglan/face-study-v7/scripts/recover_stage.py b/art/characters/qinglan/face-study-v7/scripts/recover_stage.py
new file mode 100644
index 000000000..1e0090a49
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/recover_stage.py
@@ -0,0 +1,22 @@
+"""Validate and recover the last stage copy after a lost live session."""
+import bpy,sys,json
+from pathlib import Path
+ROOT=Path(__file__).resolve().parents[1]
+sys.path.append(str(ROOT/'scripts'))
+import identity_cage as I
+source=I.OUT/'02-cheek-continuity.blend'
+bpy.ops.wm.open_mainfile(filepath=str(source))
+head=bpy.data.objects['Qinglan_Identity_Cage']
+keys=[(k.name,k.value) for k in head.data.shape_keys.key_blocks if k.name.startswith('V7_')]
+assert len(keys)==6 and all(v==1 for _,v in keys)
+assert all(bpy.data.objects.get('Qinglan_Brow_Proxy_'+side) for side in ('L','R'))
+print('RECOVERED_STATE '+json.dumps(keys),flush=True)
+# V5/V6 remain in their original files. Drop only redundant hidden objects
+# from this candidate, reducing the saved dependency graph and file size.
+for name in ('Qinglan_Head_Multires','Qinglan_Live_Sculpt','Inspection_Cage','Inspection_High'):
+ ob=bpy.data.objects.get(name)
+ if ob and ob.hide_render:
+ mesh=ob.data;bpy.data.objects.remove(ob,do_unlink=True)
+ if mesh.users==0:bpy.data.meshes.remove(mesh)
+I.save_main()
+print('RECOVERY_SAVED',flush=True)
diff --git a/art/characters/qinglan/face-study-v7/scripts/refine_saved.py b/art/characters/qinglan/face-study-v7/scripts/refine_saved.py
new file mode 100644
index 000000000..206b468fb
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/refine_saved.py
@@ -0,0 +1,53 @@
+"""Continue reversible control-mesh work on the recovered saved candidate."""
+import bpy,sys,json,math
+import numpy as np
+from pathlib import Path
+from mathutils import Vector
+ROOT=Path(__file__).resolve().parents[1]
+sys.path.append(str(ROOT/'scripts'))
+import identity_cage as I
+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))
+head=bpy.data.objects['Qinglan_Identity_Cage'];keys=head.data.shape_keys.key_blocks
+next(m for m in head.modifiers if m.type=='MULTIRES').levels=0
+for name in ('V7_07_Ear_Proportion','V7_08_Nose_Profile','V7_09_Upper_Lip'):
+ if name in keys:keys[name].value=0
+reports=[]
+current=I.world_coords(head,I.mixed_coords(head,exclude_prefix='NONE'))
+new=current.copy();x=np.abs(current[:,0]);z=current[:,2];y=current[:,1]
+# Ears in the reference sit above the nasal base; the source ears are low.
+weight=I.smooth((x-.062)/.016)*I.band(z,1.505,1.535,1.610,1.636)*I.smooth((y+.085)/.030)
+new[:,2]+=(.010-.16*(z-1.574))*weight
+new[:,0]-=np.sign(current[:,0])*.0015*weight
+reports.append(I.key_delta(head,'V7_07_Ear_Proportion',current,new,{'target':'Raise and shorten low source ears to the reference eye/nose-base band'}))
+current=new;new=current.copy();x=np.abs(current[:,0]);z=current[:,2];y=current[:,1]
+# Reduce the sharply projecting source tip; the bridge stays anchored.
+w=(1-I.smooth((x-.008)/.013))*I.band(z,1.548,1.558,1.572,1.599)*I.smooth((-.145-y)/.012)
+new[:,1]+=.0032*w
+reports.append(I.key_delta(head,'V7_08_Nose_Profile',current,new,{'target':'Soften projecting nasal tip while preserving bridge and nostril topology'}))
+current=new;new=current.copy();x=np.abs(current[:,0]);z=current[:,2];y=current[:,1]
+# The raised oral region compressed the upper vermilion. Restore its height
+# without opening the mouth seam or shortening the philtrum further.
+w=I.band(z,1.5363,1.5395,1.5432,1.5518)*(1-I.smooth((x-.010)/.016))*I.smooth((-.129-y)/.012)
+new[:,2]+=.0023*w
+new[:,1]-=.0007*w
+reports.append(I.key_delta(head,'V7_09_Upper_Lip',current,new,{'target':'Restore upper-lip volume above the raised mouth seam'}))
+bpy.context.view_layer.update()
+(ROOT/'review/feature-edits.json').write_text(json.dumps(reports,indent=2))
+# Reference views are illustrations, not calibrated orthographic views.
+# These explicitly labelled long-lens estimates complement fixed ortho views.
+cameras=[]
+for name,yaw in [('Reference_front',0),('Reference_profile',-72),('Reference_threequarter',25)]:
+ ob=bpy.data.objects.get(name)
+ if ob is None:
+ data=bpy.data.cameras.new(name);ob=bpy.data.objects.new(name,data);bpy.context.scene.collection.objects.link(ob)
+ target=Vector((0,-.048,1.582));angle=math.radians(yaw)
+ ob.location=target+Vector((math.sin(angle),-math.cos(angle),0))*.79
+ ob.rotation_euler=(target-ob.location).to_track_quat('-Z','Y').to_euler()
+ ob.data.type='PERSP';ob.data.lens=90;ob.data.sensor_width=36
+ ob.data.clip_start=.001;ob.data.clip_end=20
+ ob['calibration']='Approximate yaw and long-lens perspective; reference metadata unavailable'
+ cameras.append({'name':name,'yaw_degrees':yaw,'focal_length_mm':90,'distance_m':.79,'calibrated':False})
+(ROOT/'review/cameras.json').write_text(json.dumps(cameras,indent=2))
+I.save_stage('03-features-and-reference-cameras')
+I.save_main()
+print('REFINEMENT_SAVED '+json.dumps(reports),flush=True)
diff --git a/art/characters/qinglan/face-study-v7/scripts/render_cage.py b/art/characters/qinglan/face-study-v7/scripts/render_cage.py
new file mode 100644
index 000000000..01c6251fe
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/render_cage.py
@@ -0,0 +1,34 @@
+"""Render real control edges, not a dense triangulated beauty surface."""
+import bpy,json,sys
+from pathlib import Path
+from bpy_extras.object_utils import world_to_camera_view
+from mathutils import Vector
+ROOT=Path(__file__).resolve().parents[1]
+sys.path.append(str(ROOT/'scripts'))
+import identity_cage as I
+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))
+head=bpy.data.objects['Qinglan_Identity_Cage'];scene=bpy.context.scene
+# Project actual pupil patch centers to support subsequent image overlays.
+landmarks={}
+for name in ('Review_front','Reference_front','Reference_profile','Reference_threequarter'):
+ camera=bpy.data.objects[name];points={}
+ for side in ('L','R'):
+ eye=bpy.data.objects['Iris_'+side];co=I.world_coords(eye,I.mixed_coords(eye,exclude_prefix='NONE'))[0]
+ p=world_to_camera_view(scene,camera,Vector(co));points[side]=[float(p.x*600),float((1-p.y)*800)]
+ landmarks[name]=points
+(ROOT/'review/projected-pupils.json').write_text(json.dumps(landmarks,indent=2))
+multi=next(m for m in head.modifiers if m.type=='MULTIRES');multi.levels=0;multi.render_levels=0
+mat=bpy.data.materials.new('Review_Control_Edges');mat.diffuse_color=(.012,.018,.022,1);mat.use_nodes=True
+bs=next((n for n in mat.node_tree.nodes if n.type=='BSDF_PRINCIPLED'),None)
+if bs is None:
+ bs=mat.node_tree.nodes.new('ShaderNodeBsdfPrincipled');out=mat.node_tree.nodes.new('ShaderNodeOutputMaterial');mat.node_tree.links.new(bs.outputs['BSDF'],out.inputs['Surface'])
+bs.inputs['Base Color'].default_value=(.012,.018,.022,1);bs.inputs['Roughness'].default_value=.7
+idx=len(head.data.materials);head.data.materials.append(mat)
+wire=head.modifiers.new('Review_Control_Edges','WIREFRAME');wire.thickness=.00012;wire.use_replace=False;wire.offset=1;wire.material_offset=idx
+scene.render.engine='CYCLES';scene.cycles.samples=24
+prefs=bpy.context.preferences.addons['cycles'].preferences;prefs.compute_device_type='OPTIX';prefs.get_devices()
+for d in prefs.devices:d.use=d.type=='OPTIX'
+scene.cycles.device='GPU'
+for name in ('front','threequarter'):
+ scene.camera=bpy.data.objects['Review_'+name];scene.render.filepath=str(ROOT/'review'/f'cage-{name}.png');bpy.ops.render.render(write_still=True)
+print('CONTROL_CAGE_RENDERED',flush=True)
diff --git a/art/characters/qinglan/face-study-v7/scripts/render_review.py b/art/characters/qinglan/face-study-v7/scripts/render_review.py
new file mode 100644
index 000000000..f07113d3c
--- /dev/null
+++ b/art/characters/qinglan/face-study-v7/scripts/render_review.py
@@ -0,0 +1,26 @@
+"""Render a saved control-cage candidate without changing the live session."""
+import bpy,sys,json
+from pathlib import Path
+from mathutils import Vector
+ROOT=Path(__file__).resolve().parents[1]
+bpy.ops.wm.open_mainfile(filepath=str(ROOT/'qinglan-identity-cage.blend'))
+scene=bpy.context.scene
+scene.render.engine='CYCLES';scene.cycles.samples=32
+prefs=bpy.context.preferences.addons['cycles'].preferences
+prefs.compute_device_type='OPTIX';prefs.get_devices()
+for device in prefs.devices:device.use=device.type=='OPTIX'
+scene.cycles.device='GPU'
+scene.render.resolution_x=600;scene.render.resolution_y=800
+scene.render.resolution_percentage=100
+names=('front','profile','threequarter','low')
+if '--front-only' in sys.argv:names=('front',)
+for name in names:
+ scene.camera=bpy.data.objects['Review_'+name]
+ scene.render.filepath=str(ROOT/'review'/f'after-{name}.png')
+ bpy.ops.render.render(write_still=True)
+if '--reference-views' in sys.argv:
+ for name in ('front','profile','threequarter'):
+ scene.camera=bpy.data.objects['Reference_'+name]
+ scene.render.filepath=str(ROOT/'review'/f'reference-camera-{name}.png')
+ bpy.ops.render.render(write_still=True)
+print('REVIEW_RENDER_COMPLETE '+json.dumps({'views':names}),flush=True)