# SiteForge Enterprise V8.34.1-dev.1 — 多图 Banner 与参数表可视化编辑

本版本以已验收的 **V8.34.0-dev.1** 为基线，执行融合开发计划中 P4（主题/可视化编辑）的下一阶段，不替代原项目，不直接修改线上网站。

## 给非技术用户的操作说明

### 首页轮播横幅

1. 打开站点的**可视化编辑器**，选择首页的“封面横幅”。
2. 在右侧 **多图 Banner（可选）** 点击 **添加一张横幅**。第一次会复制当前横幅内容，因此原图与文字不会丢失。
3. 在每张卡片里编辑标题、副标题、说明、按钮文字及链接。图片可直接上传或从当前站点素材库选择。
4. 使用 **上移 / 下移 / 删除** 调整图片顺序。最多六张。删除全部后恢复之前的单图 Banner。
5. 保存页面草稿，点击预览检查电脑和手机，完成原有审核、构建、部署流程。

轮播不自动播放，手机可左右滑动，电脑可点击上一张/下一张；首张首页图片具有优先加载标记，其余图片延迟加载。为了保持标题语义，轮播只有第一张使用 `H1`，之后为 `H2`。

### 产品参数表

1. 选择页面中的“参数信息表”。
2. 在“参数内容来源”选择 **从产品数据自动读取 / 只显示手动填写 / 产品数据 + 手动补充**。
3. 如果选择后两项，点击“添加一项”，填写 **参数名称** 和 **数值**。无需 JSON。
4. 保存草稿并预览。默认模式继续使用内容数据，不改写原产品字段。

注意：手动添加的参数属于**当前页面的布局草稿**，不会写回产品数据表；如果多个详情页使用相同布局模板，应检查模板复用和页面数据的适配性。

## 主要源码变动

- `app/blueprints.py`：新增 Banner slides 和参数表 source_mode/items 的声明、严格校验与静态渲染；旧区块不受影响。
- `app/static/editor.js`：复用原有数组编辑器，上移、下移、复制首张、上传与素材库定点替换、参数来源选择。
- `app/static/site-runtime.js`：无外部依赖、无自动轮播定时器、原生滑动及键盘可达的手动控制。
- `app/static/blocks.css`、`editor.css`：响应式 Banner、可见焦点和紧凑输入。
- `tests/test_v8341_slide_specs.py`：参数边界、XSS、SEO、兼容与真实构建测试。
- `examples/V8_34_1_多图Banner与参数表_真实渲染预览.html`：原项目渲染函数和原始静态 CSS/JS 生成的独立演示。

## 不回退的要求

五套主题，旧主题锁定版本，主题预览安全限制，编辑器简洁模式、嵌套组件、历史记录、URL/SEO 保留，发布审批与 Worker 流程均保留。平台是开发集成版；尚未完成的 Art Design Pro 官方源工程集成、真实 PostgreSQL/Redis 多 Worker、生产远程部署及正式登录后台全浏览器 E2E 不得标记为完成。

## 升级及回滚

1. 备份原 V8.34 源码和站点数据；**不要直接覆盖线上正在运行的服务**。
2. 在独立环境解压本完整源码，使用 `.env.example` 建立独立配置。不可从交付包中寻找正式密钥。
3. `python scripts/verify_release.py`；`python -m pytest -q tests/test_v8341_slide_specs.py`；`node --test tests_js/*.cjs tests/test_nested_helpers_v823.cjs`。
4. 在测试站点新建 Banner 多图和参数内容、预览、构建并比对。确认历史主题版本没有改变后再走原审批流程上线。
5. 回滚时使用前一版源码和经过备份的数据，重新按原构建/发布流程执行。已有新字段在回滚前需完成兼容性核对。

## 下一阶段范围

继续按融合计划推进更直观的栏目布局、图片裁切与焦点设置、嵌套轮播图管理、完整五主题跨页面视觉测试；随后进入 V8.35 的 WordPress 迁移数据完整性专项。