Adobe AEM CLI 本地开发助手

解决的核心问题

在 AEM Edge Delivery Services 本地开发中，开发者常面临三类痛点：安装环节易因旧版 helix-cli 包残留导致二进制冲突；本地开发服务器配置复杂，涉及端口绑定、TLS 证书、代理环境变量等参数调试；内容同步时二进制文件静默失败、HTML 预处理导致 EDS 装饰丢失等问题难以排查。

技能工作方式

该技能围绕 AEM CLI 的三大核心命令展开：

• aem up：启动本地开发服务器，支持通过 --html-folder 挂载本地 HTML 文件、--forward-browser-logs 转发浏览器日志、--tls-cert/--tls-key 配置可信证书等参数，满足不同调试场景。
• aem import：启动导入服务器（默认端口 3001），支持自定义 Importer UI 仓库、缓存代理响应、请求头调试等功能，适配复杂导入流程。
• aem content：处理 da.live 内容同步，通过浏览器 OAuth 获取认证令牌，支持通过环境变量或 .env 文件持久化配置。

在配置层面，技能强调通过 .env 文件统一管理环境变量，如 AEM_HTML_FOLDER、AEM_PORT 等，避免命令行参数冗余。对于企业代理场景，明确指导如何设置 NODE_EXTRA_CA_CERTS 和代理环境变量（HTTP_PROXY、HTTPS_PROXY 等），解决 TLS 拦截导致的证书验证失败问题。

适用边界与注意点

• 二进制文件限制：aem content push 对二进制文件（如图片、PDF）静默无操作，需通过 DA Source API 直接上传以验证结果。
• HTML 预处理影响：上传前的 HTML 规范化会剥离 EDS 图标装饰（如 <span class="icon">），若需字节级忠实上传，需绕过 CLI 直接调用 API。
• 环境依赖：要求 Node.js 12.11+，推荐 Node 22 LTS；TLS 配置需结合 mkcert 生成可信证书，避免浏览器警告。
• 故障排查：针对 EADDRINUSE、unable to get local issuer certificate、本地路径 404 等常见问题，提供对应的参数调整或配置修正方案。