arona-agent 1.0.0

package/pet/renderer/spinetest.js

@@ -0,0 +1,295 @@
+// ARONA Spine 调试页（spinetest）：加载 skel/atlas/png → 交互预览（事实转储到 console）。
+// 用途（spike 遗留）：
+//   1) Head_Rot 手动设 rotation 是否只转头
+//   2) A/M/Dev 各变体动画语义
+//   3) Look/LookEnd 起止姿势
+//   4) spine-webgl 在透明窗的实际合成效果（?pm=0 可切换非 premultiplied 路径对比）
+// 键盘：←/→ 手动转 Head_Rot；↑/↓ 循环动画；1~9/0/a~z 直接跳转到第 N 个动画。
+const SPINE_BASE = "../../assets/blue-archive/arona/spine/";
+const canvas = document.getElementById("spine");
+const hud = document.getElementById("hud");
+const params = new URLSearchParams(location.search);
+
+const USE_PM = params.get("pm") !== "0"; // 默认 premultiplied 路径
+console.log("[spinetest] URL", location.href, "| search", location.search);
+
+let gl = null;
+let assetManager = null;
+let skeleton = null;
+let state = null;
+let renderer = null;
+let headBone = null;
+let headRestRot = 0;
+let manualHeadRot = 0;
+let isoSet = null;
+let animIndex = 0;
+let fps = 0;
+let fit = null; // { offset:{x,y}, size:{x,y}, scale }
+
+function log(...args) {
+  console.log("[spinetest]", ...args);
+}
+
+// ---- 加载 ----
+async function load() {
+  gl = canvas.getContext("webgl", {
+    alpha: true,
+    premultipliedAlpha: USE_PM,
+    antialias: true,
+    preserveDrawingBuffer: false,
+  });
+  if (!gl) {
+    hud.textContent = "WebGL 不可用";
+    return;
+  }
+  assetManager = new spine.webgl.AssetManager(gl, SPINE_BASE);
+  if (USE_PM) {
+    // 纹理上传时预乘（UNPACK_PREMULTIPLY_ALPHA_WEBGL），与 drawSkeleton(skeleton, true) 配套
+    // 本 vendored 3.8 构建 GLTexture 无 premultiply 参数，须上传前手动设 pixelStorei
+    assetManager.textureLoader = (image) => {
+      gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+      const tex = new spine.webgl.GLTexture(gl, image, false);
+      gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, false);
+      return tex;
+    };
+  }
+  assetManager.loadBinary("arona_spr.skel");
+  assetManager.loadTextureAtlas("arona_spr.atlas.txt");
+
+  const ok = await waitLoad();
+  if (!ok) {
+    hud.textContent = "加载失败：\n" + Object.keys(assetManager.errors).map((k) => k + ": " + assetManager.errors[k]).join("\n");
+    console.error("加载失败", assetManager.errors);
+    return;
+  }
+
+  const atlas = assetManager.get("arona_spr.atlas.txt");
+  const atlasLoader = new spine.AtlasAttachmentLoader(atlas);
+  const binary = new spine.SkeletonBinary(atlasLoader);
+  const skelBytes = assetManager.get("arona_spr.skel");
+  let skelData = null;
+  try {
+    skelData = binary.readSkeletonData(skelBytes);
+  } catch (e) {
+    console.error("readSkeletonData 失败:", e.message, "\n", e.stack);
+    hud.textContent = "解析失败: " + e.message;
+    return;
+  }
+
+  skeleton = new spine.Skeleton(skelData);
+  skeleton.setToSetupPose();
+  skeleton.updateWorldTransform();
+  headBone = skeleton.findBone("Head_Rot");
+  headRestRot = headBone ? headBone.data.rotation : 0;
+
+  state = new spine.AnimationState(new spine.AnimationStateData(skelData));
+  // 基础轨道固定 Idle_01（setup pose 是瘫开的折叠姿势，不能直接显示）
+  state.setAnimation(0, "Idle_01", true);
+  animIndex = skelData.animations.findIndex((a) => a.name === "Idle_01");
+
+  renderer = new spine.webgl.SceneRenderer(canvas, gl, true);
+  resize();
+  fitCamera();
+
+  dumpFacts();
+  requestAnimationFrame(loop);
+  window.addEventListener("keydown", onKey);
+  window.addEventListener("resize", resize);
+  window.addEventListener("mousemove", onMouseMove);
+  updateHud();
+}
+
+function waitLoad() {
+  return new Promise((resolve) => {
+    const t0 = performance.now();
+    const poll = () => {
+      if (assetManager.isLoadingComplete()) return resolve(Object.keys(assetManager.errors).length === 0);
+      if (performance.now() - t0 > 8000) return resolve(false);
+      requestAnimationFrame(poll);
+    };
+    requestAnimationFrame(poll);
+  });
+}
+
+// ---- 尺寸与相机拟合 ----
+function resize() {
+  const dpr = window.devicePixelRatio || 1;
+  const w = canvas.clientWidth || 320;
+  const h = canvas.clientHeight || 674;
+  canvas.width = Math.round(w * dpr);
+  canvas.height = Math.round(h * dpr);
+  gl.viewport(0, 0, canvas.width, canvas.height);
+}
+
+// 以 setup pose 包围盒为中心，等比缩放填满画布（CSS px 世界单位；DPR 由 backing store 处理）
+function fitCamera() {
+  const offset = new spine.Vector2();
+  const size = new spine.Vector2();
+  skeleton.getBounds(offset, size, []);
+  const pad = 8;
+  const cw = canvas.clientWidth || 320;
+  const ch = canvas.clientHeight || 674;
+  const scale = Math.min(cw / (size.x + pad * 2), ch / (size.y + pad * 2));
+  renderer.camera.setViewport(cw / scale, ch / scale);
+  renderer.camera.position.set(offset.x + size.x / 2, offset.y + size.y / 2, 0);
+  fit = { offset: { x: offset.x, y: offset.y }, size: { x: size.x, y: size.y }, scale };
+  log("包围盒", JSON.stringify(fit));
+}
+
+// 窗口 CSS px → 骨架世界坐标（逆相机变换）
+function windowToSkeleton(x, y) {
+  const cw = canvas.clientWidth || 320;
+  const ch = canvas.clientHeight || 674;
+  const p = new spine.webgl.Vector3(x, y, 0);
+  renderer.camera.screenToWorld(p, cw, ch);
+  return { x: p.x, y: p.y };
+}
+
+// ---- 事实清单转储 ----
+function dumpFacts() {
+  const sd = skeleton.data;
+  const TL = spine.TimelineType;
+  const typeName = (t) => {
+    const id = (t.getPropertyId() >> 24) & 0xff;
+    for (const k in TL) if (TL[k] === id) return k;
+    return "?";
+  };
+  const anims = sd.animations.map((a) => {
+    const types = {};
+    const keyedBones = new Set();
+    const keyedSlots = new Set();
+    const attachments = [];
+    for (const tl of a.timelines) {
+      types[typeName(tl)] = (types[typeName(tl)] || 0) + 1;
+      if (tl.boneIndex != null) keyedBones.add(sd.bones[tl.boneIndex].name);
+      if (tl.slotIndex != null) keyedSlots.add(sd.slots[tl.slotIndex].name);
+      if (typeName(tl) === "attachment") {
+        // 列出该 timeline 里的 attachment 帧名（含眼部 slot 切换；帧名存于 tl.attachmentNames）
+        const names = [];
+        for (let i = 0; i < tl.frames.length; i++) {
+          names.push(sd.slots[tl.slotIndex].name + ":" + (tl.attachmentNames[i] == null ? "∅" : tl.attachmentNames[i]));
+        }
+        attachments.push(names.join(","));
+      }
+    }
+    return {
+      name: a.name,
+      duration: +a.duration.toFixed(3),
+      timelines: a.timelines.length,
+      types,
+      keyedBones: [...keyedBones],
+      keyedSlots: [...keyedSlots],
+      attachmentFrames: attachments,
+    };
+  });
+  // Point attachment（动画师定义的触摸命中点）
+  const points = [];
+  for (const skin of sd.skins) {
+    for (const slotName in skin.attachments) {
+      for (const name in skin.attachments[slotName]) {
+        const at = skin.attachments[slotName][name];
+        if (at instanceof spine.PointAttachment) {
+          points.push({ skin: skin.name, slot: slotName, name, x: +at.x.toFixed(1), y: +at.y.toFixed(1), rotation: at.rotation });
+        }
+      }
+    }
+  }
+  const facts = {
+    version: sd.version,
+    hash: sd.hash,
+    width: sd.width,
+    height: sd.height,
+    bones: sd.bones.map((b) => ({
+      name: b.name,
+      parent: b.parent ? b.parent.name : null,
+      rotation: +b.rotation.toFixed(2),
+      x: +b.x.toFixed(1),
+      y: +b.y.toFixed(1),
+      length: +b.length.toFixed(1),
+      transformMode: b.transformMode,
+    })),
+    slots: sd.slots.map((s) => ({ name: s.name, bone: s.boneData.name, attachment: s.attachmentName })),
+    skins: sd.skins.map((s) => s.name),
+    animations: anims,
+    pointAttachments: points,
+    events: sd.events.map((e) => e.name),
+    ikConstraints: sd.ikConstraints.map((c) => c.name),
+    fit,
+    headBone: headBone
+      ? { name: headBone.data.name, parent: headBone.parent ? headBone.parent.data.name : null, restRot: headRestRot, world: { x: +headBone.x.toFixed(1), y: +headBone.y.toFixed(1) } }
+      : null,
+  };
+  log("FACTS", JSON.stringify(facts));
+  log("动画数", sd.animations.length, "骨骼数", sd.bones.length, "Point 附件数", points.length);
+}
+
+// ---- 渲染循环 ----
+let lastT = performance.now();
+function loop(now) {
+  const dt = Math.min(0.1, Math.max(0, (now - lastT) / 1000));
+  lastT = now;
+  fps = fps * 0.9 + (1000 / Math.max(1, now - (loop._lastNow || now))) * 0.1;
+  loop._lastNow = now;
+
+  state.update(dt);
+  state.apply(skeleton);
+  // 手动 Head_Rot 覆盖：apply 之后、updateWorldTransform 之前（spike 验证签名）
+  if (headBone) headBone.rotation = headRestRot + manualHeadRot;
+  // 隔离渲染覆盖（每帧重施加，因 state.apply 会重置 slot 颜色）
+  if (isoSet) for (const s of skeleton.slots) s.color.a = isoSet.has(s.data.name) ? 1 : 0;
+  skeleton.updateWorldTransform();
+
+  gl.clearColor(0, 0, 0, 0);
+  gl.clear(gl.COLOR_BUFFER_BIT);
+  renderer.begin();
+  renderer.drawSkeleton(skeleton, USE_PM);
+  renderer.end();
+  requestAnimationFrame(loop);
+}
+
+// ---- 交互 ----
+function onKey(e) {
+  const anims = skeleton.data.animations;
+  if (e.key === "ArrowLeft" || e.key === "ArrowRight") {
+    const step = e.key === "ArrowLeft" ? -5 : 5;
+    manualHeadRot = Math.max(-35, Math.min(35, manualHeadRot + step));
+    log("Head_Rot 手动偏移", manualHeadRot + "°");
+  } else if (e.key === "ArrowUp" || e.key === "ArrowDown") {
+    animIndex = (animIndex + (e.key === "ArrowUp" ? 1 : -1) + anims.length) % anims.length;
+    state.setAnimation(0, anims[animIndex].name, true);
+    log("动画", anims[animIndex].name);
+  } else if (/^[0-9a-z]$/i.test(e.key)) {
+    const idx = e.key >= "0" && e.key <= "9" ? (e.key === "0" ? 9 : +e.key - 1) : 10 + (e.key.toLowerCase().charCodeAt(0) - 97);
+    if (idx < anims.length) {
+      animIndex = idx;
+      state.setAnimation(0, anims[animIndex].name, true);
+      log("动画", anims[animIndex].name);
+    }
+  }
+  updateHud();
+}
+
+// 鼠标位置 → 骨架坐标，实时打印（验证 windowToSkeleton / 头部命中换算）
+function onMouseMove(e) {
+  const p = windowToSkeleton(e.clientX, e.clientY);
+  if (headBone) {
+    const dx = p.x - headBone.x;
+    const dy = p.y - headBone.y;
+    const deg = Math.atan2(dy, dx) * spine.MathUtils.radDeg;
+    hud.dataset.head = `光标→骨架 (${p.x.toFixed(0)},${p.y.toFixed(0)}) 头骨(${headBone.x.toFixed(0)},${headBone.y.toFixed(0)}) 夹角 ${deg.toFixed(0)}°`;
+  }
+  updateHud();
+}
+
+function updateHud() {
+  const anim = state.tracks[0] ? state.tracks[0].animation.name : "-";
+  hud.textContent =
+    `动画[${animIndex}] ${anim}  循环=${state.tracks[0] ? state.tracks[0].loop : "-"}\n` +
+    `Head_Rot 手动 ${manualHeadRot}°  渲染=${USE_PM ? "premultiplied" : "straight"}  fps≈${fps.toFixed(0)}\n` +
+    `骨架 ${skeleton.data.animations.length} 动画 / ${skeleton.data.bones.length} 骨骼\n` +
+    `包围盒 ${fit ? `offset(${fit.offset.x.toFixed(0)},${fit.offset.y.toFixed(0)}) size(${fit.size.x.toFixed(0)},${fit.size.y.toFixed(0)}) scale=${fit.scale.toFixed(3)}` : "-"}\n` +
+    (hud.dataset.head || "") +
+    `\n按键：←→ 转 Head_Rot · ↑↓/数字/字母 切动画`;
+}
+
+load();

