用途:canai-blocks 是 canai-mcp 的可选配套技能。附加此技能表示用户希望页面以原生 WordPress 区块部署、可在 Gutenberg 中编辑,而不是 Twig。未附加时页面为 Twig,canai-mcp 不会自行转向区块。同一服务器、同一 API 密钥、同一传输方式({site}/wp-json/mcp/wpcanai),仅在其上增加区块页面工具和页面格式概念。
安装前提:需先安装并配置 canai-mcp,它涵盖 MCP 客户端设置、API 密钥、仅用 MCP 的传输规则,以及模板、Twig 页面与布局、wpcanai-write-post 博客文章、设置、媒体 sideload、i18n、Tailwind 构建等全部其他工具。博客文章本质是区块内容,不属本技能。
页面格式:页面以 Twig(默认,属 canai-mcp)或区块(本技能)两种格式之一创作。格式是仅由 MCP 设置的标记 _canai_format。Twig 正文存于 _canai_html/_canai_css/_canai_js,用 wpcanai-write-meta 写入;区块正文存于 post_content,用 wpcanai-write-page 写入。区块页面的 CSS 用 write-page 的 css 以纯 CSS 写入,不经 Twig 渲染。
主要能力:wpcanai-create-page 支持 format: "blocks" 与 blocks 参数;wpcanai-write-page 接受 blocks、css、convert 等参数。区块类型包括 paragraph、heading、list、quote、image、code、separator、embed、table、group、columns、buttons、cover、media_text、spacer、html。除 embed 和 html 外均接受 className(Tailwind);嵌套上限 4 层。图片需先 sideload 再传 attachment id。
转换:支持 Convert post id 123 to blocks. 与 Convert post id 123 to twig. 双向转换。转换为区块时需重写或丢弃旧 _canai_css;转换为 Twig 时须处理 CSS 槽,避免 Twig 解析 {# 导致样式静默丢失。
适用场景:当站主要自行在 Gutenberg 中编辑文案与布局时选择区块(营销页、落地页、关于/联系页);含逻辑、对 Woo/分类/菜单数据循环或 Alpine 的页面保留 Twig。布局、页眉页脚、商店、产品、购物车、结账与归档模板始终为 Twig。
限制:区块页面无 snapshots、replace-in-meta、grep-content、scan,也无导出/导入;修订是区块内容的唯一历史。原生翻译用内容覆盖而非 t() 字符串表。html 区块需 unfiltered_html 权限。读取 Twig 页面的区块或区块页面的 html/js 会以 format_mismatch 失败且不改变任何内容。缺失信息:未提供具体收费、价格或平台信息。