# @apache-superset/core 中文文档

规范地址：https://npmcn.com/package/%40apache-superset/core/

版本：0\.1\.0
npm 元数据更新时间：2026-05-11T17:09:47.433Z
中文译文更新时间：2026-11-06T10:31:39.645Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：213 kB，114 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@emotion/cache ^11\.4\.0，@emotion/react ^11\.4\.1，@emotion/styled ^11\.14\.1，@fontsource/ibm-plex-mono ^5\.2\.7，@fontsource/inter ^5\.2\.6，nanoid ^5\.0\.9，react ^17\.0\.2，react-dom ^17\.0\.2，react-loadable ^5\.5\.0，tinycolor2 \*，lodash ^4\.17\.21，antd ^5\.26\.0，jed ^1\.1\.1
- 首次发布：2025-08-26T19:14:43.480Z
- 最新版本发布：2026-05-11T17:09:47.263Z
- 近 30 天下载量：3463（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 10 个）

## 中文简介

这个软件包包含UI元素,API,以及Superset使用的公用功能.

## 安装

```sh
npm install @apache-superset/core
```

也可以使用：`pnpm add @apache-superset/core`、`yarn add @apache-superset/core`、`bun add @apache-superset/core`

## README

# @ apache- 超集/ 核心

[![npm version](https://badge.fury.io/js/%40apache-superset%2Fcore.svg)](https://badge.fury.io/js/%40apache-superset%2Fcore) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

用于构建Apache Superset扩展和集成的官方核心包. 这个软件包为主机应用程序和扩展提供了包括共享的UI组件,公用功能,API,以及类型定义在内的基本构件.

## \* 安装

```bash
npm install @apache-superset/core
```

## QQ 软件包结构

该源被组织成有重点的命名空间,各自在自己的目录中:

```
src/
├── authentication/
├── commands/
├── common/
├── components/
├── contributions/
├── editors/
├── extensions/
├── menus/
├── sqlLab/
├── theme/
├── translation/
├── utils/
├── views/
└── index.ts
```

## QQ 快速启动

前端贡献从您的扩展切入点注册为模块级副作用.

### 视图

在应用程序中的特定位置添加自定义面板或 UI 组件 :

```tsx
import { views } from '@apache-superset/core';
import MyPanel from './MyPanel';

views.registerView(
  { id: 'my-extension.main', name: 'My Panel Name' },
  'sqllab.panels',
  () => <MyPanel />,
);
```

### 图标

定义可从菜单、键盘快捷键或代码中被触发的命名动作 :

```typescript
import { commands } from '@apache-superset/core';

commands.registerCommand(
  {
    id: 'my-extension.copy-query',
    title: 'Copy Query',
    icon: 'CopyOutlined',
    description: 'Copy the current query to clipboard',
  },
  () => {
    /* implementation */
  },
);
```

### 菜单

将命令附加到指定位置的初级、二级或上下文菜单中:

```typescript
import { menus } from '@apache-superset/core';

menus.registerMenuItem(
  { view: 'sqllab.editor', command: 'my-extension.copy-query' },
  'sqllab.editor',
  'primary',
);
```

### 编辑器

替换一个或多个语言的默认文本编辑器 :

```typescript
import { editors } from '@apache-superset/core';
import MonacoSQLEditor from './MonacoSQLEditor';

editors.registerEditor(
  {
    id: 'my-extension.monaco-sql',
    name: 'Monaco SQL Editor',
    languages: ['sql'],
  },
  MonacoSQLEditor,
);
```

## 许可证

根据Apache许可证第2.0版获得许可. 见 [自由主义](https://github.com/apache/superset/blob/master/LICENSE.txt) 详细情况.

## 链接

-   [社区](https://superset.apache.org/community/)
-   [GitHub 仓库](https://github.com/apache/superset)
-   [扩展文档](https://superset.apache.org/developer-docs/extensions/overview)

## 常见问题

### @apache-superset/core 是什么？

这个软件包包含UI元素,API,以及Superset使用的公用功能\.

### 如何安装 @apache-superset/core？

在项目目录运行 npm install @apache-superset/core，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@emotion/cache（^11\.4\.0）、@emotion/react（^11\.4\.1）、@emotion/styled（^11\.14\.1）、@fontsource/ibm-plex-mono（^5\.2\.7）、@fontsource/inter（^5\.2\.6）、nanoid（^5\.0\.9）、react（^17\.0\.2）、react-dom（^17\.0\.2）、react-loadable（^5\.5\.0）、tinycolor2（\*）、lodash（^4\.17\.21）、antd（^5\.26\.0）、jed（^1\.1\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @apache-superset/core 支持 TypeScript 吗？

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

### @apache-superset/core 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @apache-superset/core 可以商用吗？

@apache-superset/core 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @apache-superset/core 的下载量有多少？

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

### @apache-superset/core 还在维护吗？

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