常见问题

本故障排除指南旨在帮助 WordPress 用户解决 AI Generator 在安装、内容生成、图像、页面、积分以及批量工作流中遇到的常见问题。

API Key 未配置

前往 AI Generator > Settings 并粘贴您的 API Key。保存设置后，再次检查仪表盘组件。

连接失败

请检查以下各项：

• API Key 是否复制正确。
• 您的 WordPress 网站是否允许发送出站 HTTPS 请求。
• 安全插件或服务器防火墙是否拦截了向 wpthemoon.com 发送的请求。

积分不足

请在 wpthemoon.com 上增加积分。然后刷新仪表盘组件或重新加载 WordPress 编辑器。

生成中断或仅返回部分内容

这种情况可能是由网络超时、服务器限制或浏览器中断引起的。

请尝试使用更短的提示词（prompt）或关键词再次尝试。对于文章生成，请保留任何可用的部分意图分析，然后重新生成文章。

文章未插入

请确认您正在编辑的是 WordPress 的“文章”（Post）而非“页面”（Page）。文章生成面板（Article Generator panel）仅适用于文章。

如果生成的内容无法转换为区块（blocks），请尝试重新生成或简化主题。

无法应用特色图像

请先保存草稿。WordPress 需要在文章已保存的情况下，插件才能从媒体库中关联图像。

同时，请确认您的用户账户拥有上传媒体和编辑文章的权限。

页面被生成为 HTML 区块

某些复杂的页面部分可能会变成 HTML 区块，而不是原生的 Gutenberg 区块。

您可以直接编辑这些 HTML 区块，手动重建该部分，或者使用更简单的页面简报（page brief）重新生成。

批量生成部分失败

对于失败的关键词，请使用重试选项。如果批量处理因积分不足而停止，请先充值积分，然后继续处理未完成的关键词。

在联系支持团队之前

• 确认您的 API Key 已保存。
• 刷新您的积分显示。
• 尝试使用更短的关键词、提示词或页面简报再次执行操作。
• 检查该问题是仅在单篇文章中出现，还是在整个网站中普遍存在。
• 记录您的 WordPress 版本、PHP 版本和插件版本。

常见问题解答 (FAQ)

为什么有些问题只在编辑器中出现？

编辑器依赖于您的浏览器、WordPress 权限和站点配置。某些插件或安全规则可能会影响编辑器的操作，而不会影响仪表盘。

为什么应用图像需要先保存文章？

WordPress 需要在媒体被关联并设置为特色图像之前，先获得一个文章 ID。

每次失败后我都应该重试吗？

对于临时性失败可以尝试重试。对于重复出现的验证或权限失败，请先修复安装配置。