diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..24a7d22 --- /dev/null +++ b/.gitignore @@ -0,0 +1,28 @@ +# 凭据与本地环境 +.env +.env.* +*.key +*.pem +*.p12 +*.pfx + +# 本地/编辑器杂项 +.DS_Store +Thumbs.db +.vscode/ +.idea/ +node_modules/ +dist/ + +# 备份、调试与临时产物 +*.bak +*.bak-* +*.log +_debug_* +_repro_* +_shots/ +*.tmp + +# 原始私有素材与原站导出(协作仓只保留脱敏副本) +raw/ +backup/ diff --git a/order/index.html b/order/index.html new file mode 100644 index 0000000..2273083 --- /dev/null +++ b/order/index.html @@ -0,0 +1,4179 @@ + + + + + +自助模板渲染 · 金钻工坊 + + + + + + + + + + + + + + +
+
+
+

自助模板渲染

+ 金钻工坊 · 传皮肤 · 选模板 · 出图 +
+ 检测中… +
+
+
+ +
+ + +
+

要做什么?

+
两条路,选一条。
+
+ + + + + +
+ + + +
+
+ 已经下过单、要取成品? + + +
+
+ + +
+
1

上传皮肤 · 自动质检

+
支持 64 / 128 / 256 / 512 / 1024 等任何分辨率的皮肤(.png,单个文件最大 10MB)。质检在你的浏览器里本地完成。
+ +
+ +
+ 查看条款全文 +
服务条款 · 版本 2026-10-01.1
+
+1. 网站服务只提供渲染服务:把你上传的皮肤图按你选择的模板渲染成一张成图。不创作、不编辑、不修改皮肤内容。
+2. 本站不对皮肤内容与渲染结果作任何合规担保。皮肤由买家自行提供,其内容的合法性由提供者负责。
+3. 因皮肤内容(含夹带数据、隐藏信息、违规图案等)产生的任何后果,由皮肤提供者承担,与本站无关。
+4. 渲染全流程由脚本自动执行,本站不对皮肤内容作人工审核;人工介入或维护时如发现违法内容,将拒绝接单并删除相关文件。
+5. 渲染效果由所选模板决定。模板质量问题请联系金钻维护修复;非模板质量问题不予重做。
+6. 提交订单并使用卡密,即视为已阅读并同意本条款。
+7. 本站保留订单号、IP 与提交时间记录,用于争议处理及配合有权机关调查。
+
+
+ + + + + + +
+ + +
+
2

出图组合

+
一张单可以放 多张皮肤,每张各挑各的模板 —— + 出图数 = 实际配出来的张数(皮肤 A 用麦田、皮肤 B 用樱花,就是 2 张)。 + 两种看法而已,数据是同一份。
+
+
+
皮肤(每张各自判粗/细臂)
+
+ +
下面勾这张皮肤要出的模板
+
+ +
+ + +
+
出图分辨率 —— 越高越慢。 + 默认 1000 是网易我的世界头图的标准分辨率; + 换更高的,文件名会带上数字(如 飞跃樱花林2048.png)
+
+
+
+
+ + +
+
+ + +
+
3

卡密

+
一行一个,多个码会合并成一个单子一次提交。一个码 = 一次渲染机会(一张图)。 +
+ +
+
+ + +
+
+ + +
+
4

整单核对

