Files
cms-SiteForge/README_V8_31.md
T
浅念 8884e100f9 upgrade: adopt V8.31.1 (theme 1.3/1.4 redesigns, editor deep-canvas, guided launch, component library)
Overlay 190 upstream items (V8.22→8.31) preserving trade-pro theme,
registry tests, and design docs. Re-applied full patch set on identical
anchors (discovery/env_for/blocks.css/type-mapping/locale-override/
theme_color/frontend entries/test_theme_pro_v3 mods) plus compose pins.

Verified: theme suites 35/35; dual-baseline full run 415 passed vs
pristine 386+29 ours, FAILED-set diff EMPTY (same 10 Windows env fails).
Live: container 8.31.1-dev.1 healthy, hesupipe 192 entries intact,
trade-pro build 203 pages 0 errors.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-26 09:43:17 +08:00

54 lines
4.1 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.
# SiteForge Enterprise V8.31.0-dev.1 — 汽车主题行业化重设计
## 目标与范围
依据获授权参考网站 https://magicbridgeauto.com/ 的汽车出口内容组织方式,将汽车主题从偏概念视觉,调整为以客户选车、品牌筛选、车型参数和询盘为中心的商用网站。**只参考信息架构、导航交互与视觉层次,不抓取或复制参考站的文案、车型数据、图片及 Logo。**
本次是 SiteForge **完整源码**中的汽车主题升级,不是另起一个独立 HTML。主题发布版本为 `automotive@1.4.0`,平台版本 `8.31.0-dev.1`。工业、企业及极简三套主题继续保留 `1.3.0`。
## 用户直接感知到的变化
- **导航更清晰**:固定醒目的“首页、产品、品牌、资讯、案例、关于、联系”,品牌/分类大菜单使用实际数据;在手机端仍通过右侧抽屉进入。
- **首页更聚焦选车**:横幅主信息、车型快速搜索、品牌入口、精选车型、选车/出口服务、公司介绍、资讯案例和询盘 CTA。
- **车型列表可快速查找**:`?q=` 搜索参数支持静态页面本地搜索,与已有筛选器协同工作;没有使用必须联网的动态查询服务。
- **品牌独立页**:品牌介绍、品牌车型和相关内容分层展示;品牌菜单仅展示网站内真实存在的品牌项。
- **车型详情**:车型主图、缩略图图库、型号标签、参数和联系入口分区;真实图片与规格来自站点数据。
- **关于、联系等内页**:沿用 V8.30 已优化的业务内容区域,整体视觉匹配新汽车风格。
- **移动端**:宽幅内容转单列,车型卡片使用两列,继续保留抽屉菜单、可选底部 Tabs。按钮、点击区域和标题间距优化。
## 重要兼容性修复
已有站点可能将汽车主题版本固定为 `1.3.0` 甚至更早版本。在 V8.30 中,此类站点可能仅使用旧版 CSS、却错误包含最新页面片段。本轮修复模板解析:**优先加载固定版本存档里的页面模板**。`themes/automotive/versions/1.0.0`、`1.1.0`、`1.2.0`、`1.3.0` 均保留,旧站不会被强制升级。已固定旧版站点需由用户明确切换至 `1.4.0` 后才会采用新页面。
## 实际体验
- 独立预览:`examples/V8_31_汽车主题_完整页面交互预览.html`(支持七种页面类型、电脑/平板/手机切换)
- 真正由 SiteForge 静态生成的页面视觉截图:`reports/v831/auto-home-desktop.png`、`auto-home-mobile.png`、`auto-product-desktop.png`
- 可视化验收:`reports/V8_31_汽车主题验收报告.html`
> 演示数据为虚构;未提供有效车辆图片时,保留主题占位区,避免冒用参考网站的车辆照片。实际网站应在内容管理中上传真实车辆图片、品牌资料、商品规格、询盘联系方式,再检查上线效果。
## 测试
```bash
python -m pytest -q tests/test_v831_automotive_ref.py tests/test_v830_real_pages.py tests/test_theme_pro_v3.py tests/test_v829_theme_studio.py
node --test tests_js/*.test.cjs
python scripts/http_end_to_end.py
python scripts/verify_release.py
# 分批历史回归,避免长时间同进程测试相互干扰
python scripts/regression_v829.py --group-size 2 --timeout 35
```
可选演示构建:
```bash
PYTHONPATH=. SITEFORGE_DATA_DIR=/tmp/siteforge-v831-demo SITEFORGE_DEMO_OUT=/tmp/siteforge-v831-static \
python scripts/make_theme_demo_v830.py
```
已进行四主题样站静态构建、汽车六类页面在 375/390/430/768/1440px 宽度下的 Chromium 检测,并对品牌大菜单、车型过滤、手机抽屉执行交互检查。完整数据请查看 HTML 验收报告与 `reports/v831/browser_results.json`。
## 仍需由真实业务决定的内容
此版本不等于对参考网站数据的逐条复制,也不等于取得了全部原站品牌/车型资料。若需要与 magicbridgeauto.com 业务数据 **1:1** 一致,应通过站点数据迁移系统额外导出并核对菜单层级、车型图片、规格及品牌关系。正式 Art Design Pro 完整工程编译、生产 PostgreSQL/Redis、远程上线和真实设备浏览器验收仍需独立完成。