用途:把 Visual Composer(经典 VCV/WPBakery 格式)页面迁移到 Gutenberg 区块编辑器。内容存于 post_meta 的 VCV JSON,目标为 post_content 中的区块注释标记。
主要能力:审计全部 VC 页面,统计元素类型、嵌套深度、第三方元素与 Design Options;生成迁移计划供确认;逐页转换并创建副本。映射包括 vc_row→Group、vc_column→Columns/Column、vc_column_text→Paragraph/Heading、vc_single_image→Image、vc_btn→Buttons、vc_video→Embed、vc_separator→Separator、vc_raw_html→Custom HTML、vc_empty_space→Spacer、vc_custom_heading→Heading、vc_row_inner/vc_column_inner→嵌套 Columns;vc_toggle、vc_tabs、vc_accordion 仅作基础回退并标记人工处理。转换写入会把颜色与排版注册为区块编辑器全局样式中的命名设计令牌,页面引用令牌而非内联值。
使用方式:需安装并连接 Respira for WordPress 插件、MCP 连接可用、源站启用 Visual Composer,并具备读取与写入权限。触发语如“migrate visual composer to gutenberg”。流程为审计、计划确认、逐页迁移(写入前用 respira_get_snapshot 快照,创建副本后写入标记)、验证、审阅与上线。审阅可用 respira_create_review_link 生成链接,评论用 respira_list_review_comments 读取,修改用 respira_find_element 与 respira_update_element,完成后 respira_resolve_review_comment 关闭;上线由站点所有者决定,之后调用 respira_purge_cache 全站清理缓存。
限制:不保证像素级一致;不自动迁移第三方 VC 附加元素;不转换 Design Options CSS;不处理新版 Visual Composer Website Builder(vcwb);不迁移模板库;视差与滚动效果需替代实现;仍需逐页人工 QA。核心元素约 70–85% 可映射。运行结束会向指定端点发送非阻塞遥测。