SuperAPI AI 工具集

native-data-fetching

编程与开发

查看项目

更新于 10-30 16:17

技能介绍

用途:该技能面向 Expo/React Native 应用中的网络层开发与排错,要求在任何涉及 API 请求、数据获取、缓存或网络调试的工作中使用。

主要能力:文档围绕七类主题展开:基础 fetch 用法(GET、带 body 的 POST)、React Query 的安装与配置(QueryClientProvider、useQuery、useMutation、invalidateQueries)、错误处理(自定义 ApiError、网络错误捕获、指数退避重试)、认证(用 expo-secure-store 存储令牌、封装带 Authorization 头的请求、令牌刷新去重)、离线支持(NetInfo 监听网络状态、onlineManager 同步 React Query)、环境变量(EXPO_PUBLIC_ 前缀、.env.development/.env.production、API 客户端封装与类型声明)、请求取消(AbortController 与 React Query 自动取消)。

使用方式:按决策树选择路径——路由级数据加载参考 references/expo-router-loaders.md(Web、SDK 55+);基础请求用 fetch 并检查 response.ok;需要缓存与状态管理时用 React Query,较简单场景用 SWR 或自定义 hooks;认证用 SecureStore 存令牌并实现刷新流程;离线用 NetInfo 检测状态;环境配置用 EXPO_PUBLIC_ 前缀变量。文档偏好避免 axios,优先使用 expo/fetch。

适用场景:Expo/React Native 应用的数据获取、缓存策略、网络故障排查、离线优先体验、令牌管理与 API 地址配置。

限制与注意:EXPO_PUBLIC_ 变量会在构建时内联并暴露给客户端,不得存放密钥;修改 .env 后需重启开发服务器;敏感数据应使用 SecureStore 而非 AsyncStorage。技能中的 agents/openai.yaml 属于 Codex CLI 扩展,不被其他 agent 识别,也不属于 Agent Skills 规范。价格、平台支持范围等未在资料中说明的细节暂未提供。