# @dnb/eufemia 中文文档

规范地址：https://npmcn.com/package/%40dnb/eufemia/

版本：11\.17\.1
npm 元数据更新时间：2026-11-10T20:36:52.837Z
中文译文更新时间：2026-11-12T13:22:48.352Z
软件包许可：SEE LICENSE IN LICENSE FILE

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

原始 npm 页面：https://www.npmjs.com/package/%40dnb/eufemia
原文对照：https://npmcn.com/package/%40dnb/eufemia/?lang=original
项目主页：https://eufemia.dnb.no/web/get-started/quick-start
源码仓库：https://github.com/dnbexperience/eufemia

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

- 包体积（解压后）：162 MB，29974 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：17 个
- peer 依赖：react ^19，purgecss ^8\.0\.0，react-dom ^19，stylelint ^16\.0\.0 \|\| ^17\.0\.0 \|\| ^18\.0\.0，@types/react ^19，@types/react-dom ^19，@tanstack/react-virtual ^3\.14\.10，@modelcontextprotocol/server ^2\.0\.0
- 首次发布：2021-03-02T05:48:43.716Z
- 最新版本发布：2026-11-10T20:36:52.467Z
- 近 30 天下载量：286607（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：333（近 12 个月 68 个）

## 中文简介

DNB Eufemia 设计系统 UI 库

## 安装

```sh
npm install @dnb/eufemia
```

也可以使用：`pnpm add @dnb/eufemia`、`yarn add @dnb/eufemia`、`bun add @dnb/eufemia`

## README

# DNB UI 图书馆

Eufemia是DNB的设计系统和UI库,为构建现代网络应用提供了一套连贯而可访问的组件. 它通过提供可重复使用的要素、设计准则和最佳做法来简化发展,确保国家银行数字产品具有统一的用户经验.

更多信息:欧菲米亚和 [DNB UI 图书馆](https://eufemia.dnb.no/web/get-started/quick-start)。 。 。 .

## 代理技能

包包括便携式 [代理技能](https://agentskills.io/) 该用途 Eufemia通过Eufemia MCP服务器的版本文档.

在已经依赖的项目中安装技能 `@dnb/eufemia`数字 :

```bash
yarn eufemia skills install
```

命令询问支持哪个代理地址来使用并预选已存在的 管理设施。 交互式用户应该使用此选择器 。 CI 和其他 非互动环境可以通过 `--target <directory>` 因为他们不能 回答终端提示 .

见 [代理技能和MCP文档](https://eufemia.dnb.no/web/ai-tools-and-resources/developer-tools/#agent-skills) 用于安装目标, npm 和 pnpm 命令, 更新安全性, 云剂 使用,和MCP配置.

```bash
yarn eufemia skills check
yarn eufemia skills list
yarn eufemia skills update
yarn eufemia skills uninstall
```

安装器轨道生成文件并拒绝替换本地更改 除非 `--force` 给出。 何时提交已安装的项目技能 可供云剂.

配置 [Eufemia MCP 服务器](https://eufemia.dnb.no/web/ai-tools-and-resources/developer-tools/#ai-assistance-and-mcp-server) 在使用技能之前。 技能文件包含工作流程,而组件 API、令牌、主题支持和其他版本敏感事实仍在 Eufemia的包装文件. 主机MCP为最新版本服务; 使用 当已安装的项目版本不同时, 包- 本地 MCP .

## 许可证

你在这里找到执照: [自由主义](https://github.com/dnbexperience/eufemia/blob/main/LICENSE)

## 常见问题

### @dnb/eufemia 是什么？

DNB Eufemia 设计系统 UI 库

### 如何安装 @dnb/eufemia？

在项目目录运行 npm install @dnb/eufemia，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19）、react-dom（^19）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 eufemia，可以用 npx eufemia 直接运行。

### @dnb/eufemia 支持 TypeScript 吗？

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

### @dnb/eufemia 支持 ESM 还是 CommonJS？

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

### @dnb/eufemia 可以商用吗？

@dnb/eufemia 使用 SEE LICENSE IN LICENSE FILE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @dnb/eufemia 的下载量有多少？

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

### @dnb/eufemia 还在维护吗？

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