# @engenty/wizards 中文文档

规范地址：https://npmcn.com/package/%40engenty/wizards/

版本：0\.19\.0
npm 元数据更新时间：2026-11-10T08:57:48.531Z
中文译文更新时间：2026-11-13T17:19:24.774Z
软件包许可：FSL-1\.1-MIT

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

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

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

- 包体积（解压后）：2.7 MB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：zod 4\.6\.7，react ^19\.3\.0，react-dom ^19\.3\.0，drizzle-orm ^0\.45\.4，@openuidev/react-lang ^1\.0\.1
- 首次发布：2026-10-17T22:17:19.413Z
- 最新版本发布：2026-11-10T08:57:48.345Z
- 近 30 天下载量：4870（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：37（近 12 个月 37 个）

## 中文简介

您的代码从 engenty 向导导入什么 : 插件在 /plugin , 向导在 OpenUI 聊天在 / openui 中导入 。 FSL-1.1-MIT,来源可用.

## 安装

```sh
npm install @engenty/wizards
```

也可以使用：`pnpm add @engenty/wizards`、`yarn add @engenty/wizards`、`bun add @engenty/wizards`

## README

# @engenty/wizards (英语)

许可证:FSL-1.1-MIT,可用来源 (单位:千美元)[自由主义](https://github.com/engenty/wizards/blob/main/LICENSE)) (中文(简体) ).

什么代码外的 诱惑法师进口, 一个子路径每次使用。 运行时间和工作室 诱惑法师不在其中.

| 导入 | 这是什么 | 文档 |
| --- | --- | --- |
| `@engenty/wizards/plugin` | 插件服务器的一半 : `definePlugin` 类型 | `docs/content/dev/plugins` |
| `@engenty/wizards/plugin/studio` | 插件工作室的一半 : `defineStudioPlugin` | `docs/content/dev/plugins/studio.md` |
| `@engenty/wizards/plugin/thread` | 信使频道 : `ThreadDoor` | `docs/content/dev/plugins/runners.md` |
| `@engenty/wizards/openui` | 向导在 [打开UI](https://github.com/thesysdev/openui) 聊天时间: `Wizard` 组件 | `docs/content/dev/integration/openui.md` |
| `@engenty/wizards/openui/server` | 其服务器的一半: 聊天提示的规则和向导列表 |  |
| `@engenty/wizards/openui/styles.css` | 风格 `Wizard` 组件绘图 |  |

## OpenUI 聊天中的向导

聊天模式决定一个巫师运行和它已经知道的东西. 向导然后运行 在对话中,作者对对话作了界定,由跑者取出(`packages/runner`(单位:千美元) 聊天的专页.

```tsx
// The browser
import "@engenty/wizards/openui/styles.css";
import { addWizard, configureWizards, Wizard } from "@engenty/wizards/openui";
import { openuiChatLibrary } from "@openuidev/react-ui/genui-lib";

configureWizards({ runtime: "/wizards-runtime" }); // where the runtime answers
const library = addWizard(openuiChatLibrary, Wizard);
```

```ts
// The server that builds the system prompt
import { addWizard, loadWizards, wizardRules } from "@engenty/wizards/openui/server";

const wizards = await loadWizards("http://localhost:24368", ["<token>"]);
const prompt = addWizard(openuiChatLibrary).prompt({
  ...openuiChatPromptOptions,
  additionalRules: [...(openuiChatPromptOptions.additionalRules ?? []), ...wizardRules(wizards)],
});
```

模特儿写道: `Wizard("<token>", "<note>", {plate: "W-12345"})`预填开始 页面的字段,而个人仍然看到并发送每个页面。 当运行完成时 组件发送 a `continue_conversation` 以结果的案文为背景采取行动 继续聊天 尝试用: `examples/openui-chat`。 。 。 .

## 包裹

每一版都发布到npm(`scripts/npm-package.mjs`, (中文(简体) ), `.github/workflows/release.yml`) (中文(简体) ). `pnpm --filter @engenty/wizards build` 写入 `dist/` 随船而行`scripts/build.mjs`: `/openui` 与跑道和它使用的共享模块组合在一起,其类型包含在内 跑车 `runner.css` 作为 `styles.css`;每个其他软件包都保留导入,库为 `dependencies`,反应,OpenUI,Zod和细雨作为同龄人. 里面所有东西都进口 来源.

## 许可证

FSL -1.1 -MIT,像存储器. `dist/openui` 捆绑跑跑者( r)`packages/runner`页:1 麻省理工学院:它的执照船在旁边作为 `dist/openui/LICENSE-MIT`。 。 。 .

## 常见问题

### @engenty/wizards 是什么？

您的代码从 engenty 向导导入什么 : 插件在 /plugin , 向导在 OpenUI 聊天在 / openui 中导入 。 FSL-1\.1-MIT,来源可用\.

### 如何安装 @engenty/wizards？

在项目目录运行 npm install @engenty/wizards，或使用 pnpm add / yarn add / bun add。

### @engenty/wizards 支持 TypeScript 吗？

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

### @engenty/wizards 支持 ESM 还是 CommonJS？

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

### @engenty/wizards 可以商用吗？

@engenty/wizards 使用 FSL-1\.1-MIT 许可。声明的许可为 FSL-1\.1-MIT，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @engenty/wizards 的下载量有多少？

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

### @engenty/wizards 还在维护吗？

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