Faust.js 无头 WordPress 工具包
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,将 @user_3c6cb52e/faustjs-headless-wordpress-toolkit-nextjs 安装到你的 AI 助手中。
技能介绍
解决什么问题
把 WordPress 当 CMS 用时,传统主题把表现层和内容耦合在一起;团队一旦想用 React 重建前端,就得自己拼装数据接口、鉴权、预览与渲染管线。Faust.js 要处理的正是这堆胶水代码。
它如何工作
- 数据获取:通过
WPGraphQL查询内容,按需选取字段,避免 REST API 的冗余响应。 - 鉴权:内置 headless 认证流程,前端可安全读写受限内容。
- 内容预览:在 Next.js 端预览未发布文章与修订版本,对齐 WP 后台编辑体验。
- 服务端渲染:处理 SSR 数据注水,保证首屏 HTML 完整可索引。
- 双组件架构:NPM 包提供 React hooks 与渲染组件,WordPress 插件负责接入后台与配置项,两边缺一不可。
适用边界与注意点
- 要求
Node.jsv18 及以上、npmv8 及以上。 - 后端必须是 WordPress,且需安装配套插件,不能脱离 WP 独立运行。
- 适合以 WP 为 CMS 的 Next.js 项目;前端框架不是 Next.js 时这套工具包不适用。
使用场景
- 内容团队计划用 React 重做网站前端,需要通过 WPGraphQL 查询文章、分类和媒体字段,把 WordPress 数据接入 Next.js 页面。
- 前端工程师在 Next.js 项目里实现服务端渲染,需要首屏 HTML 在 SSR 阶段完成数据拉取并正确注水。
- 编辑需要在 React 页面里预览未发布的草稿和修订版本,确认排版后再上线。
- 开发者需要配置 headless 认证流程,让前端安全地读取和更新受限的 WordPress 内容。
适合人员
- 负责把 WordPress 站点前端迁到 Next.js 的技术负责人,需要现成的数据层与渲染方案而非从零搭建。
- 维护 WordPress 编辑后台的内容团队,希望前端预览体验与后台保持一致。
- 为客户交付 headless WordPress 站点的独立开发者,需要认证、预览、SSR 等生产可用能力。