# @haneinfo/identity-core 中文文档

规范地址：https://npmcn.com/package/%40haneinfo/identity-core/

版本：4\.7\.1
npm 元数据更新时间：2026-11-17T01:10:43.035Z
中文译文更新时间：2026-11-17T07:47:09.078Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40haneinfo/identity-core
原文对照：https://npmcn.com/package/%40haneinfo/identity-core/?lang=original

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

- 包体积（解压后）：243 kB，101 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：2 个
- peer 依赖：zod ^4\.4\.0，react ^19\.0\.0，react-dom ^19\.0\.0，@nestjs/core ^11\.0\.0 \|\| ^12\.0\.0，lucide-react ^1\.22\.0，@nestjs/common ^11\.0\.0 \|\| ^12\.0\.0，@prisma/client ^6\.19\.0 \|\| ^7\.10\.1，@haneinfo/common ^0\.6\.1 \|\| ^0\.7\.0，@haneinfo/frontend-shell ^1\.1\.0，@haneinfo/plugin-host-nest ^2\.0\.0
- 首次发布：2026-10-02T05:26:01.642Z
- 最新版本发布：2026-11-17T01:10:42.845Z
- 近 30 天下载量：5309（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：38（近 12 个月 38 个）

## 中文简介

Haneinfo应用软件的提供者中立用户和服务账户身份:用户模式,用户CRUD和haneinfo.identity-store能力.

## 安装

```sh
npm install @haneinfo/identity-core
```

也可以使用：`pnpm add @haneinfo/identity-core`、`yarn add @haneinfo/identity-core`、`bun add @haneinfo/identity-core`

## README

# 身份核心

Haneinfo插件的提供者中立身份存储和用户管理.

## 读者拾取器身份搜索

身份StoreService执行可选身份StorePort.searchA活性ByName. 在 PostgreSQL 中活动/名称/被排除在外的用户/密钥集上游并运行了 20-row 封顶;只选择了 id 和 无效名称. 可以提供电话交易。 该方法不提供实例访问,也不披露新的公共用户搜索端点:协作执行授权. 更新身份核心,并开展合作,以便提及发现.

## 挂起活动显示名称

身份存储可选执行 `findActiveNamesByIds(ids, transaction?)`,仅返回 `{ id, name }` 用于在一个预测查询中积极匹配用户,去除ID并跳过空输入。 未知、已删除和不活跃的用户被省略。 消费者对省略的名字和年长的提供者使用无效,没有这种可选的方法;他们必须在查取前授权他们的对象,不得倒回到每行找到ById的电话. 这没有添加普通用户 HTTP 端点或 schema 字段.

## 认证名称查询

得到/身份/用户/查看?q=使用互动AuthGuard而不使用AdminGuard. 它修剪 q 并需要 2–200个字符,否则为INVALID INPUT/400. 它返回最多20个活动用户的数组, 每一个准确的 { id, name }, 带有无效名称, 由名称命令然后 ID 。 百分比、下划线和 反斜线是字面搜索字符。 没有电子邮件/作用披露、光标或批量导出, 没有新的 MCP 工具。 现有的身份存储密钥集搜索保持其 id 命令; 只有此 控制器请求具体执行的可选名称排序 .

## 与飞行前匹配的电子邮件

在此版本启用前, 运行 `psql -X -v ON_ERROR_STOP=1 -f node_modules/@haneinfo/identity-core/scripts/check-email-duplicates.sql` 以目标数据库为对象,只读账户。 配置标准 PostgreSQL 客户端设置的连接 。 SELECT将现有的不敏感大小写复制到标准输出;它不写入文件,合并账户,或修改数据. 在启用认证前手动解析复制 。 将输出保护为个人数据, 不将其重定向为日志或文件 .

新用户使用小写邮件存储 。 查找忽略了大小写,拒绝模棱两可的匹配,包括在导入时. 现存行不重写. 现有的对案件有敏感认识的独特制约不能阻止外部写作员同时插入混合写作重复;所有写作员都必须遵循这一政策,操作员应当根据需要重复飞行前的操作.

## 默认角色和 CSV `roles` 栏

**行为改变 :** 创建不明确的用户 `roleIds` (手语: `UsersService.create`,OIDC JIT通过 `IdentityStoreService.create`,然后将 CSV 导入为空 `roles` 单元格)不再指定 `USER` (单位:千美元)`SYSTEM_USER_ROLE`默认情况下。 想要默认角色的应用程序必须声明 `defaultRoleNames` 内 `@haneinfo/rbac` (单位:千美元)`configRef: "rbac"`); 保留先前的行为,设置 `defaultRoleNames: ["USER"]`。 。 。 .

CSV 导入`UsersImportService`)支持可选 `roles` 列(别名: `role`, (中文(简体) ), `roles`, (中文(简体) ), `角色`),其中多个角色机器名称由 `;`。当创建新用户时:

-   非空值通过 `RbacPolicyPort.resolveImportRoleIds` (关闭与 `ROLES_UNSUPPORTED` 如果缺失,或 `ROLE_NOT_ASSIGNABLE` 如果任何角色是 `ADMIN` 或不详).
-   空单元格返回 App 已宣布 `defaultRoleIds()`。 。 。 .
-   现有用户`bind` 或者说 `skip`),角色从未被修改,非空单元格被标记为 `ROLES_IGNORED_FOR_EXISTING_USER`。 。 。 .

## 常见问题

### @haneinfo/identity-core 是什么？

Haneinfo应用软件的提供者中立用户和服务账户身份:用户模式,用户CRUD和haneinfo\.identity-store能力\.

### 如何安装 @haneinfo/identity-core？

在项目目录运行 npm install @haneinfo/identity-core，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^4\.4\.0）、@nestjs/core（^11\.0\.0 \|\| ^12\.0\.0）、@nestjs/common（^11\.0\.0 \|\| ^12\.0\.0）、@prisma/client（^6\.19\.0 \|\| ^7\.10\.1）、@haneinfo/common（^0\.6\.1 \|\| ^0\.7\.0）、@haneinfo/plugin-host-nest（^2\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @haneinfo/identity-core 支持 TypeScript 吗？

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

### @haneinfo/identity-core 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @haneinfo/identity-core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @haneinfo/identity-core 可以商用吗？

@haneinfo/identity-core 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @haneinfo/identity-core 的下载量有多少？

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

### @haneinfo/identity-core 还在维护吗？

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

