Agent Skills
返回列表
AEM导入本地预览验证

AEM导入本地预览验证

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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>` 标签写入是否正确。