package/pet/renderer/style.css

@@ -0,0 +1,63 @@
+html, body {
+  margin: 0;
+  padding: 0;
+  width: 100%;
+  height: 100%;
+  background: transparent;
+  overflow: hidden;
+  user-select: none;
+  -webkit-user-select: none;
+  cursor: grab;
+}
+
+body:active {
+  cursor: grabbing;
+}
+
+#stage {
+  position: relative;
+  width: 100%;
+  height: 100%;
+}
+
+/* Spine 骨骼动画基底：z1 常驻、永不隐藏（情绪由 track4 数字预设切换，无 DOM 层）。
+   固定在窗口左侧 320px 渲染区（fitCamera 读 canvas.clientWidth 仍按 320 拟合，角色位置/大小不变） */
+#spine {
+  position: absolute;
+  left: 0;
+  top: 0;
+  width: 320px;
+  height: 100%;
+  pointer-events: none;
+  z-index: 1;
+}
+
+
+/* 桌宠文字气泡：定位到角色头部右侧，贴近角色（不遮脸、不高高飘在右上）；
+   top 取头部高度（头 CSS y 40~195），left 紧邻渲染区右缘（320 + 10px 间距）；
+   高于 Spine、鼠标穿透；只显示 mid/final 短消息 */
+#pet-bubble {
+  position: absolute;
+  left: 310px;
+  top: 90px;
+  transform: none;
+  max-width: 220px;
+  padding: 8px 12px;
+  box-sizing: border-box;
+  background: rgba(20, 22, 34, 0.82);
+  border-radius: 14px;
+  color: #fff;
+  font-size: 13px;
+  line-height: 1.45;
+  text-align: left;
+  white-space: pre-line;
+  word-break: break-all;
+  pointer-events: none;
+  z-index: 10;
+  opacity: 1;
+  transition: opacity 0.25s ease;
+}
+
+#pet-bubble.hidden {
+  opacity: 0;
+}

