# @equinor/echo-update 中文文档

规范地址：https://npmcn.com/package/%40equinor/echo-update/

版本：2\.0\.0
npm 元数据更新时间：2026-10-30T09:45:03.499Z
中文译文更新时间：2026-11-14T06:39:57.809Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：55.5 kB，20 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.12\.0
- 运行依赖：4 个
- 首次发布：2021-08-23T10:56:31.411Z
- 最新版本发布：2026-04-09T12:42:07.756Z
- 近 30 天下载量：2232（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 1 个）

## 中文简介

Echo 依赖更新器

## 安装

```sh
npm install @equinor/echo-update
```

也可以使用：`pnpm add @equinor/echo-update`、`yarn add @equinor/echo-update`、`bun add @equinor/echo-update`

## README

![logo](https://raw.githubusercontent.com/equinor/EchoFramework/main/doc/ee.png)

# 回声更新

这是一个用于更新回声 npm 包的简单工具,或者可选地所有 npm 包.

少校 轻取. 补丁

-   如果新建了稳定的小补丁或补丁,则自动更新 。 稳定=少校。 轻取. 没有其它文字的补丁
-   新建 Major - 显示选择对话框:在上方新建 Major和当前 Major,然后将其余列表进行排序.
-   新建小版本( F) - 在当前软件包固定时显示选择对话框
-   新建小项 - 如果新版本不稳定, 显示选择对话框( 少数软件包已释放被标记为最新候选人)
-   如果包含多个版本或 > <. 如"<1.0.0""2.3.1 QQ 2.4.5",则不要升级
-   在版本名中保留任何前缀,如:~^等.

日志/产出

-   绿色( 如果更新)
-   需要手动更新的红色
-   黄色( 如果固定而不更新)
-   没有更新的白/灰

```CMD
OPTIONS
  -a, --all            Will update all packages, not just echo-packages
  -d, --dev            Will skip update for devDependencies
  -e, --peer           Will skip update for peerDependencies
  -f, --filter=filter  Will only update packages matching the filter, example: --filter=*react*
  -i, --skipFixed      Will skip dialogue and update for new fixed-version
  -m, --skipMajor      Will skip dialogue and update for new major-version
  -o, --optional       Will skip update for optionalDependencies
  -p, --path=path      The path (directory) containing package.json

EXAMPLES
  echo-update                                | update echo packages
  echo-update --all                          | update all packages
  echo-update --filter=*jest*                | update all packages that includes jest
  echo-update -f=jest                        | only update the jest package
  echo-update -a --path="./folder"           | only update the jest package
  echo-update -a --skipFixed --skipMajor     | update all minor- & patch-versions, skip dialogue for major- & fixed-versions
```

# 全球

对于 `global` 在命令行中使用全局安装软件包并使用回声更新.

## Npm 安装

```sh-session
$ npm install @equinor/echo-update -g
```

## 使用量

用于全局使用,用软件包导航到文件夹.json并使用以下命令.

全部更新 `echo packages`,运行 :

```sh-session
$ echo-update
```

对于任何需要特定版本的特殊情况,可以使用以下命令之一. 用于版本选择使用.

```sh-session
$ echo-update -v
```

用于选择“ beta” 和“ next” 版本 .

```sh-session
$ echo-update -c
```

用于更新 `all packages` (不只是回声),运行:

```sh-session
$ echo-update -a
```

在不同的路径/目录上运行, 请运行 :

```sh-session
$ echo-update --path="../EchoCli/"
```

# 当地

对于 `local` 用于特定项目.

## Npm 安装

```sh-session
$ npm install @equinor/echo-update -D
```

添加 `scripts` 给您的 `package.json`。 。 。 .

```JSON
{
    "scripts": {
        // Other scripts...
        "echo-update": "echo-update",
        "echo-update-version": "echo-update -v",
        "echo-update-next": "echo-update -c",
        "echo-update-all": "echo-update -a"
    }
}
```

## 使用量

如果作为依赖性安装软件包,则在软件包的脚本部分中添加以下命令. json

更新 `echo packages`,运行 :

```sh-session
$ npm run echo-update
```

更新 `all packages`,运行 :

```sh-session
$ npm run echo-update-all
```

# 发展

第一次使用, 先按命令运行 :

```sh-session
$ npm install
```

## 国家预防机制的建设

```sh-session
$ npm run build
$ yalc publish
```

## 用节点在本地运行

您可以在构建后以节点在当地运行脚本. 使用指定的路径更新 EchoCli 所有软件包的示例 :

```sh-session
cd non-monorepo-libs/echo-update
npm run build
node ./lib/index.js --path="./" -a              <-- Echo-update
node ./lib/index.js --path="../echo-cli/" -a    <-- Echo-Cli
node ./lib/index.js --path="../../" -a          <-- Echopedia
node ./lib/index.js --path="./sampleFile/" -a   <-- Sample file for testing
```

## 雅尔克:用于测试开发时的回声更新

记住 **向 package.json 添加脚本** 如前文所述 `local` 节.

在回声更新中:

```sh-session
$ npm run build
$ yalc publish
```

在您想要测试此选项的其他寄存器中( 每次您想要测试不同的回声更新选项时运行这两个) :

```sh-session
$ yalc add @equinor/echo-update
$ npm run echo-update-all
```

你要运行所有这些命令 如果你做了一个改变,并想要再次测试.

# 向国家预防机制公布

看来我们得从本地机器上公布这个.

```
cd non-monorepo-libs/echo-update/
npm run build
npm pack
npm publish --dry-run
npm publish --access public
```

## Echo Update现在是无害环境管理模块

从版本 `v2.0.0` 回声更新是一个无害环境管理模块,因为依赖 `inquirer` 也转向无害环境管理.

## 常见问题

### @equinor/echo-update 是什么？

Echo 依赖更新器

### 如何安装 @equinor/echo-update？

在项目目录运行 npm install @equinor/echo-update，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 echo-update，可以用 npx echo-update 直接运行。

### @equinor/echo-update 支持 TypeScript 吗？

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

### @equinor/echo-update 支持 ESM 还是 CommonJS？

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

### @equinor/echo-update 需要什么版本的 Node\.js？

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

### @equinor/echo-update 可以商用吗？

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

### @equinor/echo-update 的下载量有多少？

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

### @equinor/echo-update 还在维护吗？

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