# @contentstack/cli-asset-management 中文文档

规范地址：https://npmcn.com/package/%40contentstack/cli-asset-management/

版本：1\.0\.2
npm 元数据更新时间：2026-10-06T14:50:54.496Z
中文译文更新时间：2026-11-10T16:48:06.178Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：235 kB，69 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-04-28T12:25:42.194Z
- 最新版本发布：2026-10-06T14:50:53.025Z
- 近 30 天下载量：40253（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

用于导出和导入的内存 API 适配器

## 安装

```sh
npm install @contentstack/cli-asset-management
```

也可以使用：`pnpm add @contentstack/cli-asset-management`、`yarn add @contentstack/cli-asset-management`、`bun add @contentstack/cli-asset-management`

## README

# @contentstack/cli-资产管理

资产管理 2.0 API 适配器用于Contack CLI的出入口. 当启用资产管理(AM 2. 0)时,由出入口插件使用. 为了了解如何在Contack中出口和进口内容,请参考 [移徙指南](https://www.contentstack.com/docs/headless-cms/cli/migration/)。 。 。 .

[![License](https://img.shields.io/npm/l/@contentstack/cli)](https://github.com/contentstack/cli-plugins/blob/main/LICENSE)

-   [@contentstack/cli-资产管理](https://npmcn.com/package/%40contentstack/cli-asset-management/#readme-contentstackcli-asset-management)
-   [概览](https://npmcn.com/package/%40contentstack/cli-asset-management/#readme-overview)
-   [使用量](https://npmcn.com/package/%40contentstack/cli-asset-management/#readme-usage)
-   [出口](https://npmcn.com/package/%40contentstack/cli-asset-management/#readme-exports)

# 概览

本套件提供:

-   **全面保障协定 适配器** – 资产管理 API 的 HTTP 客户端(空间,资产,文件夹,字段,资产类型).
-   **导出空间结构** - 为链接的工作空间输出空间元数据和全部工作空间结构(元数据、文件夹、资产、领域、资产类型).
-   **类型** – 说吧 – `AssetManagementExportOptions`, (中文(简体) ), `LinkedWorkspace`, (中文(简体) ), `ICSAssetsAdapter`,以及进出口一体化的相关类型.

# 使用量

此套件被导出和导入插件所消耗. 当使用导出 CLI 时 `--asset-management` 旗帜(或当主机应用程序启用 AM 2. 0 时),导出插件调用 `exportSpaceStructure` 与链接的工作空间和选项相连接:

```ts
import { exportSpaceStructure } from '@contentstack/cli-asset-management';

await exportSpaceStructure({
  linkedWorkspaces,
  exportDir,
  branchName: 'main',
  csAssetsUrl,
  org_uid,
  context,
});
```

# 出口

| 导出 | 说明 |
| --- | --- |
| `exportSpaceStructure` | Async 函数导出给定链接的工作空间的空间结构 . |
| `CSAssetsAdapter` | 要调用资产管理 API 的类( getSpace, getWorkspace Fields, getWorkspace Assets等) . |
| 类型来自 `./types` | `AssetManagementExportOptions`, (中文(简体) ), `ExportContext`, (中文(简体) ), `ChunkedJsonWriteOptions`, (中文(简体) ), `LinkedWorkspace`, (中文(简体) ), `SpaceResponse`, (中文(简体) ), `FieldsResponse`, (中文(简体) ), `AssetTypesResponse`,以及相关的 API 类型. |

## 常见问题

### @contentstack/cli-asset-management 是什么？

用于导出和导入的内存 API 适配器

### 如何安装 @contentstack/cli-asset-management？

在项目目录运行 npm install @contentstack/cli-asset-management，或使用 pnpm add / yarn add / bun add。

### @contentstack/cli-asset-management 支持 TypeScript 吗？

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

### @contentstack/cli-asset-management 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @contentstack/cli-asset-management 可以商用吗？

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

### @contentstack/cli-asset-management 的下载量有多少？

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

### @contentstack/cli-asset-management 还在维护吗？

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