# @epignosis\_llc/gnosis 中文文档

规范地址：https://npmcn.com/package/%40epignosis_llc/gnosis/

版本：6\.12\.0
npm 元数据更新时间：2026-11-12T09:26:31.132Z
中文译文更新时间：2026-11-14T03:15:30.566Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：11.6 MB，1804 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.19\.0 \|\| \>=22\.12\.0
- 运行依赖：14 个
- peer 依赖：react \>=18\.0\.0，react-dom \>=18\.0\.0
- 首次发布：2021-09-24T11:17:08.243Z
- 最新版本发布：2026-11-12T09:26:30.861Z
- 近 30 天下载量：2419（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：509（近 12 个月 56 个）

## 中文简介

Epigosis官方反应设计系统.

## 安装

```sh
npm install @epignosis_llc/gnosis
```

也可以使用：`pnpm add @epignosis_llc/gnosis`、`yarn add @epignosis_llc/gnosis`、`bun add @epignosis_llc/gnosis`

## README

# 肠道

> [麻风病](https://www.epignosishq.com/) 官方反应设计系统.

一个内部的,有观点的UI图书馆. 主要重点是在我们的产品中提供由一体和统一的UI、UX和无障碍环境.

## \* 安装

```text
$ npm i @epignosis_llc/gnosis
```

```text
$ yarn add @epignosis_llc/gnosis
```

重新推荐的字体家族是 `"Mulish", Arial, sans-serif` 因此请不要忘记包含它(当然你可以通过自定义主题来改变默认字体家族——下面是更多信息).

请注意: `react >= 16.0.0` 财务报告和审定财务报表 `react-dom >= 16.0.0` 是同伴的依赖关系。 而且,情感11正在被使用,这不会在旧的情感项目中起作用.

## 使用量

开始将您的 App 包装为 `ThemeProvider` (见下文实例)。 所有其他组件MUST被放入"主题提供",以获得适当的主题上下文.

```jsx
import { ThemeProvider, Button } from "@epignosis_llc/gnosis";

function App() {
  return (
    <ThemeProvider>
      <Button>My Button</Button>
    </ThemeProvider>
  );
}
```

要查看每个组件的所有可用道具复制当前重播和运行 `npm install` 以安装所有依赖,然后 `npm start` 以全部可用的道具查看故事书中的所有组件.

## 主题

您可以使用 gnosis 主题默认主题( 颜色, 字体等) 或自定义以适应您的工程需要 。 本节介绍您可以用来修改它的各种选项.

### QQ 全球

您可以通过提供序列化样式来添加全局样式, 如下面的例子 :

```js
const globalStyles = {
  "html, body": {
    background: "red",
  },
  h1: {
    fontSize: "5rem",
    textAlign: "center",
  },
  "#my-id": {
    color: "green",
  },
  ".my-css-class": {
    color: "blue",
  },
};

<ThemeProvider globalStyles={globalStyles}></ThemeProvider>;
```

### QQ 主题配置

也可以简单地通过提供一个新的颜色主题来应用自己的品牌和颜色. 只要找到您需要更改的组件的主题配置 - 下面的示例是用于更改成功按钮颜色 - 并创建一个带有您新值的对象 。 新的主题配置会与默认主题合并,而最终合并的主题会将所有的新值应用到成功按钮(或任何其他组件)上. 默认主题的配置文件位于 `./src/theme/default/config/` 目录 - 例如按钮组件的默认主题是 `./src/theme/default/config/button.ts`。查看默认主题的配置并创建/配置您的新自定义主题.

```js
const myCustomTheme = {
  button: {
    success: {
      default: {
        background: "pink",
        borderColor: "red",
        color: "white",
      },
      hover: {
        background: "red",
        borderColor: "pink",
        color: "white",
      },
      active: {
        background: "red",
        borderColor: "pink",
        color: "white",
      },
    },
  },
};

<ThemeProvider theme={myCustomTheme}></ThemeProvider>;
```

## 图标

您可以使用这样的自定义 Svg 图标 :

```js
import { HomeSVG, CalendarSVG, CircleQuestionSVG } from "@epignosis_llc/gnosis/icons";

<HomeSVG height={32} />
<CalendarSVG height={32} />
<CircleQuestionSVG height={32} />
```

您可以查看所有可用的图标名称 `gnosis/src/icons/index.ts` 或者通过检查适当的故事书页.

## 即将到来的构成部分

-   [ ] 多选择
-   [ ] 图表
-   [ ] 输入日期
-   [ ] 文件输入

## 常见问题

### @epignosis\_llc/gnosis 是什么？

Epigosis官方反应设计系统\.

### 如何安装 @epignosis\_llc/gnosis？

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

### @epignosis\_llc/gnosis 支持 TypeScript 吗？

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

### @epignosis\_llc/gnosis 支持 ESM 还是 CommonJS？

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

### @epignosis\_llc/gnosis 需要什么版本的 Node\.js？

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

### @epignosis\_llc/gnosis 可以商用吗？

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

### @epignosis\_llc/gnosis 的下载量有多少？

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

### @epignosis\_llc/gnosis 还在维护吗？

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