Files
jinzuanwork/order/skincheck.js
T

246 lines
13 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/* =========================================================
皮肤质检(共用)—— 网页下单页 和 本机开单工具 共用这一份
⚠️ 绝对不要复制成两份:两边判定一旦不一致,
就会出现「网页说能渲、本地渲不出来」这种最难查的 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<r[3];y++) for(let x=r[0];x<r[2];x++){
const a=A(x,y); total++;
if(a===0) clear++; else if(a<255) semi++;
}
}
return {total, clear, semi, clearPct: total?clear/total*100:0, semiPct: total?semi/total*100:0};
}
const AR = arm.model==='slim' ? ARM.slim : ARM.classic;
const baseAll=[], ovlAll=[], partStat={};
const groups=[['头',BASE.head],['身体',BASE.body],['右臂',AR.armR],['左臂',AR.armL],
['右腿',BASE.legR],['左腿',BASE.legL]];
for(const [cn,rs] of groups){ baseAll.push(...rs); partStat[cn]=stat(rs); }
for(const rs of Object.values(OVL)) ovlAll.push(...rs);
const base = stat(baseAll), ovl = stat(ovlAll);
/* --- 4. 颜色数(判断是不是像素风皮肤) --- */
const seen=new Set();
for(let i=0;i<D.length;i+=4){
if(D[i+3] < 8) continue;
seen.add((D[i]>>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/ys-order/pngcheck.py 的**镜像**,两边判定必须一致:
前端负责「拦」(给人看明白的原因),后端负责「剥」(存下来的是干净字节)。
改一边必须同步改另一边 —— 共享用例在 /opt/ys-order/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};
}