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