用途：为 Hugo CMS 主题开发提供中高级模式参考，按当前任务加载对应参考文件，而非一次性通读。
主要能力与对应参考文件：模板架构（v0.120+，base 模板与 block、模板查找顺序、partials、partial 装饰器 v0.154+、短代码基础）；资源管线（v0.161+，Tailwind CSS v4 的 css.TailwindCSS 或 v3 的 PostCSS、Hugo Pipes 打包 SCSS/JS、指纹与 SRI、srcset 响应式图片、页面/全局/远程资源处理）；短代码与渲染钩子（v0.112+，嵌套短代码、原始 HTML 短代码、短代码内 Markdown、链接/图片/标题/代码块自定义渲染钩子、Mermaid 等语言特定代码块）；内容组织与 i18n（v0.126+，leaf 与 branch bundle、headless bundle、封面图、自定义分类法、内容适配器、分节布局、archetypes、多语言）；封面图（v0.120+，页面 bundle 资源与 frontmatter 路径、响应式 srcset、无封面处理）；模块与性能（v0.109+，Hugo Modules 的 init/import/vendor/workspace、mount 配置、partialCached、缓存 TTL、配置驱动主题）；设计与无障碍（排版系统、可访问配色、设计令牌、语义化 HTML、ARIA、键盘导航、表单、响应式导航、阅读进度、暗色模式、Core Web Vitals、容器查询、:has()、axe-core/Lighthouse CI/视觉回归测试）；SEO、输出格式与 CI/CD（JSON-LD、Open Graph/Twitter Cards、自定义输出格式、sitemap、GitHub Actions 流水线）。
使用方式：先建主题目录，创建 baseof.html 定义 title、styles、header、main、footer、scripts 等 block，再建 partials，配置资源管线与 hugo.yaml，最后执行 hugo --gc 验证。项目级 layouts/ 会覆盖主题 layouts/，隔离测试时保持项目 layouts/ 为空。
限制与常见陷阱：SCSS 需 Hugo extended 版，可用 hugo version | grep extended 确认；Tailwind v4 用 css.TailwindCSS 而非 PostCSS，v3 仍需 PostCSS 管线；partialCached 传入非常量参数（如 .Section、page.RelPermalink）需保证唯一，否则结果陈旧；archetypes 需放在 archetypes/<section>/index.md 才生成 page bundle；resources.Get 查找 assets/ 而非 static/；内容适配器模板必须命名为 _content.gotmpl；渲染钩子放在 _markup/ 子目录；partials 中的 block 与页面模板的 define 共用命名空间，冲突会报 multiple definition，partials 应改用直接页面变量。具体版本要求与命令以资料为准，未提供的功能与收费信息暂未提供。