package/pet/tools/gallery_capture.cjs

@@ -0,0 +1,267 @@
+// 表情目视图库截图 harness：逐预设/逐情绪渲染（落定末帧）+ capturePage + 生成目视页
+// 用法（预设模式，22 个数字表情）：
+//   env -u ELECTRON_RUN_AS_NODE ARONA_AGENT=plana ./node_modules/.bin/electron --no-sandbox pet/tools/gallery_capture.cjs
+// 用法（情绪确认模式，按 agents.cjs 映射渲染 17 个情绪，水印 = "情绪名 → 预设"）：
+//   GALLERY_MODE=emotions ARONA_AGENT=plana ...同上...
+// 产物：/tmp/<agent>_emotions/（预设）或 /tmp/<agent>_emotion_map/（情绪）下 PNG + gallery.html
+// 断言：每帧截图前校验 track4 已就位（防止"截到 Idle 基底脸"——B7 规则 4）
+const { app, BrowserWindow, ipcMain } = require("electron");
+const path = require("path");
+const fs = require("fs");
+const PET = path.join(__dirname, "..");
+const { AGENTS } = require(path.join(PET, "agents.cjs"));
+
+const agentId = process.env.ARONA_AGENT && AGENTS[process.env.ARONA_AGENT] ? process.env.ARONA_AGENT : "arona";
+const AGENT = AGENTS[agentId];
+const MODE = process.env.GALLERY_MODE === "emotions" ? "emotions" : "presets";
+// 数字预设普查（CLAUDE.md B5）：arona = 00~32 + 99（34 个）；plana = 00~20 + 99（22 个）；
+// shiroko/hoshino = 00~17 + 99（19 个，精灵图切脸式角色）
+const PRESETS = AGENT.id === "arona"
+  ? [...Array.from({ length: 33 }, (_, i) => String(i).padStart(2, "0")), "99"]
+  : AGENT.id === "plana"
+    ? [...Array.from({ length: 21 }, (_, i) => String(i).padStart(2, "0")), "99"]
+    : [...Array.from({ length: 18 }, (_, i) => String(i).padStart(2, "0")), "99"];
+// 附件签名互异断言仅对骨脸角色（arona/plana）强制；精灵图角色（shiroko/hoshino）可能出现
+// 预设共用同一 sprite（如 99 与 00 同默认脸），碰撞是预期，只警告不算失败。
+const SIGNATURE_UNIQUE_REQUIRED = AGENT.id === "arona" || AGENT.id === "plana";
+
+// 情绪确认模式：17 个情绪名 → 其映射预设（顺序 = agents.cjs 定义顺序）
+const EMOTIONS = Object.entries(AGENT.emotions);
+const OUT = MODE === "emotions" ? `/tmp/${agentId}_emotion_map` : `/tmp/${agentId}_emotions`;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+let win;
+let failures = 0;
+const SIGNATURES = new Map(); // 附件签名 → 预设编号（互不相同断言用）
+
+// watchdog：全流程 ~22 × 3.6s + 新鲜度重试余量，220s 强制退出
+setTimeout(() => { console.log("FATAL watchdog timeout"); app.exit(3); }, 220000);
+
+// 已捕获 PNG 字节列表：新鲜度守卫（透明窗口上 capturePage 会间歇性返回合成器过期纹理，
+// 表现为截图与某张历史帧完全相同——曾导致 06 重复、08 缺失的编号↔脸错位）
+const seenPngs = [];
+
+async function cap(tag) {
+  if (!win || win.isDestroyed()) return;
+  let png = null;
+  for (let attempt = 1; attempt <= 3; attempt++) {
+    win.webContents.invalidate(); // 强制合成器全量重绘后再截
+    await sleep(attempt === 1 ? 200 : 600);
+    const img = await win.webContents.capturePage();
+    png = img.toPNG();
+    if (!seenPngs.some((b) => b.equals(png))) break; // 与所有历史帧都不同 → 新鲜
+    console.log("STALE", tag, "attempt", attempt, "-> retry");
+  }
+  const dup = seenPngs.some((b) => b.equals(png));
+  if (dup) console.log("WARN", tag, "仍与某历史帧完全相同（若附件签名独立，则是两预设视觉相同，非过期帧）");
+  seenPngs.push(png);
+  fs.writeFileSync(path.join(OUT, tag + ".png"), png);
+  console.log("CAP", tag, dup ? "(dup)" : "(fresh)");
+}
+
+/** PNG → data URI（自包含 HTML：图片全部内嵌，单文件可随意移动/另存，换文件名即防缓存） */
+function dataUri(file) {
+  return "data:image/png;base64," + fs.readFileSync(path.join(OUT, file)).toString("base64");
+}
+
+/** 单元格：图片内嵌 + 点击放大（缩略图太小分不清嘴/眉差异，lightbox 看原尺寸 2× DPR 图） */
+function cellHtml(cap, file) {
+  const q = JSON.stringify(cap);
+  return `<div class="cell" onclick='zoom(${q}, this.querySelector("img").src)'><img src="${dataUri(file)}"><div class="cap">${cap}</div></div>`;
+}
+
+/**
+ * 目视 contact sheet（自包含单文件 HTML，任何浏览器可直接打开）：
+ * - 图片 base64 内嵌（无相对路径依赖、无 file:// 旧缓存复用问题）
+ * - 点击图片全屏放大（标题随动）
+ * - binder 非空时（预设模式）附"映射重绑面板"：17 情绪 × 下拉选预设（默认 = 当前映射），
+ *   一键生成 emotions 映射文本并复制，用户直接粘贴回对话，避免手抄错号
+ */
+function writeSheet({ title, cells, binder }) {
+  const binderBlock = binder
+    ? `<div id="binder">
+  <h2>重新绑定映射：为每个情绪选一个预设编号（下拉默认 = 当前映射，只改你要改的）</h2>
+  <div id="rows"></div>
+  <button class="btn" onclick="genMap()">生成映射文本（并复制）</button>
+  <span id="copyhint" style="margin-left:10px;font-size:12px;color:#8f8"></span>
+  <textarea id="out" readonly spellcheck="false"></textarea>
+</div>
+<script>
+const PRESETS = ${JSON.stringify(PRESETS)};
+const CURRENT = ${JSON.stringify(Object.fromEntries(binder))};
+const rows = document.getElementById('rows');
+for (const name of Object.keys(CURRENT)) {
+  const wrap = document.createElement('div');
+  const lab = document.createElement('label');
+  lab.textContent = name + ' ';
+  const sel = document.createElement('select');
+  sel.dataset.e = name;
+  for (const p of PRESETS) {
+    const opt = document.createElement('option');
+    opt.value = p;
+    opt.textContent = p;
+    if (p === CURRENT[name]) opt.selected = true;
+    sel.appendChild(opt);
+  }
+  wrap.appendChild(lab);
+  wrap.appendChild(sel);
+  rows.appendChild(wrap);
+}
+function genMap() {
+  const lines = Object.keys(CURRENT).map(
+    (name) => '  ' + name + ': "' + document.querySelector('select[data-e="' + name + '"]').value + '",',
+  );
+  const out = document.getElementById('out');
+  out.value = 'emotions = {\\n' + lines.join('\\n') + '\\n}';
+  out.style.display = 'block';
+  out.focus();
+  out.select();
+  try {
+    document.execCommand('copy');
+    document.getElementById('copyhint').textContent = '已复制，直接粘贴给 Agent 即可';
+  } catch (e) {}
+}
+</script>`
+    : "";
+  const html = `<!DOCTYPE html>
+<html><head><meta charset="utf-8"><title>${agentId} 表情目视</title>
+<style>
+  body { background:#1a1a1a; color:#eee; font-family: Menlo, Consolas, monospace; padding: 20px; }
+  h1 { font-size: 18px; }
+  .grid { display:flex; flex-wrap:wrap; gap:16px; margin-top:16px; }
+  .cell { background:#2a2a2a; border:1px solid #444; border-radius:6px; padding:8px; text-align:center; cursor:zoom-in; }
+  .cell img { width:280px; height:590px; display:block; }
+  .cap { margin-top:6px; font-size:15px; font-weight:bold; color:#9fd3ff; }
+  #lightbox { display:none; position:fixed; inset:0; background:rgba(0,0,0,.93); z-index:10; cursor:zoom-out; text-align:center; }
+  #lightbox .cap { font-size:24px; margin-top:12px; }
+  #lightbox img { max-width:96vw; max-height:88vh; }
+  #binder { position:sticky; top:0; z-index:5; background:#111; border:1px solid #444; border-radius:8px; padding:12px 18px; }
+  #binder h2 { font-size:14px; margin:0 0 10px; }
+  #rows { display:flex; flex-wrap:wrap; gap:6px 18px; }
+  #rows label { font-size:13px; }
+  #rows select { font:inherit; font-size:13px; background:#2a2a2a; color:#eee; border:1px solid #555; border-radius:4px; padding:2px 6px; }
+  .btn { margin-top:10px; font:inherit; background:#2f6fb0; color:#fff; border:none; border-radius:4px; padding:6px 14px; cursor:pointer; }
+  #out { display:none; width:100%; box-sizing:border-box; margin-top:10px; height:120px; background:#222; color:#9f9; font:13px Menlo, Consolas, monospace; border:1px solid #555; }
+</style></head>
+<body>
+${binderBlock}
+<h1>${title}</h1>
+<div class="grid">\n${cells}\n</div>
+<div id="lightbox" onclick="this.style.display='none'"><div class="cap" id="lb-cap"></div><img id="lb-img" alt=""></div>
+<script>
+function zoom(cap, src) {
+  document.getElementById('lb-cap').textContent = cap;
+  document.getElementById('lb-img').src = src;
+  document.getElementById('lightbox').style.display = 'block';
+}
+</script>
+</body></html>`;
+  fs.writeFileSync(path.join(OUT, "gallery.html"), html);
+}
+
+app.whenReady().then(() => {
+  fs.mkdirSync(OUT, { recursive: true });
+  win = new BrowserWindow({
+    width: 320, height: 674, transparent: true, frame: false, show: true,
+    // 窗口被遮挡/后台时 rAF 与 DOM 合成会被节流 → capturePage 拿到过期纹理；关闭节流
+    webPreferences: { preload: path.join(PET, "preload.cjs"), contextIsolation: true, nodeIntegration: false, backgroundThrottling: false },
+  });
+  win.webContents.on("console-message", (_e, _a, b) => console.log("[R]", b));
+  ipcMain.handle("pet:get-agent-config", () => ({ id: agentId, ...AGENT }));
+  ipcMain.on("pet:drag", () => {});
+  ipcMain.on("pet:dragend", () => {});
+  ipcMain.on("pet:shake", () => {});
+  win.loadFile(path.join(PET, "renderer", "gallery.html"), { search: "agent=" + agentId });
+
+  win.webContents.on("did-finish-load", async () => {
+    const t0 = Date.now();
+    while (true) {
+      try {
+        // ⚠️ 不能用 !== null：__gallery 未赋值时是 undefined（undefined !== null 为 true）
+        if (await win.webContents.executeJavaScript("typeof window.__gallery === 'object' && typeof window.__gallery.show === 'function'")) break;
+      } catch {}
+      if (Date.now() - t0 > 15000) { console.log("FATAL init timeout"); app.exit(3); return; }
+      await sleep(200);
+    }
+    console.log("READY", agentId, "mode:", MODE, "items:", MODE === "emotions" ? EMOTIONS.length : PRESETS.length);
+
+    if (MODE === "emotions") {
+      // 情绪确认模式：水印 = "情绪名 → 预设编号"，文件名 = <情绪名>_settled.png
+      for (const [name, preset] of EMOTIONS) {
+        try {
+          await win.webContents.executeJavaScript(`window.__gallery.showEmotion(${JSON.stringify(name)}, ${JSON.stringify(preset)})`);
+        } catch (e) {
+          console.log("CHECK emotion", name, "FAIL exec:", e.message);
+          failures++;
+          continue;
+        }
+        await sleep(120);
+        const st = JSON.parse(await win.webContents.executeJavaScript("JSON.stringify(window.SpineLayer.getState())"));
+        if (st.track4 !== preset) {
+          console.log("CHECK emotion", name, "FAIL track4=" + st.track4 + " != " + preset);
+          failures++;
+        }
+        await sleep(3600); // 等 3.333s 动画落定到末帧
+        await cap(name + "_settled");
+      }
+      const cells = EMOTIONS.map(([name, preset]) =>
+        cellHtml(`${name} → preset ${preset}`, name + "_settled.png"),
+      ).join("\n");
+      writeSheet({ title: `${agentId} 情绪映射确认（settled 末帧，共 ${EMOTIONS.length} 个）`, cells, binder: null });
+      console.log(failures === 0 ? "ALL OK" : failures + " FAILURES");
+      console.log("DONE →", OUT, "(open gallery.html)");
+      app.exit(failures === 0 ? 0 : 2);
+      return;
+    }
+
+    // 参考帧：Idle_01 基底（track0 常驻循环，不动 track4）
+    await sleep(800);
+    await cap("idle_base");
+
+    for (const p of PRESETS) {
+      try {
+        await win.webContents.executeJavaScript(`window.__gallery.show(${JSON.stringify(p)})`);
+      } catch (e) {
+        console.log("CHECK preset", p, "FAIL exec:", e.message);
+        failures++;
+        continue;
+      }
+      await sleep(120);
+      // B7 规则 4：截图前验证 track4 已就位（像素会骗人，状态不会）
+      const st = JSON.parse(await win.webContents.executeJavaScript("JSON.stringify(window.SpineLayer.getState())"));
+      if (st.track4 !== p) {
+        console.log("CHECK preset", p, "FAIL track4=" + st.track4);
+        failures++;
+      }
+      // 附件签名断言：骨脸角色预设签名必须互不相同（B5 普查）；碰撞 = 预设未生效。
+      // 精灵图角色允许共用签名（同一 sprite 复用），仅打印 WARN。
+      const sig = await win.webContents.executeJavaScript("window.SpineLayer.getAttachmentSignature()");
+      if (SIGNATURES.has(sig)) {
+        const prev = SIGNATURES.get(sig);
+        if (SIGNATURE_UNIQUE_REQUIRED) {
+          console.log("CHECK preset", p, "FAIL 附件签名与 preset " + prev + " 碰撞");
+          failures++;
+        } else {
+          console.log("WARN preset", p, "附件签名与 preset " + prev + " 相同（精灵图共用 sprite，预期内）");
+        }
+      } else {
+        SIGNATURES.set(sig, p);
+      }
+      await sleep(3600); // 等 3.333s 动画落定到末帧
+      await cap("p" + p + "_settled");
+    }
+
+    // 目视 contact sheet（自包含单文件，附映射重绑面板）
+    const cells = [
+      cellHtml("Idle_01 基底", "idle_base.png"),
+      ...PRESETS.map((p) => cellHtml("preset " + p, "p" + p + "_settled.png")),
+    ].join("\n");
+    writeSheet({
+      title: `${agentId} 数字情绪预设（settled 末帧，共 ${PRESETS.length} 个）— 点击图片放大；顶部面板重绑映射`,
+      cells,
+      binder: EMOTIONS,
+    });
+    console.log(failures === 0 ? "ALL OK" : failures + " FAILURES");
+    console.log("DONE →", OUT, "(open gallery.html)");
+    app.exit(failures === 0 ? 0 : 2);
+  });
+});