# @byline/ui 中文文档

规范地址：https://npmcn.com/package/%40byline/ui/

版本：6\.13\.0
npm 元数据更新时间：2026-11-04T13:20:50.363Z
中文译文更新时间：2026-11-08T21:29:48.772Z
软件包许可：MPL-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40byline/ui
原文对照：https://npmcn.com/package/%40byline/ui/?lang=original
项目主页：https://github.com/Byline-CMS/bylinecms.dev
源码仓库：https://github.com/Byline-CMS/bylinecms.dev

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

- 包体积（解压后）：1.4 MB，776 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.22\.2
- 运行依赖：8 个
- peer 依赖：react ^19\.0\.0，postcss ^8\.5\.0，react-dom ^19\.0\.0
- 首次发布：2026-05-03T13:20:30.560Z
- 最新版本发布：2026-11-04T13:20:50.070Z
- 近 30 天下载量：2367（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：175（近 12 个月 175 个）

## 中文简介

下行 CMS 用户界面软件包

## 安装

```sh
npm install @byline/ui
```

也可以使用：`pnpm add @byline/ui`、`yarn add @byline/ui`、`bun add @byline/ui`

## README

# @ byline/ ui

Byline CMS 的框架独立反应原始,包括按钮, 输入、覆盖、图标和拖放组件。 CMS 字段部件和 文档编辑器表格属于 `@byline/admin`。 。 。 .

此软件包是 [线性CMS](https://github.com/Byline-CMS/bylinecms.dev) ——一个开发者友好,开源的无头CMS,有版本,编辑功能 工作流程,和内容翻译作为一等关注.

用于文件、整个架构概览和开始 指令,参见主仓库: [https://github.com/Byline-CMS/bylinecms.dev. 互联网档案馆的存檔,存档日期2013-12-22](https://github.com/Byline-CMS/bylinecms.dev)。 。 。 .

## 与 `@infonomic/uikit`

这个软件包的基础表面—— `components`, (中文(简体) ), `icons`, (中文(简体) ), `hooks`, (中文(简体) ), `lib`, (中文(简体) ), `loaders`, (中文(简体) ), `styles`, (中文(简体) ), `utils`,以及 `widgets` 目录,加 `uikit.ts` ——与 [`@infonomic/uikit`](https://github.com/infonomic)两者 套件保存在同步状态 **手动移动更改,以任何方向为单位 更改来源**: 这里所做的更改是移植到上游, 做了更改 上游是这里。 任何副本均可直接编辑;其中亦非唯一 真相的来源.

线条 `dnd/` 组件和组件 `react.ts` 入境点没有上游对应点.

## 故事书

故事书让你检查和互动 与UI原始人没有开始 内容管理系统或数据库。 故事从兄弟的UI套装中移植到现场 除了它们的组件 `src/**/*.stories.tsx`。 。 。 .

在安装工作空间依赖性后, 从寄存器根运行 :

```sh
pnpm storybook
```

打开 [http://localhost:6007 (英语)](http://localhost:6007/)。预览包括 UI 工具包的重置,主题, 印刷、本地字体、抽屉和土司供应商。 使用工具栏 来切换光和暗的主题。 无障碍面板检查 ; 文档页面和控件.

建立一个静态站点:

```sh
pnpm build-storybook
```

输出为 `packages/ui/storybook-static/`,Git对此置之不理. 两个命令都与 `pnpm --filter @byline/ui` 在命令名称之前. 端口 6007 匹配兄弟姐妹套件; 启动此套件前停止它的服务器, 或 运行 `pnpm --filter @byline/ui storybook --port 6008` 用于使用不同的端口.

配置居住于 `.storybook/main.ts` 财务报告和审定财务报表 `.storybook/preview.tsx`。 。 。 . 静态预览资产存在 `public/`,在字体旁边有字体许可. 预览应用 `.byline-ui` 切入到 iframe 体上, 从而传送了覆盖的继承 和故事一样有范围 故事布局使用内线样式, 并且确实 不需要网络应用程序的 Tailwind 配置 .

在添加故事时, 从本地源模块导入组件 故事书类型 `@storybook/react-vite`软件包 `typecheck` 命令 检查故事和配置; 库构建不包括故事模块 . 在合并之前运行静态构建并检查浏览器中更改的故事.

## 许可证

MPL - 2.0 导弹

## 常见问题

### @byline/ui 是什么？

下行 CMS 用户界面软件包

### 如何安装 @byline/ui？

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

### @byline/ui 支持 TypeScript 吗？

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

### @byline/ui 支持 ESM 还是 CommonJS？

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

### @byline/ui 需要什么版本的 Node\.js？

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

### @byline/ui 可以商用吗？

@byline/ui 使用 MPL-2\.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。

### @byline/ui 的下载量有多少？

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

### @byline/ui 还在维护吗？

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