浅念
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>
27 lines
2.0 KiB
Markdown
27 lines
2.0 KiB
Markdown
# V8.34.1 实施与验收技术说明
|
|
|
|
## 变更模型
|
|
|
|
### hero
|
|
|
|
- 新增可选 `slides: [{title, subtitle, description, image, button, href}]`；最多六条，字段仅允许字符串，单值最长 2000 字符。
|
|
- `slides=[]` 或字段不存在时，原单图渲染逻辑保持不变。
|
|
- 含幻灯片时每张使用完整的按钮与链接，图片地址仅允许原项目 `safe_media` 规则；使用 `safe_href` 过滤目标 URL；所有文字在 HTML 边界做转义。
|
|
- 首页首张图 loading=eager、fetchpriority=high，后续图片 lazy；从第二张开始使用 `H2`，但保留同一视觉字号。
|
|
- 使用 scroll-snap 和原生水平滚动，JS 仅绑定手动上一张/下一张与当前页数；不添加计时器/轮播依赖；键盘能聚焦滚动区，支持 reduced motion。
|
|
|
|
### attributes
|
|
|
|
- 增加 `source_mode`: `page`（默认）、`custom` 或 `merge`；新增 `items:[{label,value}]`，最多 30 项，字符串最长 300 字。
|
|
- `page`: 现有页面绑定产品参数；`custom`: 仅展示手动参数；`merge`: 保留页面参数并追加手动内容。
|
|
- 所有字段均经服务端白名单校验；手动值通过 `resolve_text` 后 HTML 转义，不允许直接注入 HTML。
|
|
- 编辑器在自动数据模式隐藏手动项，降低冗余操作；切换回手动模式时未删除的手动项仍在草稿里。
|
|
|
|
## 已知边界
|
|
|
|
- 多图编辑重点面向 **页面顶层 hero 区块**。嵌套布局里的 hero 虽可渲染，其独立 slides 编辑入口仍待下一阶段完善。
|
|
- 当前展示仅为手动轮播，没有自动轮播、媒体压缩和自动热点裁切功能。用户上传的原图大小仍会影响真实速度。
|
|
- 未对五套主题的全部真实页和所有终端做正式视觉基线对比。本轮实测的是原 CSS/JS 生成的独立页面与现有构建测试。
|
|
- 手动参数在页面布局中保存，不回写 CMS，避免影响其他内容与 SEO。
|
|
- 当前未进行生产数据库、完整 Art Design Pro 源工程及正式远程发布验收。
|