# WordPress Abilities API：面向开发者、发布者和产品团队的通俗易懂指南 *Published:* 2025-09-23 *Author:* 小雨 WordPress Abilities API[5](#d7fd8d51) （能力 API）是什么 ------------------------------------------------- 能力 API 是一个官方的 WordPress 计划，它创建了一个共享的、机器可读的网站功能目录。与将操作隐藏在不同的插件或深层嵌套的代码中不同，能力通过一致的元数据在中央目录中注册，这些元数据既便于人类理解，也便于软件理解。其结果是一个功能可发现、可文档化、可安全调用的系统。 为什么是现在才提供此功能？ WordPress 生态系统正在朝着可互操作的自动化和 AI 助手发展。这些工具需要一种可预测的方式来列出、理解和调用网站功能，而无需为每个插件编写自定义的粘合代码。标准的能力层直接满足了这一需求。 了解更多 [WordPress AI](https://wptea.com/tag/wordpress-ai) 信息扩展阅读： - [即将进入新品密集发布期，WordPress AI 专栏也要来了。](https://wptea.com/wordpress-ai-project-website-is-coming/) - [最近一直在给 WordPress 网站深度集成 AI …](https://wptea.com/wordpress-website-deep-integration-ai/) - [AI 实验插件 – WordPress AI 功能官方介绍说明](https://wptea.com/ai-experiments-wordpress-ai/) - [PHP[8](#2cdf9635) AI Client – WordPress AI 能力官方介绍说明](https://wptea.com/php-ai-client-wordpress-ai/) - [Abilities API – WordPress AI 能力官方介绍说明](https://wptea.com/abilities-api-wordpress-ai/) - [MCP[7](#45c0c455) Adapter – WordPress AI 适配器官方介绍说明](https://wptea.com/mcp-adapter-wordpress-ai/) - [WordPress AI Building Blocks 构建区块计划方案官方说明](https://wptea.com/wordpress-ai-building-blocks-plan/) 在 WordPress 生态系统中的位置 -------------------- 能力 API 位于 “WordPress AI 构建模块” 中，与 PHP AI 客户端、MCP 适配器和 AI 实验插件并列。这些构建模块为开发者提供了一个可立即采用的通用基础，同时核心集成分阶段进行。 当前以 Composer[1](#748098c6) 包的形式分发，并有一个功能插件用于实验。WordPress 开发者博客强调了该包的可用性，并鼓励在计划于 WordPress 6.9 版本中发布到核心之前进行早期测试。这表明了强大的发展势头和明确的集成路径。 能力 API 如何工作 ----------- ### 可查询的中央注册表 项目的核心是一个注册表，任何插件或主题都可以向其添加内容。能力通过标识符和一捆元数据进行注册：标签和描述、输入和输出模式、执行回调以及明确权限。这使得网站的功能可以列出和检查，而不是隐藏或重复。 GitHub[2](#1a211efe) 仓库简洁地总结了设计目标：可发现性使每个能力都可以列出和检查，通过统一模式实现互操作性，通过明确的权限设置实现安全第一的态势，以及从可迁移到核心的 Composer 包开始的逐步采用。 ### 元数据的结构 每个能力描述： - **名称**和功能，使用通俗易懂的语言。 - **输入**，通过模式而非临时数组或非正式注释来记录。 - **输出**，同样通过模式记录。 - **运行方式**，通过回调在服务器上执行。 - **权限检查**，用于控制执行。 这种模式让开发者、UI[10](#d7c4eb19) 和外部代理在调用函数之前可以评估其”形态”。API 的 Make 帖子甚至展示了一个使用 **wp\_register\_ability** 的原型注册示例，包含输入模式、输出模式和权限回调。 ### 安全和权限 能力将安全需求代码化，而不是绕过它们。每个能力声明自己的权限检查，WordPress 在运行时强制执行该要求，然后再分发回调。这使得权限检查集中化和可审计，而不是分散在模板、AJAX[3](#ce8871bd) 处理器和 REST[4](#d6e25484) 端点中。 ### 谁可以触发能力 能力可以由 WordPress 本身调用、插件 UI 调用，或通过适配器路由的外部代理调用。无论哪种情况，系统都依赖注册表元数据来指导验证、资格和权限检查，然后再运行实际的业务逻辑。 ### 与 AI 和外部工具的连接 能力 API 被设计为与现代 AI 协议良好配合。MCP 适配器将注册的能力转换为 MCP “工具”，这让 ChatGPT 或 Claude 等助手可以枚举网站上的可用操作，理解所需输入，并通过适当的授权请求执行。WordPress 可以作为 MCP 服务器来暴露能力，也可以作为 MCP 客户端来调用其他 MCP 系统。 这与 PHP AI 客户端和 AI 实验插件并列。它们共同提供了一个完整的解决方案：一种与 AI 提供商对话的方式，一种以标准形式暴露网站功能的方式，以及一个探索端到端流程的工作环境。这些构建模块被有意设计为模块化并以包的形式发布，使早期采用者现在就可以开始行动，而无需等待核心更新。 高影响力用例 ------ ### 内容和编辑操作 编辑系统通常将核心功能与 SEO[9](#0ae41898) 工具、媒体处理和自定义工作流程混合在一起。能力使这些功能可发现和可组合。内容助手可以列出”创建草稿”、”分析内容”或”生成摘录”，并有信心地将它们链接起来，因为输入和输出模式是明确的。 ### 跨插件自动化和工作流构建器 WordPress 开发中最大的隐藏成本之一是插件之间的粘合代码。没有共享接口时，集成需要自定义 REST 路由、专用钩子和脆弱的 UI 脚本。有了中央注册表中的能力，不相关的组件可以通过通用工具组合成工作流程，而不是自定义代码。这为可视化构建器铺平了道路，可以在单个序列中编排”生成发票”、”发送邮件”和”记录到 CRM[6](#671f4ad4)”。 ### 命令面板和上下文感知 UI 命令面板和类似界面依赖于可靠的操作列表和明确的资格规则。当能力注册时带有标签、描述和权限回调，UI 可以上下文地显示操作，在不允许时隐藏它们。模板中更少的条件检查，框架级别更好的一致性。 ### 企业治理和合规 企业需要可审计性和明确的职责划分。声明操作的中央注册表，所有操作都有文档化的权限，将治理从经验知识转变为可追溯的元数据。检查网站上存在哪些操作、哪些角色可以执行它们，以及最初是哪些插件注册的它们变得更加容易。 ### 具有服务器保障的前端交互 面向公众的交互通常依赖于资格规则，而不仅仅是身份验证。能力可以在权限回调或资格守卫中封装状态检查。这可以简化前端逻辑。前端”应用优惠券”控件可以查询能力元数据以确定操作当前是否有资格，然后请求执行，而服务器端权限检查仍然是真实性的来源。 文档和实时参考资料 --------- 三个值得收藏的资源： - [WordPress 关于能力 API 的文章](https://wptea.com/abilities-api-wordpress-ai/)，提供概念框架和注册示例。 - [项目仓库](https://github.com/WordPress/abilities-api)，提供设计目标、文档和发布信息。 - [MCP 适配器](https://wptea.com/mcp-adapter-wordpress-ai/)文章，介绍协议桥和在向助手暴露能力时的安全态势。 接下来值得关注的内容 ---------- ### 客户端库 开发者博客提到正在进行能力 API 客户端库的开发。一旦建立了标准的浏览器端接口，可以预期更紧密的 UI 集成、增强的命令面板操作，以及更全面的工作流构建器，这些构建器可以使用统一的心理模型在服务器和客户端上下文中查询、过滤和执行。 ### 重塑插件架构的模式 标准化输入和输出的注册表通常会将架构推向更小、可组合的操作。随着时间的推移，这鼓励插件暴露更少的”一体化向导”，而是暴露更多的离散类型化操作。优势体现在测试、可观察性和集成方面。相同的操作可以从 PHP 调用、通过 MCP 从助手调用、从内部 UI 组件调用，所有这些都使用相同的模式作为契约。 ### 总结 能力 API 将 WordPress 从一个隐藏钩子的迷宫转变为声明的、可发现操作的目录。它为编辑人员、产品团队和 AI 系统提供了一种通用语言来理解网站能做什么，以及请求这些操作的安全方式。随着包的成熟和 6.9 周期将其推向核心，实际收益是清晰的：更清晰的集成、更快的自动化、更强的治理，以及一个更容易负责任扩展的平台。 ### 名词解释 1. Composer：PHP 的依赖管理工具 [↩︎](#748098c6-link) 2. GitHub：全球最大的代码托管和协作开发平台 [↩︎](#1a211efe-link) 3. AJAX：异步加载技术，实现网页无刷新更新 [↩︎](#ce8871bd-link) 4. REST：一种网络服务架构风格 [↩︎](#d6e25484-link) 5. API：应用程序编程接口，软件之间交互的标准方式 [↩︎](#d7fd8d51-link) 6. CRM：客户关系管理系统 [↩︎](#671f4ad4-link) 7. MCP：AI 模型与外部工具交互的协议 [↩︎](#45c0c455-link) 8. PHP：WordPress 核心使用的服务端编程语言 [↩︎](#2cdf9635-link) 9. SEO：搜索引擎优化，提升网站在搜索结果中排名的技术 [↩︎](#0ae41898-link) 10. UI：用户界面，用户与软件交互的视觉部分 [↩︎](#d7c4eb19-link)