这篇文章适合准备在 WordPress 7.0 里做 AI 图片能力的插件作者：官方教程已经把怎么接 AI Client、怎么判断能力可用、怎么把图存回媒体库串成了完整范式。
- 01先读摘要，判断是否与你的场景相关。
- 02再看来源，保留继续查证的路径。
- 03最后看步骤、风险和可复用动作。
摘要：这篇文章适合准备在 WordPress 7.0 里做 AI 图片能力的插件作者：官方教程已经把怎么接 AI Client、怎么判断能力可用、怎么把图存回媒体库串成了完整范式，直接照着做比自己拼接 provider 更稳。
适用场景
如果你要在 WordPress 后台里提供图片生成、图像预览或媒体库保存，这个教程就有用。它不适合只想在站点外部单独生成图片的人，也不适合完全不打算碰 REST 或媒体库的人。
先理解 AI Client 的设计
WordPress 官方教程强调，AI Client 是 provider 和 model agnostic 的。插件不应该直接绑定某一家供应商，而是把需求描述给 WordPress，由站点管理员在 Settings > Connectors 中配置连接。这样做的价值很直接：站点自己决定用哪个 provider，插件只关心能力是否可用。
插件结构怎么拆
官方示例把插件拆成几个清晰的文件：主入口、prompt 构建、REST API、管理端脚本和前端界面。主插件文件会先检查 wp_ai_client_prompt() 是否存在，再决定是否继续加载，这是一层很实用的运行时保护。
plugin.php负责入口和 hook。includes/prompt.php负责构造 prompt builder。includes/rest-api.php负责生成和上传两条 REST 路由。src/index.ts负责前端对话框和交互。
生成图片的最小链路
真正的核心只有三步：先用 wp_ai_client_prompt() 创建 builder，再用 with_text() 和 as_output_file_type(FileTypeEnum::inline()) 描述输出，最后调用 generate_image_result()。在把 UI 暴露给用户之前，再用 is_supported_for_image_generation() 先做能力检查，避免无效按钮。
为什么要把生成和上传拆开
官方教程把“生成图片”和“存到媒体库”分成两个 REST endpoint，这是很合理的设计：先让用户预览，再决定是否保存。这样做可以减少误保存，也更容易处理失败、重试和审核流程。
准备材料
- 一个已启用 AI Client 的 WordPress 站点。
- 一个能够访问媒体库上传权限的账号。
- 一个准备好的插件骨架。
- 一个明确的图片生成用途，比如封面、插图或摘要卡片。
检查清单
- 站点是否已经配置可用的 AI provider。
- 所选 provider 是否支持图片生成。
- 前端是否只在支持能力时显示入口。
- 保存媒体时是否具备
upload_files权限。
常见坑
最常见的坑，是把 provider 写死，结果换站就要重写。另一个坑，是先把保存流程接起来，再补能力检查，最后会出现“按钮能点但不可用”的假入口。还有一个坑，是把生成和上传绑在一个接口里，失败后难以重试。
排错路径
如果插件无法生成图，先检查 AI Client 是否启用，再检查 Connectors 配置。接着确认图片生成能力是否真的可用，最后才看 REST 路由和前端脚本。只要能力检查没过，就不要继续往下跑。
可复制模板
模板可以很简单：插件负责展示入口，AI Client 负责生成，REST 负责预览和保存，媒体库负责最终落盘。你不需要把所有逻辑塞进一个文件里，真正重要的是边界清楚。
更新日期与维护建议
更新日期：2026-06-17。以后只要 WordPress 再更新 AI Client 教程或 Connector 相关说明，就重新检查能力检测、REST 分拆和媒体库上传流程。