第三阶段改进

docs/3-completion-stage.md

@@ -2,7 +2,9 @@
 
 ## 1. 阶段简介
 
-读取 SAM 可见 mask，为需要遮挡补全或关节延伸的部件准备局部画布，调用中转站图片编辑模型，再将允许区域内的新增像素与原可见像素合并。Python 几何处理固定使用 Conda `ai-spine`；图片生成在远端完成，本阶段不加载本地 SAM。
+读取 SAM 可见 mask，规划分割缺口修复、遮挡补全、关节延伸和附件底图清理，向图片模型提供部件与原图参考，再把结果映射回原图坐标。Python 几何处理固定使用 Conda `ai-spine`；图片生成在远端完成，本阶段不加载本地 SAM。
+
+默认 `--completion-profile adaptive` 使用实际 mask 重建需求、自适应半径和可逆缩放；`legacy` 保留旧画布与筛选规则，供旧候选复检。原 SAM 输入始终留档，只有保留区域锁定原像素；明确规划的编辑区域可以替换，人工确认的移除区域可删除。
 
 当前已实现准备、真实图片请求、离线候选导入、几何检查与透明补全部件输出。[第四阶段](4-spine-stage.md) 独立整合 SAM 与补全部件，输出完整角色组装、Spine 骨架和预览。几何通过仍为 `needs_review`，不能等同于部件可用。
 
@@ -14,18 +16,19 @@
 tools/model-check.mjs --stage completion --input-dir SAM目录
 → stages/completion-stage.mjs 校验计划、mask 文件、参数及 Conda
 → completion_geometry.py prepare
-   筛选需求 → 计算允许区域 → 建立局部画布与编辑 mask
+   adaptive：completion_planning.py 重建需求 → 区分保留/编辑/移除 → 缩放工作区并加入参考
+   legacy：沿用 needs_completion → 固定半径 → 原像素平移
 → prepare-only：保存任务和报告后结束
 → 否则：串行请求 images/edits，或读取离线候选
 → completion_geometry.py merge
-   检查画布/前景/对齐 → 限制新增区域与连通性 → 恢复原可见像素
+   检查画布/前景/对齐 → 逆变换回原像素尺寸 → 限制编辑和连通性 → 恢复保留像素
 → 每部件选第一个通过几何检查的候选
 → finalize 输出透明部件、原图坐标和报告
 ```
 
-任务必须同时满足：计划 `needs_completion=true`、非 hidden、有可见 SAM mask、允许新增区域非空。指定 `--part` 只缩小范围，不强制绕过筛选。分别记录 `NO_COMPLETION_NEEDED`、`NO_VISIBLE_SAM_MASK`、`NO_ALLOWED_EXTENSION`。
+adaptive 检查所有选中部件的实际 mask，不再以第一阶段 needs_completion 为唯一门槛。必须有可见 mask、保留对齐锚点，以及非空编辑或移除区域。隐藏/缺 mask、无观察到的编辑区域、无保留锚点分别跳过；无明确遮挡关系的近重复 mask（IoU≥0.8）要求人工复核。一般有歧义的重叠只记录诊断，不自动猜测归属。指定 `--part` 只缩小处理范围。
 
-以 `output/20260918-183532/sam` 为例：32 个计划项中 10 个 hidden 没有 mask；22 个有 mask，其中 12 个进入补全。帽子、两袖、两眼、两眉、鼻、嘴、胡子这 10 个因第一阶段标记不需补全而跳过，没有重新由模型判断实际 mask 完整性。
+legacy 才要求 `needs_completion=true` 且允许新增非空。旧实验 `output/20260918-183532/sam` 的 22 个可见部件中 12 个进入补全，是旧筛选结果，不能套用于 adaptive。
 
 ## 3. 阶段执行命令示例及参数说明
 
@@ -68,6 +71,7 @@ node .\tools\model-check.mjs --stage completion `
   --input-dir $samInput `
   --candidates-dir .\output\20260918-183532\complete2_gpt `
   --out-dir ".\output\$runId\complete-recheck" `
+  --completion-profile legacy `
   --candidate-size-policy uniform
 ```
 
@@ -83,6 +87,18 @@ node .\tools\model-check.mjs --stage completion `
 
 探针只保存候选，不执行部件准备与几何验收，不能与 `--input-dir` 混用。
 
