# @briebug/ngrx-auto-entity 中文文档 规范地址：https://npmcn.com/package/%40briebug/ngrx-auto-entity/ 版本：21\.1\.0 npm 元数据更新时间：2026-02-05T22:36:45.532Z 中文译文更新时间：2026-11-08T15:11:31.744Z 软件包许可：SEE LICENSE IN LICENSE\.md 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40briebug/ngrx-auto-entity 原文对照：https://npmcn.com/package/%40briebug/ngrx-auto-entity/?lang=original 项目主页：https://briebug.gitbook.io/ngrx-auto-entity/ 源码仓库：https://github.com/briebug/ngrx-auto-entity ## 关键信息（来自 npm 元数据） - 包体积（解压后）：910 kB，5 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：1 个 - peer 依赖：@angular/core ^21\.0\.0，@ngrx/effects ^21\.0\.0，@ngrx/store ^21\.0\.0，rxjs ^7\.0\.0 - 首次发布：2018-07-26T04:18:53.705Z - 最新版本发布：2026-02-05T22:36:45.377Z - 近 30 天下载量：27076（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：73（近 12 个月 4 个） ## 中文简介 NgRx 自动实体状态和 Facades。 简化反应状态 ! ## 安装 ```sh npm install @briebug/ngrx-auto-entity ``` 也可以使用：`pnpm add @briebug/ngrx-auto-entity`、`yarn add @briebug/ngrx-auto-entity`、`bun add @briebug/ngrx-auto-entity` ## README [![Issues](https://img.shields.io/github/issues/briebug/ngrx-auto-entity.svg)](https://github.com/briebug/ngrx-auto-entity/issues) ![Version](https://img.shields.io/npm/v/@briebug/ngrx-auto-entity.svg) ![Downloads](https://img.shields.io/npm/dm/@briebug/ngrx-auto-entity.svg) [![Downloads](https://img.shields.io/npm/dt/@briebug/ngrx-auto-entity.svg)](https://www.npmjs.com/package/@briebug/ngrx-auto-entity) # NgRX 自动实体 自动实体用于 [@ngrx (英语)](https://github.com/ngrx/platform)简化反应状态! ## 这是什么? NGRX 自动实体旨在提供一种无缝手段来处理标准实体行动和 效果,尽量减少重复代码要求,同时保持 NGRX本身。 此库不是NgRX的替换或替代. 它的工作内部 nGRX 设定的标准范式, 使用动作, 减少和效果 类似任意 其他 NGRX 应用程序. 自动实体所做的是提供一组现成的动作、选择器、效果和一个核心 为实体处理所有标准 CRUD 功能的元调制器, 因此您既不是 要自己写或者生成密码 自动实体支持执行应用程序 建议的最佳做法,包括良好的行动卫生。 自动实体也生成 **预制外观** 围绕NgRx和商店/状态,提供凝聚性、逻辑和 将 API 简化为您喜欢外观的人 。 自动实体具有灵活性 框架,您可以全部用于您所有实体的需要,或者零碎地用作 为了实现你们的具体目的,有必要这样做. 虽然不需要,但自动实体是一个完全独立的图书馆,完全依赖 在 Angular 和 NgRX 上, Auto- Entity 管理状态的方式与 @ ngrx/ entity 兼容 另外,如果您想使用 图书馆的一些公用设施 减量自定义. # 依赖关系 NgRx自动实体兼容以下版本. | NgRx 自动实体 | 角状核心 | NgRx 函数 | 缩写 | | --- | --- | --- | --- | | 21.x (中文(简体) ) | 21.x (中文(简体) ) | 21.x (中文(简体) ) | 7.x 电话 | | 20.x 电话 | 20.x 电话 | 20.x 电话 | 7.x 电话 | | 19.x (中文(简体) ) | 19.x (中文(简体) ) | 19.x (中文(简体) ) | 7.x 电话 | | 18.x 国家 | 18.x 国家 | 18.x 国家 | 7.x 电话 | | 17.x (中文(简体) ) | 17.x (中文(简体) ) | 17.x (中文(简体) ) | 7.x 电话 | | 13.x (中文(简体) ) | 13.x - 16.x (英语) | 13.x - 16.x (英语) | 7.x 电话 | | 12.x (中文(简体) ) | 12.x (中文(简体) ) | 12.x (中文(简体) ) | 6.x (单位:千美元) | [![Deps-AngularCore](https://img.shields.io/badge/@angular/core-%5E21.x-blue.svg)](https://github.com/angular/angular) [![Deps-AngularCommon](https://img.shields.io/badge/@angular/common-%5E21.x-blue.svg)](https://github.com/angular/angular) [![Deps-NgRxStore](https://img.shields.io/badge/@ngrx/store-%5E21.x-blue.svg)](https://github.com/ngrx/platform) [![Deps-RxJs](https://img.shields.io/badge/rxjs-%5E7.x-blue.svg)](https://github.com/reactivex/rxjs) # 安装 从 npm 安装 @ briebug/ngrx- 自动实体 : - `npm install @briebug/ngrx-auto-entity`, (中文(简体) ), - `yarn add @briebug/ngrx-auto-entity`,或 - `pnpm add @briebug/ngrx-auto-entity` 如果您尚未安装, 请同时安装所需的同伴依赖性 : - `npm install @ngrx/{effects,store,store-devtools}`, (中文(简体) ), - `yarn add @ngrx/{effects,store,store-devtools}`,或 - `pnpm add @ngrx/{effects,store,store-devtools}` ## 快速启动 如果你想越快越简单,你可以跳到 [快速启动引导](https://briebug.gitbook.io/ngrx-auto-entity/getting-started/quick-start)。 。 。 . (注:文件仍在编制中!) ## 完全使用文档 如果你想更多地了解自动实体是如何工作的,你可以跳到 [全部使用文档](https://briebug.gitbook.io/ngrx-auto-entity/advanced/usage)。 。 。 . (注:文件仍在编制中!) # 路线图 - [x] 自动行动的初步设计 - [x] 自动服务映射和查询 - [x] 自定义标准 - [x] 默认效果 - [x] 复合密钥 - [x] 获取实体关键支持到实体 - [x] 内置加载指标跟踪 - [x] 内建储蓄指标跟踪 - [x] 内建删除指标跟踪 - [x] 内建实体选择支持 - [x] 动态产生的实体行动 - [x] 动态生成的每个实体选择器 - [x] 预制外观生成 - [x] 生成的分柱还原器 - [x] 相关启动和结果行动的自动关联 - [x] 加强实体 与命名工具的接口 - [x] 过滤实体效果控件 - [x] 自定义到服务器的数据转换( 即ISO 日期到日期( Date( )) ) - [x] 可选数据加载尚未显示, 最大年龄 - [x] API 与 NgRx 8 功能/ 构件函数架构的规范化 - [ ] 动态生成- 仅在使用时进行设计 - [ ] 用于加载指示器显示,土司或小吃栏等的扩展效果. - [ ] 筛选实体元a 压缩手柄 - [ ] 预制、现成、可再利用的实体服务 # 贡献者 [![Follow-BB](https://img.shields.io/twitter/follow/briebugsoftware.svg?style=flat)](https://twitter.com/briebugsoftware) [![Follow-BB](https://img.shields.io/twitter/follow/jonristadev.svg?style=flat)](https://twitter.com/JonRistaDev) [![Follow-BB](https://img.shields.io/twitter/follow/kevinschuchard.svg?style=flat)](https://twitter.com/kevinschuchard) [![Follow-BB](https://img.shields.io/twitter/follow/anthonyjones519.svg?style=flat)](https://twitter.com/anthonyjones519) - [杰西・桑德斯](https://github.com/jessesanders):邪恶大师明德! - [乔恩·里斯塔](https://github.com/jrista): 设计、建筑和执行 - [凯文·舒查德](https://github.com/schuchard): 设计和实施 - [布莱恩·洛夫](https://github.com/blove): 设计和实施 - [杰西·威尔斯](https://github.com/Wells-Codes)执行 - [爱丽丝·帕克特](https://github.com/paquettealice)执行 - [帕特里斯·帕奎特](https://github.com/patpaquette)执行 - [安东尼·琼斯](https://github.com/anthonymjones)执行 ## 常见问题 ### @briebug/ngrx-auto-entity 是什么？ NgRx 自动实体状态和 Facades。 简化反应状态 \! ### 如何安装 @briebug/ngrx-auto-entity？ 在项目目录运行 npm install @briebug/ngrx-auto-entity，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@angular/core（^21\.0\.0）、@ngrx/effects（^21\.0\.0）、@ngrx/store（^21\.0\.0）、rxjs（^7\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @briebug/ngrx-auto-entity 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @briebug/ngrx-auto-entity 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @briebug/ngrx-auto-entity 可以商用吗？ @briebug/ngrx-auto-entity 使用 SEE LICENSE IN LICENSE\.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。 ### @briebug/ngrx-auto-entity 的下载量有多少？ 根据 npm 官方下载统计，@briebug/ngrx-auto-entity 在 2026/10/09 – 2026/11/07 这 30 天内被下载 27,076 次，日均约 903 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @briebug/ngrx-auto-entity 还在维护吗？ 最新版本 21\.1\.0 发布于 2026/02/06（9 个月前）；至今共发布 73 个版本，其中过去 12 个月发布了 4 个；首次发布于 2018/07/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。