Files
jinzuanwork/交接说明.md
T
2026-10-05 04:01:41 +00:00

102 lines
9.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 交接说明 · 前端视觉重设计(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`。