+新的单部件多图/mask 能力探针会产生一次真实请求，并执行新几何链路；不会修改默认 capabilities。仅在决定进行付费小样时运行，替换 part 为实际存在的可执行任务：
+
+```powershell
+node .\tools\model-check.mjs --stage completion `
+  --config .\configs\tiantoken.json `
+  --input-dir $samInput `
+  --out-dir ".\output\$runId\capability-probe" `
+  --part head --probe-edit-capabilities
+```
+
+该探针发送主图、局部参考、全角色参考和透明可编辑 mask，强制 n=1、禁用 HTTP 重试。查看 request.json、原候选、QA 和 capability-evidence.json；HTTP 接受不等于参考图被使用或 mask 语义正确，因此不会自动启用能力。prepare-only 可配 `--completion-reference both --completion-mask required` 检查计划发送内容而不联网。
+
 | 参数 | 说明 |
 | --- | --- |
 | `--input-dir DIR` | 完整 SAM 输出目录，部件补全必需 |
@@ -90,8 +106,13 @@ node .\tools\model-check.mjs --stage completion `
 | `--part ID` | 可重复，ID 必须存在且不重复；省略时处理所有符合筛选条件的部件 |
 | `--prepare-only` | 只生成画布、区域、提示词和报告，不请求模型 |
 | `--candidates-dir DIR` | 离线导入候选，与 prepare-only 互斥 |
-| `--completion-size N` | 方形画布边长，默认 1024，整数 128～4096；原像素不缩放 |
-| `--extension-radius N` | 轮廓延展距离与关节圆盘半径，默认 32，整数 1～256 |
+| `--completion-profile adaptive/legacy` | 默认 adaptive；旧候选需显式 legacy |
+| `--completion-reference auto/board/local/full/both/none` | auto：支持多图时 local+full，否则单图参考板；legacy auto 为旧单图/局部参考行为 |
+| `--completion-mask auto/required/off` | auto 遵循配置；required 要求已配置支持，或用单部件能力探针试验；off 不发送但仍本地限制编辑 |
+| `--completion-review FILE` | 人工确认的补全区域文件，格式见第 4 节；只用于 adaptive |
+| `--probe-edit-capabilities` | adaptive 在线单部件试验多图+mask，不持久修改配置，不自动认定能力支持 |
+| `--completion-size N` | 请求方形画布边长，默认 1024，整数 128～4096；adaptive 记录显式缩放和逆变换 |
+| `--extension-radius N` | 原图像素半径覆盖，整数 1～256；adaptive 默认 min(mask宽,高)×0.15 向上取整并限于 4～96；legacy 默认 32 |
 | `--candidate-size-policy NAME` | strict 默认拒绝尺寸不符；uniform 允许同宽高比整画布缩放后复检 |
 | `--completion-model ID` | 图片模型 ID，原样发送 |
 | `--config FILE` / `--env-file FILE` | 默认 astra-qwen.json / 项目 .env；shell 同名变量优先 |
@@ -122,19 +143,42 @@ node .\tools\model-check.mjs --stage completion `
 
 不同原图、mask 或参数的候选不能混用。尺寸之外，部件位置、朝向、比例也必须保持一致。
 
+adaptive 的旧运行候选还要匹配 profile、参考布局、复核文件/掩码哈希和规划版本；board 与独立多图的画布不同，不可混用。平铺候选仍需人工保证它对应当前请求画布。
+
+人工复核文件示例（JSON 中的 ID 取自当前语义计划，字段均可省略但 confirmed 必须为 true）：
+
+```json
+{
+  "schema_version": 1,
+  "parts": {
+    "part_id": {
+      "confirmed": true,
+      "extension_radius": 24,
+      "repair_mask": "review-masks/repair.png",
+      "replace_mask": "review-masks/replace.png",
+      "remove_mask": "review-masks/remove.png"
+    }
+  }
+}
+```
+
+mask 是与 source 同尺寸的单通道 0/255 PNG，白色表示区域；路径相对于复核 JSON 且不得越出其目录。repair 必须在当前 SAM mask 外；replace/remove 必须位于 SAM 内且互不重叠。replace 用于误分重绘或额外底图清理，remove 用于明确不属于该部件的像素。半径优先级为部件复核值 > CLI 全局值 > 自适应值。文件及 masks 会复制进输出，哈希纳入复用身份。
+
 ## 5. 执行链路中重要部分代码文件及原理说明（包括重点说明）
 
