@fayz-ai/app-builder

中文文档
64.0.0发布于 2026/11/11MITTypeScriptES Module零依赖近 30 天下载 7375

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

中文使用文档
文档目录5 节
  1. 两扇门
  2. 安装
  3. 水面 水面
  4. 管理员
  5. 费兹SDK的一部分

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

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

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

npm license

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

两扇门

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

安装

npm install @fayz-ai/app-builder

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

水面 水面

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 在两个主机中都是相同的按钮,每个主机后面都有运输工具;没有合同,它就会被禁用,并说原因.

管理员

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 共发布 69 个版本,首次发布于 2026/09/08;过去 12 个月发布了 69 个版本。

版本发布日期距今
64.0.0latest2026/11/112 天前
63.0.02026/11/113 天前
62.0.02026/11/113 天前
61.0.02026/11/067 天前
60.0.02026/11/068 天前
59.0.02026/11/068 天前

其他发布通道:canary → 55.0.0-canary.20261028153856。

关于 @fayz-ai/app-builder 的常见问题

@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 和提交记录判断。