# @animus-ui/unplugin 中文文档

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

版本：0\.1\.87
npm 元数据更新时间：2026-10-24T04:20:21.711Z
中文译文更新时间：2026-11-06T04:54:21.828Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40animus-ui/unplugin
原文对照：https://npmcn.com/package/%40animus-ui/unplugin/?lang=original
项目主页：https://github.com/codecaaron/animus/tree/main/packages/unplugin#readme
源码仓库：https://github.com/codecaaron/animus

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

- 包体积（解压后）：86.8 kB，28 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0
- 运行依赖：2 个
- 首次发布：2026-08-20T07:20:52.446Z
- 最新版本发布：2026-10-24T04:20:21.323Z
- 近 30 天下载量：6531（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：68（近 12 个月 68 个）

## 中文简介

Animus 将主机转换为非插件捆绑机——在一次提取会话中不以插件为基础的滚动/构建/rspack/webpack入口

## 安装

```sh
npm install @animus-ui/unplugin
```

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

## README

# @animus-ui/ unplugin (英语)

Animus 变换主机,用于非插剂捆绑器——滚出,起积, rspack, 和 Webpack 的切入点在一次提取会话上。 变换 `@animus-ui/system` 构建器链条在构建时间进入静态CSS,交付 样式表作为真实释放的资产( q)`animus.css`供应 `__ANIMUS_DEV__` 定义.

虚拟用户: 使用 [`@animus-ui/vite-plugin`](https://npmcn.com/package/%40animus-ui/vite-plugin)。下一个.js用户: 使用情况 [`@animus-ui/next-plugin`](https://npmcn.com/package/%40animus-ui/next-plugin)。根导出可达 `.vite` 适配器是 **不支持** - 支撑的地表就是 4个子路径条目下面.

## 安装

```bash
npm install --save-dev @animus-ui/unplugin
npm install @animus-ui/system
```

需要节点 `>=22.12.0`原生引擎二进制飞船,为darwin-arm64, linux-x64-gnu,和 linux-arm64-gnu (英语).

## 设置( 滚动)

```js
// rollup.config.mjs — ESM configs use the NAMED export.
import { animusRollup as animus } from '@animus-ui/unplugin/rollup';
import esbuild from 'rollup-plugin-esbuild';

export default {
  input: 'src/entry.tsx',
  plugins: [
    // The host FIRST: its transform must see raw TSX (rollup has no
    // enforce ordering — config order is the law).
    animus({ system: './src/ds.ts', strict: true }),
    esbuild({ jsx: 'automatic', target: 'es2022' }),
  ],
  output: { dir: 'dist', format: 'esm' },
};
```

其他捆绑者从自己的子路径遵循相同的形状: `animusEsbuild` 从 `@animus-ui/unplugin/esbuild`, (中文(简体) ), `animusRspack` 从 `@animus-ui/unplugin/rspack`, (中文(简体) ), `animusWebpack` 从 `@animus-ui/unplugin/webpack`在 CJS 配置文件中使用默认导出 :

```js
// CJS config files:
const animus = require('@animus-ui/unplugin/rollup').default;
```

节点- ESM **默认** 输入 CJS 构建约束导出对象, 而不是插件功能——在无害环境管理配置中,总是使用命名导出.

## 插件顺序

提取引擎解析 **原始 TSX 数据** ——这个主机的变换必须运行 在任何TS/JSX转录之前. `enforce: 'pre'` 命令网络包装和rs包装 自动加载链; **滚动消费者必须列出此插件 在他们的转接器之前** 在配置中。 命令错误的建筑发出 a 源驱动警告( e)`transform-time source … differs from analyze-time source`) 之后在 TSX 语法上进行捆绑解析错误——移动 Animus 首先要修复插件 .

## 它会做什么