-**允许区域。** `completion_geometry.py::allowed_regions()` 先计算可见 mask 外、距轮廓不超过 extension-radius 的区域，再分别与以下区域取交集：遮挡补全用 occluded_by 的 mask 并集；父关节延展用本部件 pivot 周围圆盘；子关节延展用直接子骨骼部件 pivot 圆盘。始终排除原可见 mask，新增范围限制在原图画布内。它是保守几何范围，不是完整隐藏形状推断。
+**按实际 mask 重建需求。** 遮挡延伸使用轮廓外半径带与 occluded_by 的实际 mask 交集；父/子关节需求来自骨骼层级与 pivot。自动分割修复仅选择 mask 内部闭合孔洞、原图有前景且无其他 mask 归属的像素；开放缺口和重叠归属不自动猜测，可用复核文件指定。自动底图清理仅针对 occluded_by 中直接 bind_to 当前骨骼的附件/五官与当前 mask 的交集。这些仍是几何候选，语义不自动获证。
 
-**局部坐标。** `prepare()` 将可见区和允许区居中放入方形画布，至少留 16 像素边距，只平移和补边。`origin_xy` 是局部左上角在原图的位置，可为负数；原图位置=局部位置+origin。放不下时失败，不能偷偷缩放原像素。
+**保留与编辑。** editable 为遮挡/关节/修复/清理/人工替换区域的并集，扣除 removed；preserve = SAM − editable − removed。保留原 mask 和源图，并另存三种全画布区域供第四阶段核对。只有原始 SAM 或单一图片目录不足以描述这个契约。
 
-**重点：当前实际发送什么。** `stages/completion-stage.mjs` 默认只发送白底 `input.png`。三个现有配置均为 `multiple_images=false`、`mask=false`，因此本地生成 context.png 和 edit-mask.png 不意味着发给模型。只有开启并验证对应能力后，分支才发送第二张同坐标局部原图参考和编辑遮罩；当前没有独立全角色参考图输入。文字边界说明及返回后的区域裁剪不能替代模型侧遮罩约束。
+**可逆画布。** native 方形裁剪边长为可见+编辑区域最长边的 1.15 倍向上取整，记录 origin。工作区缩放到请求画布（board 工作区边长为请求边长约 68%，其余为参考板；独立参考时工作区占整幅）。RGBA 用 LANCZOS，区域 mask 用最近邻。task.json 保存 native_size、scale、working_xyxy 和含像素中心约定的正反仿射变换。返回后只取工作区，逆缩放到 native，再裁剪回原图坐标；保留像素从原图恢复，所以缩放不改变最终保留像素。legacy 仍仅平移补边。
+
+**实际发送内容。** 当前三个提供方默认仍关闭 multiple_images/mask。adaptive auto 因此发送一张 input.png：左侧是待编辑工作区，右侧为局部及完整角色参考，参考区域不参与最终资产。支持多图时 auto 顺序为 input.png → context.png → reference.png；也可选 local/full/both。request-plan.json 保存计划；只有实际请求才写 request.json，包含有序文件角色、SHA-256、尺寸、image 字段、mask 哈希、透明可编辑语义与是否发送。mask 不支持时明确标 local_only，不能宣称模型侧已受 mask 约束。
 
 **图片解码与尺寸。** `providers/image-edits.mjs` 使用 multipart images/edits，支持非空 b64_json 或返回 URL 下载；空 b64_json 会回退有效 URL。当前部件请求显式发送 size=画布宽x高，并写入 request.json；配置 params.size 冲突会报错。strict 模式拒绝 CANVAS_SIZE_MISMATCH；uniform 仅将同宽高比整画布 LANCZOS 缩放到目标尺寸，保留原候选，不平移、不裁剪、不单独缩放物体，也不改变原图/mask。
 
-**几何验收与合并。** `merge_candidate()` 去除边界连通白底，在原部件 Alpha≥240 的像素处检查 RGB 平均绝对误差≤30、可见保留率≥95%；无不透明锚点拒绝。只取允许区域内且与原部件连通的新增像素，没有有效新增即拒绝。通过后逐像素恢复原可见 RGBA，模型只提供新增部分。
+**几何验收与合并。** adaptive 在请求工作区的保留不透明像素处检查 RGB MAE≤30、保留率≥95%，先验对齐再逆采样，避免把逆采样边界 Alpha 变化误判成位移。返回前景只保留 editable 内且连接 preserve 的像素；清理/人工替换区域至少 95% 有效填充，否则拒绝。没有有效修改且没有人工移除则拒绝。最后恢复 preserve 的原 RGBA，已连接的可见缺口使用原图纹理，removed 清零。legacy 沿用原可见像素全保护规则。
 
