# @datalayer/reactor 中文文档

规范地址：https://npmcn.com/package/%40datalayer/reactor/

版本：1\.3\.5
npm 元数据更新时间：2026-11-07T09:09:02.100Z
中文译文更新时间：2026-11-11T14:48:54.234Z
软件包许可：BSD-3-Clause

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

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

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

- 包体积（解压后）：979 kB，274 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：zod \>=3\.23，react \>=18，react-dom \>=18，@module-federation/runtime \>=0\.8
- 首次发布：2026-07-19T11:48:12.305Z
- 最新版本发布：2026-11-07T09:09:01.722Z
- 近 30 天下载量：14224（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

具有框架不可知核和反应桥的延伸反应堆

## 安装

```sh
npm install @datalayer/reactor
```

也可以使用：`pnpm add @datalayer/reactor`、`yarn add @datalayer/reactor`、`bun add @datalayer/reactor`

## README

[![Datalayer](https://images.datalayer.io/legacy/datalayer-25.svg)](https://datalayer.ai/)

[![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor&message=%E2%9D%A4&logo=GitHub&style=flat&color=1ABC9C)](https://github.com/sponsors/datalayer)

# 反应堆

当一个特性跨越浏览器和 服务器:前端和后端插件系统通常对发现有分歧, 依赖性,生命周期,相容性和能动性. 团队重复 合同,硬线可选功能进入主机,必须协调 重建和部署,只是为了增加、去除或替换一种能力.

反应堆给JavaScript前端和Python后端一个可扩展模型, 灵感来自VS代码,Eclipse(OSGi)等被验证的插件系统.

[![Reactor Example Music](https://images.datalayer.io/products/reactor/reactor-example-music.png)](https://reactor.datalayer.tech/)

反应堆提供两个兄弟包:

-   `@datalayer/reactor` (TypeScript):插件运行时间,带有框架不可知的核心和独立的React集成.
-   `datalayer_reactor` ( PYPI 分发, 以 `reactor`: FastAPI + 插件插件反应堆用于模块扩展.

两层都实施同一种架构. 这就是写下来的意义 一次: 列表、 描述、 组或绘图插件的主机绝不需要 问一线从何处来.

## 页:1

**[反应堆 数据采集器 技术](https://reactor.datalayer.tech/)** - 万事俱备 在那里,只有那里,没有。 来源于 [`docs/`](https://npmcn.com/package/%40datalayer/reactor/docs)。 。 。 .

|  |  |
| --- | --- |
| [为什么反应堆](https://reactor.datalayer.tech/overview/why) | 钩子召回的目标是什么 |
| [建筑](https://reactor.datalayer.tech/overview/architecture) | 7个构件, 和两个区别 模型基于 |
| [在类型脚本中开始](https://reactor.datalayer.tech/getting-started/typescript) • 妇女 [以 Python 为单位](https://reactor.datalayer.tech/getting-started/python) | 安装并运行插件 |
| [类型脚本运行时间](https://reactor.datalayer.tech/typescript-plugins/) | 插件、 生命周期、 贡献点、 扩展、 激活、 懒惰装入、 远程插件、 允许的出处、 反应绑定、 信号 |
| [Python 运行时间](https://reactor.datalayer.tech/python-plugins/) | 清单、贡献点、扩展、租户、HTTP API |
| [跨层](https://reactor.datalayer.tech/cross-tier-dependencies/) | 插件可能声明对应方的什么, 为何不执行 |
| [联合会](https://reactor.datalayer.tech/federation/) | 从 URL 、 容器 和允许从哪里来的插件 |
| [Python 包装扩展](https://reactor.datalayer.tech/python-packaged-extensions/) | 一个 `pip install` 两层都装船,前端装入车轮 |

### 音乐商店,在页面中运行

**[反应堆.数据采集器.技术/实例/音乐/演示](https://reactor.datalayer.tech/examples/music/demo)** ——完全由插件组装的商店,每台插件都有切换功能 等级。 解开一个,看它给的休假.

## 仓库布局

| 路径 | 里面有什么东西 |
| --- | --- |
| `src/` | 类型脚本包源 `@datalayer/reactor` |
| `reactor/` | Python 软件包来源 `datalayer_reactor` |
| `plugins/` | 与运行时间一起运出可重复使用的插件 – the [管理器](https://reactor.datalayer.tech/core-plugins/manager) 编辑 [图表](https://reactor.datalayer.tech/core-plugins/graph) |
| `examples/` | 演示,包括 [音乐商店](https://npmcn.com/package/%40datalayer/reactor/examples/music) |
| `docs/` | 文档网站 |

## 开发

```bash
# TypeScript: the runtime and the bundled plugins.
npm install
npm run build
npm test
npm run typecheck

# Python.
python -m venv .venv
source .venv/bin/activate
pip install -e .
python -m reactor

# The music example, both tiers.
make music

# The documentation site.
cd docs && make install && make start
```

## 释放

见 [发 言](https://npmcn.com/package/%40datalayer/reactor/RELEASE.md)。 。 。 .

## 常见问题

### @datalayer/reactor 是什么？

具有框架不可知核和反应桥的延伸反应堆

### 如何安装 @datalayer/reactor？

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

### @datalayer/reactor 支持 TypeScript 吗？

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

### @datalayer/reactor 支持 ESM 还是 CommonJS？

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

### @datalayer/reactor 可以商用吗？

@datalayer/reactor 使用 BSD-3-Clause 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括，不构成法律意见，请以许可原文为准。

### @datalayer/reactor 的下载量有多少？

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

### @datalayer/reactor 还在维护吗？

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