# @chaibuilder/sdk 中文文档

规范地址：https://npmcn.com/package/%40chaibuilder/sdk/

版本：4\.0\.0-beta\.51
npm 元数据更新时间：2026-07-12T17:44:12.393Z
中文译文更新时间：2026-11-09T17:47:47.528Z
软件包许可：BSD-3-Clause

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

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

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

- 包体积（解压后）：6.4 MB，205 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=21\.0\.0
- 运行依赖：91 个
- peer 依赖：ai ^6\.0\.11，react ^18\.0 \|\| ^19\.0 \|\| ^19\.1 \|\| ^19\.2，postgres ^3\.4\.8，react-dom ^18\.0 \|\| ^19\.0 \|\| ^19\.1 \|\| ^19\.2，drizzle-orm ^0\.45\.1，@types/react \*，@types/react-dom \*，@supabase/supabase-js ^2\.90\.1
- 首次发布：2023-11-14T15:50:13.866Z
- 最新版本发布：2026-03-16T04:11:04.442Z
- 近 30 天下载量：2048（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：531（近 12 个月 86 个）

## 中文简介

AI 为 ReactJS 启用开源网站构建器

## 安装

```sh
npm install @chaibuilder/sdk
```

也可以使用：`pnpm add @chaibuilder/sdk`、`yarn add @chaibuilder/sdk`、`bun add @chaibuilder/sdk`

## README

# Chai 构建器 - 开源反应网站构建器

[![npm version](https://img.shields.io/npm/v/@chaibuilder/sdk.svg)](https://www.npmjs.com/package/@chaibuilder/sdk) [![License](https://img.shields.io/npm/l/@chaibuilder/sdk.svg)](https://github.com/chaibuilder/chaibuilder-sdk/blob/main/LICENSE)

柴建机是一个 **完全开源React网站构建器** 授权开发者使用拖放功能在视觉上创建惊人的网页。 由React和Tailwind CSS搭建,无缝地融入了您现有的项目.

🚀 **外部支持:**

-   **下一个.js 16**
-   **尾风 CSS v3+**

📚 **[代码Wiki](https://codewiki.google/github.com/chaibuilder/sdk)** | **[现场直播](https://chaibuilder-sdk.vercel.app/)**

![CHAI BUILDER](https://fldwljgzcktqnysdkxnn.supabase.co/storage/v1/object/public/dam-assets/assets/chai-builder.jpg)

## \* 特性

-   🎨 **视觉拖放构建器( D)** - 创建不写代码的可视页面
-   ⚛️ **反应第一** - 作为无缝集成的反光组件建造
-   🎯 **尾风 CSS 电源** - 充分利用Tailwind CSS v3+的全能
-   🚀 **下一个.js 16 准备** - 全力支持最新的Next.js特性
-   🔧 **两个灵活模式** - 用作核心构建器组件或完整的 Next.js 网站构建器
-   📦 **广泛** - 增加自定义块和组件
-   💾 **数据控制** - 全面控制如何和在何处保存数据
-   🎭 **框架不可知渲染** - 任何反应应用程序中的渲染块

* * *

## • 软件包

Chai Builder可分为三个包:

| 特性 | 标准  
(反应) | 下一个  
(接下来) | 专业  
(多租户相邻) |
| --- | :-: | :-: | :-: |
| 拖放反应构建器( D) | ✅ | ✅ | ✅ |
| 广泛 API | ✅ | ✅ | ✅ |
| 内钩 | ✅ | ✅ | ✅ |
| 自定义块 | ✅ | ✅ | ✅ |
| 自定义面板 | ✅ | ✅ | ✅ |
| 数据绑定 | ✅ | ✅ | ✅ |
| i18n 辅助 | ✅ | ✅ | ✅ |
| AI 专门小组(标准) | ✅ | ✅ | ✅ |
| 主题系统 | ✅ | ✅ | ✅ |
| 导入 HTML | ✅ | ✅ | ✅ |
| 部分块 |  | ✅ | ✅ |
| 页面类型 |  | ✅ | ✅ |
| 收款 |  | ✅ | ✅ |
| 媒体管理器 |  | ✅ | ✅ |
| SEO & JSON 在线 |  | ✅ | ✅ |
| 预览模式 |  | ✅ | ✅ |
| CMS 整合 |  | ✅ | ✅ |
| ByeO 堆叠 |  | ✅ | ✅ |
| 多语言 |  |  | ✅ |
| 道德操守办公室 |  |  | ✅ |
| 订正 |  |  | ✅ |
| 设计托肯斯 |  |  | ✅ |
| 图书馆 |  |  | ✅ |
| 多用户 |  |  | ✅ |
| AI 背景和高级AI |  |  | ✅ |
| 多租户支助 |  |  | ✅ |
| 启示动画 |  |  | 🔜 |
| 新建构建器 UI |  |  | 🔜 |
| 自定义区块登记册 |  |  | 🔜 |
| 高级模板 |  |  | 🔜 |

* * *

## 使用大小写

-   **登陆页面** - 轻松地建立美丽的登陆页
-   **营销网站** - 创建和更新营销内容
-   **内容管理** - 授权非技术用户创建网页
-   **快速原型制作** - 快速的原型 并且以设计为主
-   **白标签解决方案** - 在您的 SaaS 产品中构建页面构建器

* * *

## ++ 辅助

如果你喜欢这个项目 你可以帮助我们扩大范围 ChaiBuilder是开发商在他们空闲时间设计的一种协作努力. 我们珍视每一项贡献,无论贡献多么微薄,因为每一项贡献都是以各种方式向前迈出的重要一步,特别是在推动我们不断加强这一工具方面.

[![Buy Me A Coffee](https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png)](https://www.buymeacoffee.com/chaibuilder)

## 承认

Chai Builder站在许多开源图书馆和工具的肩上. 我们感谢这些项目的开发者和维护者所作的贡献.

## 常见问题

### @chaibuilder/sdk 是什么？

AI 为 ReactJS 启用开源网站构建器

### 如何安装 @chaibuilder/sdk？

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

### @chaibuilder/sdk 支持 TypeScript 吗？

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

### @chaibuilder/sdk 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @chaibuilder/sdk 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=21\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @chaibuilder/sdk 可以商用吗？

@chaibuilder/sdk 使用 BSD-3-Clause 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括，不构成法律意见，请以许可原文为准。

### @chaibuilder/sdk 的下载量有多少？

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

### @chaibuilder/sdk 还在维护吗？

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