-**重点：验收仍有缺口。** `unfulfilled_regions` 记录未补到的子区域，但当前不是硬性拒绝条件；某一区域新增少量像素也不代表关节补够。语义、接缝、材质、运动露底没有自动验收。错误 SAM 像素会被原样恢复；若头部 mask 已含眼睛/胡子，当前规则也不能清除这些内部附件生成干净脸底。
+**能力证据与质量边界。** adaptive QA 记录合并前的 raw_outside_edit_mae / changed_pixels，避免本地恢复掩盖模型越界修改。capability-evidence.json 记录探针的输入顺序、尺寸、候选和 QA，但 reference_use_verified、mask_semantics_verified 不自动置 true，仍需视觉验证。区域填满不能证明生成的是正确底图；未明确划入 editable/remove 的误分仍受保护。接缝、材质、关节补足和运动露底尚无可靠自动验收。
 
 ## 6. 各个代码文件职责索引
 
@@ -143,6 +187,7 @@ node .\tools\model-check.mjs --stage completion `
 | [tools/model-check.mjs](../tools/model-check.mjs) | 部件补全与独立探针分发、参数互斥检查 |
 | [stages/completion-stage.mjs](../stages/completion-stage.mjs) | 输入指纹、准备、串行请求/离线读取、候选选择、状态留档 |
 | [completion_geometry.py](../completion_geometry.py) | allowed_regions、prepare、merge_candidate、finalize 与报告 |
+| [completion_planning.py](../completion_planning.py) | adaptive 需求重建、复核输入、参考板、正反变换、编辑分区与合并 |
 | [normalize_reference.py](../normalize_reference.py) | 候选 Alpha 保留、边界连通白底提取 |
 | [providers/image-edits.mjs](../providers/image-edits.mjs) | multipart 编辑请求、能力检查、Base64/URL 图片解码 |
 | [providers/http.mjs](../providers/http.mjs) | HTTP、超时、重试、诊断和脱敏 |
@@ -153,6 +198,7 @@ node .\tools\model-check.mjs --stage completion `
 | [prompts/complete-v1.txt](../prompts/complete-v1.txt) | 保持姿势、尺寸、可见纹理与隐藏区域补全约束 |
 | [Tiantoken](../configs/tiantoken.json)、[DeepSeek/Qwen](../configs/deepseek-qwen.json)、[Astra/Qwen](../configs/astra-qwen.json) 配置 | 图片模型、认证变量、请求参数与能力开关 |
 | [tests/completion-stage.test.mjs](../tests/completion-stage.test.mjs) / [tests/test_completion.py](../tests/test_completion.py) | mock 编辑、离线复用、尺寸/对齐拒绝、像素保真与区域回归 |
+| [tests/test_completion_adaptive.py](../tests/test_completion_adaptive.py) | 放大/缩小回贴、漏分重建、附件清理、区域复核、拒绝位移和第四阶段契约 |
 | [tests/model-stages.test.mjs](../tests/model-stages.test.mjs) | 提供方与探针相关回归 |
 
 ## 7. 产物详细说明
