# @frigear-nu/account 中文文档

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

版本：0\.6\.0
npm 元数据更新时间：2026-11-12T17:11:59.199Z
中文译文更新时间：2026-11-15T14:20:12.699Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：104 kB，63 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：10 个
- peer 依赖：@nuxt/ui ^4\.12\.0，@nuxthub/core ^0\.10\.12，@frigear-nu/menu ^0\.4\.0，@frigear-nu/widget ^0\.4\.0，@frigear-nu/authorization ^0\.6\.0
- 首次发布：2026-10-09T14:47:54.708Z
- 最新版本发布：2026-11-12T17:11:58.634Z
- 近 30 天下载量：3389（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）

## 中文简介

主 friger app中用于管理账户区域(profile, mail, 密码, security)的模块.

## 安装

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

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

## README

# @frigear-nu/帐号

主 friger app中的账户区域( profile, security, 文档, API sorders pages)的一个模块. 从 [`nuxt-frigear-nu`](https://github.com/Frigear-nu/nuxt-frigear-nu)是因为 `app/pages/account/**`。 。 。 .

## 特征

-   QQ 更新您的配置细节( 名称, 化身) .
-   更改您的电子邮件地址 .
-   – 更改密码 .
-   管理密码(通过) `@frigear-nu/auth`是因为 `usePasskeys`,当WebAuthn被启用时.
-   \* \* \* 超重可堆肥(`useAccount`)和选入配置/安全网页(使用 [`@nuxt/ui`](https://ui.nuxt.com/)) (中文(简体) ).
-   🗂️ An `account` 布局:公共站点内部的设置页面(站点头和页脚保留),以中央 `max-w-5xl` 内容栏。 宽屏幕与签名用户一起获得一个左段列表,窄屏幕 a `PageSectionSwitcher`,两者都从 `account` 菜单 `@frigear-nu/menu` (安装时). 加一览 页面列出相同的条目,以及 `account.overview` 部件区域( 当 `@frigear-nu/widget` 已安装).

此模块是一个UI shell:它拥有没有表格和变异路线. 表格称为自助路线 `@frigear-nu/users` (单位:千美元)`/api/users/me/*`和标志性路线 `@frigear-nu/auth`。 。 。 .

## 快速设置

用一个命令将模块安装到您的 Nuxt 应用程序 :

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

此模块需要 [`@frigear-nu/users`](https://npmcn.com/package/%40frigear-nu/users) 将安装在主机应用程序中,因为其形式称为 自我服务路线在那里.

## 配置

通过 `account` 键入 `nuxt.config.ts`数字 :

```ts
export default defineNuxtConfig({
  modules: [
    '@nuxthub/core',
    '@frigear-nu/users',
    '@frigear-nu/menu', // optional - enables the account navigation and overview page
    '@frigear-nu/account',
  ],
  account: {
    settings: {
      pages: {
        profile: true, // or a custom path, e.g. '/me'
        security: true,
        // Only registered when `@frigear-nu/menu` is also installed.
        index: true,
      },
    },
  },
})
```

## API 路线

这些路线属于 `@frigear-nu/users`;账户页称:

-   `PATCH /api/users/me` - 最新情况 `name`编号 :`avatar`。 。 。 .
-   `PUT /api/users/me/email` - 最新情况 `email` (如果已被另一个用户取用,则拒绝).
-   `PUT /api/users/me/password` - 核实 `currentPassword` 更新到 `newPassword`。 。 。 .

这三个系统都需要经过认证的会话,并将更新的用户重新映入其中.

## 可编曲

```ts
const { updateProfileDetails, changeEmailAddress, changePassword, pending, error } = useAccount()

await updateProfileDetails({ name: 'Ada Lovelace' })
await changeEmailAddress({ email: 'ada@example.com' })
await changePassword({ currentPassword: 'old', newPassword: 'new-password', confirmNewPassword: 'new-password' })
```

## 翻译

字符串生活在 `account.*` 名称空间 `da`编号 :`en` 本地化文件并可在您的应用程序中被覆盖 `i18n/locales/<code>.json`见 [文档](https://docs.frigear.dev/modules/identity/account#translations)。 。 。 .

## 覆盖部分

任意 `Account*` 组件可以在您的应用程序中被同名组件所取代(模块的优先级较低). `AccountIdentity` 在概览摘要卡中显示在用户旁边(默认情况下是给任何人的角色徽章) 不是一个平地 `user`; 覆盖以显示其他细节, 如成员或身份证。 为了取代整个布局, 定义 `app/layouts/account.vue` 在您的应用程序中: 它胜过模块的, 并且账户页面仍在其中渲染 。 设定 `account.settings.layout: false` 完全去除布局,并在应用程序选择的布局中制作页面.

## 页标题

版式没有标题: 每页都是自己的, 作为根的第一个子 `<div class="flex flex-col gap-4">`。模块的页面使用 `AccountHeader`页:1 `PageHeading` 标题是页面 `title` mata, 否则标签为 `account` 菜单项目; 描述来自相同的 项目,以及 `#actions` 正在通过(API 令牌的一页将“创造 API 令牌”放在那里)。 添加其他模块 下级 `/account` 产生 `PageHeading` 以相同的 i18n 键作为其菜单项.

## 常见问题

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

主 friger app中用于管理账户区域\(profile, mail, 密码, security\)的模块\.

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

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

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

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

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

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

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

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

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

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

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

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