# @firecms/core 中文文档

规范地址：https://npmcn.com/package/%40firecms/core/

版本：3\.5\.2
npm 元数据更新时间：2026-11-10T18:04:14.096Z
中文译文更新时间：2026-11-14T19:30:50.383Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：13.9 MB，781 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=14
- 运行依赖：47 个
- peer 依赖：react \>=18\.3\.1 \|\| \>=19\.0\.0，react-dom \>=18\.3\.1 \|\| \>=19\.0\.0，react-router ^6\.28\.0，react-router-dom ^6\.28\.0
- 首次发布：2023-10-26T19:46:03.576Z
- 最新版本发布：2026-11-10T18:04:13.691Z
- 近 30 天下载量：10145（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：465（近 12 个月 79 个）

## 中文简介

出色的消防基地/火炉式无头开源CMS

## 安装

```sh
npm install @firecms/core
```

也可以使用：`pnpm add @firecms/core`、`yarn add @firecms/core`、`bun add @firecms/core`

## README

![Intro video](https://firecms.co/img/dark_mode.webp)

[![FireCMS logo](https://firecms.co/img/logo_small.png)](https://firecms.co/)

# FireCMS 系统

### 出色的消防基地/蒙戈DB型无头CMS

[现场演示](https://demo.firecms.co/)

  

[![NPM](https://img.shields.io/npm/v/firecms.svg)](https://www.npmjs.com/package/firecms) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com/)

FireCMS由开发者为开发者设计,是一个无头的CMS和管理员面板 与无缝结合 **消防基地和消防场** 默认,但 (单位:千美元) 兼容任何后端.

不费力地生成 **CRUD 视图** 基于您的配置。 FireCMS 为 简单 建立标准案例,并方便扩展和定制更具体的 需要帮助.

用于生成收藏和形成自然符合 fireCMS的收集/文件模型涵盖广泛的基本和先进用途 案例。 考虑到可扩展性,很容易创建你自己的观点或修改 现有.

FireCMS 确实如此 **不强制任何数据结构** 限制,确保平滑, 任何项目都需具备非常规经验.

### 核心技术

FireCMS基于这个伟大的技术:

-   字体
-   尾风 CSS
-   火炮基地 SDK 10
-   反应 + 反应路由器 6

### 快速启动

最容易走的方法就是检查我们的快速启动指南! 你会 需要采取一些快速步骤:

[https://firecms.co/docs 互联网档案馆的存檔,存档日期2013-12-21](https://firecms.co/docs)

### 演示

检查所有核心功能的演示.

[https://demo.firecms.co (英语)](https://demo.firecms.co/)

> 您可以修改数据, 但它会定期恢复 .

### 更改日志

[https://firecms.co/docs/changelog 页面存档备份,存于互联网档案馆](https://firecms.co/docs/changelog)

## 特征

FireCMS 已经精心设计,让开发者变得非常容易 建立一个CMS/admin工具,同时提供出色的数据编辑经验 并为营销者和内容管理人员提供方便用户的界面.

### 特殊电子表格视图

我们开发了一个高效的窗口 **电子表格视图** 页:1 集合,允许对大多数常见字段进行内置编辑,以及弹出 查看其他情况以及您的自定义字段执行.

装扮 **实时** 支持, FireCMS 适合需要的应用程序 不断更新。 它还支持 **文本搜索** (通过外部提供者) 像阿尔戈利亚,如果使用Firestore, **过滤和排序**,以及 **导出** 数据.

### 强力表

![fields](https://firecms.co/img/form_editing.webp)

当编辑一个实体时, FireCMS 提供了一个嵌入式的侧式对话框系统 导航 **子收藏** 并访问自定义视图(例如自定义) 表格或博客预览)。 此功能也可以访问 从方案角度使用 `useSideEntityController` 钩.

FireCMS 包含 **20个内置作业区** 多次定制 验证选项。 这些部件经过精心设计,用于 杰出的用户经验,包括高级功能 **参考文献** 改为 其他藏书, **减值**,以及 **阵列重排顺序**。 。 。 .

对于不支持的使用,请创建自己的 **自定义字段** 作为反应 组件.

FireCMS 还支持 **条件字段** ,允许您定义 基于您的逻辑,对活动字段的规则.

### 认证、权限和角色系统

定义浏览用户可以看到的导航视图和操作(创建、编辑、, 他们可以根据您的角色系统来表演。 你甚至可以配置这个 或收集数量.

默认情况下, FireCMS 支持所有 Firebase 授权机制, 但您可以 执行你自己的.

### \* 关系支助

界定其他收藏中提及实体的内容并从中受益 综合参考字段和快捷键.

也可以定义实体级的子收藏,用于在 收集/文件/收集模式.

### QQ 实时数据

CMS 中的每个视图都支持实时数据,使其适合显示 不断更新信息.

表格也支持此特性,数据库中的任何修改值都是 只要用户没有触及到任何开放形式视图中更新. 它可以在保存后触发 Cloud 函数的高级案件 实体,修改一些值,并需要实时更新.

### QQ 文件存储

FireCMS 支持将文件上传到 Firebase 存储出框并提供 处理单个和多个文件上传的特定字段,以及 重订.

你可以用你自己的存储器来取代 .

## 包含实例

您可以访问演示项目的代码 [`example`](https://github.com/FireCMSco/firecms/tree/master/example)它包括: 这个CMS提供的每一个功能.

请记住,如果您想要更新该项目中的依赖性,您需要更新其中的依赖性 按原样使用,而不将其与库源代码相链接. 详见 其读物

## 谁造的

建造和维护 [坎贝里](https://camberi.com/?utm_source=firecms&utm_medium=referral&utm_campaign=built-by),马德里和慕尼黑的一个产品工程工作室,它也为客户而建.

## 联系和支助

需要一般支持的,可以打开GitHub问题.

您需要咨询 设置您的 Firestore 的CMS 在短时间内? 我们是 很乐意帮忙! `hello@firecms.co`

## 发展

如果你想改变来源,请自由提交公关!

开发时,核心库可在以下 `lib`。 。 。 . 文件夹中有一个示例工程 `example`。 。 。 .

要运行工程, 您需要创建文件 调用 `firebase_config.ts` 内 `example/src`。 。 。 .

文件需要导出一个有效的 Firebase 配置, 您可以得到 在为您的项目创建网络应用程序时从 Firebase 控制台中创建 .

那就赶紧跑 `npm install` 财务报告和审定财务报表 `npm run dev` (或 `yarn` 财务报告和审定财务报表 `yarn dev`(中文(简体) )

## 许可证

麻省理工学院 [FireCMS 系统](https://github.com/FireCMSco)

## 常见问题

### @firecms/core 是什么？

出色的消防基地/火炉式无头开源CMS

### 如何安装 @firecms/core？

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

### @firecms/core 支持 TypeScript 吗？

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

### @firecms/core 支持 ESM 还是 CommonJS？

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

### @firecms/core 需要什么版本的 Node\.js？

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

### @firecms/core 可以商用吗？

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

### @firecms/core 的下载量有多少？

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

### @firecms/core 还在维护吗？

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