# SiteForge Enterprise V8.33.1 — HESU PIPE 首页布局专项修复

**基线**：V8.33.0-dev.1。**本补丁版本**：V8.33.1-dev.1。**工业主题**：1.3.0 → 1.3.1。

## 修复原因（已通过实际构建确认）

1. 原渲染结果同时具有 `<section class="sf-section sf-collection">` 和内部 `<div class="sf-collection">`。共有 CSS 将二者都设为网格，导致整个 section 自身出现多列，内容宽度被压缩。同样的问题影响 `.sf-features`、`.sf-stats` 和部分其他区块。
2. 浏览器运行时代码会对所有 `.sf-collection` 插入筛选工具栏，导致首页展示区也出现产品筛选，并可能重复作用于外层 section。
3. 工业建材主题缺少与其页面视觉一致的核心优势和产品展示专用样式，卡片列数、图片比例与文字高度在不同设备下不能合理协调。

## 实际代码调整

- `app/static/blocks.css`：禁止区块外层误套内部 Grid 布局；维持内部网格。
- `app/blueprints.py`：核心优势根据 1~4 条目选择相应桌面列数；动态列表根据页面用途决定是否显示筛选，首页只呈现产品卡片。
- `app/static/site-runtime.js`：仅对 `data-sf-filterable="true"` 的内部网格启用筛选。
- `themes/industrial/blocks.css`：独立工业主题卡片样式，适配 1440/820/390/375px；产品图片采用 `object-fit:contain` 不裁切管材。
- `themes/industrial/manifest.json`：升级至 `1.3.1`；`themes/industrial/versions/1.3.0/` 保存原 1.3.0 完整主题文件。
- `tests/test_hesupipe_layout_v8331.py`：增加 4 项专项测试；升级已硬编码主题版本号的 3 个历史测试模块。

## 用户端如何查看

在 SiteForge 后台找到 HESU PIPE 对应站点，检查其主题是否为 **工业制造 / Industrial**，然后在主题管理中选择新版本 **1.3.1**（这一步不自动修改网站内容）。进入首页可视化编辑器，确认“核心优势”和“动态内容列表”区块已经填好内容。保存草稿，再进行主题预览与构建。经预览检查、审批和部署完成后，线上才会更新。

> 旧站如固定 1.3.0，将继续使用原始布局。主题版本升级须由使用者明确选择，不直接修改现有站点或在线数据。

## 离线预览、验证范围

- `examples/V8_33_1_HesuPipe_首页布局真实构建预览.html`：使用真正的静态构建 HTML/CSS/JS，合成的示范站点（非线上实际数据），支持电脑、平板、手机宽度切换。
- `reports/v8331/hesupipe-home-blocks-1440.png` 和 `...-390.png`：实际 Chromium 浏览器截图。
- `reports/v8331/browser-results.json`：四种屏宽的 computed CSS 验证。
- `scripts/hesupipe_v8331_preview.py`、`scripts/hesupipe_v8331_browser.py`：可复现的构建和浏览器核验脚本。

**限制**：本次未取得 hesupipe.com 线上部署权限，也没有用户后台中的真实首页草稿和照片。公开的 hesupipe.com 当前为不同的已发布网站；本补丁针对 SiteForge 项目版本的组件渲染，不代表线上网站已更新。请在测试环境先检查真实图片、数据与移动端，再走现有审批发布流程。