浅念
df2a183dbf
Plain overlay (33 items, same-source lineage, zero patch replay). Theme suites 35/35; full run 453 passed + 10 known Windows env fails (suspect-module rerun confirms identical failure set). Live: container 8.34.1-dev.1; hesupipe home leftover industrial-preset blocks cleared via studio draft+publish flow — home now renders pure trade-pro template (sf-section/Chinese blocks = 0). Co-Authored-By: Claude Code <noreply@anthropic.com>
3.8 KiB
3.8 KiB
SiteForge Enterprise V8.34.1-dev.1 — 多图 Banner 与参数表可视化编辑
本版本以已验收的 V8.34.0-dev.1 为基线，执行融合开发计划中 P4（主题/可视化编辑）的下一阶段，不替代原项目，不直接修改线上网站。
给非技术用户的操作说明
首页轮播横幅
- 打开站点的可视化编辑器，选择首页的“封面横幅”。
- 在右侧 多图 Banner（可选） 点击 添加一张横幅。第一次会复制当前横幅内容，因此原图与文字不会丢失。
- 在每张卡片里编辑标题、副标题、说明、按钮文字及链接。图片可直接上传或从当前站点素材库选择。
- 使用 上移 / 下移 / 删除 调整图片顺序。最多六张。删除全部后恢复之前的单图 Banner。
- 保存页面草稿，点击预览检查电脑和手机，完成原有审核、构建、部署流程。
轮播不自动播放，手机可左右滑动，电脑可点击上一张/下一张；首张首页图片具有优先加载标记，其余图片延迟加载。为了保持标题语义，轮播只有第一张使用 H1，之后为 H2。
产品参数表
- 选择页面中的“参数信息表”。
- 在“参数内容来源”选择 从产品数据自动读取 / 只显示手动填写 / 产品数据 + 手动补充。
- 如果选择后两项，点击“添加一项”，填写 参数名称 和 数值。无需 JSON。
- 保存草稿并预览。默认模式继续使用内容数据，不改写原产品字段。
注意：手动添加的参数属于当前页面的布局草稿，不会写回产品数据表；如果多个详情页使用相同布局模板，应检查模板复用和页面数据的适配性。
主要源码变动
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 不得标记为完成。
升级及回滚
- 备份原 V8.34 源码和站点数据；不要直接覆盖线上正在运行的服务。
- 在独立环境解压本完整源码，使用
.env.example建立独立配置。不可从交付包中寻找正式密钥。 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。- 在测试站点新建 Banner 多图和参数内容、预览、构建并比对。确认历史主题版本没有改变后再走原审批流程上线。
- 回滚时使用前一版源码和经过备份的数据，重新按原构建/发布流程执行。已有新字段在回滚前需完成兼容性核对。
下一阶段范围
继续按融合计划推进更直观的栏目布局、图片裁切与焦点设置、嵌套轮播图管理、完整五主题跨页面视觉测试；随后进入 V8.35 的 WordPress 迁移数据完整性专项。