用途：提供使用 Sage（roots/sage）框架开发 WordPress 主题的实践模式，适用于创建、修改或调试 Sage 主题，包括 Blade 模板、布局与可复用组件、构建工具配置、模板层级映射、ACF 集成以及渲染与资源加载问题排查。
主要能力：用 Composer 创建 Sage 主题；用 Blade 编写模板，模板放在 resources/views/，布局在 layouts/，组件在 components/；将 WordPress 模板层级映射为 Blade 文件（如 page.blade.php）；用 get_field()、have_rows() 处理 ACF 基础字段、中继器与灵活内容；用 Bud 配置资源入口与 Tailwind；通过 npm run dev 开发、npm run build 生产构建。
必要用法：环境需 PHP 8.0+、Node.js 18+、Composer。创建主题：composer create-project roots/sage my-theme，然后 cd my-theme、npm install && composer install、npm run dev。生产构建用 npm run build，并确认 public/manifest.json 存在。
适用场景：新建 Sage 主题、搭建 Blade 布局与组件、配置 Bud/Vite 资源编译、ACF 字段展示、调试主题渲染与资源加载。
限制：Sage 10 需 PHP 8.0+，构建工具需 Node.js 18+，推荐 WordPress 6.0+，依赖 Composer；生产部署必须执行构建步骤，不能直接提供源文件；缺少 manifest.json 会导致资源加载失败；热重载在某些多站点配置下可能异常；通过 Composer 更新可能覆盖自定义，建议用子主题；大型中继器字段可能影响性能。安全上应转义输出、校验 ACF 输入、验证 nonce 并检查权限。