# @equinor/amplify-component-lib 中文文档

规范地址：https://npmcn.com/package/%40equinor/amplify-component-lib/

版本：16\.0\.3
npm 元数据更新时间：2026-11-06T12:24:09.937Z
中文译文更新时间：2026-11-13T20:05:29.867Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40equinor/amplify-component-lib
原文对照：https://npmcn.com/package/%40equinor/amplify-component-lib/?lang=original
项目主页：https://github.com/equinor/amplify-component-lib#readme
源码仓库：https://github.com/equinor/amplify-component-lib

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

- 包体积（解压后）：865 kB，652 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：proj4 ^2\.15\.0，react ^19\.2\.8，lodash ^4\.17\.21，motion ^12\.38\.0，lowlight ^3\.3\.0，react-dom ^19\.2\.8，@tiptap/pm ^3\.1\.0，jwt-decode ^4\.0\.0，rehype-raw ^7\.0\.0，html2canvas ^1\.4\.1，@tiptap/core ^3\.1\.0，@tiptap/react ^3\.1\.0，react-dropzone ^14\.3\.8，react-markdown ^10\.1\.0，styled-components ^6\.1\.15，@equinor/eds-icons \*，@tiptap/extensions ^3\.1\.0，@tiptap/suggestion ^3\.1\.0，@tanstack/react-query \*，@tanstack/react-router \*，@tiptap/extension-bold ^3\.1\.0，@tiptap/extension-link ^3\.1\.0，@tiptap/extension-list ^3\.1\.0，@tiptap/extension-text ^3\.1\.0，@equinor/eds-core-react 0\.44\.0，@tiptap/extension-color ^3\.1\.0，@tiptap/extension-image ^3\.1\.0，@tiptap/extension-table ^3\.1\.0，@tiptap/extension-italic ^3\.1\.0，@tiptap/extension-heading ^3\.1\.0，@tiptap/extension-mention ^3\.1\.0，@tiptap/extension-document ^3\.1\.0，@tiptap/extension-gapcursor ^3\.1\.0，@tiptap/extension-highlight ^3\.1\.0，@tiptap/extension-paragraph ^3\.1\.0，@equinor/eds-data-grid-react ^0\.7\.5，@tiptap/extension-code-block ^3\.1\.0，@tiptap/extension-hard-break ^3\.1\.0，@tiptap/extension-text-align ^3\.1\.0，@tiptap/extension-text-style ^3\.1\.0，@tiptap/extension-typography ^3\.1\.0，@equinor/subsurface-app-management ^5\.6\.1，@tiptap/extension-code-block-lowlight ^3\.1\.0
- 首次发布：2024-07-12T08:18:00.143Z
- 最新版本发布：2026-11-06T12:24:09.630Z
- 近 30 天下载量：20004（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：187（近 12 个月 52 个）

## 中文简介

前端 Typescription 组件用于扩展团队

## 安装

```sh
npm install @equinor/amplify-component-lib
```

也可以使用：`pnpm add @equinor/amplify-component-lib`、`yarn add @equinor/amplify-component-lib`、`bun add @equinor/amplify-component-lib`

## README