+
确认无误再提交。提交后会进入渲染队列。
+
+
合计出图0 张
+
+ +
+
+ + +
+
+ + + + + +
+ +
+
+ + + + + + + + + + + + + diff --git a/order/skincheck.js b/order/skincheck.js new file mode 100644 index 0000000..252d5a7 --- /dev/null +++ b/order/skincheck.js @@ -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>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}; +} diff --git a/portal/assets/tokens.css b/portal/assets/tokens.css new file mode 100644 index 0000000..7055de9 --- /dev/null +++ b/portal/assets/tokens.css @@ -0,0 +1,76 @@ +/* ========================================================================== + 金钻系 · 统一设计 tokens(唯一真源) + --------------------------------------------------------------------------- + 四个界面共用同一套设计语言与动效规范: + ① 主站 / 金钻客栈 https://example.com/ + ② 自助模板渲染 https://example.com/order/ + ③ 待会儿办 https://example.com/todo/ + ④ 本地开单后台 http://<家里电脑>:8899(HTML/CSS 内联在 ys_admin.py, + 引不到本文件 → 复制同一份变量值内联) + 规范文档:(本机路径)/设计规范.md + 动效口径:Emil Kowalski 的 skills(github.com/emilkowalski/skills,MIT) + --------------------------------------------------------------------------- + ⚠️ 引入顺序:本文件必须放在各页面自身 + + + +
+ +
+
EXAMPLE · SEASON × TECH LAB
+

春意 × 轻科技实验室 —— 同一套配色,五种厚度

+

+ 配色按你说的锁 1 号(冷黑 #0b0d0e + 翡翠绿 #3ecf8e + 7px 圆角)。 + 这一版把「春天」的味道做足,再用轻科技压住"娘"、加"精密"的质感: + 0 素版(对照)→ 1 轻花 → 2 中花 → 3 重花 → 3′ 净版。五档颜色一模一样,只叠不同厚度的装饰。 + 3′ 就是 3 去掉「斜切晨光」和「网格底纹」两样(其余全留)。点编号切换,直接并排比。 +

+
+ +
+
+ + + + + + +
+
+ + + + +
+ + +
+ +
+
金钻客栈
+ +
+ + +
+
+ 01 / HERO + +
+

把照片交给金钻,剩下我们来办。

+ +

上传 → 选模板 → 出图,全程自助;手机上也能开单。

+
+ + +
+
+ + +
+
+
01在办
+

证件照精修

+

换底色、修轮廓,当天出图。

+ 热销 +
+
+
02排期
+

老照片修复

+

去划痕、补缺损,尽量还原本来的样子。

+ 需排期 +
+
+
03批量
+

团建合影

+

整组调色统一,出片直接能用。

+ 批量 +
+
+ + +
+ 全部 + 证件照 + 修复 + 合影 + 加急 +
+ + +
+ + +
+ + +
+ + +
+ + +
+
+
+ + +

+ + +

五档一览

+

五档颜色完全相同,区别只在叠了多少层装饰。1→2→3 每档只在前一档上加一层;3′ 是 3 的「减法版」(见表格最后一行)。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
档位加了什么代价减弱动效下
0 素版什么都不加 —— 现行统一设计语言本身(空白对照)零代价,四个界面现在就是它无变化
1 轻花晨光(左上斜切,峰值 7%)+ 极淡网格底纹(1px,2.8%)几乎为零;全是静态光影,无动效、不吃 GPU完全一样(本来就是静态)
2 中花1 档 + 新芽黄绿次强调(激活标签 / 卡片角 / 细线)+ 等宽小标签与刻度线(轻科技)+ 卡片 hover「苏醒」(泛绿 + 1px 上浮 + 角透新芽色)+ 春雨灰蓝冷雾 + 叶脉纹理 + 晨光斜切边 hairline出现第二个色相(新芽黄绿),必须永远只当"次强调",一旦当主色就滑向"奶茶 / 糖果",是最考验分寸的一档;hover 的 1px 上浮是位移新芽静态色保留;hover 去掉上浮(只留泛绿 + 描边)
3 重花
(含斜线 + 网格)
2 档 + 会"生长"的强调色细线(7s 缓缓长出来,不是闪烁)+ 晨光里的浮尘(46s 极慢上浮,峰值 8%)最"贵":持续动画吃一点 GPU 与电量,静态截图 / 录屏里细尘可能显"脏",低端机更明显生长线定格成静态细线;浮尘降到 5.5% 且不动
3′ 重花·去斜网
(= 3 − 斜光 − 网格)
就是 3 档,只去掉两样:① 斜切晨光(118° 左上光束,峰值 7%)② 网格底纹(1px,峰值 2.8%)。
其余全留:新芽黄绿次强调、等宽小标签与细刻度、卡片 hover「苏醒」(泛绿 + 1px 上浮 + 角透新芽色)、会"生长"的强调色细线(7s)、晨光浮尘(46s,≤8%)、春雨冷雾、叶脉纹理。
为免去掉后显空,补两样克制的:顶部水平渐隐光(≤5%,非斜切)+ 卡片角落 2 段 1px 刻度线。
与 3 档相同(持续动画照旧)。好处:没有方向性光斑,整体更"安静、耐看",静态截图 / 录屏更耐脏;补光全是静态,不多吃 GPU与 3 档相同:生长线定格、浮尘降到 5.5% 且不动;顶部渐隐光本就是静态
+ +

+ 说明:本页只是观感 demo,占位文案、没有真数据、不会保存任何输入。
+ 四个界面(主站 / 自助模板渲染 / 待会儿办 / 本地开单后台)一行都没改;选定档位后再按「先铺 tokens、一处一验」的流程逐界面改造。
+ 设计规范参考 Emil Kowalski 的 skills(github.com/emilkowalski/skills,MIT);主站 / 自助模板渲染 / 待会儿办 / 本地开单后台共用同一套设计语言与动效规范。
+ 动效口径:--ease-out:cubic-bezier(.23,1,.32,1)、弹窗 240ms 进 / 180ms 出、scale(.96) 起手(生长线从 scaleX(.04) 起)、UI 里不用 ease-in、循环与生长动效 prefers-reduced-motion 全降级。 +
备案号(已移除) +

+ +
+ + + + +
+ + + + diff --git a/portal/dev/glow-color-lab.html b/portal/dev/glow-color-lab.html new file mode 100644 index 0000000..f2b935c --- /dev/null +++ b/portal/dev/glow-color-lab.html @@ -0,0 +1,165 @@ + + + + + + +中性光 · 选型 + + + + +
+

中性光 · 选型

+

这页是给「点下去那道光」挑颜色的 —— 上面选色板,下面**按住任意按钮**看光效(松手会自己收回去)。
同一个色板会同时作用到:中性的光、环、以及面板被染的那一片。

+ +
+ + + + + +
+ +
+
+
+
+ + +
+

↑ 这两颗发的就是上面选的那个颜色。按住看,主体是描边亮一段 + 面板染一片。

+
+ +
+
+
+
+ + +
+

↑ 这两颗的颜色是定的(绿 / 橙),拿来跟上面的中性光对照:
挑的中性光要能跟它俩放在同一页不打架。

+
+ +
+
+
+
+ + + +
+

↑ 交替按这三颗:看两种颜色切换时有没有"脏"的中间色。

+
+ +

+ 选中的值:jade · 214 240 226 +

+
+ + + + diff --git a/portal/dev/glow-lab.html b/portal/dev/glow-lab.html new file mode 100644 index 0000000..1257266 --- /dev/null +++ b/portal/dev/glow-lab.html @@ -0,0 +1,560 @@ + + + + + + + +按压发光 · 描边点亮一段(例子 v2) + + + + + + + +

按压发光 · 描边点亮一段

+

例子 v2 · 按住按钮别松、手指拖一拖 —— 光跟着手指走,颜色跟着按钮走

+ +
+
+ 档位 + +
+ +
+
+
+ + + +
+
+ + + + +
+
+ + + + +
+
+ +
+
+

面板 · 整个界面外框(同样只亮一段描边)

+ +
+
+
卡片 A · 光色跟着按钮走
+

按住任意一颗:按钮自己的描边亮起 → 面板描边亮一段(最亮在光源正对处)→ 面板染上一片它颜色的光。

+
+ + + +
+
+ +
+
+
卡片 B · 旁边的按钮也会被照亮
+

光源附近的按钮,自己的描边会跟着亮(按距离衰减)—— 不是只有被按的那一颗有反应。

+
+ + + + +
+
+ +
+
+
卡片 C · 弹提示也染色
+

点一下:光从提示自己所在的位置发出来 —— 提示在哪儿,那儿就像被点了一下(面板描边亮一段、附近按钮跟着亮、面板染一片它颜色的光),提示收起时光一起收。

+
+ + +
+
+
+ +
+ 这一版按你四条改的(对照旧版) + +
+ +
+ + + + + + diff --git a/portal/dev/juanbing-design.html b/portal/dev/juanbing-design.html new file mode 100644 index 0000000..057b1bd --- /dev/null +++ b/portal/dev/juanbing-design.html @@ -0,0 +1,433 @@ + + + + + + +卷饼铺子 · 界面方向预览 v2 + + + +
+ +
+

卷饼铺子 · 界面方向预览 v2

+

同一套结构和交互,只换材质(底色/强调色/圆角/阴影/字距)。挑一个,我照它改真实界面。
+ 选单个方向时会亮色和暗色并排给你看 —— 两个模式都得成立才行。

+
+ 方向 +
+ + + + +
+
+
+ 明暗 +
+ + + +
+
+

+ 可点的都能点:按按钮 有按下反馈、悬停卡片 会抬起、 + 点“吊销 / 生成邀请令牌” 会弹提示。 +

+
+ +
+ +

+ 备案号(已移除) +

+
+ + + + diff --git a/portal/dev/rich-demo.html b/portal/dev/rich-demo.html new file mode 100644 index 0000000..74eb90f --- /dev/null +++ b/portal/dev/rich-demo.html @@ -0,0 +1,538 @@ + + + + + + +样例 · 图片与嵌问卷 · 卷饼铺子 + + + + +
+ 卷饼铺子 + + + + + +
+ + + +
+ + + VERIFY-demo2 · owner +
+ +
+
这是渲染样例(给金钻看效果的),不是站上真文档。右上角能切亮/暗。
+ +
+

← 返回文档列表 · owner

+
+

图片 + 嵌问卷 · 样例

+

这是真渲染管线跑出来的,不是画的图。

+

一、插图片

+

先传图(POST /api/media),再把返回的那句粘进来:

+

店门口实拍

+

外链图故意不渲染 —— 下面这句就是外链,你会看到它只剩说明文字:

+

这是外链图,不会显示

+

二、嵌问卷(就地能填)

+ +
+
问卷zz-样例问卷
+ +
+ + + + + + + +
+
+ +

提交后只有 owner 能看到。

+
+

上面这个不是链接,是真的表单 —— 二舅看报告看到一半可以直接填。

+

三、顺带

+

引用块、色块、上色都在同一篇里正常共存:

+
+

引用块没问题(10-03 修过)。

+
+
+

色块也照常。

+
+
+
+ +
+ + + + + + \ No newline at end of file diff --git a/portal/dev/style-lab-shots/index.html b/portal/dev/style-lab-shots/index.html new file mode 100644 index 0000000..6a7d6d4 --- /dev/null +++ b/portal/dev/style-lab-shots/index.html @@ -0,0 +1,68 @@ + + + + + + +style-lab 自查截图(六方向 × 亮/暗) + + + + +
+

style-lab 自查截图

+

自动生成,用于自证"六个方向 × 亮/暗两套"都真的渲染出来了。原始页面:/dev/style-lab.html

+ +

联系表 · 上排亮色 / 下排暗色 · 1–6 号方向

+
contact sheet
contact-sheet.png(2410×1464)
+ +

逐方向 · 亮色

+
+

逐方向 · 暗色

+
+

交互与整页

+
+
modal
modal_dark.png(弹窗入场后)
+
toast
toast_dark.png(点确认后的 toast)
+
full light
full_light.png(整页走查)
+
full dark
full_dark.png(整页走查)
+
+
+ + + diff --git a/portal/dev/style-lab.html b/portal/dev/style-lab.html new file mode 100644 index 0000000..91bb5a0 --- /dev/null +++ b/portal/dev/style-lab.html @@ -0,0 +1,3403 @@ + + + + + + + +金钻系 · 风格方向实验室(六个方向 × 亮/暗双模 · 可手动切) + + + + + + + +
+
金钻系 · Style Lab v11
+

六个方向,两套明暗 —— 挑一个当底盘

+

+ 同一段内容,用六种美学各渲染一遍;每个方向都同时给亮色 + 暗色两套,跟随系统、也能手动切。 + 看的是"气质"和"能不能搬到咱四个界面",不是比谁花哨。 +

+

+ 六个方向里的每颗按钮、每张卡片都能拖着玩 —— 按住拖走、沿运动方向变形、松手弹回原位; + 拖不到 6px 仍算点击,原来的行为照常(比如「打开弹窗」「弹个 toast」)。 +

+

+ v11(本轮)把第 5 块「按压发光」换成了新做法: + 描边只点亮一段(2px 描边亮约 170px,不再糊一整条柔晕)、光晕浓度 15%、 + 邻按钮也照亮、光色跟着按钮走(白按钮白光、橙按钮橙光)、 + 弹提示也染一下再收回。手感三件套没动:按住跟手拖拽 / 越拉越沉 / + 松手弹簧回弹(+按下挤压)。(v10 的两个柔化 —— 边缘发光 → 软光晕、 + 融球连线 → 渐细流线 —— 仍在第 4、5 块生效。) +

+
+ +
+
+
+ 方向 +
+
+
+
+ 模式 +
+
+
+
+ 融球 +
+
+
+ +
+ +
+

对照表 · 想要什么感觉,就选几号

+

点表格里的号码可直接跳到对应方向。色块是它当前的强调关系(跟随你选的明暗模式)。

+
+ + + + + +
想要什么感觉选几号为什么
+
+ +

我的推荐 · 只留两条,我留这两条

+
+
+

主路1 号 · 素白极简

+

当统一底盘。四个界面现在就是"近黑 + 绿"的暗色底,这套等于把同一套关系在亮色下补齐,风险最低、四界面通吃;本地后台内联样式也只要换一份变量值。它不抢内容,适合长期待着。

+
+
+

副路6 号 · 侘寂自然

+

当有性格的替代。陶土 + 苔绿最贴"客栈 / 手作"的气质,比 1 号有人味儿,亮暗两套都撑得住。代价是低对比,正文字号与对比度要盯紧(正文至少 7:1),别一提亮就变成小清新。

+
+
+

+ 另外:2 号不必整体搬,但它那套"等宽数字 + 刻度 + 单色状态点"很适合塞进本地开单后台(订单号 / 金额 / 卡密正需要 tabular 数字)。 + 3 / 4 / 5 建议只借零件、不做底盘。 +

+
+ + +
+

交互演示:拖拽变形 + Q 弹 + 按钮融球

+

+ 上面六个方向给的是"静态气质",这里补手感。 + 注意:六个方向里的按钮和卡片本身就能拖(v4 起全部挂上,不再只有这一区能拖); + 下面这三块是把同一套手感拆开、放大给你看清楚。三块都能上手: + 拖一拖那张卡片、拽一拽下面每颗按钮、按一按Q 弹、连点最后两条轨道看差别。 + 口径照 design-tokens「三·B 拖拽 / 手势 / Q 弹」—— + 手势用弹簧(可中断、可反向);要 Q 但不许变成玩具:一次只弹一下,高频操作不弹。 + v5 新增第 4 块「按钮融球」:拖按钮离开原位时,原位与按钮之间拉出一根液体桥 —— + 越拉越沉、桥越拉越细、松手被"吸"回去、回弹随拉伸量变大。 +

+ + +
+
+ 01

拖拽变形

+ 低频 · 跟手 +
+

+ 按住卡片拖:跟手移动,拖动中沿运动方向拉伸(≤ 6%)、朝运动方向倾斜(≤ 3°)、抬起放大 1.03 + —— 沿运动方向合计拉伸 ≤ 6%。松手按弹簧落位到最近的槽位,落位过冲 6~10%(可以"甩"出去),变形量弹回 0。 +

+
+
+
槽位 1
+
槽位 2
+
槽位 3
+
+
+ 拖动我DRAG · 卡 01 +
+
+

+ 实现:pointerdown / pointermove / pointerup + setPointerCapture,全程只动 transform; + 卡片上挂了 touch-action:none,所以在手机上拖它不会带着页面一起滚。 + 拖到一半松手、或者拖到一半反向 —— 都从当前状态接着走,不会跳回起点重演。 +

+
+ + +
+
+ 02

Q 弹(回弹)

+ 只用在低频 · 有反馈意义处 +
+

+ 这四颗按钮都能拽:按住拖走(跟手),拖动中沿运动方向拉伸 + 倾斜 + 抬起, + 松手像被橡皮筋拴住弹回原位 —— 位移过冲 6.4%~8.0%, + 回位时"嘣"一下、scale 峰值 1.051~1.057(抬起 1.03 与弹性环的合成值,守住 ≤1.06)。 + 位移不超过 6px 仍按普通点击处理,按钮原本的行为照常触发。 + 原则:一次只弹一下;高频操作(列表滚动、每次 hover)一律不弹。 +

+
+
+
① 按钮按下回弹(可拽走)
+ +

+ 按下 ~0.20s 收到 0.96(视觉 ~120ms 已到位),松手弹回、峰值 1.043~1.052; + 拖着它走再松手,会弹回原位。 + 当前 scale:1.000 +

+
+
+
② 卡片掉进列表
+
+
01拍照上传已好
+
02选模板已好
+
+
+ 03渲染出图已好 +
+
+
04待取货等通知
+
+ +

+ 从上方落位,纵向过冲 ≈ 6px(看得见的弹一下);半路再点它不会跳回顶部重来,直接从当前位置接着落。 +

+
+
+
③ 成功提示弹一下
+
+
✓渲染完成
+
+ +

+ 从 0.8 + 淡入起(不从 scale(0) 起 —— 现实里没有东西从"无"里蹦出来), + 峰值 ≈ 1.05、弹一次就停;外圈光环 400ms 一次性。 +

+
+
+
+ + +
+
+ 03

可中断:弹簧 vs keyframes

+ 手势必须用弹簧 +
+

+ 同一个动作做两遍:左边弹簧,右边 keyframes。连点下面那颗按钮 —— + 左边每次打断都从当前位置、带着当前速度接着走;右边每次打断都跳回起点、从头再演。 + 这就是拖拽 / 滑动手势必须用弹簧、不能用 keyframes 的原因(能中断、能反向、能 retarget)。 +

+
+
+
弹簧(可中断)SPRING · 从当前状态继续
+
+
+
+
keyframes(从头再演)KEYFRAMES · 打断即重来
+
+
+
+ +

+ 实心绿块 = 弹簧,虚线空心块 = keyframes(反面教材)。为了能用眼睛分辨"接着走"和"重演", + 这一轨刻意放慢到 620ms;正常 UI 动效 ≤ 300ms(这页是实验室,所以破例并注明原因)。 +

+
+ + +
+
+ 04

按钮融球 + 越拉越沉

+ 低频 · 跟手 +
+

+ 按住按钮拖走 —— 按钮与原位之间会拉出一根"液体"的桥(v10:两端渐细、 + 中段带一道细腰、中间半透明的流线,不是等宽直线):拉得越远、丝越细, + 拉满(约 120px)时几乎断开,松手被"吸"回去、桥随之消失。 + 跟手本身也越拉越沉(渐进阻尼 x = 120·(1 − e^(−d/66)):前段跟手、后段越来越拉不动); + 松手回弹与拉伸量成正比 —— 拉得越多、弹得越快、过冲越大(6% → 14%)。 + 拖动中照旧沿运动方向拉伸 ≤6% / 倾斜 ≤3° / 抬起 1.03;位移 < 6px 仍算点击。 +

+
+ + +
+

+ 当前位移 0 px · + 上一次回弹过冲 — +

+

+ v10 改法:桥不再是"一根等宽直线",而是两端渐细、中段带一道细腰的流线 + (<path> 梯形 ribbon + 沿 A→B 的渐变 → 中段半透明、两端渐隐), + 看着像黏液被拉出去的那道"丝"。
+ 两种渲染仍然保留:桌面 / 精确指针走 SVG 滤镜版(feGaussianBlur 1.6, + 让丝的边缘再柔一点);窄屏 / 触屏 / 低端机走细线版(不上滤镜 —— 手机 GPU 上 SVG 滤镜很贵)。 + v10 起两者走同一条几何(以前是两条不同的东西),只是滤镜版多一层模糊。 + 顶部「融球」那一排可以手动强制两种模式对比。暗色下丝带一点点发光,亮色下改用柔和投影。 + 回弹过冲按 60Hz 标定(拉伸小 → 拉满:6.1% → 13.3%);120 / 144Hz 上同一条曲线会高约 1.5pp, + 软件渲染 / 低帧率设备上会略收敛 —— 趋势(越拉弹得越狠)在任何刷新率下都成立。 +

+
+ + +
+
+ 05

按压发光(描边点亮一段)+ 按压挤压

+ v11 · 低频 · 反馈 +
+

+ 按住任意一颗带色按钮别松、手指拖一拖 —— 光源跟着手指走,光色跟着按钮走: + 白按钮白光、橙按钮橙光、绿按钮绿光、蓝按钮蓝光。 + 被按的那颗自己描边亮起;外框与卡片各亮一段 2px 描边 + (约 170px、linear-gradient 两端自己渐隐,最亮正对光源 —— + 是"描边被点亮一段",不是糊一整片),同时整块面板按按钮颜色染一片光 + (径向渐变,浓度默认 0.15);四条边都按到光源的距离给亮度(远处留 0.02 环境底光)。 + 光源附近的其它按钮,自己的描边也跟着亮(按到按钮外框的距离衰减,reach ≈210px、 + pow(1−d/reach,2))—— 不是只有被按的那一颗有反应。 + 一个光源会同时照到它附近的多块面板(这里的外框 + 卡片),不是只照被按的那一颗。 +

+
+
+
+

外框 · 光源也会同时照亮它附近的这张卡片

+
+
+
+
+ + + + +
+
+
+

+ 描边点亮 0.00 · + 挤压 X 1.000 / + Y 1.000 · + 松手过冲 X — / + Y — +

+

+ 按压挤压:按住不满 6px 就是"按下" —— 捏扁(X +3% / Y −4%,≈体积守恒)用时 120ms; + 松手过冲回弹(X 0.99 / Y 1.02)再落回原样,只弹一下。 + 一旦真的拖起来(> 6px)就平滑转成交互拖拽、挤压自然收掉(不会卡在捏扁状态)。 + 减弱动效下不做挤压(按下 / 松开直接变,不捏)。 +
光的两套口径:暗色用 mix-blend-mode:plus-lighter(真加法光); + 亮色用 multiply + 去饱和的浅色(白卡上别用饱和色,否则会变成"彩色墨水渍")。 +
点「弹出提示」:整套面板按提示颜色薄薄染一层再自己收回去 + (@keyframes 约 1.15s、both,动画结束把 class 摘掉), + 底部出一颗本页自己的小 toast(180ms 入场)—— 只提示、不弹窗抢视线。 +
性能:面板 / 按钮的坐标在按下那一刻量一次(缓存),跟手期间每帧只写 CSS 变量、 + 零次 getBoundingClientRect,不重排。 +

+
+ +

+ 减弱动效(系统开了「减少动态效果」)下会怎样:拖拽照常跟手 —— 卡片和按钮都还拖得动, + 但不拉伸、不倾斜、不抬起,松手直接落位 / 直接回原位、不过冲、不弹; + 按钮只保留"按下变暗一点点"这一个状态指示;Q 弹三项与两条轨道都只保留淡入 / 直接跳到终点; + 融球桥完全不显示(覆盖层整个不出现,直接回原位);按压挤压不做(直接按下 / 松开)。 + 规范口径是"更少更轻",不是"全砍"——助手里要的是不晕,不是没反馈。 +

+
+ + + + + + + + + +
+ + +
+ + + + + + + + diff --git a/portal/exhibition/渲染与动画/20240229/没有图片.webp b/portal/exhibition/渲染与动画/20240229/没有图片.webp new file mode 100644 index 0000000..251768a Binary files /dev/null and b/portal/exhibition/渲染与动画/20240229/没有图片.webp differ diff --git a/portal/fonts/OPPOSans-B.woff2 b/portal/fonts/OPPOSans-B.woff2 new file mode 100644 index 0000000..08f14c5 Binary files /dev/null and b/portal/fonts/OPPOSans-B.woff2 differ diff --git a/portal/fonts/OPPOSans-R.woff2 b/portal/fonts/OPPOSans-R.woff2 new file mode 100644 index 0000000..eac9f3f Binary files /dev/null and b/portal/fonts/OPPOSans-R.woff2 differ diff --git a/portal/icons/jzyuzhou-light.png b/portal/icons/jzyuzhou-light.png new file mode 100644 index 0000000..012839d Binary files /dev/null and b/portal/icons/jzyuzhou-light.png differ diff --git a/portal/icons/match-people.png b/portal/icons/match-people.png new file mode 100644 index 0000000..246f99e Binary files /dev/null and b/portal/icons/match-people.png differ diff --git a/portal/icons/wm/wm_sample_own.webp b/portal/icons/wm/wm_sample_own.webp new file mode 100644 index 0000000..a64770f Binary files /dev/null and b/portal/icons/wm/wm_sample_own.webp differ diff --git a/portal/index.html b/portal/index.html new file mode 100644 index 0000000..7c237bc --- /dev/null +++ b/portal/index.html @@ -0,0 +1,5550 @@ + + + + + + + +金钻客栈 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+ + + 金钻客栈EXAMPLE.COM + + + +
+ + LINK // 已同步 + + +
+
+
+ +
+ + +
+
+
+ 客栈 // EXAMPLE.COM 内容总入口 +

金钻客栈

+

集画展、应用、金钻宇宙与各平台入口于一体的线上客栈,随处逛逛。

+
+
板块 BOARDS
6个
+
内容 ITEMS
4条
+
站外 LINKS
7个
+
状态 STATUS
在线
+
+ +
+
+ + +
+
+ + +
+
+
+
BOARDS // 01-05 内容板块
+

板块总览五个内容板块

+

在这里分清寻路:想看看金钻的作品去画展,想装工具去应用栏,想走进世界线就去金钻宇宙,平台主页与关于都在前面等着。

+
+
板块 5 个
01-05 · 等宽网格
+
+
+
+ +
+ + + + + + + + + + + + + + + + + +
+ +
+
+
+ + 金钻客栈EXAMPLE.COM · ICD-0 +
+ +
+ © 2026 金钻客栈 example.com · 保留所有权利
+ 备案号(已移除) +
+
+
+ +
+ + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + diff --git a/给协作者的说明.md b/给协作者的说明.md new file mode 100644 index 0000000..b94aee1 --- /dev/null +++ b/给协作者的说明.md @@ -0,0 +1,97 @@ +# 给协作者 AI 的说明 + +## 这是什么 + +两个页面的前端,想请你从**前端美化**角度改一版。都是**单文件 HTML** +(HTML + CSS + JS 内联,无构建工具、无框架依赖,浏览器直接打开就能看): + +- `portal/index.html` —— 门户首页(另有 `fonts/` 自托管字体、`icons/` 图标) +- `order/index.html` —— 自助下单页 + +画展部分的原始作品、客户/创作者昵称与外链都已从交付副本移除; +只保留 `portal/exhibition/渲染与动画/20240229/没有图片.webp` 这一张**占位图**, +用于让你看画廊卡片的排版结构。 + +> 另附《设计思路(仅供参考).md》:它只解释原页面的出发点,**不是约束**; +> 你可以完全采用自己的方案。 + +## 你可以改:样式(完全自由发挥) + +布局、配色、字体、间距、圆角、阴影、动效、交互手感——**不用问想要什么风格, +按你自己的判断来**。唯一要求:改完功能照样能用。 + +## 请在「关于」里加一笔 + +门户页里有一块**「制作者 / 鸣谢」**(在代码里搜 `ab-kicker` 或「制作者」能找到)。 +现在署名只有一个人 —— 改完之后请补成: + +> **苏达 · 空枝** + +## ⚠️ 别动:JS 逻辑与接口调用 + +**只改样式,不要改 JS 逻辑和接口调用** —— 逻辑一动整站就废了。 +下面这些是页面在用的接口(都是**相对路径**,代码里会拼一个基址在前面): + +### 下单页 order/index.html + +| 接口 | 干什么 | +|---|---| +| `/submit` | 提交订单 | +| `/status` | 渲染机状态 | +| `/tick/<单号>` | 轻量心跳(轮询进度) | +| `/order/<单号>` | 订单详情 | +| `/code/<卡密>` | 查卡密 | +| `/dl/<单号>/<序号>` | 下载成品 | +| `/receipt/<单号>` | 小票文字 | +| `/accept` | 确认收货 | +| `/redo` | 免费重渲 | +| `/add-skin` | 加皮肤 | +| `/call` | 呼叫站长 | +| `/feedback` | 反馈 | +| `/zip/<单号>` | 打包下载 | +| `/gift` | 福利券 | +| `/gift/claim` | 领券 | +| `/my-coupons` | 我的券 | +| `/payinfo` | 付款信息 | +| `/paid` | 付款回执 | + +### 门户 portal/index.html + +| 接口 | 干什么 | +|---|---| +| `view_stats.json` | 页面访问计数(静态文件) | +| `hd_cache/manifest.json` | 素材清单(静态文件) | + +## 推送位置(改完后由你推送) + +本次允许推送的唯一远端是: + +```text +https://git.lingll.icu/public/jinzuanwork.git +``` + +请将**这份脱敏后的交付目录**和你的改动推送到这里;不要把原始线上目录、备份、个人素材、 +账号信息、密钥或其它本机文件混进去,也不要镜像到其它远端。 + +推送后,在 `交接说明.md` 里写明:仓库地址、分支名、提交哈希,以及 `git status` 是否干净。 + +## 改完要交回的内容(请一并写在交接说明里) + +不要只丢一份代码。请随改动附一份 `交接说明.md`,至少写清: + +1. **改了哪些文件**:逐个列相对路径;没有改的明确说没改。 +2. **做了什么**:按页面分项说清楚视觉/交互上分别改了什么,以及为什么这么改。 +3. **没有动什么**:明确写「没有改 JS 业务逻辑、没有改接口路径/请求参数」; + 如果确实不得不动了,必须逐项说明原因、改前改后是什么。 +4. **怎么验证的**:列出实际打开/点击过的页面和结果;不能实际验证的如实标「未验证」,不要猜测说已通过。 +5. **待确认/风险**:不确定的地方、需要原项目方补资源或补接口的地方,单列出来。 +6. **交付方式**:保留原目录结构;不要带入 `.git/`、备份、调试截图、构建缓存、账号信息或任何新密钥。 + +回报写短也没关系,但必须让接手的人一眼知道:**改了什么、有没有动逻辑、实测到哪一步、还卡着什么。** + +## 其它注意 + +- 页面里的 `example.com`、`123456789`、`备案号(已移除)`、`(本机路径)` + 是**脱敏后的占位值**,请**保持原样**,不要换成真实地址。 +- 这两份是脱敏后的协作副本;**只允许推送到上面指定的仓库**,不要外传、镜像或发布到其它位置。 +- 有看不懂的地方,先问再改,别猜。 diff --git a/设计思路(仅供参考).md b/设计思路(仅供参考).md new file mode 100644 index 0000000..ba889fa --- /dev/null +++ b/设计思路(仅供参考).md @@ -0,0 +1,97 @@ +# 设计思路(仅供参考) + +> 这份只是当前整理者对两个页面的理解,**不是必须遵守的设计规范**。 +> 你可以保留、调整,甚至完全推翻其中任何一条;它的作用只是让你知道: +> 原页面为什么会长成现在这样,方便你决定哪些值得留下、哪些该重做。 +> +> 真正不能碰的边界,只有另一份《给协作者的说明》里写明的:**业务逻辑、接口路径与请求参数。** + +--- + +## 总体感觉 + +原先想做的不是“通用后台”或“组件库拼出来的网页”,而是一个有一点实体感的小站: + +- 背景不是纯黑的死底,内容区要像浮在背景上; +- 边框、阴影、光感可以有,但不要每个地方都抢眼; +- 动效更像按下、展开、收拢、回弹这些真实反馈,而不是为了动而动; +- 重点是让人知道:**现在在哪、下一步做什么、操作有没有成功。** + +这些只是出发点,不是固定风格。若你有更好的整体方案,直接按你的方案来就行。 + +--- + +## 门户页 portal + +### 它想承担的事 + +门户更像“入口 / 展示柜 / 导航页”: + +- 让人快速看到有哪些内容和入口; +- 有一点作品集或个人空间的感觉; +- 内容很多时,仍然能一眼分清层级,而不是变成很长的链接清单。 + +### 可以考虑保留的方向 + +- **首屏有重心**:不要把所有入口平均铺开,给一个最容易理解的进入点。 +- **内容分层**:链接、应用、画廊等不同性质的内容,视觉上可以有不同权重。 +- **画廊结构仍可保留**:交付版只放了一张“没有图片”占位图,不代表线上一定要做成空画廊;它只是方便你看卡片、时间轴、筛选和弹层的大致结构。 +- **信息多也要轻**:比起不断加装饰,更希望通过留白、字重、大小、容器层级来组织内容。 + +### 可以大胆推翻的部分 + +首页现有的板块顺序、色彩、卡片样子、时间轴形式、标题文案、动效表现,都可以改。只要入口和已有功能仍然找得到、用得了即可。 + +--- + +## 自助下单页 order + +### 它想承担的事 + +下单页不是展示页,重点是让用户在几个关键时刻不迷路: + +1. 选什么; +2. 现在选了多少、是否符合规则; +3. 是否成功提交; +4. 渲染机有没有开始做; +5. 进度走到哪、什么时候大概能完成; +6. 出问题时去哪里重渲、反馈或联系。 + +### 比“好看”更值得守住的体验 + +- **状态要显眼但别吓人**:排队、渲染、完成、失败、数量不足/超出,要一眼看懂。 +- **错误要有下一步**:例如数量不对时,告诉用户还差多少或超了多少;不要只抛一个红字。 +- **手机优先**:卡片、按钮、弹窗要考虑窄屏;按钮别被长内容挤到屏幕外。 +- **动态过程有反馈**:渲染中不必堆复杂动画,但进度、状态变化、完成通知应让用户感到“页面还活着”。 +- **低频动作可以有仪式感**:例如确认收货、完成下载;高频点击则应干净、快速。 + +### 可以大胆推翻的部分 + +表单步骤、模板卡样式、进度条表现、弹窗结构、按钮外观、色彩体系、动效方式都可以重新设计。 + +唯一请注意:样式重做时,别让“选模板 / 数量提示 / 提交 / 查订单 / 看进度 / 重渲”等功能入口消失或难以找到。 + +--- + +## 关于动效的一点想法 + +这同样只是参考: + +- 操作反馈比装饰性循环动画更重要; +- 按钮按下、弹窗进出、列表/步骤切换,做得顺会比大面积特效更有用; +- 动画应该能被打断,也别拖太久; +- 考虑 `prefers-reduced-motion`:用户要求减少动效时,保留功能、减少动画即可。 + +如果你的方案更简洁、更稳、更顺,优先用你的方案。 + +--- + +## 交付时希望看到什么 + +不要求你照着这份思路做。只希望你在交接说明里简单说一句: + +- 这份思路里你**保留了什么**; +- 你**改掉或推翻了什么**; +- 为什么。 + +这样后续接手的人不会把“当前效果”误当成唯一正确答案。