SuperAPI AI 工具集

cms-environments-publishing

编程与开发

查看项目

更新于 10-15 20:27

技能介绍

用途:面向在 Contentstack 无头 CMS 上开发的工程师,解答环境搭建、内容发布行为、交付/预览令牌、Sync API、定时发布以及 CDN 与缓存配置等问题。适用场景包括询问应设置多少环境、交付令牌与预览令牌的区别、发布后内容未上线、Sync API 如何工作、能否定时发布等。

主要能力:解释发布流水线;识别场景所需的正确令牌类型;在合适时推荐 Sync API;避免建议任何不安全的客户端密钥处理方式。预期输入为部署流水线或环境需求、前端框架或静态站点生成器、令牌或认证问题、定时或发布队列相关顾虑;输出环境配置建议、令牌使用建议、发布工作流说明、Sync API 配置指引、CDN 与缓存说明。

使用要点:环境应视为部署目标(开发、预发、生产),并与真实部署流水线保持一致;每个 stack 默认最多 5 个环境,环境为全局模块,跨分支共享。内容在显式发布到环境之前均为草稿,发布可针对一个或多个环境与语言;嵌套引用发布需使用 api_version: 3.2,以便完整引用树被解析并自动发布,发布条目时应连同引用一起发布。令牌类型:交付令牌用于经 CDA 访问已发布内容,按环境限定,可安全用于客户端;预览令牌用于实时预览中未发布的草稿内容;管理令牌用于 stack 级读写,仅限服务端,绝不可暴露给客户端。SDK 初始化需 Stack API key、交付令牌、环境名称,可选分支或别名 ID;CDA 基础 URL 因区域而异,如 AWS NA 为 cdn.contentstack.io,AWS EU 为 eu-cdn.contentstack.com,AWS AU 为 au-cdn.contentstack.com。Sync API 适用于静态站点、离线应用或本地内容缓存:首次请求返回全部已发布内容及 sync_token,后续请求只返回变更(created、updated、deleted、published、unpublished);需要近实时更新且不想过度调用 API 时,优于轮询。发布队列跟踪发布与取消发布操作及状态,每个分支各有自己的队列,定时发布可在执行前取消。速率限制:单个请求每秒 10 次,组织批量请求每秒 1 次;脚本建议使用带抖动的指数退避,CLI 批量发布插件会自动处理限流。

限制:这是只读咨询技能,不执行发布、取消发布或修改环境,仅提供指导;如应用了 Claude 工具限制,仅使用 Read、Grep、Glob。所有示例使用环境变量,绝不在前端代码中硬编码令牌;管理令牌、API key 等密钥绝不暴露,浏览器应用的所有 CMA 调用须经服务端代理;绝不建议在客户端使用管理令牌。缺少发布后内容缺失排查的完整步骤细节,暂未提供。