WordPress 7.0 AI 原生架构完全解读:Connectors + Client 三层体系让每个插件都能调用 AI 能力
WordPress 7.0 带来了一个里程碑式的变化——AI 能力被深度集成到了核心架构中-2。在此之前,每个需要 AI 功能的插件都要自己管理 API Key、自己写 cURL 请求、自己处理不同 AI 提供商的差异-2。这种碎片化的方式不仅让插件代码臃肿,还带来了严重的安全隐患——API Key 散落在各个插件中,任何一个插件出问题都可能导致密钥泄露。
WordPress 7.0 彻底改变了这一局面,构建了一套全新的三层 AI 架构-2。
第一层:AI Connector(连接器层)
Connector 是这套架构的配置入口。在 WordPress 后台的“设置 → Connectors”中,你可以一次性配置好所有 AI 服务提供商的 API Key——OpenAI、Anthropic Claude、Google Gemini、Vercel AI Gateway 等-2-1。配置完成后,所有安装了 Connector 插件的 AI 功能都会自动使用这些凭证-2。
这对网站管理员来说意味着什么?以前,如果你使用了三个不同的 AI 插件(比如内容生成、图片生成、智能客服),你需要分别在三个插件中配置 API Key。更换 Key 时要改三次。现在,你只需要在 Connectors 界面配置一次,所有插件共享-2。如果某个 AI 提供商的 Key 泄露了,也只需要在一个地方更换-2。
对于插件开发者来说,好处更加明显。你的插件不再需要关心用户用的是哪个 AI 提供商、API 格式是什么、认证方式是什么。只需要调用 WordPress 核心的 AI Client,剩下的都由 Core 处理-2。代码量大幅减少,安全性和可维护性大幅提升。
第二层:AI Client(客户端层)
AI Client 是开发者实际调用的 API 接口-2。它的设计非常直观,采用了链式调用的方式:
$text = wp_ai_client_prompt( '用一句话写一个关于独角兽的睡前故事' )
->using_provider( 'openai' )
->generate_text();
这是最基础的用法-1。你还可以指定模型偏好、系统指令、温度参数、最大 Token 数等-1:
$text = wp_ai_client_prompt( '用一段话解释量子计算' )
->using_provider( 'ai_gateway' )
->using_model_preference( 'claude-sonnet-4.6', 'gemini-3.1-pro-preview' )
->using_system_instruction( '你是一个谨慎、精确的助手,请逐步思考。' )
->using_temperature( 0.2 )
->using_max_tokens( 200 )
->generate_text();
更强大的是,AI Client 支持多轮对话的历史上下文传递-1:
use WordPress\AiClient\Messages\DTO\UserMessage;
use WordPress\AiClient\Messages\DTO\ModelMessage;
use WordPress\AiClient\Messages\DTO\MessagePart;
$history = [
new UserMessage( [ new MessagePart( '我叫 Ada。' ) ] ),
new ModelMessage( [ new MessagePart( '很高兴认识你,Ada。' ) ] ),
];
$text = wp_ai_client_prompt( '我刚才说我叫什么名字?' )
->using_provider( 'openai' )
->with_history( ...$history )
->generate_text();
AI Client 还支持传递图片、音频等媒体文件-1:
$text = wp_ai_client_prompt( '描述一下你在这张图片中看到了什么。' )
->using_provider( 'openai' )
->using_model_preference( 'gpt-4o' )
->with_file( '/path/to/image.jpg' )
->generate_text();
第三层:AI Provider(提供商层)
Provider 是具体的 AI 服务实现。每个 AI 提供商(OpenAI、Anthropic、Google 等)都有自己的 Provider 插件,负责将 WordPress 的标准化 AI 请求转换为该提供商特有的 API 格式-2。
这种分层设计的精妙之处在于:插件开发者只需要写一次代码,用户可以在不修改任何代码的情况下切换 AI 提供商-2。今天用 OpenAI,明天想换成 Claude?只需要在 Connectors 中更换 Key 和选择 Provider,所有 AI 功能自动切换。
对于注重数据隐私的网站,还有 Local AI Connector 这样的方案-6。它允许你连接本地部署的开源模型(通过 Ollama、LM Studio 等),所有 AI 推理都在你自己的服务器上完成,数据不外传-6。
实际应用场景
这套 AI 架构已经催生了一批原生 AI 插件。比如 Aculect AI Companion 允许你用自然语言管理网站——直接说“帮我创建一篇关于 XX 的文章”或“更新首页的关于我们页面”,AI 就会自动执行-。KnowChatBot 可以在你的网站上添加一个浮动聊天窗口,AI 助手会学习你网站的所有页面内容,回答访客的问题-。
WordPress 7.0 的 AI 原生架构,把 AI 能力从“插件的附加功能”变成了“平台的基础设施”。无论你是网站管理员还是插件开发者,这套架构都值得深入学习。

