SuperAPI AI 工具集

ios-networking-advanced

通用与其它

查看项目

更新于 10-16 08:03

技能介绍

用途:这是一个面向生产级 iOS 网络编程的技能包,指导用 URLSession 配合 async/await 构建可复用的网络层。当任务需要可复用判断、领域约束或成熟工作流而非临时建议时使用;若任务与本技能无关,或只需简单答案且这些约束无实质帮助,则不应使用。

必要输入:收集相关项目上下文、约束与具体问题;按需加载参考文件;确认期望交付物(设计、代码、评审、迁移方案、审计或文档)。

工作流程:先读 SKILL.md,只加载任务所需的深层参考文件;按顺序应用清单与决策规则,而非挑拣片段;产出交付物时明确假设、风险与后续工作。

主要能力(快速参考索引):Section 1 类型化错误 + async/await 基础;Section 2 类型安全端点构建;Section 3 认证令牌刷新拦截器(401);Section 4 指数退避重试;Section 5 后台 URLSession(下载/上传);Section 6 证书固定;Section 7 multipart 表单上传;Section 8 网络可达性 + 离线队列(见 references);Section 9 请求去重;Section 10 Combine + URLSession(旧方案,见 references);Section 11 结构化并发(async-let、Task group);Section 12 生产反模式。

示例基础:定义了 NetworkError 枚举(含 invalidURL、noData、decodingFailed、httpError、unauthorized、forbidden、serverError、cancelled、noInternetConnection)与 actor NetworkClient,使用 JSONDecoder 配置 convertFromSnakeCase 与 iso8601,request 泛型方法按 200...299 解码、401/403/5xx 抛出对应错误。

质量与限制:输出应面向执行、简洁并符合仓库基线标准;保持与既有项目约定的兼容,除非技能要求更强标准;优先确定、可评审的步骤。反模式包括把示例当复制粘贴的真理而不检查适配与失败模式,以及默认加载全部参考文件而非渐进披露。证据产物示例为 API 契约测试输出与 TLS/证书固定配置说明;具体平台版本、价格或效果资料未提供。