AEM导入本地预览验证
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装规范名 @user_fccf428b/preview-import,将该技能添加到你的 AI 助手。
技能介绍
解决什么问题
在 AEM 内容导入流程里,generate-import-html 产出的 HTML 并不会出现在远端 AEM 服务器上。直接运行 aem up,CLI 会把请求代理到远端,而远端没有你本地导入的页面,结果是一片 404。即使页面能打开,仍需确认 AEM 风格的 Block 是否正确装饰、图片是否加载、metadata 是否写进了源码。这个技能负责在交付前完成这一轮本地核实。
核心能力与关键步骤
- 启动本地预览服务:从
metadata.json读取paths.dirPath,用aem up --html-folder us指定 HTML 根目录;缺少该参数是 404 最常见的原因。 - 拼接预览地址:基于
documentPath访问如http://localhost:3000/us/en/about;index页面要写成/而不是/index。 - 核对渲染结果:检查 Block 样式、布局与
screenshot.png是否一致、图片能否加载、页面源码中<meta>标签是否就位、有无裸 HTML 泄漏。 - 对照原页面:把浏览器预览与
./import-work/screenshot.png并排比较,确认内容结构、Block 装饰与区段边界对齐。
适用边界与注意点
- 它是
page-import编排链路的第 5 步,依赖generate-import-html提供 HTML、scrape-webpage提供截图,不能脱离前置产物单独运行。 - Block 名称大小写敏感;渲染异常时先确认 HTML 中的 Block 名与
blocks/目录逐一对应,再查浏览器控制台报错。 - 图片路径必须为
./images/...格式,且与 HTML 同级;复制失败会导致占位符或加载失败。 - 端口冲突(默认 3000)或不在正确的项目目录,也是预览起不来时的高频坑。
使用场景
- 已完成 HTML 导入生成,需要在本地开发服务器中打开页面并核对渲染结果。
- `aem up` 默认代理到远端导致 404,需要加 `--html-folder` 让本地 HTML 生效。
- 有 `screenshot.png` 截图,需要与浏览器预览并排比对结构、区块边界和样式。
- 页面出现裸 HTML 或图片不加载,需要根据技能中的排障清单定位原因。
适合人员
- 负责把外部页面导入 AEM 的技术工程师,需要在交付前确认本地渲染与原页面一致。
- 维护 AEM 页面迁移流水线的开发者,需要在 `page-import` 流程中接上本地预览验证环节。
- 处理 AEM 区块和元数据的数据工程师,需要排查区块名称大小写与 `<meta>` 标签写入是否正确。