/* ========================================================= 皮肤质检(共用)—— 网页下单页 和 本机开单工具 共用这一份 ⚠️ 绝对不要复制成两份:两边判定一旦不一致, 就会出现「网页说能渲、本地渲不出来」这种最难查的 bug。 ========================================================= */ /* ---------------- 标准 64 网格分区(来自 MC 皮肤规范) ---------------- ⚠️ 手臂区粗臂(4px)/细臂(3px)分区不同,必须按判定结果取用。 实测教训:细臂皮肤若用粗臂的 4px 框去统计,会有 2.94% 被当成「主体镂空」 → 直接被红牌拦下(其实是正常皮肤那一列本来就空着)。 */ const BASE = { head:[[8,0,16,8],[16,0,24,8],[0,8,8,16],[8,8,16,16],[16,8,24,16],[24,8,32,16]], body:[[20,16,28,20],[28,16,36,20],[16,20,20,32],[20,20,28,32],[28,20,32,32],[32,20,40,32]], legR:[[4,16,8,20],[8,16,12,20],[0,20,4,32],[4,20,8,32],[8,20,12,32],[12,20,16,32]], legL:[[20,48,24,52],[24,48,28,52],[16,52,20,64],[20,52,24,64],[24,52,28,64],[28,52,32,64]] }; const ARM = { classic:{ armR:[[44,16,48,20],[48,16,52,20],[40,20,44,32],[44,20,48,32],[48,20,52,32],[52,20,56,32]], armL:[[36,48,40,52],[40,48,44,52],[32,52,36,64],[36,52,40,64],[40,52,44,64],[44,52,48,64]] }, slim:{ /* 细臂:手臂宽 3px,顶/底面也只用 3 列(第 4 列是空的) —— 这正是渲染端两条判据(x=47 / x=51 处 y=17 镂空)在测的特征。 若这里按 4px 画,皮肤会被自己的质检判成「粗臂」(3粗/1细),自相矛盾。 */ armR:[[44,16,47,20],[48,16,51,20],[40,20,44,32],[44,20,47,32],[47,20,50,32],[50,20,54,32]], armL:[[36,48,39,52],[40,48,43,52],[32,52,36,64],[36,52,39,64],[39,52,42,64],[42,52,46,64]] } }; const OVL = { 头外层:[[32,0,64,16]], 身外层:[[16,32,40,48]], 右臂外层:[[40,32,56,48]], 左臂外层:[[48,48,64,64]], 右腿外层:[[0,32,16,48]], 左腿外层:[[16,48,32,64]] }; const ARM_GROUPS = {右臂:'armR', 左臂:'armL'}; /* ---------------- 皮肤分析 ---------------- */ function analyze(img, origW, origH){ const c = document.createElement('canvas'); c.width = 64; c.height = 64; const g = c.getContext('2d', {willReadFrequently:true}); g.imageSmoothingEnabled = false; g.clearRect(0,0,64,64); g.drawImage(img, 0, 0, 64, 64); const D = g.getImageData(0,0,64,64).data; const A = (x,y) => D[((y*64)+x)*4+3]; /* --- 1. 尺寸 --- 皮肤分辨率没有"标准值"这回事:64 是基准,往上 128/192/256/512/1024…都是同一个 64 网格的整倍数放大,所以只要【正方形 + 64 的整倍数】就是标准皮肤。 另外把 16/32 这类小图和其它正方形尺寸也识别出来(标注非常规、允许人工确认继续)。 非正方形 = 旧版 2:1(64×32),没有独立左右臂/腿纹理,模板渲不了。 */ const sq = (origW === origH); const mult64 = sq && origW >= 64 && origW % 64 === 0; const legacy = (origH * 2 === origW) || (!sq && origW > origH); const tooBig = (origW > 4096 || origH > 4096); const tooSmall = sq && origW < 16; /* --- 2. 臂型(与 make_order.py 同算法:4 票制) --- */ const arm = (function(){ let slim=0, classic=0; const v=[]; let nt=0; for(let x=40;x<56;x++) if(A(x,25)===0) nt++; const c1 = nt>=2 ? 'slim' : 'classic'; c1==='slim'?slim++:classic++; v.push({n:'侧面行 y=25 透明列数', val:nt+' 列', r:c1==='slim'?'细臂':'粗臂'}); const pairs=[[47,'顶面第 4 列 x=47'],[51,'底面第 4 列 x=51']]; for(const [x,lab] of pairs){ const empty = A(x,17)===0; empty?slim++:classic++; v.push({n:lab, val:empty?'镂空':'已涂色', r:empty?'细臂':'粗臂'}); } let cols=0; for(let x=44;x<52;x++){ let has=false; for(let y=16;y<20;y++) if(A(x,y)>0){has=true;break;} if(has) cols++; } const c4 = cols<=6 ? 'slim' : 'classic'; c4==='slim'?slim++:classic++; v.push({n:'y16-19 有效列数 x44-51', val:cols+'/8', r:c4==='slim'?'细臂':'粗臂'}); const model = slim>classic ? 'slim':'classic'; const conf = Math.max(slim,classic); return {model, slim, classic, conf, certain: conf>=3, votes:v}; })(); /* --- 3. 分层像素统计(手臂区按判定出的臂型取框,见上方教训) --- */ function stat(rects){ let total=0, clear=0, semi=0; for(const r of rects){ for(let y=r[1];y>3<<10)|(D[i+1]>>3<<5)|(D[i+2]>>3)); if(seen.size>6000) break; } return {sq, mult64, legacy, tooBig, tooSmall, origW, origH, arm, base, ovl, partStat, colors:seen.size}; } /* ---------------- 生成检测报告 ---------------- */ function buildReport(a){ const out=[]; let hasBad=false, hasWarn=false; const push=(lv,tag,t,d)=>{out.push({lv,tag,t,d}); if(lv==='bad')hasBad=true; if(lv==='warn')hasWarn=true;}; /* 尺寸:只要正方形 + 64 的整倍数都算标准;放大倍数直接说出来 */ const sz = a.origW+'×'+a.origH; const times = a.mult64 ? (a.origW/64) : 0; if(a.mult64){ push('ok','通过','图片规格 '+sz, times===1 ? '标准皮肤尺寸(64 网格)' : times+" 倍高清皮肤("+times+"×"+times+" 像素块,会按 64 网格解析,出图精度不受影响)"); } else if(a.tooBig){ push('bad','不通过','图片规格 '+sz,'图太大了(上限 4096×4096)。请先缩到 1024 或 512 再传。'); } else if(a.tooSmall){ push('bad','不通过','图片规格 '+sz,'图太小了(最小 16×16),装不下一套皮肤的分区。'); } else if(a.legacy){ push('bad','不通过','图片规格 '+sz,'这是旧版 2:1 皮肤(没有独立的左臂/左腿纹路),模板无法正确渲染,需要的是正方形皮肤。'); } else if(a.sq){ push('warn','注意','图片规格 '+sz, '能识别,但不是 64 的整倍数(如 64 / 128 / 256 / 512 / 1024),也不是标准皮肤分区比例。' +'会按 64 网格缩放解析;如果皮肤本身是照标准画的,通常也能出图,但有错位风险 —— 你确认没问题就勾下面的「无视风险」。'); } else { push('bad','不通过','图片规格 '+sz,'这不是皮肤比例(应为正方形,或旧版的 2:1)。请确认传的是皮肤图。'); } /* 是否像皮肤 */ if(a.colors>3000) push('warn','注意','图片来源看着不像皮肤','画面颜色数异常多('+a.colors+'+ 色),像素风皮肤一般不到几百色。确认没有传错图(比如误传照片或渲染成品图)。'); else push('ok','通过','像素风检查','颜色数 '+a.colors+',符合像素风皮肤特征'); /* 主体层镂空 */ const bp=a.base.clearPct; const badParts=Object.entries(a.partStat).filter(([,s])=>s.clearPct>1.5).map(([n,s])=>n+'('+s.clearPct.toFixed(1)+'%)'); if(bp>2){ push('bad','不通过','主体层有大量镂空','皮肤本体共有 '+bp.toFixed(1)+'% 的像素是全透明的' +(badParts.length?',集中部位:'+badParts.join('、'):'')+'。渲染出来身体会「漏空」,请先把本体补实再提交。'); }else if(bp>0.2){ push('warn','注意','主体层有小面积镂空','本体有 '+bp.toFixed(1)+'% 的像素是透明的' +(badParts.length?',主要在:'+badParts.join('、'):'')+'。多数情况能正常出图,少数会在成图上看到细小的透光点。'); }else{ push('ok','通过','主体层完整','本体没有明显镂空'); } /* 半透明 */ const semiN = a.base.semi + a.ovl.semi; if(a.base.semi>30){ push('warn','注意','存在半透明像素','本体层有 '+a.base.semi+' 个半透明像素(alpha 不是全实心)。渲染边缘可能出现毛边或色差。'); }else if(semiN>0){ push('warn','注意','存在少量半透明像素','全图 '+semiN+' 个半透明像素,通常不影响出图,但边缘可能略有杂色。'); }else{ push('ok','通过','透明度正常','未发现半透明像素'); } /* 外层 */ const op=a.ovl.clearPct; if(a.ovl.total && op>99.5){ push('ok','通过','外层(第二层)未使用','这套皮肤没有用外套/帽子层,属正常情况'); }else if(a.ovl.total && op<2){ push('warn','注意','外层几乎铺满','外层(帽子/外套)几乎每一格都有颜色。如果本意是「只有部分外套」,可能是不小心整层涂满了。'); }else{ push('ok','通过','外层覆盖正常','外层(帽子/外套)有内容也有留白,符合常见皮肤画法'); } /* 臂型 */ if(a.arm.certain){ push('ok','通过','手臂规格 · '+(a.arm.model==='classic'?'粗臂(Steve 4px)':'细臂(Alex 3px)'), '判定明确(' + Math.max(a.arm.slim,a.arm.classic) + '/4 项)。渲染时会用' + (a.arm.model==='classic'?'粗臂':'细臂') + '模型。若你觉得不对,可在下面手动改。'); }else{ push('warn','注意','手臂规格判定不确定', '4 项检验只命中 '+Math.max(a.arm.slim,a.arm.classic)+' 项('+(a.arm.classic)+' 粗 / '+(a.arm.slim)+' 细),这类皮肤容易判错。' +'请自己在下面确认一下手臂是粗的还是细的——判错会导致皮肤整体错位。'); } return {items:out, hasBad, hasWarn}; } /* ---------------- PNG 结构核验(防夹带私货) ---------------- ⚠️ 这份是 /opt/order-app/pngcheck.py 的**镜像**,两边判定必须一致: 前端负责「拦」(给人看明白的原因),后端负责「剥」(存下来的是干净字节)。 改一边必须同步改另一边 —— 共享用例在 /opt/order-app/tests/png_struct_test.py。 拦什么:尾部夹带 / 未知关键块 / APNG / 结构损坏 / 非 PNG 只警告:tEXt 等元数据块(很多编辑器会加,后端会剥掉,不算错) u8: Uint8Array(整个文件字节)→ {ok, reason, notes} ------------------------------------------------------------- */ function checkPngBytes(u8){ const notes=[]; const bad=(why)=>({ok:false, reason:why, notes:notes}); const SIG=[0x89,0x50,0x4E,0x47,0x0D,0x0A,0x1A,0x0A]; if(!u8 || u8.length < 33) return bad('不是 PNG 文件'); for(let i=0;i<8;i++){ if(u8[i]!==SIG[i]) return bad('不是 PNG 文件'); } const STRIP=['tEXt','zTXt','iTXt','eXIf','tIME','sPLT','hIST']; const OK_CRIT=['IHDR','PLTE','IDAT','IEND']; const OK_ANC=['PLTE','tRNS','gAMA','cHRM','sRGB','iCCP','bKGD','pHYs','sBIT']; const rd=(o)=>((u8[o]<<24)>>>0)+(u8[o+1]<<16)+(u8[o+2]<<8)+u8[o+3]; const typ=(o)=>String.fromCharCode(u8[o],u8[o+1],u8[o+2],u8[o+3]); let off=8, n=0, seenIhdr=false, seenIdat=false, seenIend=false; while(off < u8.length){ if(++n > 4096) return bad('PNG 结构异常(块数量过多)'); if(off+8 > u8.length) return bad('PNG 文件损坏(块头不完整)'); const ln=rd(off), t=typ(off+4), end=off+12+ln; if(end > u8.length) return bad('PNG 文件损坏(块数据不完整)'); if(t==='IHDR'){ if(off!==8) return bad('PNG 结构异常(IHDR 不在最前)'); seenIhdr=true; }else if(t==='IEND'){ seenIend=true; const tail=u8.length-end; if(tail>0) return bad('图片尾部夹带了 '+tail+' 字节额外数据(正常 PNG 到 IEND 就该结束)'); break; }else if(t==='acTL'){ return bad('这是动画 PNG(APNG),请用普通静态 PNG'); }else if(t==='IDAT'){ seenIdat=true; }else if(OK_ANC.indexOf(t)>=0){ /* 允许 */ }else if(STRIP.indexOf(t)>=0){ notes.push('已剥掉元数据块 '+t); }else{ const critical = (u8[off+4] & 0x20) === 0; /* PNG 规范:首字母大写=关键块 */ if(critical && OK_CRIT.indexOf(t)<0) return bad('图片里有无法识别的内容块 '+t); notes.push('已剥掉附加块 '+t); } off=end; } if(!seenIhdr) return bad('PNG 缺少 IHDR(不是完整图片)'); if(!seenIdat) return bad('PNG 缺少图像数据(IDAT)'); if(!seenIend) return bad('PNG 没有正常结束(缺 IEND)'); return {ok:true, reason:'', notes:notes}; }