@@ -160,34 +206,40 @@ node .\tools\model-check.mjs --stage completion `
 | 路径 | 内容与用途 |
 | --- | --- |
 | `source.png`、`semantic-parts.json`、`segmentation.json`、`masks/` | 输入快照，用于复现与离线候选身份核对 |
-| `completion-plan.json` | 准备任务、允许区域、参数和跳过原因 |
-| `tasks/<id>/input.png` | 白底局部可见部件，默认唯一模型输入图 |
-| `tasks/<id>/visible.png` | 原图可见 RGBA，合并时恢复像素 |
-| `tasks/<id>/context.png` | 同坐标局部原图参考，当前默认不发送 |
-| `tasks/<id>/edit-mask.png` | RGBA 编辑遮罩，透明处可编辑，当前默认不发送 |
+| `completion-plan.json` | 准备任务、区域、跳过原因；adaptive 含 assessments、重建需求、半径及歧义重叠 |
+| `tasks/<id>/input.png` | 实际请求主图；board 含目标、局部参考与全角色参考 |
+| `tasks/<id>/visible.png` | 请求坐标的保留 RGBA；legacy 为原可见 RGBA |
+| `tasks/<id>/context.png` / `reference.png` | 局部 / 全角色原图参考，由 reference mode 决定是否独立发送 |
+| `tasks/<id>/edit-mask.png` | RGBA 编辑遮罩，透明处为 editable 或 removed；是否发送以 request.json 为准 |
 | `tasks/<id>/allowed-mask.png` | 白色表示允许新增区域 |
 | `tasks/<id>/<补全字段>.png` | 启用的补全子区域 mask |
-| `tasks/<id>/task.json` / `prompt.txt` | origin、区域、需求和告警 / 实际提示词 |
-| `tasks/<id>/request.json` | 在线请求模型、图片哈希、是否发送 mask；修复后含 size |
+| `tasks/<id>/task.json` / `prompt.txt` | origin、区域、变换、参考布局、重建需求和告警 / 实际提示词 |
+| `tasks/<id>/native-*.png` | 原像素尺寸的源图、保留像素与各区域，用于逆映射和精确恢复 |
+| `preservation/<id>-*.png` | 原图全画布 preserve/editable/removed 契约，第四阶段核对用 |
+| `review-source.json`、`review.json`、`review/` | 可选原始复核文件、路径规范化快照及对应 masks |
+| `tasks/<id>/request-plan.json` / `request.json` | 计划 / 实际请求；记录有序图片角色、哈希、尺寸、mask 语义和发送状态 |
+| `tasks/<id>/capability-evidence.json` | 仅能力探针：请求接受情况及原始越界指标，能力需人工确认 |
 | `tasks/<id>/response.raw.json` / `request-metadata.json` | 在线响应留档 / 请求 ID、耗时等元数据 |
 | `tasks/<id>/response.error.json` | 可获取时保存的脱敏请求失败诊断 |
 | `tasks/<id>/candidate-N.*` | 模型或离线导入的原始候选，拒绝也保留 |
 | `tasks/<id>/merged-N-normalized.png` | uniform 实际重采样时保存的候选；不代表通过 |
 | `tasks/<id>/qa-N.json` | 尺寸、对齐、新增/丢弃像素、各区域完成情况、拒绝原因 |
-| `tasks/<id>/merged-N.png` | 通过几何检查且恢复原可见像素后的局部 RGBA |
+| `tasks/<id>/merged-N.png` | 原像素尺寸的局部 RGBA；adaptive 已逆采样并恢复 preserve |
 | `parts/<id>.png` | 每部件选中结果的紧裁剪透明 PNG |
-| `completion-result.json` | 每部件状态、候选 QA、原图 crop_xyxy 和路径 |
+| `completion-result.json` | 每部件状态、候选 QA、原图 crop_xyxy、preservation 路径和变换 |
 | `report.html` / `manifest.json` | 人工检查页 / 模式、网络标记、状态、输入/代码/产物哈希 |
 
 parts/ 只含本次选中且通过检查的补全部件，不是全部 SAM 部件集合。无需补全、失败和未选中的部件不会自动复制进来；完整角色组装由第四阶段读取 SAM 与本目录后生成。
 
 当前实验：`output/20260918-183532/complete2_gpt` 已真实请求 Tiantoken gpt-image-2 共 12 个部件。旧请求未传 size，返回 1248/1254 方形图，预期为 1024，全部严格尺寸拒绝。`complete2_gpt-size-recheck-v2` 离线复用原候选后，8 个几何通过；head、pants_thigh_l、pants_thigh_r、shoe_l 共 4 个因对齐或无有效新增拒绝。通过项中仍有衣料误分、错误手部和未补全子区域。显式 size 的请求构造已验证，但尚无修复后中转遵守 size 的新实测结论。
 
+2026-09-22 adaptive 验证：Conda ai-spine 下 npm test 共 29 项通过（包括 8 项新 Python adaptive 用例），覆盖 board/独立参考顺序、mask mock、放大与缩小回贴、位移拒绝、实际孔洞、附件清理、人工编辑契约及第四阶段接续。`output/completion-adaptive-prepare-20260922` 使用既有 SAM 数据离线生成 16 个任务、11 个跳过，上衣规划 3708 个孔洞像素、头部规划 10205 个底图清理像素。它们是准备阶段的候选区域，不代表补全质量；本轮未请求付费模型，也未验证中转真实能力。
+
 ## 8. 当前阶段可改进点说明
 
 - **完整角色组装已接入第四阶段。** 按原坐标与遮挡约束组装，复用原拆件并记录失败回退，输出补全前后对比、覆盖与重叠诊断及单骨骼旋转检查动画。可靠的接缝与运动质量自动验收仍待实现。
-- **把原图或部件相关原图区域交给补全模型参考。** 接入并实测全角色/局部上下文参考和编辑 mask，记录实际发送内容。不能仅把 capabilities 改为 true 就宣称中转支持；需验证图片顺序、mask 语义、返回尺寸和画面保持能力。
-- **根据 SAM 实际结果重建需求。** 区分分割缺口修复、遮挡补全、关节延伸、附件底图清理；对应建立保留区域与可编辑区域，避免误分像素被永久保护。
-- **改进画布与补全区域。** 固定 32 像素不适配所有部件；小部件在 1024 大白底中占比低。可验证按部件设计区域、显式局部放大并记录逆变换，保证回贴坐标可检查。
+- **参考输入已实现，真实能力待验证。** 支持 board 与独立 local/full/both、mask 发送策略、有序请求记录及单部件能力探针。离线 mock 已覆盖图片顺序、mask、返回尺寸和越界记录；本轮未请求付费模型，未宣称中转支持或生成质量提升。
+- **实际 mask 需求重建已实现。** 分别规划缺口、遮挡、关节和附件清理，保存 preserve/editable/removed，并支持人工复核区域。保守孔洞检测不会自动解决所有开放缺口、误分与语义歧义；这些仍需复核。
+- **自适应画布与区域已实现。** 半径随部件尺寸变化并可覆盖；小部件放大、大部件缩小，请求与原图间变换留档，最终恢复原像素尺寸和保护区。离线测试覆盖放大/缩小、Alpha 保真、位移拒绝及第四阶段接续；真实模型效果待小样验证。
 - **加强验收。** 对必需区域定义有效覆盖要求，增加部件语义、接缝、材质、回贴和关节旋转露底检查；不能放宽阈值来掩盖重绘、位移或错误输入。
 - **按小样验证后批量。** 先修正 SAM 输入，再用头、前臂、上衣验证参考图与遮罩，比较原输入、原候选、合并图和回贴图，确认改善后再跑全量。

docs/4-spine-stage.md

@@ -69,9 +69,9 @@ conda run -n ai-spine node .\tools\verify-spine-runtime.mjs `
 
 SAM 目录需含 `source.png`、有效 v2 `semantic-parts.json`、`segmentation.json`、其中记录的全画布二值 masks。可见部件缺少 mask 直接报错；hidden 不得有可见 mask。
 
