# @frigear-nu/users 中文文档

规范地址：https://npmcn.com/package/%40frigear-nu/users/

版本：3\.1\.0
npm 元数据更新时间：2026-11-12T17:12:17.870Z
中文译文更新时间：2026-11-15T14:18:46.944Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40frigear-nu/users
原文对照：https://npmcn.com/package/%40frigear-nu/users/?lang=original
项目主页：https://docs.frigear.dev/modules/identity/users
源码仓库：https://github.com/Frigear-nu/frigear-nu

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：150 kB，111 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：11 个
- peer 依赖：@nuxt/ui ^4\.12\.0，@nuxthub/core ^0\.10\.12，@frigear-nu/menu ^0\.4\.0，@frigear-nu/admin \>=0\.0\.0，@frigear-nu/widget ^0\.4\.0，@frigear-nu/email-templates ^0\.1\.1
- 首次发布：2026-10-09T14:36:22.808Z
- 最新版本发布：2026-11-12T17:12:17.214Z
- 近 30 天下载量：4456（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

主frigerapp的用户实体:用户表,管理员用户管理和自助配置,电子邮件和密码更改. 签到者住在@frigear-nu/auth.

## 安装

```sh
npm install @frigear-nu/users
```

也可以使用：`pnpm add @frigear-nu/users`、`yarn add @frigear-nu/users`、`bun add @frigear-nu/users`

## README

# @frigear-nu/ 用户

[![npm version](https://img.shields.io/npm/v/@frigear-nu/users/latest.svg?style=flat&colorA=020420&colorB=00DC82)](https://npmjs.com/package/@frigear-nu/users) [![npm downloads](https://img.shields.io/npm/dm/@frigear-nu/users.svg?style=flat&colorA=020420&colorB=00DC82)](https://npm.chart.dev/@frigear-nu/users) [![License](https://img.shields.io/npm/l/@frigear-nu/users.svg?style=flat&colorA=020420&colorB=00DC82)](https://npmjs.com/package/@frigear-nu/users) [![Nuxt](https://img.shields.io/badge/Nuxt-020420?logo=nuxt)](https://nuxt.com/)

主 friger 应用的用户实体: `users` 表格,用户的人事管理,以及登录用户可提供哪些服务 改变自己。 人们如何在生活中签字 [`@frigear-nu/auth`](https://npmcn.com/package/%40frigear-nu/auth),该模块安装.

## 特征

-   {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `users` 表格及其计划,由其他模块扩展(证书由 `auth`(中文(简体) ).
-   工作人员行政管理`settings.admin`: 列表、创建、编辑、删除和重新邀请用户,即“新用户”部件和 管理页面(与 `@frigear-nu/admin`) (中文(简体) ). 准许进入(`users:read`, (中文(简体) ), `users:list`, (中文(简体) ), `users:create`, (中文(简体) ), `users:update`, (中文(简体) ), `users:delete`, (中文(简体) ), `users:manage`(b) 工作人员永远不能改变拥有下列功能的用户: 允许他们缺乏。 角色本身通过 `@frigear-nu/authorization`。 。 。 .
-   QQ自動:更改配置,电子邮件(可选择从收件箱中确认)和密码.
-   🧩 `requireUser` 编号 : `getUser` (仅认证)服务器路线,以及 `extendUsersAdmin` 加号 `loadUsersAdminTarget` 对于添加到管理员用户页面的模块.
-   QQ 注册用户存储 `@frigear-nu/auth` 读写用户通过.

## 快速设置

```bash
npx nuxt module add @frigear-nu/users
```

此模块需要 [`@nuxthub/core`](https://hub.nuxt.com/) 在主机应用程序。 创造并完成迁移 它提供的表格(见模块- kit 迁移指南).

```ts
export default defineNuxtConfig({
  modules: ['@nuxthub/core', '@frigear-nu/users'],
  users: {
    settings: {
      admin: true, // staff administration; `{ page: false }` = API only
      verifyEmailChange: true, // a new address must be confirmed from its inbox
      profilePath: '/account/profile', // where that confirmation lands
      mcp: false, // the `get-my-profile` MCP tool
    },
  },
})
```

见 [文档](https://npmcn.com/package/apps/docs/content/3.modules/1.identity/2.users.md) 路径、钩子和用户页面扩展名 点,和 [`@frigear-nu/auth`](https://npmcn.com/package/%40frigear-nu/auth/README.md) 用于登录(`authentication.settings`) (中文(简体) ).

## 发展

```bash
pnpm --filter '@frigear-nu/users' test
```

## 常见问题

### @frigear-nu/users 是什么？

主frigerapp的用户实体:用户表,管理员用户管理和自助配置,电子邮件和密码更改\. 签到者住在@frigear-nu/auth\.

### 如何安装 @frigear-nu/users？

在项目目录运行 npm install @frigear-nu/users，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@nuxthub/core（^0\.10\.12）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @frigear-nu/users 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @frigear-nu/users 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @frigear-nu/users 可以商用吗？

@frigear-nu/users 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @frigear-nu/users 的下载量有多少？

根据 npm 官方下载统计，@frigear-nu/users 在 2026/10/16 – 2026/11/14 这 30 天内被下载 4,456 次，日均约 149 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @frigear-nu/users 还在维护吗？

最新版本 3\.1\.0 发布于 2026/11/13（3 天前）；至今共发布 27 个版本，其中过去 12 个月发布了 27 个；首次发布于 2026/10/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。