-   运行一个 `ExtractionSession` 时间 `buildStart` 在你的包厢里 process;每个文件的变换来自保留的引擎状态. 分析 失败就是建设失败——绝不是沉默的通过.
-   解析样式表 id (`.animus/styles.css`),系统道具id, 并且每个被录取的设计系统设备包的规格调整到准确位置 分析条目提取。 配置图 `paths` 是别名来源.
-   将已提取的样式表显示为真实 `animus.css` 资产(用于建造: 写入 `outdir`,或旁边 `outfile`) (中文(简体) ).
-   与 `stylesheets: 'split'`样式表 旁边的切片 `animus.css`, (中文(简体) ), `animus.<slice>.<hash>.css` (创始人, (b) 部件、公用事业) `animus-stylesheets.json`,其名称链接 秩序。 秩序。 它们的字节顺序是 `animus.css`'s; 切片编辑叶 独守其名. 后建到同一目录中可删除 切片它不再出版, 当它出版无.
-   用品 `__ANIMUS_DEV__` dev- signal 定义通过每个捆绑器 自己的机制.
-   当字体面部声明时 `preload: true`输出 `animus-font-preloads.json` 旁边 `animus.css`: 预装, 如 `{ href, type, fetchpriority }`,与样式表相对. `renderFontPreloads(preloads, { base, exclude })` 返回时 `<link>` hTML 标记, 在哪里 `base` 是一个 URL `animus.css`'目录是 任职于 `exclude` 列出已预加载的文档. 这个 `fontPreloads` 选项(姓氏,或 `{ family, weight?, style?, unicodeRange?, fetchpriority? }`)选择预先装入的面孔 联合国 `preload` 旗帜; 条目 `fetchpriority` 到达他们的标记.

## 选项

选项是共享驱动程序核心( S)`system`, (中文(简体) ), `exclude`, (中文(简体) ), `strict`, (中文(简体) ), `mode`, (中文(简体) ), `targets`, (中文(简体) ), `minify`,...);未知的密钥响亮失效. `mode` (单位:千美元)`'development' | 'production'`选择 **仅限排放量** - 微调 默认, dev- signal 定义, 引擎 dev 诊断—— 永不处理 生命周期。 缺席时,则适用捆绑者自己的命令甲骨文(webpack/ 橡胶包 `compiler.options.mode`,滚动表模式),其他 `production` (建设显示没有信号). `exclude` 模式是模糊的; 列表 核可 `dist`, (中文(简体) ), `.test.` 财务报告和审定财务报表 `.spec.` 默认值,而 `node_modules`, (中文(简体) ), `.next` 财务报告和审定财务报表 `.animus` 总是适用。 无论绑匪写到哪里 总是被排除在外:它的输出目录(每个虚拟环境的, 每个输出的 `dir`网络包装 `output.path` 直至第一个 `[…]` 占位符)及其输出文件的精确名称(`outfile`, (中文(简体) ), `output.file`网络包装, rspack, esbuilt 和Vite 命名它们之前 分析。 卷起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起 将它们排除在其第二个发展之外,以及已经 分析了1份报告(一个产出文件作为先前的输出;一个文件在内) 输出目录作为较早的输出或输出旁的源, 命名要添加的内容 `exclude`; 下节 `strict` 建造失败.

完整的消费者合同——模块化家庭、界定的合同、, 工艺品、平台矩阵——生活在 [独立开采合同](https://github.com/codecaaron/animus/blob/main/docs/standalone-extraction.md)。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @animus-ui/unplugin 是什么？

Animus 将主机转换为非插件捆绑机——在一次提取会话中不以插件为基础的滚动/构建/rspack/webpack入口

### 如何安装 @animus-ui/unplugin？

在项目目录运行 npm install @animus-ui/unplugin，或使用 pnpm add / yarn add / bun add。

### @animus-ui/unplugin 支持 TypeScript 吗？

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

### @animus-ui/unplugin 支持 ESM 还是 CommonJS？

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

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

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

### @animus-ui/unplugin 可以商用吗？

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

### @animus-ui/unplugin 的下载量有多少？

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

### @animus-ui/unplugin 还在维护吗？

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