接通第四步

tools/model-check.mjs

@@ -7,12 +7,14 @@ import {runUnderstanding, runCompletionProbe} from '../stages/model-stage.mjs';
 import {readImage} from '../lib/images.mjs';
 import {runSegmentation} from '../stages/segmentation-stage.mjs';
 import {runCompletion} from '../stages/completion-stage.mjs';
+import {runSpine} from '../stages/spine-stage.mjs';
 
 const help = `模型接入与结构理解（新增模式，不调用旧拆件流程）
   node pipeline.mjs --mode annotated-parts --reference image.png --out-dir output/run --stop-after understand
   node tools/model-check.mjs --stage completion --image local.png --prompt-file task.txt --out-dir output/edit
   node tools/model-check.mjs --stage segmentation --input-dir output/understand --out-dir output/segment --sam-dir F:/Study/SAM3
   node tools/model-check.mjs --stage completion --input-dir output/segment --out-dir output/complete --part head --prepare-only
+  node tools/model-check.mjs --stage spine --input-dir output/segment --completion-dir output/complete --out-dir output/spine
   node tools/model-check.mjs --list-models
   node tools/model-check.mjs --dry-run
 
@@ -28,6 +30,11 @@ const help = `模型接入与结构理解（新增模式，不调用旧拆件流
   --parts-file FILE              离线读取已有 v1/v2 计划，做 Alpha 校验与种子生成，不请求模型
   --python FILE                  ai-spine Conda 环境解释器（默认使用已激活环境）
   --input-dir DIR                SAM 阶段读理解目录；补全阶段读 SAM 目录
+  --completion-dir DIR           Spine 阶段可选补全目录；input-dir 指向同批 SAM 目录
+  --fallback-policy sam|error    Spine 未完成补全时回退 SAM（默认）或报错
+  --draw-order-file FILE         Spine 绘制顺序覆盖：{"draw_order":[全部可绘制ID，从后到前]}
+  --check-angle FLOAT            Spine 单骨骼检查动画角度，默认 10，范围 (0,45]
+  --genielabs-dir DIR            外部 spine-animation-ai 路径，仅用于 Spine 图集和播放器
   --part ID                      补全部件 ID，可重复；默认处理所有需补全部件
   --prepare-only                 仅准备补全画布、掩码和提示词，不请求模型
   --candidates-dir DIR           离线导入 ID.png，或旧补全目录的首张候选，不请求模型
@@ -44,7 +51,7 @@ const help = `模型接入与结构理解（新增模式，不调用旧拆件流
   --dry-run                     检查配置与本地输入，不请求模型、不生成产物
 
 --stop-after 支持 understand / segment。SAM 在临时 GPU 子进程运行，完成后退出。
-部件补全使用 --stage completion --input-dir；可见像素恢复与几何检查已接入，Spine 导出尚未接入。`;
+部件补全使用 --stage completion --input-dir；--stage spine 离线组装并导出 Spine 4.2，资产和动作质量仍需复核。`;
 
 export function parseOptions(argv) {
   const options = {stage: 'understanding', imagePaths: [], partIds: []};
@@ -58,6 +65,8 @@ export function parseOptions(argv) {
     ['--sam-checkpoint', 'samCheckpoint'], ['--sam-confidence', 'samConfidence'], ['--sam-precision', 'samPrecision'],
     ['--candidates-dir', 'candidatesDir'], ['--completion-size', 'completionSize'], ['--extension-radius', 'extensionRadius'],
     ['--candidate-size-policy', 'candidateSizePolicy'],
+    ['--completion-dir', 'completionDir'], ['--fallback-policy', 'fallbackPolicy'],
+    ['--draw-order-file', 'drawOrderFile'], ['--check-angle', 'checkAngle'], ['--genielabs-dir', 'genielabsDir'],
   ]);
   for (let i = 0; i < argv.length; i += 1) {
     const flag = argv[i];
@@ -80,7 +89,19 @@ export function parseOptions(argv) {
 export async function main(argv = process.argv.slice(2)) {
   const options = parseOptions(argv);
   if (options.help) { console.log(help); return; }
-  if (!['understanding', 'completion', 'segmentation'].includes(options.stage)) throw new Error('--stage 仅支持 understanding / completion / segmentation');
+  if (!['understanding', 'completion', 'segmentation', 'spine'].includes(options.stage)) throw new Error('--stage 仅支持 understanding / completion / segmentation / spine');
+  if (options.stage === 'spine') {
+    const allowed = new Set(['stage', 'inputDir', 'outDir', 'completionDir', 'fallbackPolicy', 'drawOrderFile',
+      'checkAngle', 'genielabsDir', 'python', 'resume', 'dryRun', 'mode', 'imagePaths', 'partIds']);
+    if (Object.keys(options).some((key) => !allowed.has(key)) || options.imagePaths.length || options.partIds.length ||
+        (options.mode && options.mode !== 'annotated-parts')) throw new Error('Spine 为独立离线阶段，不接受模型配置、请求或补全参数');
+    const result = await runSpine(options);
+    if (!result.dryRun) console.log(`Spine ${result.reused ? '复用完成' : '导出完成，需复核'}：${path.join(result.out, 'report.html')}`);
+    return result;
+  }
+  if (['completionDir', 'fallbackPolicy', 'drawOrderFile', 'checkAngle', 'genielabsDir'].some((key) => options[key] !== undefined)) {
+    throw new Error('Spine 导出参数仅用于 --stage spine');
+  }
   if (options.partsFile && (options.stage !== 'understanding' || options.listModels)) throw new Error('--parts-file 仅用于离线结构理解');
   if (options.streamRaw !== undefined && !['true', 'false'].includes(options.streamRaw)) throw new Error('--stream 仅支持 true 或 false');
   options.stream = options.streamRaw === undefined ? undefined : options.streamRaw === 'true';