# SiteForge Enterprise V8.34.0-dev.1 — 五主题可视化布局优化（第一批）

**基线**：V8.33.1（HESU PIPE 首页布局修复）；**主路线**：用户上传的 `COMPLETION_PLAN.md`，V8.34 主题商业化与易用编辑器阶段。

## 交付范围（本轮实际落地）

- **Banner 直接改布局**：选中封面横幅，在右侧内容设置以可点击卡片选择「文字左 / 图片左 / 标题居中」，不需要设置 CSS、JSON 或行列参数。
- **图片显示方式**：图片铺满或完整显示，适用于车型外观、HDPE 管材等不应被裁切的商品图；仍通过本站素材库上传、选择图片。
- **动态内容列表**：选择标准、紧凑、图片优先的卡片形式；后台仍绑定真实车型/产品数据，不复制产品信息，页面 URL 和 SEO 不变。
- **一致的存储和渲染**：新字段 `hero.layout_variant`、`hero.image_fit`、`collection.card_style`、`collection.image_fit` 经过 `validate_blocks` 白名单验证；正式渲染与编辑器预览共用 `render_blocks` 和 `app/static/blocks.css`。
- **旧站保护**：老区块若没有新字段，则不生成新布局类名，旧表现保持；原五套主题版本与 1.3.1 工业主题均不修改。只有主动选用新布局才改变页面。
- **移动端与性能**：响应式排序、减少无意义箭头、新 Banner 首页图片 `loading=eager` 与 `fetchpriority=high`；详情/内页依旧按需加载。

## 操作路径

进入后台 → 网站 → 页面 → 可视化编辑 → 点选 Banner 或动态内容列表 → 右侧 **内容设置** → 点击布局选项 → 中间实时预览 → 保存草稿 → 检查并发布设计 → 构建部署。

点击「从素材库选择 / 上传新图片」即可更换当前图片区块素材。其它高级样式设置仍在单独的「更多设计设置」中。

## 质量验收

- 19/19 批独立 Python 回归通过，合计 **448 个测试**（详见 `reports/v834-regression/result.json`及原始日志）。
- 39/39 JavaScript 测试通过（`node --test tests_js/*.cjs`）。
- HTTP + Worker 登录、CSRF、创建网站、构建、ZIP 下载、静态预览通过（`scripts/http_end_to_end.py`）。
- **36 组** Chromium 独立页面状态检查：汽车/工业 × 三种 Banner × 三种卡片 × 电脑/390px，浏览器脚本错误 0、横向溢出 0。
- `scripts/verify_release.py` 与 `node --check app/static/editor.js` 通过。

### 演示与报告

- `examples/V8_34_主题Banner与产品卡片_真实渲染交互预览.html`：服务端实际渲染 HTML 的离线交互对比，不连接正式站点。
- `reports/v834/V8_34_可视化布局阶段验收.html`、`reports/v834/browser-check.json`，含所有测试记录与生产限制。
- `scripts/v834_visual_preview.py`、`scripts/v834_browser_check.py` 可复现示例与浏览器检查。

## 本轮没有宣称完成的内容

五套主题的 14 类页面逐页人工商业视觉验收，车型参数表格/全局导航的画布级所见即所得编辑，真实企业图片素材规范化，Art Design Pro 官方工程编译，PG/Redis 多 Worker 生产压力和公网部署/回滚验证。下阶段继续优先完善这些操作，但必须先测试当前新增字段在真实网站草稿上的表现。