# @amplience/dc-cli 中文文档 规范地址：https://npmcn.com/package/%40amplience/dc-cli/ 版本：0\.31\.0 npm 元数据更新时间：2026-03-03T11:42:32.864Z 中文译文更新时间：2026-11-06T01:18:29.635Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40amplience/dc-cli 原文对照：https://npmcn.com/package/%40amplience/dc-cli/?lang=original 项目主页：https://github.com/amplience/dc-cli#readme 源码仓库：https://github.com/amplience/dc-cli ## 关键信息（来自 npm 元数据） - 包体积（解压后）：607 kB，202 个文件 - 模块格式：CommonJS - TypeScript 类型：未声明 - Node.js 要求：\>=20 - 运行依赖：17 个 - 首次发布：2019-11-20T16:17:24.298Z - 最新版本发布：2026-03-03T11:42:32.368Z - 近 30 天下载量：27881（2026-10-06 至 2026-11-04，npm 官方下载统计） - 已发布版本数：38（近 12 个月 3 个） ## 中文简介 动态内容 CLI 工具 ## 安装 ```sh npm install @amplience/dc-cli ``` 也可以使用：`pnpm add @amplience/dc-cli`、`yarn add @amplience/dc-cli`、`bun add @amplience/dc-cli` ## README # (简体中文) Amplience动态内容服务的命令行界面. ## 说明 **(简体中文)** 是 Amplience 动态内容管理 APIs 的命令行界面应用程序. 运行 `dc-cli --help` 以获取可用的命令列表. - [(简体中文)](https://npmcn.com/package/%40amplience/dc-cli/#readme-dc-cli) - [说明](https://npmcn.com/package/%40amplience/dc-cli/#readme-description) - [安装](https://npmcn.com/package/%40amplience/dc-cli/#readme-installation) - [配置](https://npmcn.com/package/%40amplience/dc-cli/#readme-configuration) - [选项](https://npmcn.com/package/%40amplience/dc-cli/#readme-options) - [实例](https://npmcn.com/package/%40amplience/dc-cli/#readme-examples) - [使用客户端ID和秘密创建/更新单个中枢配置文件](https://npmcn.com/package/%40amplience/dc-cli/#readme-createupdate-configuration-file-for-single-hub-using-client-id-and-secret) - [使用个人访问符创建/更新单个中枢的配置文件](https://npmcn.com/package/%40amplience/dc-cli/#readme-createupdate-configuration-file-for-single-hub-using-personal-access-token) - [创建/ 更新用于双色调的配置文件( 复制/ 移动/ clone)](https://npmcn.com/package/%40amplience/dc-cli/#readme-createupdate-configuration-file-for-two-hub-usage-copymoveclone) - [使用替代配置 `hub` 命令](https://npmcn.com/package/%40amplience/dc-cli/#readme-alternative-configuration-using-hub-command) - [命令类别](https://npmcn.com/package/%40amplience/dc-cli/#readme-command-categories) - [内容类型图](https://npmcn.com/package/%40amplience/dc-cli/#readme-content-type-schema) - [内容类型](https://npmcn.com/package/%40amplience/dc-cli/#readme-content-type) - [内容项目](https://npmcn.com/package/%40amplience/dc-cli/#readme-content-item) - [扩展](https://npmcn.com/package/%40amplience/dc-cli/#readme-extension) - [搜索索引](https://npmcn.com/package/%40amplience/dc-cli/#readme-search-index) - [内容存储器](https://npmcn.com/package/%40amplience/dc-cli/#readme-content-repository) - [事件](https://npmcn.com/package/%40amplience/dc-cli/#readme-event) - [设置](https://npmcn.com/package/%40amplience/dc-cli/#readme-settings) - [中枢](https://npmcn.com/package/%40amplience/dc-cli/#readme-hub) - [任务](https://npmcn.com/package/%40amplience/dc-cli/#readme-job) - [链接内容存储器](https://npmcn.com/package/%40amplience/dc-cli/#readme-linked-content-repository) - [网点](https://npmcn.com/package/%40amplience/dc-cli/#readme-webhook) - [建设国家综合倡议](https://npmcn.com/package/%40amplience/dc-cli/#readme-building-the-cli) - [所需权限](https://npmcn.com/package/%40amplience/dc-cli/#readme-required-permissions) ## 安装 从国家防范机制软件包管理器安装DC CLI可以使用以下命令: ```bash npm install -g @amplience/dc-cli ``` 或者你可以下载操作系统的可执行文件 [页 次](https://github.com/amplience/dc-cli/releases)。 。 。 . ## 配置 **(简体中文)** 需要一套有效的Amplience客户证书和中枢ID(`--hubId`)进行手术。 您可以使用客户身份和秘密进行认证( Name`--clientId` 打开 `--clientSecret`)或个人访问标志(`--patToken`) (中文(简体) ). 这些参数必须在使用 CLI 之前使用下列命令之一设定 : `dc-cli configure --clientId --clientSecret --hubId ` `dc-cli configure --patToken --hubId ` 一些命令( E)`content-item copy`, (中文(简体) ), `content-item move`,并 `hub-clone`)允许以单一命令输出和导入内容。 客户资格还有其他选择(`--dstClientId` 打开 `--dstSecret`)和中枢ID(`--dstHubId`)是一个独特的动态内容中心。 如果没有提供目的地选项,这些命令的目的地将与源相同. 工具配置完成后, 单个参数可以在运行任何命令时通过提供来覆盖, 例如 `dc-cli --hubId `。 。 。 . 默认情况下, 配置会被保存到目录中的文件 `/.amplience/`,使用 `--config` 选项. ### 选项 | 选项名称 | 类型 | 说明 | | --- | --- | --- | | \--版本 | \[叫声\] | 显示版本编号 | | \-- 客户身份 | \[弦\] \[须 | 源中心客户端ID | | \--客户安全 | \[弦\] \[须 | 源中心客户端秘密 | | \-- patToken 语句 | \[弦\] \[须 | 源中心的个人访问令牌 | | \- 呼号 | \[弦\] \[须 | 源代码中心 | | \--配置 | \[弦\] \[默认:"~. amplience/dc-cli-config.json"\] | JSON 配置文件的路径 | | \-- 帮助 | \[叫声\] | 显示帮助 | | \--日志 | \[弦\] \[默认:(生成值)\] | 要写入日志文件的路径 . | | \--dst HubId (英语) | \[弦\] | 目的地中心号 如未明确,则会同出处. | | \--dst 客户端 | \[弦\] | 目的地账户的客户身份 如未明确,则会同出处. | | \--dstSecret (英语) | \[弦\] | 目的地账户的秘密。 必须同时使用 dstClientId . | #### 实例 ##### 使用客户端ID和秘密创建/更新单个中枢配置文件 `dc-cli configure --clientId foo --clientSecret bar --hubId baz` ##### 使用个人访问符创建/更新单个中枢的配置文件 `dc-cli configure --patToken foo --hubId baz` ##### 创建/ 更新用于双色调的配置文件( 复制/ 移动/ clone) `dc-cli configure --clientId foo --clientSecret bar --hubId baz --dstClientId qux --dstSecret quux --dstHubId quuz` #### 使用替代配置 `hub` 命令 使用 [**中枢**](https://npmcn.com/package/%40amplience/dc-cli/docs/HUB.md) 子命令,您可以保存枢纽配置供稍后检索. 此命令增加了一个中枢, 并提供了证书 : `dc-cli hub add --clientId --clientSecret --hubId ` 然后,为了使用中枢,可以指代它的名称或中枢ID的一部分: `dc-cli hub use ` ## 命令类别 ### 内容类型图 这一类别包括与内容类型计划的互动. 这些命令可用于检索一个或多个计划的信息,创建新的计划,从单个中心站输出和导入计划,以及归档和无存档计划. [查看命令为 **内容类型图**](https://npmcn.com/package/%40amplience/dc-cli/docs/CONTENT-TYPE-SCHEMA.md) ### 内容类型 该类包括了与内容类型的互动. 这些命令可用于检索一个或多个类型的信息,注册新类型或更新现有类型,从单个枢纽导出和导入类型,以及归档和无存档类型. 在导入内容类型之前, 您必须确保一个有效的 [内容类型计划a](https://npmcn.com/package/%40amplience/dc-cli/#readme-content-type-schema) 存在于每种类型的目的中心. [查看命令为 **内容类型**](https://npmcn.com/package/%40amplience/dc-cli/docs/CONTENT-TYPE.md) ### 内容项目 这一类别包括与内容项目的互动. 这些命令可用于从单个中枢输出和导入内容,复制和移动中枢之间的项目,以及归档和无存档内容. 在导入、复制或移动内容之前,您必须确保有效 [内容类型](https://npmcn.com/package/%40amplience/dc-cli/#readme-content-type) 存在于每个内容项目的目的地中心. [查看命令为 **内容项目**](https://npmcn.com/package/%40amplience/dc-cli/docs/CONTENT-ITEM.md) ### 扩展 该类包括了与动态内容的UI扩展的交互,可用于从单个中枢导出,导入和删除扩展. [查看命令为 **扩展**](https://npmcn.com/package/%40amplience/dc-cli/docs/EXTENSION.md) ### 搜索索引 这一类别包括与Algolia搜索索引的动态内容互动,可用于从单个枢纽导出和导入索引. [查看命令为 **搜索索引**](https://npmcn.com/package/%40amplience/dc-cli/docs/SEARCH-INDEX.md) ### 内容存储器 这一类别包括与动态内容库的互动. 这些命令可用于获取特定寄存器的细节,列出多个寄存器,或者从寄存器中指定或取消指定内容类型. [查看命令为 **内容存储器**](https://npmcn.com/package/%40amplience/dc-cli/docs/CONTENT-REPOSITORY.md) ### 事件 这一类包括与动态内容事件及其组成部分(Editions, Slots,和Snapshots)的互动. 这些命令可用于导出和导入事件,以及归档事件. [查看命令为 **事件**](https://npmcn.com/package/%40amplience/dc-cli/docs/EVENT.md) ### 设置 这一类别包括与动态内容枢纽的支持属性的互动。 这些命令可用于导出和导入一个枢纽的断点设置,用于可视化,预览应用程序,工作流程状态,以及地产. [查看命令为 **设置**](https://npmcn.com/package/%40amplience/dc-cli/docs/SETTINGS.md) ### 中枢 这一类别包括与动态内容中心的全部互动. 这些命令可用于将一个枢纽的设置和内容全部复制到另一个枢纽,或者将一个可以存档的枢纽的所有部分归档. 此外,这些命令还可用于存储和取回枢纽配置. [查看命令为 **中枢**](https://npmcn.com/package/%40amplience/dc-cli/docs/HUB.md) ### 任务 这一类包括与动态内容工作的互动. [查看命令为 **任务**](https://npmcn.com/package/%40amplience/dc-cli/docs/JOB.md) ### 链接内容存储器 这一类别包括与动态内容链接的内容存储库的互动. 这些命令可用于列出多个链接的内容寄存器. [查看命令为 **链接内容存储器**](https://npmcn.com/package/%40amplience/dc-cli/docs/LINKED-CONTENT-REPOSITORY.md) ### 网点 该类包括了与动态内容的UI Webhooks的交互,可用于从单个中枢导出,导入和删除webhooks. [查看命令为 **网点**](https://npmcn.com/package/%40amplience/dc-cli/docs/WEBHOOK.md) ## 建设国家综合倡议 我们列入了一些国家预防机制的文字,以帮助创建国家行动倡议的各种设施. - [国家领导才能建设指南](https://npmcn.com/package/%40amplience/dc-cli/docs/BUILDING_THE_CLI.md) ## 所需权限 下面概述了运行CLI每个指令所需的详细权限. 要申请运行 CLI 的 API 密钥, 请联系 Amplience 支持 . | 命令 | 所需空调 | 所需的功能权限 | | --- | --- | --- | | `configure` | 枢纽 - 读取 | | | `content-repositories get ` | 枢纽 - 读取 | 内容:职能:替代:READ | | `content-repositories list` | 枢纽 - 读取 | 内容:职能:替代:READ | | `content-repositories assign-content-type ` | 内容存储器 - EDIT 枢纽 - 读取 | 内容:职能:替代: | | `content-repositories unassign-content-type ` | 内容存储器 - EDIT 枢纽 - 读取 | 内容:职能:替代: | | `content-type get ` | 枢纽 - 读取 | 内容:职能: 职能: | | `content-type list` | 枢纽 - 读取 | 内容:职能: 职能: | | `content-type register` | 枢纽 - 读取 | 内容:职能:职能:职能:职能:职能:职能 | | `content-type sync [id]` | 枢纽 - 读取 | 内容:职能: | | `content-type update ` | 枢纽 - 读取 | 内容:职能: | | `content-type import ` | 内容存储器 - EDIT 枢纽 - 读取 | 内容:职能: 职能: 内容:职能:职能:职能:职能:职能:职能 内容:职能: | | `content-type export ` | 枢纽 - 读取 | 内容:职能: 职能: | | `content-type-schema create` | 枢纽 - 读取 | 内容:职能:职能:职能:职能:职能:职能 | | `content-type-schema get ` | 枢纽 - 读取 | 内容:职能: 职能: | | `content-type-schema list` | 枢纽 - 读取 | 内容:职能: 职能: | | `content-type-schema update ` | 枢纽 - 读取 | 内容:职能: | | `content-type-schema import ` | 枢纽 - 读取 | 内容:职能: 职能: 内容:职能:职能:职能:职能:职能:职能 内容:职能: | ## 常见问题 ### @amplience/dc-cli 是什么？ 动态内容 CLI 工具 ### 如何安装 @amplience/dc-cli？ 在项目目录运行 npm install @amplience/dc-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dc-cli，可以用 npx dc-cli 直接运行。 ### @amplience/dc-cli 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/amplience\_\_dc-cli 是否存在。 ### @amplience/dc-cli 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### @amplience/dc-cli 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @amplience/dc-cli 可以商用吗？ @amplience/dc-cli 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @amplience/dc-cli 的下载量有多少？ 根据 npm 官方下载统计，@amplience/dc-cli 在 2026/10/06 – 2026/11/04 这 30 天内被下载 27,881 次，日均约 929 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @amplience/dc-cli 还在维护吗？ 最新版本 0\.31\.0 发布于 2026/03/03（8 个月前）；至今共发布 38 个版本，其中过去 12 个月发布了 3 个；首次发布于 2019/11/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。