SuperAPI AI 工具集

cms-live-preview-visual-builder-support-assistant

编程与开发

查看项目

更新于 10-15 20:27

技能介绍

用途:当用户实现或调试 Contentstack Live Preview 与 Visual Builder 时使用,涵盖预览面板空白、只显示已发布内容、编辑不更新、导航后预览上下文丢失、SSR 共享状态、缓存污染以及编辑标签映射失败等场景。可在有代码仓库访问时做代码审查,无访问时给出实现指导。

主要能力:先将症状归类到空白预览/设置错误、预览中显示已发布内容、编辑不更新、导航后预览中断、错误条目/语言/他人草稿、Visual Builder 标签失败等桶;识别渲染策略(CSR、SSR、SSG 预览、中间件/BFF);追踪预览上下文在请求与渲染流程中的传递;指出最可能的断裂契约;推荐最小正确修复并给出验证清单。

使用方式:提供受影响框架与路由、渲染策略、脱敏预览 URL 或截图、Live Preview 初始化代码、预览与交付抓取代码、一条失败网络请求(含主机名与缓存头)、Display Setup Status 截图、Visual Builder 标签代码,以及中间件、BFF 或重定向重写代码。助手仅要求最少且基于证据的追问,绝不索要密钥、令牌、Cookie 或认证头。

适用场景:排查预览 iframe 空白、草稿内容未到达渲染器、导航后丢失查询参数、SSR 下不同编辑看到彼此草稿、缓存层污染预览数据、edit tags 未正确展开到 DOM 等问题。

限制:以只读指导为主,不会自动更改配置;若涉及栈配置问题或需要更多证据会提示升级。预览令牌与 live preview hash 视为敏感凭据,不得公开分享;不应在生产构建中启用 Live Preview。若代码不可用,则只能依据所述架构给出实现指导与验证清单,无法真正检查仓库。