# @fayz-ai/app-builder 中文文档

规范地址：https://npmcn.com/package/%40fayz-ai/app-builder/

版本：64\.0\.0
npm 元数据更新时间：2026-11-11T14:52:43.403Z
中文译文更新时间：2026-11-14T12:12:25.439Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fayz-ai/app-builder
原文对照：https://npmcn.com/package/%40fayz-ai/app-builder/?lang=original

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

- 包体积（解压后）：197 kB，49 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^18\.0\.0 \|\| ^19\.0\.0，@fayz-ai/ui \>=0\.94\.0，lucide-react \>=0\.400\.0 \<1\.0\.0，@fayz-ai/core \>=0\.94\.0，@fayz-ai/admin \>=0\.94\.0
- 首次发布：2026-09-07T23:30:18.861Z
- 最新版本发布：2026-11-11T14:52:42.978Z
- 近 30 天下载量：7375（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：69（近 12 个月 69 个）

## 中文简介

\[实验\] Fayz SDK – 应用构建器表面:窗口铬,活画布,出版和聊天接缝

## 安装

```sh
npm install @fayz-ai/app-builder
```

也可以使用：`pnpm add @fayz-ai/app-builder`、`yarn add @fayz-ai/app-builder`、`bun add @fayz-ai/app-builder`

## README

# @fayz-ai/应用程序创建器

> **状态:预览(实验).** 表面是真实的;代码视图,发布和聊天是执行最少的合同. API可不经通知而更改.

> 应用构建器表面:一个窗口栏,应用程序在它内部运行,以及用来查看代码,发布,和正在做这项工作的人交谈的接缝.

[![npm](https://img.shields.io/npm/v/@fayz-ai/app-builder.svg)](https://www.npmjs.com/package/@fayz-ai/app-builder) [![license](https://img.shields.io/npm/l/@fayz-ai/app-builder.svg)](https://github.com/FayaLabs/fayz-sdk/blob/main/LICENSE)

Fayz编辑和一个管理员的应用程序需要同样的东西:窗口铬,里面的活应用程序,旁边的对话,以及一个发布按钮. 写上两次是这个软件包存在要避免的错误。 一个表面,两个主机——编辑器保持其容器的生命周期和聊天,管理员保存其外壳和助手,两者都挂载了相同的组件.

## 两扇门

-   **`.`** ——地表. **没有 `@fayz-ai/*` 完全依赖**: 反应,明快反应和阴影符号,这两个主机已经拥有了. 这是费兹编辑进口的门.
-   **`./plugin`** —— 说 `createAppBuilderPlugin()`SDK管理员怎么装的 拉动 `@fayz-ai/core`, (中文(简体) ), `@fayz-ai/admin` 财务报告和审定财务报表 `@fayz-ai/ui` 作为 **选项** 等同位素, 因此导入表面时不会拖动管理员 .

## 安装

```bash
npm install @fayz-ai/app-builder
```

端点 : `react`, (中文(简体) ), `react-dom`, (中文(简体) ), `lucide-react`可选同龄人(仅限 `./plugin`: `@fayz-ai/core`, (中文(简体) ), `@fayz-ai/admin`, (中文(简体) ), `@fayz-ai/ui`。 。 。 .

## 水面 水面

```tsx
import { AppBuilder } from '@fayz-ai/app-builder'

<AppBuilder
  target={{ name: 'Artorius', url: containerPreviewUrl, liveUrl }}
  chat={<YourChatColumn />}
  chatContract={{ send: (message, element) => yourChat.send(message, element) }}
  publish={{ state, publish }}
  onClose={goBack}
  onToggleChat={toggleChat}
  onToggleWide={toggleSidebar}
  slots={{ chromeEnd: <YourTabs />, belowCanvas: <YourTerminal /> }}
/>
```

预览和代码为 **在两个州有一个地表** (单位:千美元)`mode`),而不是两个组件:通过 a `code` 槽和开关出现; 省略它而不存在。 聊天从不在这里画——每个主机都不同,但 `chatContract` "改变这个街区" 是如何从画布 变成任何对话 东道主挂起. `publish` 在两个主机中都是相同的按钮,每个主机后面都有运输工具;没有合同,它就会被禁用,并说原因.

## 管理员

```tsx
import { createAppBuilderPlugin } from '@fayz-ai/app-builder/plugin'

plugins: [createAppBuilderPlugin({ sandboxUrl: import.meta.env.VITE_APP_BUILDER_SANDBOX_URL })]
```

挂载 a `immersive` 路由(没有导航条目——门是"Seu site"部件),从租户的站点行中解决目标,打开外壳的助理铁路,并出版 `builder_navigate` 编号 : `builder_reload` 编号 : `builder_set_viewport` 编号 : `builder_request_change` 给探员.

## 费兹SDK的一部分

路线图: 元素拾取器上覆( 协议已经在两侧有线) , 真实的代码表面, 和 Fayz 编辑器互换 `components/preview/` 这棵树.

## 常见问题

### @fayz-ai/app-builder 是什么？

\[实验\] Fayz SDK – 应用构建器表面:窗口铬,活画布,出版和聊天接缝

### 如何安装 @fayz-ai/app-builder？

在项目目录运行 npm install @fayz-ai/app-builder，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.0\.0 \|\| ^19\.0\.0）、react-dom（^18\.0\.0 \|\| ^19\.0\.0）、lucide-react（\>=0\.400\.0 \<1\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fayz-ai/app-builder 支持 TypeScript 吗？

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

### @fayz-ai/app-builder 支持 ESM 还是 CommonJS？

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

### @fayz-ai/app-builder 可以商用吗？

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

### @fayz-ai/app-builder 的下载量有多少？

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

### @fayz-ai/app-builder 还在维护吗？

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