9.5 KiB
交接说明 · 前端视觉重设计(redesign-2026)
一句话
两个页面都只在 </body> 前追加了一个 <style id="redesign-2026"> 覆盖块,相对 origin/main(d1e34b7)是纯新增、零删除;
没有改 JS 业务逻辑、没有改接口路径/请求参数、没有改 HTML 文本和结构。功能用自动化脚本对比原版逐项点过,未发现回归;需要后端的流程未验证(见第 4 节)。
仓库信息
- 仓库:
https://git.lingll.icu/public/jinzuanwork.git - 分支:
main - 样式提交:
8ee505fstyle: 门户与下单页视觉重设计(精致暗色 + 宝石色) - 本说明所在的提交:紧跟在
8ee505f之后的一个 docs 提交(提交自身的哈希无法写进自身,以git log为准) - 推送后
git status:干净(无未提交改动、无未跟踪文件) - 基线:已先 rebase 到你方最新的
d1e34b7(相对路径修复),无冲突
1. 改了哪些文件
| 文件 | 改动 |
|---|---|
portal/index.html |
第 5549–6671 行新增 <style id="redesign-2026">(+1121 行,0 删除) |
order/index.html |
第 4178–4752 行新增 <style id="redesign-2026">(+573 行,0 删除) |
交接说明.md |
新增(本文件) |
没有改:portal/assets/tokens.css、order/assets/tokens.css、order/skincheck.js、portal/dev/*、fonts/、icons/、exhibition/、两份原有说明文档。
2. 做了什么
方向:精致暗色 + 宝石色(参考 Linear / Vercel 一类克制暗色站;强调色取自 logo 像素钻石:翡翠绿 #3ecf8e 为主,钻石青 #7dd3e0、金 #e9c46a 只做点缀)。
门户 portal
- 去噪:
.kicker/.eyebrow/.sec-meta/.ro dt/.core-tag/ 顶部导航等「等宽 + 全大写 + 大字距」标签,统一改为常规无衬线、小号、淡灰;隐藏.core-hint、.core-bracket(瞄准框角)等纯装饰。 - 首屏重心:H1 放大并紧字距,「客栈 / 宇宙」二字青绿渐变;钻石徽记外加柔和宝石色光晕;四个统计数字从格子框弱化为一行轻量数据;收紧首屏与「板块总览」之间的大块空白。
- 背景:隐藏网格/点阵层(
body::after、#bgBlur、#blockgrid、#halftone、.boot-grid、.v-grid),只保留一层极淡径向氛围光。 - 卡片与网格:实色卡面
#111316+ 1px 发丝边,圆角 14–16px,hover 轻微上浮;首页板块 5 张卡改为 3+2(「画展」主卡跨两列),关于页 5 张卡同样 3+2,不再有单张掉行。 - 按钮:主按钮实心翡翠绿 + 深色字,次按钮透明底 + 细边。
- 画展:筛选栏、左侧年份时间轴、底部说明统一新风格。
- 金钻宇宙:盘符机架结构、抽插/拖拽/回弹动效原样保留,只跟随新配色与字体层级。
- 页脚:改为与新风格一致的常规小号淡灰。
- 手机端:顶部 6 个导航改为 3×2 网格(原来最后一项「关于」被截一半);按钮在窄屏自动整行。
下单页 order
- 与门户统一底色、卡片、圆角、按钮与字体层级。
- 步骤编号
.num做成小圆形徽章;顶部进度条.prog加粗、当前段高亮。 - 两个入口
.entry做成可 hover 上浮的大卡。 - 状态色保持可辨:正常/成功 翡翠绿、不足/警告 暖金、超出/失败 红。
顺手修的两个原有样式问题(都只是 CSS,在 redesign-2026 块内)
- 手机端画展「更多 ▾」按钮永远不显示:原 CSS 中第 951 行(手机端
@media内)设了#fltMoreBtn{display:inline-flex},但第 1201 行有一条无条件的#fltMoreBtn{display:none}写在它后面,把它盖掉了 → 手机上「看过的在前 / 金钻制作 / 瀑布流 / 时间轴倒序」等筛选全部点不到。已在覆盖块末尾补@media (max-width:719px){ #fltMoreBtn{display:inline-flex} },实测手机上可展开、可点。 - 手机端下单页页头贴屏幕边:原
.hd{padding:15px 0 12px}左右为 0,标题和「渲染机离线」胶囊紧贴屏幕边缘。覆盖块内改为左右 16px,与下方卡片对齐。
对《设计思路(仅供参考)》的取舍
- 保留:「内容浮在背景上」「层级靠亮度差」「单一强调色(翡翠绿)」「动效是反馈不是装饰」「手机优先」「状态显眼但不吓人」「尊重 prefers-reduced-motion」。
- 改掉:「终端感」——大量等宽大写字距标签、仪器网格、瞄准框角在实际页面里噪音过多、主次不清,所以大幅弱化或隐藏;改用留白、字号字重和容器层级来分层。
- 小幅突破:原思路说「不出彩色光环」,这次在钻石徽记外加了一圈很淡的青绿光晕作为首屏视觉锚点,强度克制;不想要的话删掉
.home-core相关光晕规则即可。
3. 没有动什么
- 没有改 JS 业务逻辑,没有改任何
<script>内容。 - 没有改接口路径和请求参数(实测下单页仍按原路径请求
/order/api/payinfo、/order/api/gift、/order/api/status,与原版一致)。 - 没有改 HTML 文本、id、class、data- 属性,没有删除任何元素。*
- 占位值(
example.com、123456789、备案号(已移除)、(本机路径))保持原样。
4. 怎么验证的
环境:服务器上用 python3 -m http.server 分别托管「原版(origin/main)」和「改版」,Playwright + Chromium 无头浏览器,1440px 桌面宽和 390px 手机宽各跑一遍同一套点击脚本,逐行对比输出;每次点击前先检测目标元素是否可见、是否被别的层遮挡(elementFromPoint 命中测试)。
结果:与原版一致,无回归(仅有的差异是:① 弹窗/提示条 z-index 数值调高,不影响行为;② 手机端「更多」筛选从不可用变为可用,即上面修的原有问题)。
实际点过并通过的:
- 门户:6 个导航切换板块与 hash 正确;首页 5 张板块卡可点并跳转;首屏 3 个按钮可点;「动效 / 音」开关 aria-pressed 正确翻转;画展「全部/图片/视频/特殊」筛选、「更多」、瀑布流切换、时间轴倒序、看过排序、按制作者筛选,筛选后「清除筛选」按钮出现(列数 +/- 与清除筛选本身未点);作品卡点开大图弹窗(关闭弹窗未单独验证);金钻宇宙 11 个盘符渲染,点击可抽出(open 状态);启动仪式遮罩约 3–8 秒后正常让出点击(与原版相同);12 个站外链接可点;关于页 5 张卡与署名原样。
- 下单页:卡密框打开/取消;「凭票取图」弹窗打开、按钮可点、取消关闭;「浏览器历史订单」弹窗;页脚「反馈」弹窗;「网页下单」进入第 1 步;勾选条款;上传测试皮肤 → 本地质检报告正常出现;臂型三选一;继续到第 2 步、7 个模板渲染、模板可选中;退回第 1 步。未解锁的第 2–4 步仍然点不到(
pointer-events:none锁定有效)。 - 两页:控制台 0 个 JS 报错;390px 下 5 个页面均无横向滚动。
未验证(本地没有后端,/order/api/* 全部 404):提交订单、查卡密、付款回执、进度轮询、下载/打包、确认收货、重渲、加皮肤、呼叫站长、领券等需要后端返回数据的流程与对应状态 UI(排队中/渲染中/完成/失败的样式)。这些状态的配色在 CSS 里保留了,但没有实际看到渲染出来的样子。
另:只在 Chromium 下测过,未在 Safari / iOS / 微信内置浏览器实测。
5. 待确认 / 风险
- 署名未改:《给协作者的说明》要求把「制作者/鸣谢」补成「苏达 · 空枝」。本次按委托方要求暂不改署名,关于页保持原文「苏达 · 大肥鱼」,请你方自行决定后再改。
- 背景流态效果被关掉:为去掉背景网格,隐藏了
#bgBlur、#blockgrid、#halftone三个背景层,原首屏提示的「移动鼠标 · 背景流态」跟随鼠标效果因此不再可见(只是用 CSS 隐藏,相关 JS 未改;是否仍在后台计算未核实)。如需保留,删掉覆盖块里对这三个 id 的display:none即可。 - 大量
!important:覆盖块为压过原有多层样式(portal-shell/jz-unified/jz-1014等)用了较多!important。后续若在原样式里继续调视觉,可能被覆盖块压住;建议以后视觉改动直接改 redesign-2026 块,或等稳定后把它合并回原样式。 - 文案里的「XXX // 中文」(如「BOARDS // 01-05 内容板块」)是写在 HTML 里的文字,按约定没改文本,所以
//还在,只是变淡变小了。要彻底去掉需要改文案。 - 字体:下单页
@font-face仍引用/fonts/OPPOSans-*.woff2(绝对路径,你方上一提交未改到这里),在包内本地打开时会回落到系统字体;不影响本次样式,但与你方「相对路径」修复不一致,提醒一下。
6. 交付方式
- 保留原目录结构;只改了上面两个 HTML 并新增本说明。
- 没有带入备份、截图、调试脚本、构建缓存、账号信息或任何密钥(截图与测试脚本都放在仓库外)。
- 只推送到上面指定的仓库,没有镜像到其它位置。
附:怎么回退
- 只想撤掉视觉改动:删掉两个文件里的整个
<style id="redesign-2026">…</style>块即可,页面恢复原样。 - 或:
git revert 8ee505f。