Wagtail 8.0 发布新 API：用 AI 操作 CMS，而非再造一个 AI CMS

Wagtail 8.0 的发布说明有些反常：亮点部分没有任何后台界面（admin UI）的改进。官方解释是，他们选择把精力集中在一个全新的 API 上，而不是通常备受好评的用户体验优化。这个名为 v3 的 API 是可选功能，开发者只需大约三行代码即可在现有项目中启用：在 INSTALLED_APPS 中加入 wagtail.api.v3，并配置对应的 URL 路由。

这个 API 覆盖了页面、图片、文档等 50 多种后台操作，提供完整文档和类型定义，还自动生成 Open API 模式。它内置支持将富文本输出为 Markdown 格式，既符合个人偏好，也方便 AI 代理处理。对于使用 Wagtail 作为 Django 后台替代方案的用户，该 API 还为自定义 Django 模型提供了端点。底层实现结合了类型检查和 Django Ninja 与 Pydantic 框架。

访问控制方面，该 API 支持公开匿名访问，让无头站点和其他发布机制可以平滑地从 v2 API 迁移过来；对于私有数据，则通过 bearer token 认证和 Wagtail 的权限模型来保护。官方强调了灵活性：用户既可以继续只用现有后台界面，也可以完全转向 API，或者按需混合使用。例如，可以用脚本批量执行 SEO 改进，或者让 AI 代理（如 OpenCode）自动修复页面的搜索描述。

Wagtail 的立场很明确：这是「带 AI 的 CMS」，而非「AI CMS」。除非用户自行安装 Wagtail AI 插件，否则后台不会出现花哨的 AI 按钮。但这个新 API 为代理工具提供了理想的操作入口，无论是通过 curl、命令行还是 MCP 协议使用。官方设想了一些应用场景，比如把 Markdown 文章快速发布上线、生成未发布页面和未使用图片的清理报告，或者用一百行脚本完成跨系统的内容迁移。目前该 API 作为预览版随 8.0 发布，官方欢迎用户测试并提供反馈，以便在几周后的 8.1 版本中调整。