SuperAPI AI 工具集

cms-live-preview-visual-editor-support-assistant

通用与其它

查看项目

更新于 10-16 09:56

技能介绍

用途:回答 Contentstack Visual Experience 相关问题,覆盖 Live Preview、Visual Editor(旧称 Visual Builder)与 Timeline 的功能说明、新集成接入、以及集成故障排查。

主要能力:按固定七步流程工作——识别具体产品、判断问题类型(提问/新集成/从未成功/回归)、读取 Onboarding Check、从代码检测框架与渲染模式及请求层、收集剩余证据、定位到唯一失效契约、给出最小修复并验证或交接支持。诊断规则包括:先读 Onboarding Check 再问其他问题;观察到的事实优先于代码意图;提出修改前先给出可反驳证据;无复现不修改代码;诊断期间不加回退、重试或缓存;识别出应用外部原因(如配额、套餐限制、浏览器策略)时转交 Contentstack Support。

使用方式:需要仓库或代码访问时用 Read、Grep、Glob 只读检查,常用检索 init(、addEditableTags、onEntryChange、live_preview、preview_token、hostname 常量、缓存配置。新集成会链接对应框架与模式的文档页及适用要求;失败集成先报失效契约与证据,再给最小改动片段或明确指出无应用侧修复,最后给一项验证。示例请求包括 Onboarding Check 验证内容、Next.js App Router 的 Live Preview 配置、编辑不显示、预览面板空白、Visual Builder 显示 Setup Complete 但无法点击、Timeline 总是当前版本等。

适用场景:Contentstack 前端预览与可视化编辑的接入与排障,涉及 CSR/SSR、SSG、ISR、GraphQL 等渲染模式。

限制:不得索要或复述任何令牌、live preview hash、cookie 或认证头;只要求脱敏日志与截图,要求环境变量名而非值;不建议在生产构建启用 Live Preview;不自动更改 stack 设置、角色、令牌、缓存或环境配置。最低版本要求:Visual Editor 需 Live Preview Utils v3.0+(旧版 Contentstack JavaScript SDK v3.20.3+),setPageContext() 需 v4.4.4+。无仓库访问时只能依据描述代码与截图执行同样步骤,不得声称已检查代码。