用途:针对需要获取并缓存大量 API 请求的 React 应用,提供避免压垮后端的数据获取与缓存实现模式。覆盖推荐轮播、无限信息流、多并行请求页面、仪表盘等场景。
主要能力:共 48 条规则,分 8 类,按执行生命周期影响排序。关键类别包括请求编排(并行化独立请求、批量处理 N+1 扇出、去重进行中请求、提升到路由加载器、避免 effect 链、能服务端就服务端、优先批量端点);缓存策略(确定性键、实体归一化、设置 staleTime、stale-while-revalidate、订阅字段切片、共享键工厂、分层过期);后端保护(并发限制、合并相同请求、防抖用户请求、节流滚动触发、带抖动的重试退避、熔断、感知速率限制);预取与注水;失败恢复(卸载时中止、有界超时、分段错误边界、陈旧回退、变更不自动重试、优雅降级);信息流与轮播;变更与失效;组件模式。模板同时给出库方案(TanStack Query、SWR)与无库方案(纯 React + AbortController)。
使用方式:先看 references/_sections.md 了解分类与影响理由,再读各规则文件中的错误与正确代码示例;assets/templates/ 下有 6 个可改写模板,包括 use-resource-query、无依赖版 use-resource-query-no-deps、carousel-data-loader、infinite-feed、prefetch-link、request-collapser。若无法引入 TanStack Query/SWR/DataLoader,可从无依赖模板起步,约 250 行实现核心缓存、去重、重试与中止。
适用场景:编写或审查调用 fetch/useQuery/useSWR 的组件、设计逐项取数的列表或轮播、排查后端被打爆或页面加载慢、在客户端取数/路由加载器/服务端组件/SSR 间选型、实现预取重试乐观更新等。
限制:资料标注为实验性;具体版本、收费、价格、平台支持等信息暂未提供。规则与模板的具体效果需自行验证。