# @docker/actions-toolkit 中文文档

规范地址：https://npmcn.com/package/%40docker/actions-toolkit/

版本：0\.109\.0
npm 元数据更新时间：2026-11-05T12:46:50.194Z
中文译文更新时间：2026-11-12T13:49:46.315Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：705 kB，234 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：22 个
- 首次发布：2023-01-30T10:23:53.026Z
- 最新版本发布：2026-11-05T12:46:49.832Z
- 近 30 天下载量：20413（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：151（近 12 个月 43 个）

## 中文简介

Docker( GitHub) 动作工具箱

## 安装

```sh
npm install @docker/actions-toolkit
```

也可以使用：`pnpm add @docker/actions-toolkit`、`yarn add @docker/actions-toolkit`、`bun add @docker/actions-toolkit`

## README

[![Version](https://img.shields.io/npm/v/@docker/actions-toolkit?label=version&logo=npm&style=flat-square)](https://www.npmjs.com/package/@docker/actions-toolkit) [![Downloads](https://img.shields.io/npm/dw/@docker/actions-toolkit?logo=npm&style=flat-square)](https://www.npmjs.com/package/@docker/actions-toolkit) [![Build workflow](https://img.shields.io/github/actions/workflow/status/docker/actions-toolkit/build.yml?label=build&logo=github&style=flat-square)](https://github.com/docker/actions-toolkit/actions?workflow=build) [![Test workflow](https://img.shields.io/github/actions/workflow/status/docker/actions-toolkit/test.yml?label=test&logo=github&style=flat-square)](https://github.com/docker/actions-toolkit/actions?workflow=test) [![Validate workflow](https://img.shields.io/github/actions/workflow/status/docker/actions-toolkit/validate.yml?label=validate&logo=github&style=flat-square)](https://github.com/docker/actions-toolkit/actions?workflow=validate) [![Codecov](https://img.shields.io/codecov/c/github/docker/actions-toolkit?logo=codecov&style=flat-square)](https://codecov.io/gh/docker/actions-toolkit)

# 行动工具包

Docker( GitHub) 动作工具箱 .

## : test tube:实验

考虑此寄存器 **警告语** 正在积极发展之中 直到进一步通知。 它受到非后向相容性修改或 删除任何未来的版本.

## 关于

此寄存器包含作为 由 GitHub 动作构成的库 :

-   [插头/桶-动作](https://github.com/docker/bake-action)
-   [嵌入器/建-推-动作](https://github.com/docker/build-push-action)
-   [嵌入/登录动作](https://github.com/docker/login-action)
-   [点/元数据动作](https://github.com/docker/metadata-action)
-   [插头/设置-构建-动作](https://github.com/docker/setup-buildx-action)
-   [插头/设置-组合动作](https://github.com/docker/setup-compose-action)
-   [套接字/设置-套接字动作](https://github.com/docker/setup-docker-action)
-   [插头/设置-qemu-action](https://github.com/docker/setup-qemu-action)

该工具包在开发GitHub时提供了一些公用事业和共同逻辑 行动以及作为我们建设工具的最小包装,例如 [构建x](https://github.com/docker/buildx) 财务报告和审定财务报表 [构建 Kit](https://github.com/moby/buildkit) 并提供了与它们互动的更方便的API.

## 安装

```console
$ npm install @docker/actions-toolkit
```

## 使用量

```js
const { Toolkit } = require('@docker/actions-toolkit/lib/toolkit')
const toolkit = new Toolkit()
```

## 捐款

想要为行动工具包做出贡献吗? 厉害! 您可以找到信息 协助该项目 [捐款额](https://npmcn.com/.github/CONTRIBUTING.md)

## 常见问题

### @docker/actions-toolkit 是什么？

Docker\( GitHub\) 动作工具箱

### 如何安装 @docker/actions-toolkit？

在项目目录运行 npm install @docker/actions-toolkit，或使用 pnpm add / yarn add / bun add。

### @docker/actions-toolkit 支持 TypeScript 吗？

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

### @docker/actions-toolkit 支持 ESM 还是 CommonJS？

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

### @docker/actions-toolkit 可以商用吗？

@docker/actions-toolkit 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @docker/actions-toolkit 的下载量有多少？

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

### @docker/actions-toolkit 还在维护吗？

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