处理尺寸不一致

docs/3-completion-stage.md

@@ -50,6 +50,27 @@ node .\tools\model-check.mjs --stage completion `
 
 候选文件名为 `completion-candidates/head.png`，必须与对应任务的局部画布尺寸、坐标完全一致。准备与合并必须使用相同输入、`--completion-size` 和 `--extension-radius`。缺失候选记为 `missing_candidate`，不会联网补发。可将先前任务保存的原始候选复制为 `ID.png`，离线检查它，避免重复计费。
 
+`--candidates-dir` 也支持直接指向旧补全输出目录：读取 `tasks/<id>/candidate-1.png`（亦支持 jpg/webp），不下载、不重新生成。程序先核对旧 manifest 中的源图、语义计划、SAM mask 哈希及画布/延展参数是否与本次一致；不同则拒绝复用。该模式只取每部件首张原候选。
+
+### 返回尺寸与输入不一致时
+
+`--completion-size` 控制局部画布，不能单靠提示词保证模型输出相同尺寸。修复后第三阶段会同时发送 multipart 参数 `size=画布宽x画布高`，默认 `1024x1024`，并在每部件 `request.json` 记录实际请求尺寸。配置中的 `completion.params.size` 若与画布不同会在调用前报错。[OpenAI 编辑接口的 size 参数](https://developers.openai.com/api/reference/cli/resources/images/methods/edit)有明确的输出尺寸含义，但中转站是否遵守仍以实测结果为准。
+
+默认 `--candidate-size-policy strict` 仍拒绝尺寸不一致。已有候选可以使用 `uniform` 模式离线尝试恢复：仅允许相同宽高比的整张画布等比例缩放，再执行原有的颜色/位置、可见像素保留率、新增区域和连通性检查。不对物体单独缩放、不平移、不裁剪，也不放宽对齐阈值。原图和 SAM mask 始终不缩放。
+
+```powershell
+node .\tools\model-check.mjs --stage completion `
+  --config .\configs\tiantoken.json `
+  --input-dir .\output\20260918-183532\sam `
+  --candidates-dir .\output\20260918-183532\complete2_gpt `
+  --out-dir ".\output\$runId-size-recheck" `
+  --candidate-size-policy uniform
+```
+
+该命令不请求图片模型。原始候选保留，缩放后的候选另存为 `merged-N-normalized.png`，QA 记录原始/目标尺寸、比例、重采样方法和告警。即便最终通过几何检查也仍需语义复核；如果模型同时重绘、放大或移动了部件，可能继续报 `VISIBLE_ALIGNMENT_MISMATCH`。
+
+2026-09-20 对 `complete2_gpt` 的 12 张原始候选实测：输入均为 1024×1024，输出为 1248×1248 或 1254×1254。旧请求未发送 size。离线 uniform 复查后 8 个通过几何检查、4 个因对齐不符或无有效新增像素拒绝；原始文件未覆盖，也没有重新请求生成。报告位于 `output/20260918-183532/complete2_gpt-size-recheck-v2/report.html`。22 项测试通过，含请求 size、等比例恢复后的像素保真、宽高比/偏移拒绝及旧任务输入匹配检查。显式 size 已通过请求构造测试，尚未再次付费验证中转站是否遵守。
+
 每个输出目录必须是新目录；`--resume` 仅复用已完整结束且输入、参数、源码和产物哈希一致的任务。准备模式与生成模式使用不同目录。失败任务不自动续发请求。
 
 | 参数 | 作用 |
@@ -57,7 +78,8 @@ node .\tools\model-check.mjs --stage completion `
 | `--input-dir` | SAM 输出目录，必须含 `source.png`、v2 计划、`segmentation.json`、`masks/<id>.png` |
 | `--part ID` | 指定部件，可重复；省略时处理全部有补全需求的部件 |
 | `--prepare-only` | 只准备画布、区域与提示词，不请求图片模型 |
-| `--candidates-dir` | 离线读取 `ID.png` 候选，与 prepare-only 互斥 |
+| `--candidates-dir` | 离线读取 `ID.png` 或旧补全目录首张候选，与 prepare-only 互斥 |
+| `--candidate-size-policy` | strict（默认）：严格尺寸一致；uniform：同宽高比缩放后重新检查 |
 | `--completion-size` | 方形局部画布边长，默认 1024，128～4096；不缩放原像素 |
 | `--extension-radius` | 新增区域距可见 mask 的最大距离，默认 32 像素，1～256 |
 | `--completion-model` | 图片模型原始 ID，当前示例使用 qwen-image-3.0 |
@@ -81,7 +103,7 @@ node .\tools\model-check.mjs --stage completion `
 
 ## 返回候选的检查和合并
 
-1. 尺寸必须与局部画布完全一致。拒绝自动缩放、重定位或裁切来迎合返回图。
+1. 默认要求尺寸与局部画布完全一致。显式选择 uniform 时，只对同宽高比候选做整画布等比例恢复；宽高比不同仍拒绝。所有模式都不自动重定位或裁切。
 2. 已有透明背景保留；不透明白底使用边界连通近白区域去底。无法提取前景则拒绝。
 3. 使用原部件 Alpha ≥240 的像素检查对齐：候选保留率至少 95%，RGB 平均绝对误差不大于 30。无不透明锚点则拒绝。这只能发现明显偏移或重绘，不能保证语义正确。
 4. 只保留允许区域中的新增像素，并去掉与原可见部分不连通的新增块。越界和不连通像素数量写入 QA。没有新增像素则拒绝。