TanStack Query style caching, the Angular-native way

说明与用途

**项目简介（2‑3 句话）**
TanStack Query 风格的缓存库，专为 Angular 生态打造，提供类似 React‑Query 的声明式数据获取、缓存与自动失效机制。该库在 dev.to 开源专题中被提及，适合作为 Angular 项目中统一的后端数据层实现。

**价值**

• **统一的缓存策略**：借鉴 TanStack Query 的成熟模型，避免手写重复的 HttpClient、Subject、Cache 代码。
• **自动化**：支持请求去重、后台刷新、失效重抓等特性，显著提升前端性能与用户体验。
• **Angular 原生**：使用 Angular DI、RxJS 与 NgZone，天然兼容 Angular 生命周期和 Change Detection，开发者无需在框架之间做适配。

**典型接入方式**

1. **安装**：npm i @tanstack/angular-query（或项目实际包名）。
2. **在根模块提供**

   import { QueryClient, QueryClientProvider } from '@tanstack/angular-query';

   const queryClient = new QueryClient();

   @NgModule({
     imports: [QueryClientProvider.forRoot({ queryClient })],
   })
   export class AppModule {}

1. **在组件/服务中使用**

   import { useQuery } from '@tanstack/angular-query';

   const userQuery = useQuery(['user', id], () => this.http.get<User>(`/api/users/${id}`));

• 通过 userQuery.data$、userQuery.isLoading$ 等 RxJS 流在模板中直接绑定。

1. **可选配置**：在 QueryClient 中全局配置缓存时间、重试策略、错误处理等，亦可在单个 useQuery 调用时覆盖。

**生产可用性评估**

• **成熟度**：当前评分 45/100，质量信号（最近更新、话题数）有限，说明社区活跃度和文档深度尚未完全成熟。
• **适用场景**：适合内部工具、原型或对缓存需求明确且团队对 Angular‑RxJS 有经验的项目。
• **风险**：
• 维护频率不高，需自行审查许可证、issue 处理速度以及发布节奏。
• 集成信号稀少，建议在正式上线前进行代码审计、单元/集成测试以及性能基准。
• **推荐做法**：在生产环境使用前，锁定具体版本（如 ^x.y.z），并配合内部监控（如缓存命中率、错误重试次数）进行持续评估。若项目对缓存需求极为关键，考虑同时保留后备的手写 HttpClient 实现，以防库停止维护时快速回退。

实际用途

TanStack Query style caching, the Angular-native way may be useful when its README and activity match a concrete workflow.

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.