# @animate-ui/cli 中文文档

规范地址：https://npmcn.com/package/%40animate-ui/cli/

版本：2\.4\.0
npm 元数据更新时间：2026-10-27T09:39:20.553Z
中文译文更新时间：2026-11-06T15:13:09.120Z
软件包许可：SEE LICENSE IN LICENSE\.md

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

原始 npm 页面：https://www.npmjs.com/package/%40animate-ui/cli
原文对照：https://npmcn.com/package/%40animate-ui/cli/?lang=original
项目主页：https://animate-ui.com/
源码仓库：https://github.com/imskyleen/animate-ui

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

- 包体积（解压后）：171 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.12
- 运行依赖：1 个
- 首次发布：2026-10-18T15:47:54.384Z
- 最新版本发布：2026-10-27T09:39:20.245Z
- 近 30 天下载量：2938（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

将你的阴影/ui原始相换为动画"UI"的动画相,从"Animate UI v1"迁移.

## 安装

```sh
npm install @animate-ui/cli
```

也可以使用：`pnpm add @animate-ui/cli`、`yarn add @animate-ui/cli`、`bun add @animate-ui/cli`

## README

# {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你应该知道

```bash
# Animate installed shadcn/ui components
pnpm dlx @animate-ui/cli@latest animate accordion
pnpm dlx @animate-ui/cli@latest animate all

# Migrate Animate UI v1 components to v2
pnpm dlx @animate-ui/cli@latest migrate all

# List what moves in a project, and how
pnpm dlx @animate-ui/cli@latest audit
```

过 `--dry-run` 预览更改.

`animate` 只更改导入源, 镜像每个库的样式 : `import { Accordion, Slot } from "radix-ui"` 变成 `import { Accordion, Slot } from "@animate-ui/react/primitives/radix-ui"` (枪管再出口其他一切) `radix-ui`, (中文(简体) ), `@base-ui/react` 移动到 `@animate-ui/react/primitives/base-ui`, (中文(简体) ), `react-aria-components` 改为 `@animate-ui/react/primitives/react-aria`和每批进口`@radix-ui/react-accordion`, (中文(简体) ), `@base-ui/react/accordion`, (中文(简体) ), `vaul`, (中文(简体) ), `input-otp`, (中文(简体) ), `embla-carousel-react`, (中文(简体) ), `@shadcn/react/questionnaire`)到匹配的每个原始路径(`@animate-ui/react/primitives/radix-ui/accordion`, (中文(简体) ), `@animate-ui/react/primitives/carousel`, (中文(简体) ), `@animate-ui/react/primitives/questionnaire`(......) (中文(简体) ). 一个没有任何东西的导入 ALIMAT UI 动画被留下 。 Shadcn/ui的代码块没有原始的导入来交换: `animate code-block` 重写到原地 `pre` 变成 `@animate-ui/react/primitives/code-block`是因为 `Content`,其复制按钮建立在复制按钮上,留下一部分按原样用手修改.

`migrate` 移动每个导入 `@animate-ui/react`。在导入时将可映射部件与 v1- 唯一可映射部件相混合( 突出部分, 上下文钩) , 可映射部件移动, 并且 v1 文件中只保留 v1- 唯一名称, 每个都报告为手动步骤: 当其母为 v2 时, 会在运行时丢出, 所以删除它们, 或以 shadcn/ ui + 替换组件 `animate-ui animate`. v1文件 v2 没有对应的(Files,预览链接卡,无头UI原始人,几个钩子)保留您,并继续工作:它们停留在所建的v1 Radix UI和Base UI原始人上. Flip 和 Liquid 按钮是 v2 中的注册文件 : 它们的导入也保留在 v1 文件上, 一个手动步骤给出 `shadcn add` 各个命令.

最终, `migrate` 列出 v1 文件 `@animate-ui/react` 取代不再进口的东西。 在终端中,它先要求删除(一个或一个接一个); `--delete` 删除它们 `--keep` 不用问就留着 在航站楼外面(CI,管子),除非你通过,否则会保留它们 `--delete`。 。 。 .

`audit` 列出一个项目的动画( 或您通过的文件夹和文件的动画): 每个项目的属性会改变, 以及浏览器的成本, 以及值得查看的图案( )`transition: all`,易入入出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出入出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出入入入入入入入入入出出出出入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入 动能UI技术为您权衡了这些事实.

联合国 [https://animate-ui.com (中文(简体) )](https://animate-ui.com/)

## 常见问题

### @animate-ui/cli 是什么？

将你的阴影/ui原始相换为动画"UI"的动画相,从"Animate UI v1"迁移\.

### 如何安装 @animate-ui/cli？

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

### @animate-ui/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/animate-ui\_\_cli 是否存在。

### @animate-ui/cli 支持 ESM 还是 CommonJS？

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

### @animate-ui/cli 需要什么版本的 Node\.js？

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

### @animate-ui/cli 可以商用吗？

@animate-ui/cli 使用 SEE LICENSE IN LICENSE\.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @animate-ui/cli 的下载量有多少？

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

### @animate-ui/cli 还在维护吗？

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