范围由店主圈定:网页后端 / 自助后端、本地的自助管理后台、 用于测试的 Blender 工程、以及部署层的反代片段。 出站纪律:所有指向真实环境的值(域名/端口/盘符路径/IP/账户名)已替换为占位; 代码里本来就没有硬编码凭据(令牌走文件与环境变量)。 Blender 工程因内嵌绝对路径,做了等长替换(文件字节数未变,结构完好)。 两份交接文档各含《我们的思路与方法》,并要求对方回: 问题分析 + 改正意见 + 他改了什么(含是否动到接口/字段/数据格式)。
246 lines
13 KiB
JavaScript
246 lines
13 KiB
JavaScript
/* =========================================================
|
||
皮肤质检(共用)—— 网页下单页 和 本机开单工具 共用这一份
|
||
⚠️ 绝对不要复制成两份:两边判定一旦不一致,
|
||
就会出现「网页说能渲、本地渲不出来」这种最难查的 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/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};
|
||
}
|