# @bettercms-ai/kit 中文文档

规范地址：https://npmcn.com/package/%40bettercms-ai/kit/

版本：3\.1\.8
npm 元数据更新时间：2026-11-08T16:50:17.560Z
中文译文更新时间：2026-11-08T16:51:40.818Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：9.6 MB，523 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：react ^19\.2\.0，react-dom ^19\.2\.0，framer-motion ^12\.40\.0，@base-ui/react ^1\.4\.1，@bettercms-ai/types ^1\.66\.0，@tabler/icons-react ^3\.48\.0
- 首次发布：2026-09-28T22:27:25.368Z
- 最新版本发布：2026-11-08T16:50:17.422Z
- 近 30 天下载量：4967（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：36（近 12 个月 36 个）

## 中文简介

BetterCMS V2 Block Kit: schema语言,形式引擎,控制和设计符.

## 安装

```sh
npm install @bettercms-ai/kit
```

也可以使用：`pnpm add @bettercms-ai/kit`、`yarn add @bettercms-ai/kit`、`bun add @bettercms-ai/kit`

## README

# @ bettercms-ai/ kit (英语)

BetterCMS V2 Block Kit: schema语言,绘制Visual Editor's Dook的窗体引擎,它的控件,以及设计符号. 反应19,基地UI.

```sh
npm i @bettercms-ai/kit @base-ui/react @tabler/icons-react framer-motion react react-dom
```

## 样式

-   **尾风 v4 应用程序**: 在 Tailwind后导入符号和工具名.
    
    ```css
    @import "tailwindcss";
    @import "@bettercms-ai/kit/theme.css";
    @import "@bettercms-ai/kit/tokens.css";
    @source "../node_modules/@bettercms-ai/kit/dist";
    ```
    
-   **没有尾风** (定制码头输入的iframe): `import "@bettercms-ai/kit/styles.css"`,预编的有符号和工具箱使用的每一个功能的表. 永远不要在您的 Tailwind 工作表旁边导入它 .

## 主题

```tsx
import { KitRoot, applyScheme } from "@bettercms-ai/kit/theme";

applyScheme(document.documentElement, "dark"); // .dark on <html>: portalled layers follow it
<KitRoot>{/* kit components */}</KitRoot>;
```

## 进口

`@bettercms-ai/kit` 重新出口引擎、控制器和UI原始产品。 每个模块也可以被路径导入,例如. `@bettercms-ai/kit/ui/button`, (中文(简体) ), `@bettercms-ai/kit/schema/scale`。 。 。 .

## 常见问题

### @bettercms-ai/kit 是什么？

BetterCMS V2 Block Kit: schema语言,形式引擎,控制和设计符\.

### 如何安装 @bettercms-ai/kit？

在项目目录运行 npm install @bettercms-ai/kit，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.2\.0）、react-dom（^19\.2\.0）、framer-motion（^12\.40\.0）、@base-ui/react（^1\.4\.1）、@bettercms-ai/types（^1\.66\.0）、@tabler/icons-react（^3\.48\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @bettercms-ai/kit 支持 TypeScript 吗？

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

### @bettercms-ai/kit 支持 ESM 还是 CommonJS？

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

### @bettercms-ai/kit 可以商用吗？

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

### @bettercms-ai/kit 的下载量有多少？

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

### @bettercms-ai/kit 还在维护吗？

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