@frigear-nu/account

中文文档
0.6.0发布于 2026/11/13MITTypeScriptES Module构建来源已验证近 30 天下载 3389

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

中文使用文档
文档目录8 节
  1. 特征
  2. 快速设置
  3. 配置
  4. API 路线
  5. 可编曲
  6. 翻译
  7. 覆盖部分
  8. 页标题

@frigear-nu/帐号

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

特征

  • QQ 更新您的配置细节( 名称, 化身) .
  • 更改您的电子邮件地址 .
  • – 更改密码 .
  • 管理密码(通过) @frigear-nu/auth是因为 usePasskeys,当WebAuthn被启用时.
  • * * * 超重可堆肥(useAccount)和选入配置/安全网页(使用 @nuxt/ui) (中文(简体) ).
  • 🗂️ 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 应用程序 :

npx nuxt module add @frigear-nu/account

此模块需要 @frigear-nu/users 将安装在主机应用程序中,因为其形式称为 自我服务路线在那里.

配置

通过 account 键入 nuxt.config.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。 。 。 .

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

可编曲

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

await updateProfileDetails({ name: 'Ada Lovelace' })
await changeEmailAddress({ email: '[email protected]' })
await changePassword({ currentPassword: 'old', newPassword: 'new-password', confirmNewPassword: 'new-password' })

翻译

字符串生活在 account.* 名称空间 da编号 :en 本地化文件并可在您的应用程序中被覆盖 i18n/locales/<code>.json见 文档。 。 。 .

覆盖部分

任意 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 共发布 26 个版本,首次发布于 2026/10/09;过去 12 个月发布了 26 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.6.0latest2026/11/133 天前
0.5.02026/11/123 天前
0.4.02026/11/123 天前
0.3.02026/11/0510 天前
0.2.62026/11/0411 天前
0.2.52026/11/0411 天前

关于 @frigear-nu/account 的常见问题

@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 和提交记录判断。