![intro-logo](https://raw.githubusercontent.com/equinor/amplify-component-lib/main/static/amplify.png)

[![SCM Compliance](https://scm-compliance-api.radix.equinor.com/repos/equinor/amplify-component-lib/badge)](https://scm-compliance-api.radix.equinor.com/repos/equinor/amplify-component-lib/badge)

放大组件库(ACL)包含组件,utils,提供者和被放大团队开发和使用的钩.

这个软件包首先用于我们自己的扩展应用程序。 如果你想的话,你可以在安普利兹之外使用它们, 但我们不会支持任何与我们自己的安普利兹应用程序不一致的需求。 如果你有问题或者找到任何错误, 在吉休布创建一个问题,因为我们不接受来自Amplify团队以外的贡献者的公关.

# 快速链接

-   [故事书](https://storybook-amplify-components.app.radix.equinor.com/)
-   [捐款](https://github.com/equinor/amplify-component-lib/blob/main/CONTRIBUTING.md)

# 大楼扩建部分-图书馆

合并代码后自动构建和发布 `main` 分支,如果包.json版本号更高.

# 使用来自扩展组件- lib 的配置文件

1.  导航到您的工程根文件夹, `~/Projects/recap` 举例来说
    
2.  复制并运行以下命令
    

```bash
wget -q -O - https://raw.githubusercontent.com/equinor/amplify-component-lib/main/config/install.sh | bash
```

这本应该下载到您的工程根文件夹中的不同配置文件 .

如果您想要忽略某些配置文件, 您可以创建 `.acl-ignore` 文档中 `client` 文件夹.

例如: `acquire/client/.acl-ignore`

```text
eslint.config.mjs
CODEOWNERS
pull_request.yaml
```

# 使用 github 动作工作流程从 github 从扩展组件- lib 部署

1.  导航到您的工程根文件夹, `~/Projects/recap` 举例来说
    
2.  复制并运行以下命令
    

```bash
wget -q -O - https://raw.githubusercontent.com/equinor/amplify-component-lib/main/config/install-deployment-files.sh | bash
```

这本该下载的 `build_deploy_radix.yaml`, (中文(简体) ), `promote.yaml`, (中文(简体) ), `notify.yaml`, (中文(简体) ), `push.yaml`

注:这些文件最终应从我们用来获取其他配置文件的同样安装脚本中获取. 我们用不同的脚本来服务它,这样那些还没有准备好改变部署过程的应用程序就不用匆忙了.

## 页:1

此脚本在工程中假定以下结构

```text
project
│   README.md
│
└───client
│   |   ...
│
└───server
    │   ...
```

# 使用 [承诺前](https://pre-commit.com/)

## 下载并安装预承诺

使用 python 的 pip 下载预承诺

```bash
pip install pre-commit
```

使用酿酒下载预承诺

```bash
brew install pre-commit
```

最后安装预承诺

```bash
pre-commit
```

## 添加配置文件, . pre- confimit- config. yaml

 `.pre-commit-config.yaml` 文件应该看起来像下面的东西

```yaml
repos:
  - repo: local
    hooks:
      - id: hadolint
        name: Lint Dockerfiles
        description: Runs hadolint to lint Dockerfiles
        language: system
        types: ['dockerfile']
        entry: hadolint
      - id: trufflehog
        name: TruffleHog
        description: Detect secrets in your data with TruffleHog.
        entry: trufflehog git file://. --since-commit HEAD --only-verified --fail
        language: golang
        pass_filenames: false
      - id: prettier
        name: Prettier
        description: Runs prettier on supported files
        language: system
        entry: 'npx prettier --check'
        files: .*\.jsx?$|.*\.tsx?$|.*\.ts?$
  - repo: https://github.com/pre-commit/mirrors-eslint
    rev: v9.9.0
    hooks:
      - id: eslint
        files: \.[jt]sx?$ # *.js, *.jsx, *.ts and *.tsx
        types: [file]
        additional_dependencies:
          - eslint@8.57.0
          - eslint-config-prettier@9.1.0
          - eslint-plugin-prettier@5.1.3
          - eslint-plugin-react@7.34.0
          - eslint-plugin-react-hooks@4.6.0
          - eslint-plugin-simple-import-sort@12.0.0

```

## 安装钩子

配置文件到位后需要安装钩子

```bash
pre-commit install
```

## 嵌入式文件

我们用 [白兰地](https://github.com/hadolint/hadolint) 来检查我们的文件是否采用了最佳做法.

### 安装

要执行与嵌入文件相关的更改, 您需要安装 hatolin

#### 国 际

您可以在 OSX 上使用 [酿酒](https://brew.sh/) 要安装 :

```bash
brew install hadolint
```

您可以在窗口上使用 [专辑](https://github.com/lukesampson/scoop) 要安装 :

```bash
scoop install hadolint
```

在其中任何一种情况下都行不通,那么您可以参考 [安装部分](https://github.com/hadolint/hadolint?tab=readme-ov-file#install) 在 hadolint 仓库中

#### VS 代码

如果您想要在修改您的嵌入文件时缩短反馈循环, 您可以选择添加 [haolint 扩展名](https://github.com/michaellzc/vscode-hadolint) (延长编号: `exiasr.hadolint`(中文(简体) )

#### 网络结构

看来是 [不详](https://youtrack.jetbrains.com/issue/IJPL-69780/Bundle-hadolint-a-Docker-linting-tool) 用于当前 WebStorm 的

# 最新版本

[![main](https://img.shields.io/npm/v/@equinor/amplify-component-lib?color=%23c3f3d2&label=%40equinor%2Famplify-component-lib&logo=npm&)](https://www.npmjs.com/package/@equinor/amplify-component-lib)

## 常见问题

### @equinor/amplify-component-lib 是什么？

前端 Typescription 组件用于扩展团队

### 如何安装 @equinor/amplify-component-lib？

在项目目录运行 npm install @equinor/amplify-component-lib，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：proj4（^2\.15\.0）、react（^19\.2\.8）、lodash（^4\.17\.21）、motion（^12\.38\.0）、lowlight（^3\.3\.0）、react-dom（^19\.2\.8）、@tiptap/pm（^3\.1\.0）、jwt-decode（^4\.0\.0）、rehype-raw（^7\.0\.0）、html2canvas（^1\.4\.1）、@tiptap/core（^3\.1\.0）、@tiptap/react（^3\.1\.0）、react-dropzone（^14\.3\.8）、react-markdown（^10\.1\.0）、styled-components（^6\.1\.15）、@equinor/eds-icons（\*）、@tiptap/extensions（^3\.1\.0）、@tiptap/suggestion（^3\.1\.0）、@tanstack/react-query（\*）、@tanstack/react-router（\*）、@tiptap/extension-bold（^3\.1\.0）、@tiptap/extension-link（^3\.1\.0）、@tiptap/extension-list（^3\.1\.0）、@tiptap/extension-text（^3\.1\.0）、@equinor/eds-core-react（0\.44\.0）、@tiptap/extension-color（^3\.1\.0）、@tiptap/extension-image（^3\.1\.0）、@tiptap/extension-table（^3\.1\.0）、@tiptap/extension-italic（^3\.1\.0）、@tiptap/extension-heading（^3\.1\.0）、@tiptap/extension-mention（^3\.1\.0）、@tiptap/extension-document（^3\.1\.0）、@tiptap/extension-gapcursor（^3\.1\.0）、@tiptap/extension-highlight（^3\.1\.0）、@tiptap/extension-paragraph（^3\.1\.0）、@equinor/eds-data-grid-react（^0\.7\.5）、@tiptap/extension-code-block（^3\.1\.0）、@tiptap/extension-hard-break（^3\.1\.0）、@tiptap/extension-text-align（^3\.1\.0）、@tiptap/extension-text-style（^3\.1\.0）、@tiptap/extension-typography（^3\.1\.0）、@equinor/subsurface-app-management（^5\.6\.1）、@tiptap/extension-code-block-lowlight（^3\.1\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @equinor/amplify-component-lib 支持 TypeScript 吗？

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

### @equinor/amplify-component-lib 支持 ESM 还是 CommonJS？

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

### @equinor/amplify-component-lib 可以商用吗？

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

### @equinor/amplify-component-lib 的下载量有多少？

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

### @equinor/amplify-component-lib 还在维护吗？

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