# @datamodels/identity-profile-basic 中文文档

规范地址：https://npmcn.com/package/%40datamodels/identity-profile-basic/

版本：0\.2\.0
npm 元数据更新时间：2022-04-19T15:35:20.593Z
中文译文更新时间：2026-11-13T05:20:51.856Z
软件包许可：\(Apache-2\.0 OR MIT\)

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

原始 npm 页面：https://www.npmjs.com/package/%40datamodels/identity-profile-basic
原文对照：https://npmcn.com/package/%40datamodels/identity-profile-basic/?lang=original
项目主页：https://github.com/ceramicstudio/datamodels#readme
源码仓库：https://github.com/ceramicstudio/datamodels

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

- 包体积（解压后）：13.2 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=14\.14
- 运行依赖：1 个
- 首次发布：2021-08-19T12:50:10.999Z
- 最新版本发布：2022-04-19T15:35:20.511Z
- 近 30 天下载量：2206（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 0 个）

## 中文简介

数据模式 **基本概况** 说明的策略和定义 [CIP-19 (中文(简体) )](https://github.com/ceramicnetwork/CIP/blob/main/CIPs/CIP-19/CIP-19.md)。 。 。 .

## 安装

```sh
npm install @datamodels/identity-profile-basic
```

也可以使用：`pnpm add @datamodels/identity-profile-basic`、`yarn add @datamodels/identity-profile-basic`、`bun add @datamodels/identity-profile-basic`

## README

# 基本配置数据模型

数据模式 **基本概况** 说明的策略和定义 [CIP-19 (中文(简体) )](https://github.com/ceramicnetwork/CIP/blob/main/CIPs/CIP-19/CIP-19.md)。 。 。 .

## 安装

```sh
npm install -D @datamodels/identity-profile-basic
```

## 理由

这个 **基本概况** 包含一个 DID 的基本配置信息.

Basic Profile通过将DOS的配置信息标准化,简化了应用程序如何查看和显示其用户的配置.

**一个特征是身份最重要的方面之一**: 剖面图往往与身份关系最密切,而"基本剖面图"作为DAD的标准剖面图,可以在网络上任何地方使用.

**有不可知的支持:** 由于 Ceramic 文档可以由任何 DID 创建和控制,因此 Basic Profile 可以与任何 DID 方法结合使用.

## 示马斯

### [基本文件](https://npmcn.com/package/%40datamodels/identity-profile-basic/schemas/BasicProfile.json)

Basic Profile schema 定义了包含下列属性的文档格式. 方案未定义的属性 _无法_ 将纳入基本概况,但计划始终可以通过新的CIP加以更新.

| 财产 | 说明 | 数值 | 最大大小 | 需求 | 示例 |
| --- | --- | --- | --- | --- | --- |
| `name` | 名称 | 字符串 | 150圆 | 选项 | 玛丽·史密斯 |
| `image` | 一个图像 | 图像来源 |  | 选项 |  |
| `description` | 简短描述 | 字符串 | 420 圆 | 选项 | 这是我很酷的描述. |
| `emoji` | 爱莫吉 | 单码 | 2个字符 | 选项 | 🔢 |
| `background` | 背景图像( 3:1 比例) | 图像来源 |  | 选项 |  |
| `birthDate` | 出生日期 出生日期 | [ISO 8601 标准](https://en.wikipedia.org/wiki/ISO_8601) | 10块 | 选项 | 1990-04-24 (中文(简体) ) |
| `url` | a 无效 | 字符串 | 240 个字符 | 选项 | [http://ceramic.network (中文(简体) )](http://ceramic.network/) |
| `gender` | 性别 | 字符串 | 42块 | 选项 | 女性 |
| `homeLocation` | 居住地点 | 字符串 | 140圆 | 选项 | 柏林 |
| `residenceCountry` | 居住国 | [ISO 3166-1 α-2 标准](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) | 2个字符 | 选项 | D级 |
| `nationalities` | 国籍 | 数组 [ISO 3166-1 α-2 标准](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 数值 | 2个字符 | 选项 | 氯化萘 |
| `affiliations` | 隶属关系 | 字符串数组 | 240 个字符 | 选项 | 陶瓷生态系统联盟 |

## [讨论情况](https://github.com/ceramicstudio/datamodels/discussions/10)

## 许可证

麻省理工学院和Apache 2颁发双重许可证

## 常见问题

### @datamodels/identity-profile-basic 是什么？

数据模式 基本概况 说明的策略和定义 CIP-19 \(中文\(简体\) \)。 。 。 \.

### 如何安装 @datamodels/identity-profile-basic？

在项目目录运行 npm install @datamodels/identity-profile-basic，或使用 pnpm add / yarn add / bun add。

### @datamodels/identity-profile-basic 支持 TypeScript 吗？

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

### @datamodels/identity-profile-basic 支持 ESM 还是 CommonJS？

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

### @datamodels/identity-profile-basic 需要什么版本的 Node\.js？

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

### @datamodels/identity-profile-basic 可以商用吗？

@datamodels/identity-profile-basic 使用 \(Apache-2\.0 OR MIT\) 许可。可在 Apache-2\.0、MIT 中任选其一遵守。选择 Apache-2\.0 时，宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @datamodels/identity-profile-basic 的下载量有多少？

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

### @datamodels/identity-profile-basic 还在维护吗？

最新版本 0\.2\.0 发布于 2022/04/19（4 年前）；至今共发布 5 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/08/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。