用途:本技能面向 Contentstack Dart SDK 的运行时与 HTTP 层,适用于需要改变请求构建或执行方式、处理 http、请求头、主机/区域、响应错误映射,以及调整运行时依赖(pubspec.yaml)或环境加载(dotenv)的场景。
主要能力与约定:HTTP 调用使用 http 包,需与 lib/src/ 中其他 Dart async/await 模式保持一致;未经团队同意,不要为同一代码路径引入替代 HTTP 客户端。配置方面,dotenv 用于测试,也可用于本地/开发配置,但绝不能提交真实凭据;path 和 file 用于必要的路径处理,保持导入最小化。日志使用 logger 依赖,避免记录敏感令牌或完整认证头。打包需保持 pubspec.yaml 约束与 Dart SDK 边界(>=2.12.0 <4.0.0)一致,发布流程见 .github/workflows/publish.yml。
重试与韧性:若添加重试、退避或超时,需在公共 API 或内部模块中记录行为,并在可行时补充测试。
限制:资料未提供具体重试参数、超时默认值、区域列表或错误码映射细节,这些需参考相关 SKILL.md 与 http 包文档。