踩坑清单（15 条）
来源：换装试衣_完整技术档案 §28.4 · 记录时间 2026-11-11 10:25 · 每条都真实踩过，附"以后怎么办"
1截图"右边被切"，其实页面没问题排版/截图
根因：Edge headless 的 --window-size 不等于 CSS 宽度（390 实际 492；再加 force-device-scale-factor=2 又变 484）。
以后：用 iframe 指定真实 CSS 宽度再截图（/preview?one=390），别拿 window-size 当视口。
2截图函数返回 0 字节PowerShell
根因：$args 是 PowerShell 自动变量，赋值被吞。
以后：换名（$argv）。
3补丁把函数名插进了正则代码
根因：替换串里写了 $&，String.replace 把它当成"匹配到的内容"展开。
以后：替换串里别写 $&；用函数式替换，或按行重写。
4"加了功能"但一次没生效最危险
根因：persons 是 const，赋值抛错被内层 try/catch 吞掉，接口照常返回 200。
以后：干跑钩子暴露真实行为；改 let；记住 接口 200 ≠ 功能生效。
5预览块报 ReferenceErrorJS
根因：演示代码跑在 const bn 之前（TDZ）。
以后：用 setTimeout 延后到脚本末尾再跑。
6空衣服数组照样出图、钱照扣花钱
根因：上游不校验；既有判据只覆盖"没人物/参考图丢"。
以后：前置闸门 NO_GARMENT / BAD_GARMENT（已加）。
7补丁脚本语法错 missing ) after argument list代码
根因：模板字符串嵌套 + 中文引号（"套"）把字符串截断。
以后：补丁用单引号字符串或独立 .txt 读入；中文引号换「」。
8中文文件名 404服务端
根因：静态服务没解 URL 编码。
以后：decodeURIComponent。
9说明页窄屏文字被截排版
根因：表格把容器撑宽。
以后：table-layout:fixed + word-break + overflow-x:hidden。
10版本缩略图上的按钮变成一大块橙色CSS
根因：全局 .thumb button（20×20 圆）覆盖了新按钮样式。
以后：给新按钮专用 class（.vuse/.vchip）。
11服务突然连不上（ECONNREFUSED 8899）运维
根因：重启脚本 kill 了旧进程，新进程没起来。
以后：每次重启后先打 /api/meta 确认再干活。
12白花 ¥0.05花钱
根因：想用"空 garments"当零成本探针，结果上游照常出图。
以后：零成本验证走显式干跑开关，别指望"参数不合法会被拦"。
13瘦脸位移只有 0.14 px算法
根因：把文档里的 κ=0.10 当成像素系数。
以后：按脸宽比例标定（--amp）。
143D 塑形脸被整体推移、发际线糊算法
根因：① 只用质心对齐；② 全部顶点都 splat。
以后：① 4 点相似变换（眼/鼻/嘴）；② 正面半区 + 上下渐隐。
153D 方向反了判据
根因：用"肤色窗口宽度"当方向判据。
以后：判方向只用 68 点关键点。
一句话：指标骗人比模型骗人更贵 —— 模型错了换个提示词就行，指标错了会朝错方向修半天。