LemonX 兼容性概述
LemonX 专为现代 WordPress 网站而构建，旨在与模块化 WordPress 工作流程配合使用。由于 LemonX 包括多个产品，因此兼容性可能取决于您使用的 LemonX 产品以及启用的功能。
LemonX 产品领域
LemonX AEO
SEO、AEO、架构、索引、AI 可见性、报告和内容优化。
LemonX Code
AI 页面生成、可视化编辑、模板、知识库、OCR、表单、模式和迁移工具。
LemonX Verto
AI 翻译、多语言 SEO、URL 翻译、hreflang、翻译记忆库和缓存。
LemonX MCP
安全 AI 代理连接、WordPress 读/写工具、应用前预览工作流程和 MCP 客户端。
LemonX Pro
许可证管理、云网关、产品权利、使用控制和高级功能。
LemonX Theme
入门主题、画布布局、模板基础和 AI 生成的页面支持。
重要提示：您无需在每个网站上启用每个 LemonX 产品。如果出现兼容性问题，您通常可以通过禁用未使用的 LemonX 模块并仅测试您需要的产品来隔离它。
推荐的系统要求
为了获得最佳体验，我们建议在现代 WordPress 环境中使用 LemonX。
推荐环境
- WordPress：最新稳定版本
- PHP：现代支持的 PHP 版本
- 数据库：WordPress支持的MySQL或MariaDB
- HTTPS：已启用
- REST API：已启用
- 固定链接：已启用
- 出站 HTTPS 请求：允许
- WP-Cron 或真实 cron：可用
- 内存限制：足够 AI、翻译和后台任务
- 文件权限：标准 WordPress 写入权限，用于上传和缓存（如果需要）
为什么这些要求很重要
LemonX 产品可能需要：
- 调用 AI 提供者 API
- 验证许可证
- 生成并保存内容
- 处理翻译队列
- 提交索引请求
- 使用 WordPress REST API
- 存储设置和日志
- 阅读媒体和页面内容
- 运行后台作业
- 与 MCP 客户联系
- 检查产品权利
- 安全地接收更新
如果您的服务器阻止这些操作，某些 LemonX 功能可能无法正常工作。
WordPress 兼容性
LemonX 是为使用现代 WordPress 标准的 WordPress 网站而设计的。
兼容的 WordPress 设置
WordPress 功能 LemonX 可能依赖
推荐的 WordPress 设置
- 使用干净的永久链接。
- 保持 WordPress 更新。
- 不要全局禁用 REST API。
- 不要阻止管理 AJAX。
- 使用 HTTPS。
- 避免直接编辑插件文件。
- 在重大更新之前保留备份。
- 尽可能测试分期的重大变化。
PHP 和服务器兼容性
LemonX 产品可以执行 AI 请求、索引请求、翻译队列处理、内容生成和基于文件的操作。您的服务器应该允许现代 WordPress 插件行为。
推荐的服务器功能
- 现代 PHP 版本
- 启用 cURL
- JSON 支持已启用
- 启用mbstring
- 已启用 OpenSSL
- 需要时提供 ZIP 支持
- 需要时提供文件信息支持
- 足够的内存限制
- 足够的最大执行时间
- 允许出站 HTTPS 请求
- WordPress 上传的写入权限
- 后台任务支持
- WP-Cron 或真正的 cron 可用
常见的服务器相关问题
- 许可证验证失败。
- AI 提供程序连接失败。
- 翻译队列不处理。
- 不发送索引请求。
- MCP 连接无法进行身份验证。
- 没有出现插件更新。
- 大型 OCR 或知识库任务失败。
- REST API 端点返回被阻止的响应。
- 安全防火墙阻止 LemonX 请求。
建议采取的行动：如果您不确定您的服务器是否支持这些功能，请联系您的托管提供商并询问是否允许出站 HTTPS 请求、WordPress REST API、WP-Cron 和标准插件更新请求。
Theme 兼容性
LemonX 旨在与现代 WordPress 主题配合使用，包括经典主题、块主题和轻量级入门主题。
兼容的主题类型
最佳兼容性条件
- 主题遵循 WordPress 编码标准。
- 主题支持正常的内容渲染。
- 主题不会阻止 REST API。
- 该主题不会严重覆盖管理屏幕。
- 主题不会删除所需的 WordPress 挂钩。
- 该主题支持标准的帖子、页面和媒体行为。
- 主题不会意外剥离生成的标记。
LemonX Theme 兼容性
LemonX Theme 被设计为 LemonX Code 和 AI 生成的页面的干净基础。当您需要轻量级布局基础、画布模板和可预测的页面渲染时，它非常适合。
可能的主题相关问题
- 生成的页面看起来不符合预期。
- Theme CSS 覆盖 LemonX 生成的部分。
- 画布布局不显示全宽。
- 页眉或页脚与构建器模板冲突。
- 存档模板的行为与预期不同。
- Theme 禁用部分块编辑器。
- Theme 在内容周围添加了过多的包装。
建议的故障排除
- 暂时切换到默认的 WordPress 主题。
- 暂时禁用自定义主题功能。
- 检查问题是否仅出现在一种主题上。
- 使用 LemonX Theme 或默认主题测试页面。
- 清除主题缓存和优化缓存。
- 检查您的主题是否覆盖内容过滤器。
页面构建器兼容性
LemonX Code 旨在帮助创建和管理 WordPress 页面、部分和模板。与页面构建器的兼容性取决于构建器如何存储内容和呈现布局。
常见建设者：Gutenberg、Elementor、Divi、Bricks、Oxygen、Beaver Builder、WPBakery、块主题、自定义构建器。
最佳支持的工作流程：当使用标准 WordPress 页面、帖子、块、短代码或干净的 HTML 结构存储内容时，LemonX 通常效果最佳。特定于构建器的布局可能需要额外的测试。
Gutenberg 兼容性
Gutenberg 和标准的基于块的工作流程通常是 AI 生成的内容、结构化内容、可重用部分和 SEO 友好页面的最可预测的环境。
Elementor 兼容性
LemonX 可以与 Elementor 一起使用，具体取决于所使用的功能。某些 AI 生成的部分可能需要插入为 HTML、简码、块内容或根据工作流程手动转换。
Divi、Bricks、Oxygen 和其他构建器
高级构建器通常以自定义格式存储布局数据。 LemonX 仍可能对内容、结构、SEO、文案、架构、翻译和迁移有所帮助，但直接可视化编辑兼容性可能取决于构建器。
可能与构建器相关的问题
- 生成的内容不会出现在构建器布局内。
- 构建器样式覆盖 LemonX 输出。
- LemonX 内容出现在预期容器之外。
- 短代码未正确呈现。
- 特定于生成器的模板不接受标准内容。
- MCP 编辑页面，但构建器布局需要手动刷新。
- 从构建器内容迁移需要清理。
推荐的工作流程
- 首先测试分期。
- 尽可能使用标准 WordPress 内容。
- 保留原始构建器模板的备份。
- 使用 LemonX 进行结构、复制、SEO 和内容生成。
- 如果需要，请使用构建器进行最终视觉调整。
- 避免在同一页面上混合太多布局系统。
SEO 插件兼容性
LemonX AEO 包括 SEO 和 AEO 功能，但许多网站已经使用 SEO 插件。 LemonX 可以与现有的 SEO 工具一起使用，具体取决于您的设置和启用的功能。
常用 SEO 插件
兼容方法
LemonX 可以支持 SEO 工作流程，例如内容分析、AI 搜索优化、架构生成、内部链接、索引、AI 可见性和报告。如果另一个 SEO 插件已经控制元数据或架构，您应该避免重复输出。
需要检查的领域
最佳实践
- 选择一个主要插件来输出元标记。
- 避免来自多个插件的重复架构。
- 必要时禁用重叠功能。
- 启用Schema后检查页面源。
- 使用测试工具来验证结构化数据。
- 保持规范 URL 输出一致。
- 如果重复的站点地图会造成混乱，请确保只提交一张站点地图。
可能出现的问题
- 重复的元标记。
- 重复的架构标记。
- 与规范 URLs 相冲突。
- 已提交多个 XML 站点地图。
- 打开图形预览不匹配。
- SEO 分数因工具而异。
- 重定向规则冲突。
- 机器人设置冲突。
建议的故障排除
- 暂时禁用重叠功能。
- 检查生成的 HTML 源。
- 检查架构输出。
- 检查站点地图设置。
- 清除缓存。
- 一次测试一页。
- 使用一个工具作为每种输出类型的真实来源。
翻译插件兼容性
LemonX Verto 提供 AI 翻译和多语言 SEO 功能。如果您的网站已经使用多语言插件，兼容性取决于语言版本、URLs 和翻译的存储方式。
常见的多语言插件
LemonX Verto 可以处理什么
重要的兼容性规则：避免让多个插件控制相同的语言路由、URL 结构或 hreflang 输出，除非集成是专门为该工作流程配置的。
可能出现的问题
- 重复的 hreflang 标签。
- 出现错误的语言版本。
- 翻译的蛞蝓冲突。
- 语言切换器重复。
- SEO 元数据未翻译。
- 翻译缓存不匹配。
- 不同的插件以不同的方式存储翻译的内容。
- WooCommerce 产品无法正确同步。
- 搜索引擎发现重复的语言 URLs。
推荐的工作流程
- 决定哪个系统控制语言路由。
- 决定哪个系统控制 hreflang。
- 决定哪个系统控制已翻译的 SEO 字段。
- 首先测试一种语言。
- 首先测试一种内容类型。
- 检查翻译后的URLs。
- 检查源输出。
- 翻译后清除缓存。
- 仅提交正确的多语言站点地图。
WooCommerce 兼容性
LemonX 可以支持 WooCommerce 网站，其中包含产品内容、产品 SEO、多语言产品页面、架构、类别内容、产品描述、常见问题解答和 AI 生成的电子商务内容。
可能的 WooCommerce 用例
- 生成产品描述。
- 生成产品常见问题解答部分。
- 翻译产品。
- 翻译类别。
- 翻译产品块。
- 优化产品架构。
- 创建电子商务登陆页面。
- 生成集合页面副本。
- 改善内部链接。
- 提交产品页面以进行索引。
- 创建多语言 SEO 元数据。
- 构建产品比较页面的内容。
要检查的兼容性区域
最佳实践
- 不要大量缓存购物车和结账页面。
- 首先在示例产品上测试翻译工作流程。
- 在批量更改之前备份产品数据。
- 在发布之前查看生成的产品描述。
- 检查产品架构输出。
- 避免来自多个工具的重复 SEO 元数据。
- 单独测试变异产品。
- 在索引之前检查翻译的产品 URLs。
可能的 WooCommerce 问题
- 产品变体未按预期翻译。
- 产品缺少 SEO 元数据。
- 重复的产品架构。
- 结帐页面缓存不正确。
- 翻译后的产品 URLs 冲突。
- 产品类别页面需要人工审核。
- 图像需要翻译 ALT 文本。
- 产品 Feed 可能需要单独处理。
缓存插件兼容性
LemonX 设计用于与缓存工具配合使用，但 AI 生成、转换队列、许可证检查、动态管理屏幕和 MCP 连接可能需要适当的缓存排除。
常用缓存工具
可能需要排除的领域
- LemonX 管理页面
- LemonX REST API 端点
- 许可证验证请求
- MCP 身份验证端点
- 翻译队列操作
- AI 提供者回调或请求端点
- 应用前预览页面
- 账户连接流程
- 动态仪表板小部件
可能的缓存问题
- 许可证状态不刷新。
- 翻译队列似乎卡住了。
- MCP 工具响应已过时。
- 管理仪表板显示旧数据。
- 生成的页面显示旧内容。
- 语言切换器显示错误的语言。
- REST API 响应缓存不正确。
- 更新的架构不会立即出现。
建议的故障排除
- 清除所有缓存。
- 清除 CDN 缓存。
- 暂时禁用缩小。
- 从缓存中排除 LemonX admin 和 API 路由。
- 暂时禁用对象缓存以进行测试。
- 检查服务器缓存是否处于活动状态。
- 在隐身浏览器中进行测试。
- 关闭登录用户的页面缓存。
安全插件兼容性
安全插件和防火墙可以保护您的站点，但如果配置过于激进，它们也可能会阻止许可证检查、REST API 请求、AI 提供程序调用、索引请求或 MCP 连接。
常用安全工具
LemonX 可能被阻止的操作
- 许可证验证
- 产品更新
- REST API 请求
- MCP 身份验证
- AI 提供商请求
- 索引提交内容
- 翻译队列处理
- 类似 Webhook 的请求
- 云网关请求
- 管理 AJAX 请求
可能的安全相关问题
- 许可证激活失败。
- MCP 无法连接。
- REST API 返回 401、403 或 404。
- AI 提供程序连接失败。
- 索引提交失败。
- 仪表板部分加载。
- 管理员操作被阻止。
- 请求被标记为可疑。
- 防火墙阻止出站 HTTPS。
建议的故障排除
- 检查防火墙日志。
- 如果需要，将 LemonX 路由列入白名单。
- 允许出站 HTTPS 请求。
- 确保 REST API 未全局禁用。
- 暂时禁用激进的测试规则。
- 检查应用密码是否被屏蔽。
- 如果服务器防火墙阻止请求，请询问托管支持。
- 在不了解原因的情况下，请勿永久禁用安全性。
CDN 和 Cloudflare 兼容性
LemonX 可以与 CDN 服务配合使用，但应仔细配置缓存和防火墙规则。
常见CDN服务
推荐的 CDN 配置
- 不要缓存 WordPress 管理页面。
- 不要缓存 LemonX 使用的动态 REST API 响应。
- 不要阻止出站许可证或 API 请求。
- 允许经过身份验证的用户绕过全页缓存。
- 主要内容生成或翻译后清除缓存。
- 如果 MCP 连接失败，请检查防火墙规则。
- 如果 AI 爬网程序或索引工具受到影响，请检查机器人保护设置。
可能的 CDN 问题
- 出现旧的翻译内容。
- 更新的内容不可见。
- LemonX 仪表板显示过时状态。
- MCP 连接被阻止。
- AI 爬网程序设置不会立即出现。
- 索引验证失败。
- 特定于语言的 URLs 返回缓存的错误语言。
AI 提供商兼容性
LemonX 产品可以连接到 AI 提供商，以进行内容生成、翻译、分析、OCR、知识库工作流程、MCP 相关工作流程和自动化。
常见的 AI 提供程序：OpenAI、Anthropic Claude、Google Gemini、DeepSeek、Ollama、OpenAI 兼容提供商、自定义 AI 网关、自托管或本地模型（如果支持）。
兼容性要求
- 有效的 API 密钥
- 正确的 API 基 URL
- 支持的型号名称
- 允许出站 HTTPS 请求
- 充足的供应商配额
- 正确的提供商权限
- 稳定的网络连接
- 兼容的请求和响应格式
- 合理的超时设置
可能的 AI 提供商问题
- API 密钥无效。
- 未找到型号。
- API 基 URL 不正确。
- 超出提供者配额。
- 已达到速率限制。
- 请求超时。
- 服务器无法到达提供商。
- 不支持响应格式。
- 本地模型不可用。
- 提供商阻止您的区域或服务器 IP。
建议的故障排除
- 如果可能，直接测试 API 键。
- 检查提供商配额和计费。
- 确认型号名称。
- 确认 API 基础 URL。
- 尝试其他提供商。
- 尝试较小的请求。
- 如果支持的话增加超时。
- 询问您的主机是否允许出站 HTTPS。
- 检查 LemonX 提供程序日志（如果有）。
MCP 客户端兼容性
LemonX MCP 将 WordPress 与 MCP 兼容的 AI 客户端连接起来。兼容性取决于 MCP 客户端、身份验证设置和您的 WordPress 服务器环境。
常见的 MCP 客户端：Claude Desktop、Codex、光标、其他 MCP 兼容客户端。
MCP 工作流程的要求
- WordPress 网站可通过 HTTPS 访问
- 有效认证
- MCP 端点可达
- 正确的站点URL
- 正确的凭据或令牌
- REST API 未被阻止
- 防火墙允许所需的请求
- 用户具有适当的 WordPress 权限
- LemonX MCP 模块已启用
- 根据需要配置应用前预览工作流程
可能的 MCP 问题
- 客户端无法连接。
- 认证失败。
- 站点身份不匹配。
- 工具不出现。
- 读取工具可以工作，但写入工具会失败。
- 预览有效但应用失败。
- 防火墙阻止 MCP 请求。
- 配置了错误的站点URL。
- 用户没有权限。
- REST API 已禁用。
建议的故障排除
- 确认 WordPress 站点 URL。
- 确认 HTTPS 正常工作。
- 检查身份验证凭据。
- 检查用户角色和权限。
- 确认 LemonX MCP 处于活动状态。
- 检查安全插件日志。
- 测试 REST API 可用性。
- 如果需要，重新生成凭据。
- 重新启动 MCP 客户端。
- 查看 LemonX 内的 MCP 日志。
浏览器兼容性
LemonX 管理屏幕是为现代浏览器设计的。
推荐浏览器
应启用的浏览器功能
- JavaScript
- 饼干
- 本地存储
- 现代 CSS 支持
- 安全 HTTPS 连接
- 需要帐户连接时弹出窗口
- LemonX 管理屏幕上没有激进的脚本阻塞
可能的浏览器问题
- 仪表板未加载。
- 按钮没有反应。
- 许可证连接弹出窗口失败。
- 帐户登录不会保持活动状态。
- 可视化编辑器的行为异常。
- 文件上传不开始。
- MCP 设置说明无法正确显示。
建议的故障排除
- 更新您的浏览器。
- 尝试另一个浏览器。
- 暂时禁用浏览器扩展。
- 使用隐身/私人窗口。
- 清除浏览器缓存。
- 允许 cookie。
- 禁用 LemonX 管理页面的激进隐私拦截器。
WordPress 多站点兼容性
LemonX 可用于多站点环境，具体取决于您的产品、许可证和配置。在生产使用之前应仔细测试多站点行为。
需要检查的事项
- 网络激活与站点激活
- 每个站点的许可证状态
- 每个站点的设置
- 共享用户和角色
- 不同语言的网站
- 不同的域或子域
- 插件权限
- 媒体库行为
- REST API 行为
- Cron 和后台任务
- 客户网站所有权
- 代理许可限制
推荐的工作流程
- 首先在临时多站点网络上进行测试。
- 仅在需要时激活 LemonX。
- 确认每个站点的许可证行为。
- 检查每个子站点是否需要单独设置。
- 在一个子网站正常工作之前，请避免进行批量更改。
- 查看站点管理员和网络管理员的权限。
何时联系支持人员：如果您需要确认您的计划是否支持多站点、子站点许可、代理工作流程或网络级配置，请联系支持人员。
托管兼容性
大多数现代 WordPress 托管环境应支持 LemonX，但某些主机可能会限制出站请求、cron 作业、REST API 路由、文件操作或长时间运行的后台任务。
兼容的托管类型
要检查的托管功能
可能与托管相关的问题
- AI 请求超时。
- 翻译队列停止。
- OCR 处理失败。
- 许可证验证被阻止。
- 插件更新不可用。
- MCP 无法连接。
- 大页面无法保存。
- 后台作业不运行。
- REST API 返回服务器错误。
建议采取的行动：如果您的托管提供商有严格的安全规则，请要求他们确认 WordPress 插件可以发出出站 HTTPS 请求并正常使用 REST API 端点。
已知的兼容性冲突模式
兼容性问题通常来自重叠的功能、阻塞的请求或激进的优化。
重复的 SEO 输出
两个插件同时输出元标记、Schema、规范 URLs 或 Open Graph 标记。
已阻止 REST API
安全插件、防火墙或自定义代码会阻止 LemonX 所需的 REST API 路由。
缓存动态响应
缓存工具缓存管理、API 或应保持动态的特定于语言的响应。
特定于构建器的存储
页面构建器以自定义格式存储内容，该格式不直接接受标准 WordPress 内容。
翻译路由冲突
多个插件尝试控制语言 URLs、hreflang 或翻译内容存储。
服务器请求阻塞
托管防火墙阻止对许可证、AI、翻译或索引服务的出站调用。
权限不匹配
WordPress 用户不具备 LemonX 操作所需的能力。
错误的环境URL
暂存 URL、临时 URL、www/非 www 不匹配或 HTTP/HTTPS 更改会导致许可证或 MCP 混淆。
兼容性测试清单
在生产站点上使用 LemonX 之前，请使用此清单。
基本设置
- WordPress 已更新。
- PHP 是现代的并且受支持。
- HTTPS 已启用。
- 固定链接已启用。
- REST API 有效。
- 管理 AJAX 有效。
- WP-Cron 有效。
- 允许出站 HTTPS 请求。
- LemonX 产品已更新。
产品测试
- AEO 仪表板加载。
- Code一代作品。
- Verto 翻译队列运行。
- MCP 连接成功。
- Pro 许可证状态已验证。
- Theme 模板显示正确。
- AI 提供商连接有效。
- 索引集成在配置的地方工作。
插件测试
- SEO 插件输出已检查。
- 检查翻译插件输出。
- 更改后缓存被清除。
- 已审查安全防火墙日志。
- WooCommerce 产品页面已测试。
- 已测试页面构建器页面。
- CDN 缓存已测试。
- 没有出现重复的架构。
最终生产检查
- 备份网站。
- 如果可能的话，测试分期。
- 一次启用一个模块。
- 清除所有缓存。
- 检查前端页面。
- 检查源代码输出。
- 检查管理绩效。
- 确认没有致命错误。
- 启动后监视日志。
如何报告兼容性问题
如果您认为 LemonX 与您的主题、插件、托管提供商或 AI 提供商冲突，请向我们发送足够的信息来重现和诊断问题。
包括什么
- 网站URL
- WordPress 版本
- PHP 版本
- LemonX 产品和版本
- Theme 名称和版本
- 活动插件列表
- 托管服务提供商
- 缓存插件或 CDN
- 安全插件或防火墙
- AI 提供商（如果相关）
- SEO 插件（如果相关）
- 翻译插件（如果相关）
- 页面构建器（如果相关）
- 确切的错误消息
- 屏幕截图或屏幕录制
- 重现问题的步骤
- 问题是否发生在暂存阶段
- 禁用其他插件是否可以解决问题
- 切换主题是否可以解决问题
兼容性常见问题解答
LemonX 是否适用于任何 WordPress 主题？
LemonX 旨在与现代 WordPress 主题配合使用。遵循 WordPress 标准的主题通常效果最好。高度定制的主题可能需要测试。
LemonX 可以与 Elementor 一起使用吗？
LemonX 可以在许多工作流程中与 Elementor 一起工作，特别是对于内容、SEO、AEO 和生成支持。直接布局编辑可能取决于页面的构建方式。
LemonX 可以与 Gutenberg 一起使用吗？
是的。 Gutenberg 和标准 WordPress 块工作流程是 LemonX 生成内容的最可预测的环境之一。
我可以将 LemonX AEO 与 Yoast 或 Rank Math 一起使用吗？
是的，但要避免重复输出。决定哪个工具控制元标记、架构、站点地图和开放图谱数据。
我可以将 LemonX Verto 与 WPML 或 Polylang 一起使用吗？
这取决于您的配置。避免让多个工具同时控制语言路由、hreflang 和翻译的 URLs ，除非有意配置。
LemonX 可以与 WooCommerce 一起使用吗？
LemonX 可以支持 WooCommerce 内容、产品 SEO、产品翻译、产品页面、架构和电子商务登陆页面。仔细测试产品变化和结账相关页面。
缓存插件会破坏 LemonX 吗？
缓存插件通常可以工作，但 LemonX 管理页面、API 路由、翻译队列、许可证检查和 MCP 端点可能需要缓存排除。
为什么我的安全插件会阻止 LemonX？
如果规则过于严格，安全插件可能会阻止 REST API 请求、出站 HTTPS 调用、MCP 身份验证或许可证验证。检查防火墙日志，并在需要时将安全 LemonX 操作列入白名单。
LemonX 可以在多站点上工作吗？
某些 LemonX 工作流程可能适用于多站点，但应根据您的计划确认许可和每个站点设置并在分段上进行测试。
LemonX 支持本地开发吗？
您可以在本地测试许多功能，但云功能、许可证验证、AI 提供商调用、索引和 MCP 连接可能需要可访问的 HTTPS 环境。
我的 AI 提供商无法连接。这是兼容性问题吗？
这可能是提供商配置问题、API 密钥问题、配额问题、服务器防火墙问题或不正确的 API 基础 URL。首先检查提供商设置。
发现冲突的最佳方法是什么？
禁用不必要的插件，切换到默认主题，清除缓存，一次测试一个 LemonX 模块，然后一一重新启用工具，直到问题再次出现。