# @engenty/wizards-runtime 中文文档 规范地址：https://npmcn.com/package/%40engenty/wizards-runtime/ 版本：0\.19\.0 npm 元数据更新时间：2026-11-10T08:50:47.746Z 中文译文更新时间：2026-11-13T17:14:13.621Z 软件包许可：FSL-1\.1-MIT AND CC-BY-4\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40engenty/wizards-runtime 原文对照：https://npmcn.com/package/%40engenty/wizards-runtime/?lang=original 项目主页：https://engenty.ai/ 源码仓库：https://github.com/engenty/wizards ## 关键信息（来自 npm 元数据） - 包体积（解压后）：76.6 MB，1936 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=24\.11 - 运行依赖：65 个 - peer 依赖：exceljs 4\.4\.0，@mastra/docker 0\.13\.0，@mastra/quickjs 0\.1\.5，@llamaindex/liteparse 2\.18\.0，@turbodocx/html-to-docx 1\.23\.3 - 首次发布：2026-10-17T14:44:46.862Z - 最新版本发布：2026-11-10T08:50:47.568Z - 近 30 天下载量：7771（2026-10-14 至 2026-11-12，npm 官方下载统计） - 已发布版本数：49（近 12 个月 49 个） ## 中文简介 许个愿. 去找你的巫师 它引导你一步一步。 让AI来做吧 运行在你的机器上, 在你的AI订阅已经。 运行时间,是 `npx wizards` 安装. ## 安装 ```sh npm install @engenty/wizards-runtime ``` 也可以使用：`pnpm add @engenty/wizards-runtime`、`yarn add @engenty/wizards-runtime`、`bun add @engenty/wizards-runtime` ## README ![](https://npmcn.com/package/%40engenty/wizards-runtime/docs/assets/engenty.svg) # 诱惑向导 许个愿. 去找你的巫师. 它引导你一步一步. 让AI来做吧. **个人用途和小企业** 将您重复的任务变成向导,或者从中选择一个准备中的任务 [画廊](https://engenty.ai/wizards)自己使用或与同事和客户分享: 向导一步一步地引导你,你确认它的草稿,然后得到结果. **对于开发者** 魔法师是类固醇方面的技能: 工作流程有他们自己的界面, 构建和运行在您的机器上 使用 Codex, Claude 代码或你自己的 API 密钥. 它们通过MCP和HTTP连接到其他系统. 还有 你可以把它们放到其他地方,如克劳德和其他AI聊天,或者你自己的网站,一个 嵌入密码. **企业** 向导使AI可靠. 您的域专家定义业务流程本身, 不包含 正在等待开发者。 在云中或你自己的墙壁内主持,拥有任何模型提供者. [保持联系](mailto:contact@engenty.ai)。 。 。 . ## 它会做什么
向导工作室用简单的语言说出你需要什么,工作室构建工作流程及其页面. 预览每一步并在分享前测试.
任意 LLM使用任何模式提供者. 每一步都得到一个正确的模式:一个轻而易举的简单工作模式,一个强而有力的模式,一个不需要人工智能的模式.
到处都行在浏览器和电话上,有相机,语音笔记和签名. 它甚至运行在克劳德,ChatGPT或你自己的聊天员.
创建结果报告,表格,图像,视频,文档,仪表板:任何AI能做的.
审查和完善人们确认AI的草稿或要求再次尝试.
保存内存向导会保存各种笔记和列表.
你看着每个向导都穿戴您的主题:颜色,字体和效果,在光和暗中.
集成共享( S)共享一个向导作为链接或嵌入代码,并通过电子邮件发送结果,用于驱动或Slack,或通过任何连接器.
## 打开格式 向导是 JSON 文档 。 任何人都可以在自己的工具中读取,写作并运行巫师. 这个 向人们显示向导的向导格式和跑道均在麻省理工学院许可之下,因此 4个图书馆 `packages/`:决定模型,搜索索引,搜索libSQL和Goose, 副驾驶 工作室,运行时间和其余部分都是FSL-1.1-MIT下的源. 每一次释放他们 麻省理工学院在出版两年后. [许可证](https://npmcn.com/package/%40engenty/wizards-runtime/#readme-license) 说哪个文件在哪个下面. ## 怎么样 演播室:改变一个向导的对话,人们所看到的每页的预览,以及它的台阶与它的分支相通. ![The studio of engenty wizards: on the left the assistant explains where a wizard that turns property photos into a walkthrough video branches – an optional voice-over and two ways to animate the rooms; in the middle the preview of its first page, which property, with title, key facts and location; on the right the flow with those branches](https://npmcn.com/package/%40engenty/wizards-runtime/docs/assets/studio.png) 正在使用的向导:它在一页询问,然后在下一页询问,最后是下载或分享的结果. ![A wizard in use on a phone, three pictures: which week and how many children, what is on the table, and the finished weekly plan with PDF, PNG and sharing](https://npmcn.com/package/%40engenty/wizards-runtime/docs/assets/wizard.png) ## 开始吧 在 [engenty.ai (英语)](https://engenty.ai/): 在闭合的β中,所以“开始” 把你的电子邮件作为邀请,或者你的邀请代码。 签了字,录音室问谁 你的团队是,浏览你的网站 在你的空间, 取第一文档 浏览器中的第一个向导。 Links在球队积分上昼夜奔跑. ## 在电脑上安装 在自己的机器上同一个账户:它运行在你的克洛德,ChatGPT,Google AI或Cursor上 订阅、 为您读取本地文件和浏览内容, 以及您发布的内容 同样的链条后面的云 在 macOS 或 Linux 上,在终端中: ```bash curl -fsSL https://engenty.ai/install.sh | bash ``` 在 Windows 上, 在 PowerShell 中: `irm https://engenty.ai/install.ps1 | iex`。带有20号或更新的节点 这台机器, `npx wizards` 做同样的. 什么都不需要,不过 `curl` 财务报告和审定财务报表 `tar` 并要求没有密码。 它带来了自己的节点js(a) 您已经拥有的节点被单独放置, 将激励向导安装到 `~/.engenty/wizards` 财务报告和审定财务报表 然后带你们穿过其余的路: - **你的开胃口.** “现在签署或创建你的账户?” 用于登录的浏览器,该浏览器也创建了新账户(使用您的邀请代码) 然后在云中运行。 Esc在等待的时候,或者说不,和 `wizards account sign-in` 随时都行. `--local` 离开账户:没有东西离开计算机,只有链接回答 (单位:千美元)[仅本地](https://engenty.ai/docs/user-guide/local-only)) (中文(简体) ). - **一个AI客户端.** 它寻找 Codex, Claude 代码, 抗重力和克星特工和 提议安装缺失的软件,首先是其应用程序(Claude, ChatGPT, Antigravity, Cursor)在你的Mac上,因为它的订阅很可能已经是你的了. 工作室的第一页 安装它们。 或者用你的账户的信用 API 密钥, [奥拉玛](https://ollama.com/) 或者说, 在苹果硅和macOS 26的Mac上,苹果智能. - **浏览器和 ffmpeg** (可选): PDF 的 Chrome, Edge 或 Chromium( 在 Mac 上同样勇敢) 和 PNG 导出并用于使用浏览器的步骤, ffmpeg 用于动画部件的 MP4 视频. - **开始于登录** (可选) : 当您登录( a) 时, 激励向导开始于背景 Linux上的系统化用户服务,Windows上的计划任务). Launch Agent on a Mac. 链接和AI客户端 到达它. `wizards autostart on` 或者说 `off` 以后再开关. - **你的AI应用程序** (可选):在它找到的AI应用程序中加入你的巫师,如克洛德 桌面,光标或代码. `wizards connect` 财务报告和审定财务报表 `wizards disconnect` 待会再做. 始无所起. 后来: ```bash wizards start ``` 启动并打开工作室;当终端打开时,Ctrl-C停止运行. `wizards start -s` 开始于背景. `wizards` 打开所有菜单, `wizards status` 说,什么是安装的,什么是运行的, `wizards setup` 再次运行导引的排列 `wizards --help` 列出其余部分. **安装为应用程序 .** 在Chrome或Edge,工作室作为应用程序安装:它自己的窗口,它的 在 Dock 或任务栏中自有图标。 工作室在顶端的横幅上提供;或者点击安装 图标. ### 从源 你需要节点24.11 或更新和pnpm 10(`corepack enable`; 节点25号及以后的无船 核心包装,所以先安装在 `npm install -g corepack`) (中文(简体) ). ```bash git clone https://github.com/engenty/wizards.git cd wizards pnpm install pnpm build pnpm wizards ``` pnpm 可能列出“被忽略的构建脚本 ” — — 这是预期的,没什么可做的. 代码阶梯(贝壳,节点,Python)在一个沙盒中运行. `wizards sandbox add` 安装一个( 大约 一台Mac上的480 MB,一台Linux上的820 MB,不需要多克;一台取出机在取出沙盒图像时也使用多克. ## 第一个开始 设置显示您在顶端的账户并询问AI应该如何运行. 选择人工智能 安装在计算机上的客户端 – engenty 使用您已有的订阅和标志 在页面的终端右侧给你的,你的账户的信用,苹果智能在a 麦克有它,或你自己的钥匙. 它一直呆到测试呼叫工作,然后工作室打开. 稍后在设置 ~ 模型下更改. ## 用这个 这个 [用户指南](https://engenty.ai/docs/user) 显示如何 [构建向导](https://engenty.ai/docs/user/build-a-wizard), (中文(简体) ), [测试和分享](https://engenty.ai/docs/user/test-and-share), (中文(简体) ), [连接服务](https://engenty.ai/docs/user/connectors) 财务报告和审定财务报表 [用你的AI应用程序](https://engenty.ai/docs/user/ai-apps)。 。 。 . ## 您的数据 所有东西都住在 `~/.engenty/wizards/data`: 您向导的数据库和文件 结果。 您输入的密钥保存在Mac的密钥链上, 其它加密在那个文件夹中 . 备份文件夹; 删除以重新开始 。 设置进入 `~/.engenty/wizards/.env` (见 [.env.实例](https://npmcn.com/package/%40engenty/wizards-runtime/.env.example)(三); `ENGENTY_HOME` 移动整个安装. `pnpm start` 将数据保存在 `data` 代码旁边的文件夹. ## 更新 engenty 向导自我更新: 它在开始时寻找新版本, 每天一次下载 它在背景 并切换到它的下一个开始, 从来没有在跑. `wizards autoupdate off` 关掉它。 现更新: ```bash wizards update ``` 此操作再次运行安装器而无需询问 。 工作室在顶端的横幅上说 当更新的发布退出时, 可以从那里或从其About 对话框运行相同的更新 . 来源: `git pull`, (中文(简体) ), `pnpm install`, (中文(简体) ), `pnpm build`您的数据在 下一个开始. 要删除激励向导, 请运行 `wizards uninstall` (或 `npx wizards uninstall` 如果命令没有 )). 它显示它首先要删除的内容: 您的 AI 应用程序的条目, 登录项, 每个 运行进程, `~/.engenty/wizards` 财务报告和审定财务报表 `~/.local/bin/wizards`中的数据 `~/.engenty/wizards/data` 被保存,除非您选择删除, 并重新安装它 再来一次. `--dry-run` 只显示计划, `--yes` 运行它没有问题 并保存你的数据, 财务报告和审定财务报表 `--yes --delete-data` 删除数据. ## 在服务器上运行 与 Docker, 在 https 代理服务器( Caddy, Traefik, coolify) 后面 : ```bash git clone https://github.com/engenty/wizards.git cd wizards cp .env.example .env # set APP_URL to your https address and add a model key docker compose up -d --build docker compose logs # shows the link to open once ``` 在8891号端口指向代理机. 在服务器上, engenty 使用您的密钥或 Ollama AI 客户订阅使用您的电脑。 密码沙盒在这个图像中关闭. ## 解决问题 | | | | --- | --- | | “这一联系不再有效” | 连通一次. `wizards open` 给此浏览器一个新的 . | | `wizards`: 未找到命令 | 打开新终端, 或运行 `~/.local/bin/wizards`。 。 。 . | | 你用另一个地址打开它 | 设定 `APP_URL` 内 `~/.engenty/wizards/.env` 到地址打开. | | AI 客户端显示未签名 | 在设置页面或你自己的终端(如:. `claude`, (中文(简体) ), `codex login`,然后是“再次检查”. | | PDF 或 PNG 导出失败 | 安装 Chrome、 Edge 或 Chromium( 在 Mac 上同样勇敢), 或设置 `CHROME_PATH` 到一个. | | 24368号港被抢 | 接下来的自由端口被使用. 修一个,设置 `API_PORT` 内 `~/.engenty/wizards/.env`。 。 。 . | | 还有一件事 | `wizards doctor` 检查安装. | 更多设置 : [.env.实例](https://npmcn.com/package/%40engenty/wizards-runtime/.env.example)。 。 。 . ## 对于开发者 开发服务器,检查,如何构建,管理模式: [文件/开发](https://npmcn.com/package/%40engenty/wizards-runtime/docs/development.md)。 。 。 . 插件为步骤添加工具,在工作室中包含自己的表格和页面的路由,不包含 更改运行时间 : [文档/内容/dev/插件](https://npmcn.com/package/%40engenty/wizards-runtime/docs/content/dev/plugins/index.md)。 。 。 . 文件 - 用户指南和开发者 Docs - 在 [文档/内容](https://npmcn.com/package/%40engenty/wizards-runtime/docs/content) 也是它自己的一个遗址: `pnpm dev:docs`。 。 。 . ## 许可证 向导格式,跑道和四个库都是MIT. 其余代码为FSL-1.1-MIT. | 什麽 | 许可证 | | --- | --- | | 向导格式: `packages/shared` 给巫师下定义,读出来,装成一个 `.wizard` 文件 | 麻省理工学院或FSL-1.1-麻省理工学院,你选([利马](https://npmcn.com/package/%40engenty/wizards-runtime/packages/shared/LICENSE-MIT)(中文(简体) ) | | 跑垒的, `packages/runner` | 麻省理工学院[自由主义](https://npmcn.com/package/%40engenty/wizards-runtime/packages/runner/LICENSE)(中文(简体) ) | | 图书馆 `@engenty/decision-model`, (中文(简体) ), `@engenty/search-index`, (中文(简体) ), `@engenty/search-libsql` 财务报告和审定财务报表 `@engenty/goose` 时间: npm, in `packages/decision-model`, (中文(简体) ), `packages/search-index`, (中文(简体) ), `packages/search-libsql` 财务报告和审定财务报表 `packages/goose` | 麻省理工学院 `LICENSE` 每个文件夹中) | | AI应用程序的插件, `plugin/`,没有 激励数字在里面 | 麻省理工学院[自由主义](https://npmcn.com/package/%40engenty/wizards-runtime/plugin/LICENSE)(中文(简体) ) | | 其他一切:工作室,运行时间 `wizards` 命令, `@engenty/wizards` 时间 | FSL-1.1-麻省理工学院[自由主义](https://npmcn.com/package/%40engenty/wizards-runtime/LICENSE)(中文(简体) ) | | 充满激情的画作 | CC BY 4.0 (英语:[液化纤维](https://npmcn.com/package/%40engenty/wizards-runtime/LICENSE-FIGURES)(中文(简体) ) | | 名字和数字作为一个品牌 | 商标[贸易](https://npmcn.com/package/%40engenty/wizards-runtime/TRADEMARKS.md)(中文(简体) ) | FSL-1.1-MIT是可用来源:为你自己和你的公司使用,运行,改变——只是 而不是作为竞争的产品或服务提供给他人。 每次发布都变成麻省理工两年 发表之后。 任何许可证都不得授予该名称或人物作为品牌的权利. [警视厅(MD)](https://npmcn.com/package/%40engenty/wizards-runtime/COPYRIGHTS.md) 列出每个许可证下的确切档案。 它也命名为 拥有者,标记,什么不是我们的 和第三方软件的许可证。 在文件中: [许可证发放](https://npmcn.com/package/%40engenty/wizards-runtime/docs/content/dev/licensing.md)。 。 。 . ## 常见问题 ### @engenty/wizards-runtime 是什么？ 许个愿\. 去找你的巫师 它引导你一步一步。 让AI来做吧 运行在你的机器上, 在你的AI订阅已经。 运行时间,是 npx wizards 安装\. ### 如何安装 @engenty/wizards-runtime？ 在项目目录运行 npm install @engenty/wizards-runtime，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 wizards，可以用 npx wizards 直接运行。 ### @engenty/wizards-runtime 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/engenty\_\_wizards-runtime 是否存在。 ### @engenty/wizards-runtime 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @engenty/wizards-runtime 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=24\.11。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @engenty/wizards-runtime 可以商用吗？ @engenty/wizards-runtime 使用 FSL-1\.1-MIT AND CC-BY-4\.0 许可。声明的许可为 FSL-1\.1-MIT AND CC-BY-4\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。 ### @engenty/wizards-runtime 的下载量有多少？ 根据 npm 官方下载统计，@engenty/wizards-runtime 在 2026/10/14 – 2026/11/12 这 30 天内被下载 7,771 次，日均约 259 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @engenty/wizards-runtime 还在维护吗？ 最新版本 0\.19\.0 发布于 2026/11/10（3 天前）；至今共发布 49 个版本，其中过去 12 个月发布了 49 个；首次发布于 2026/10/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。