构建你的第一个 AI 驱动 WordPress 插件：用 Abilities API + AI Client 拼出图片转文章

云上的幻象2026-10-028 分钟阅读2,860 字90

100%

构建你的第一个 AI 驱动 WordPress 插件：用 Abilities API + AI Client 拼出图片转文章

结论先说

WordPress 官方开发者博客（2026-07-30）手把手教用三大核心 API——Abilities API、WordPress AI Client、Connectors——拼出一个”给图片 URL 自动生成草稿文章”的插件；本文提炼它的架构与落地步骤，让你看懂 WordPress 的 AI 标准集成方式。

三个核心积木

API	职责	解决什么
Abilities API	注册”能力单元”	让 REST 、区块编辑器、 AI 智能体都能发现并运行同一段功能
WordPress AI Client	提供方无关的 AI 调用库	代码不绑定 OpenAI / Anthropic / 本地 Ollama，换厂商不重写得
Connectors	统一存储外部 API Key	告别每个插件各写一套设置页，后台一处配置

案例插件 Photo to Post 做了什么

你给一个图片 URL，插件做三件事：用视觉模型生成文字描述 → 基于描述生成草稿文章（标题+正文）→ 把原图设为特色图像。骨架是三个可组合的 Ability：

Ability	作用	AI 能力
describe-image	图片 URL → 文字描述	视觉（图像输入）
generate-post-from-description	描述 → 标题+正文	文本生成
create-post-from-photo	编排上面两者并建文章	无（仅编排）

第三个 Ability 调用前两个，正是 Abilities API 相比传统写法的亮点：能力可以互相组合，通过 WP_Ability::execute() 串联。

官方 starter 插件已搭好后台表单骨架，照 TODO 注释把 AI 逻辑填进去最快，不必从零搭界面。

第一步：注册 Ability 分类与能力

wp_register_ability( 'wp-ai-workshop-demo/describe-image', array(
    'label'       => __( 'Describe an image via AI', 'wp-ai-workshop-demo' ),
    'input_schema'  => array(
        'type'       => 'object',
        'properties' => array( 'image_url' => array( 'type' => 'string' ) ),
        'required'   => array( 'image_url' ),
    ),
    'output_schema' => array(
        'type'       => 'object',
        'properties' => array( 'description' => array( 'type' => 'string' ) ),
        'required'   => array( 'description' ),
    ),
    'execute_callback'  => 'wp_ai_workshop_demo_describe_image',
    'permission_callback' => function(){ return current_user_can( 'edit_posts' ); },
    'meta' => array( 'show_in_rest' => true ),
) );

重点：'show_in_rest' => true 让 WordPress 自动把这个 Ability 暴露到 REST API，无需你手写路由。注意这里用 current_user_can('edit_posts') 做权限护栏——AI 能力也要守住最小权限。

能力组合：一个 Ability 调用另一个

create-post-from-photo 在回调里先调 describe-image 拿描述，再调 generate-post-from-description 出草稿，最后用 WP 函数建文章、 sideload 原图为特色图像。这种”编排 Ability”不依赖 AI，只是把已有能力串起来。