SuperAPI AI 工具集

dx-delivery-sdk

编程与开发

查看项目

更新于 10-15 20:28

技能介绍

用途:当用户需要 Contentstack Delivery SDK 代码、查询示例、辅助函数、SDK 初始化、栈初始化、引用包含、过滤、排序、分页、类型化条目获取、资源获取、Live Preview 配置、Visual Builder 支持、SSR 预览处理或调试查询链时使用。目标是避免细微的 SDK 错误,默认输出生产级 TypeScript。

主要能力:使用当前 @contentstack/delivery-sdk 方法名与正确链式顺序;在行为不确定时对照 Delivery SDK Spec 校验 API 细节;生成 TypeScript 优先、基于环境变量安全存放凭据的示例;正确处理引用、过滤、排序、分页、字段选择、资源、语言区域与 Live Preview;标记或规避常见错误,如查询方法错误、缺少分页、SSR Live Preview 栈被复用。

使用方式:先确定目标对象(条目、资源、内容类型、分类法、引用、Live Preview 或辅助函数),仅询问缺失的 UID、语言区域、引用或返回结构。构建查询时,引用应在 .query() 之前应用,过滤使用 QueryOperation,排序使用 orderByAscending() / orderByDescending(),集合查询需加分页。SSR 或 Visual Builder 场景下,每个请求创建新栈,并在获取前应用 Live Preview 配置,不要跨请求复用 Live Preview 栈。示例使用 process.env 占位符,不硬编码凭据。

适用场景:编写博客文章查询并包含作者引用、Next.js SSR 中的 Live Preview 配置、修复返回结果不正确的查询链、按 URL 分页获取条目并类型化、获取资源并按内容类型过滤等。

限制:该技能不执行破坏性操作;若请求涉及删除、发布或修改生产内容,需明确确认并校验目标。所有凭据与令牌使用环境变量,不打印、推断或回显密钥。区域特定预览主机可使用 @timbenniks/contentstack-endpoints,并通过 getContentstackEndpoints(region, true) 使 SDK 主机值省略 https://。分页省略时需说明默认 100 条上限。技能自带 references/ 参考材料,按需读取,不凭摘要假设内容。