# @assistant-ui/vite 中文文档

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

版本：0\.0\.21
npm 元数据更新时间：2026-10-09T14:30:43.499Z
中文译文更新时间：2026-11-07T00:27:52.592Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：14.9 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：vite \>=6
- 首次发布：2026-06-01T01:36:45.362Z
- 最新版本发布：2026-10-09T14:30:43.111Z
- 近 30 天下载量：74133（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

助手-ui的Vite插件:"使用基因"指令编译器,将工具的 schema 聚合,只执行服务器,只执行客户端在一文件中渲染. 与Vite应用程序和TanStack Start合作.

## 安装

```sh
npm install @assistant-ui/vite
```

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

## README

# @ assistant-ui/ vite (英语)

助理的 Vite 插件 **`"use generative"`** 指令——一个文件 聚合一个工具的策略, 它只使用服务器 `execute`,且仅限客户端 `render`。使用简单的Vite应用程序和 **TanStack 启动**。 。 。 .

## 使用量

```ts
// vite.config.ts
import { defineConfig } from "vite";
import { aui } from "@assistant-ui/vite";
import { tanstackStart } from "@tanstack/react-start/plugin/vite";
import viteReact from "@vitejs/plugin-react";

export default defineConfig({
  plugins: [aui(), tanstackStart(), viteReact()],
});
```

`aui()` 套装 `enforce: "pre"`因此它运行之前 `@vitejs/plugin-react` 减少联署材料X——列入 `plugins` 数组无关紧要.

## 如何运作

Vite 创建您的应用程序一次 **环境**插件的 `transform` 分支 打开 `this.environment.config.consumer`数字 :

-   **客户端** 环境 – 客户端构建:保留 `render` 和任何 `"use client"` 前端 `execute`后端 `execute`。 。 。 .
-   **服务器** 环境( TanStack Start ) `ssr`,其中聊天路线和 服务器函数活 ) — 服务器构建: 保留后端 `execute`,滴数 `render`。 。 。 .

不需要外观或方向调整(不同于Next.js/Turbopack加载器)—— Environment API直接给插件一个可靠的每个构建信号.

与 Next.js 集成不同的是,服务器构建是 **没有** 注入 `import "server-only"`: 警卫依靠 `react-server` 出口条件, 一个 TanStack 启动 `ssr` 建筑不设. 分裂已经是结构性的—— 客户端构建中从不包含 `execute` 躯体.

## 撰写

从 `@assistant-ui/react`数字 :

```tsx
"use generative";
import { defineToolkit, humanTool } from "@assistant-ui/react";
import { z } from "zod";

export default defineToolkit({
  get_weather: {
    parameters: z.object({ city: z.string() }),
    execute: async ({ city }) => fetchWeather(city), // server-only
    render: ({ result }) => <Weather {...result} />, // client-only
  },
});
```

将汇编的工具包注册到 `Tools({ toolkit })` 客户端和您的 服务器工具在服务器上的运行器——两者都导入同一份文件.

## 常见问题

### @assistant-ui/vite 是什么？

助手-ui的Vite插件:"使用基因"指令编译器,将工具的 schema 聚合,只执行服务器,只执行客户端在一文件中渲染\. 与Vite应用程序和TanStack Start合作\.

### 如何安装 @assistant-ui/vite？

在项目目录运行 npm install @assistant-ui/vite，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vite（\>=6）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @assistant-ui/vite 支持 TypeScript 吗？

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

### @assistant-ui/vite 支持 ESM 还是 CommonJS？

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

### @assistant-ui/vite 可以商用吗？

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

### @assistant-ui/vite 的下载量有多少？

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

### @assistant-ui/vite 还在维护吗？

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