高级自定义字段 REST Schema 映射器

要解决的问题

默认情况下，ACF 会把字段直接丢进 WordPress 的 REST 响应里。客户端拿到的负载往往包含用不上的字段、不一致的命名和多余的嵌套结构，前端很难直接映射成自己的数据模型，团队协作时也容易出现“接口形状说不清”的情况。当你用 React、Vue 或移动客户端消费 WordPress 数据时，这种“什么字段都往外倒”的响应既不干净，也不便于版本管理。

技能如何工作

这个技能围绕三个关键 API 展开，职责划分很清楚：

• acf_add_local_field_group：声明字段组结构，把字段定义注册到 WordPress，成为后续映射的数据源。
• get_field_objects：枚举实际挂载的字段对象，拿到当前文章类型或主题上真实存在的字段元数据，而不是凭空假设。
• register_rest_field：在 REST 响应的指定位置挂载处理后的字段数据，决定负载暴露成什么形状。

大致流程是：先声明字段组，再读取字段对象获取真实元数据，最后通过 register_rest_field 把字段数据转换成你期望的结构。这样每个端点的响应是可预测的，客户端可以稳定地消费结构化字段数据。技能同时关联 ACF 官方资源中的入门说明与字段类型文档，供配置时查阅。

适用边界与注意点

• 适合需要比默认 ACF 暴露更干净的负载、并由 WordPress 客户端消费字段数据的项目。
• 前提是站点已启用 ACF 插件，且相关文章类型开放了 REST 访问。
• 字段组声明与字段对象枚举需要保持一致，否则映射结果会与预期有偏差。
• 该技能解决的是响应形状问题，不负责字段值的存储与序列化细节，具体字段类型的行为仍以 ACF 官方文档为准。