docs: 交接说明(redesign-2026)

Browse Source
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
yws
2026-10-05 04:01:41 +00:00
co-authored by Claude Opus 5.5
parent 8ee505f082
commit 1903daafc3
+101
View File
@@ -0,0 +1,101 @@
# 交接说明 · 前端视觉重设计(redesign-2026)
## 一句话
两个页面都**只在 `</body>` 前追加了一个 `<style id="redesign-2026">` 覆盖块**,相对 `origin/main`(d1e34b7)是**纯新增、零删除**;
**没有改 JS 业务逻辑、没有改接口路径/请求参数、没有改 HTML 文本和结构**。功能用自动化脚本对比原版逐项点过,未发现回归;需要后端的流程未验证(见第 4 节)。
## 仓库信息
- 仓库:`https://git.lingll.icu/public/jinzuanwork.git`
- 分支:`main`
- 样式提交:`8ee505f` style: 门户与下单页视觉重设计(精致暗色 + 宝石色)
- 本说明所在的提交:紧跟在 `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 块内)
1. **手机端画展「更多 ▾」按钮永远不显示**:原 CSS 中第 951 行(手机端 `@media` 内)设了 `#fltMoreBtn{display:inline-flex}`,但第 1201 行有一条无条件的 `#fltMoreBtn{display:none}` 写在它后面,把它盖掉了 → 手机上「看过的在前 / 金钻制作 / 瀑布流 / 时间轴倒序」等筛选全部点不到。已在覆盖块末尾补 `@media (max-width:719px){ #fltMoreBtn{display:inline-flex} }`,实测手机上可展开、可点。
2. **手机端下单页页头贴屏幕边**:原 `.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. 待确认 / 风险
1. **署名未改**:《给协作者的说明》要求把「制作者/鸣谢」补成「苏达 · 空枝」。本次**按委托方要求暂不改署名**,关于页保持原文「苏达 · 大肥鱼」,请你方自行决定后再改。
2. **背景流态效果被关掉**:为去掉背景网格,隐藏了 `#bgBlur`、`#blockgrid`、`#halftone` 三个背景层,原首屏提示的「移动鼠标 · 背景流态」跟随鼠标效果因此不再可见(只是用 CSS 隐藏,相关 JS 未改;是否仍在后台计算未核实)。如需保留,删掉覆盖块里对这三个 id 的 `display:none` 即可。
3. **大量 `!important`**:覆盖块为压过原有多层样式(`portal-shell` / `jz-unified` / `jz-1014` 等)用了较多 `!important`。后续若在原样式里继续调视觉,可能被覆盖块压住;建议以后视觉改动直接改 redesign-2026 块,或等稳定后把它合并回原样式。
4. **文案里的「XXX // 中文」**(如「BOARDS // 01-05 内容板块」)是写在 HTML 里的文字,按约定没改文本,所以 `//` 还在,只是变淡变小了。要彻底去掉需要改文案。
5. **字体**:下单页 `@font-face` 仍引用 `/fonts/OPPOSans-*.woff2`(绝对路径,你方上一提交未改到这里),在包内本地打开时会回落到系统字体;不影响本次样式,但与你方「相对路径」修复不一致,提醒一下。
## 6. 交付方式
- 保留原目录结构;只改了上面两个 HTML 并新增本说明。
- 没有带入备份、截图、调试脚本、构建缓存、账号信息或任何密钥(截图与测试脚本都放在仓库外)。
- 只推送到上面指定的仓库,没有镜像到其它位置。
## 附:怎么回退
- 只想撤掉视觉改动:删掉两个文件里的整个 `<style id="redesign-2026">…</style>` 块即可,页面恢复原样。
- 或:`git revert 8ee505f`。