-补全目录需含相同输入快照、对应 masks 和 `completion-result.json`。只有 `selected_file` 非空、`qa.accepted=true` 且 `status=geometry_passed_needs_review` 的结果会被采用；其 `image` 文件必须存在，裁剪坐标为原画布内的整数半开区间，尺寸与 PNG 一致，可见像素必须逐像素匹配 SAM 源图。输入哈希不一致时拒绝混用。图片路径必须位于相应输入目录内。
+补全目录需含相同输入快照、对应 masks 和 `completion-result.json`。只有 `selected_file` 非空、`qa.accepted=true` 且 `status=geometry_passed_needs_review` 的结果会被采用；其 `image` 文件必须存在，裁剪坐标为原画布内的整数半开区间，尺寸与 PNG 一致。legacy 可见像素必须逐像素匹配 SAM；adaptive 使用 preservation 的 preserve/editable/removed 全画布二值区域，要求 preserve=SAM−editable−removed、编辑与移除不重叠、保留像素精确匹配、输出没有超出保留/编辑区域。输入哈希不一致时拒绝混用。图片和契约路径必须位于补全目录内。
 
-补全失败、未处理、未提供或 `NO_ALLOWED_EXTENSION` 的需补全部件遵守 fallback-policy。hidden 保留语义骨骼但不生成纹理，也不因缺纹理触发严格回退错误。
+补全失败、未处理、未提供或没有允许区域的需补全部件遵守 fallback-policy；adaptive 已重建并尝试修复的部件也视为有需求，不因原计划 needs_completion=false 就忽略失败。hidden 保留语义骨骼但不生成纹理，也不因缺纹理触发严格回退错误。
 
 可选绘制顺序文件格式为 `{"draw_order":["部件ID一","部件ID二"]}`。必须列出本次全部可绘制部件，不包含 hidden。显式顺序允许覆盖模型遮挡关系，冲突会在报告中列出。