# @chelone/react 中文文档

规范地址：https://npmcn.com/package/%40chelone/react/

版本：0\.11\.0
npm 元数据更新时间：2026-11-08T22:39:38.985Z
中文译文更新时间：2026-11-09T17:29:37.481Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：2.2 MB，889 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：19 个
- peer 依赖：zod ^3\.25\.0 \|\| ^4\.0\.0，react ^18 \|\| ^19，lowlight ^3\.3\.0，recharts ^3\.8\.0，dompurify ^3\.4\.0，papaparse ^5\.4\.0，react-dom ^18 \|\| ^19，@tiptap/pm ^3\.33\.0，terra-draw ^1\.39\.0，@turf/union ^7\.4\.0，maplibre-gl ^6，@dnd-kit/dom ^0\.5\.3，@tiptap/core ^3\.33\.0，@turf/buffer ^7\.4\.0，highlight\.js ^11\.11\.1，react-router ^7\.0\.0 \|\| ^8\.0\.0，@tiptap/react ^3\.33\.0，monaco-editor ^0\.57\.0，@dnd-kit/react ^0\.5\.3，@turf/simplify ^7\.4\.0，@turf/difference ^7\.4\.0，osm2geojson-lite ^2\.0\.1，@chelone/supabase 0\.11\.0，@mdxeditor/editor ^4\.3\.4，@tiptap/extensions ^3\.33\.0，@tiptap/suggestion ^3\.33\.0，@tiptap/starter-kit ^3\.33\.0，@monaco-editor/react ^4\.7\.0，@tanstack/react-query ^5\.0\.0，@tanstack/react-store ^0\.11\.0，@tanstack/react-router ^1\.0\.0，@tiptap/extension-image ^3\.33\.0，@tiptap/extension-code-block ^3\.33\.0，@tiptap/extension-text-style ^3\.33\.0，terra-draw-maplibre-gl-adapter ^1\.5\.0，@tiptap/extension-code-block-lowlight ^3\.33\.0
- 首次发布：2026-11-03T07:52:00.300Z
- 最新版本发布：2026-11-08T22:39:38.702Z
- 近 30 天下载量：2110（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

Chelone的回放适配器,无头管理引擎,以及其shadcn组件注册的出处.

## 安装

```sh
npm install @chelone/react
```

也可以使用：`pnpm add @chelone/react`、`yarn add @chelone/react`、`bun add @chelone/react`

## README

# @ chelone/反应

Chelone的回放适配器,无头管理引擎,以及其shadcn组件注册的出处.

```bash
pnpm add @chelone/react react react-dom react-router @tanstack/react-query @tanstack/react-store
```

## 可选切入点

下方的每个条目都需要其旁边列出的对等依赖,并且只有该条目会加载它们. 主条目不需要它们.

| 条目 | 可选同伴 |
| --- | --- |
| `@chelone/react/tanstack-router` | `@tanstack/react-router` |
| `@chelone/react/monaco` | `monaco-editor`, (中文(简体) ), `@monaco-editor/react` |
| `@chelone/react/charts` | `recharts` |
| `@chelone/react/kanban` | `@dnd-kit/react`, (中文(简体) ), `@dnd-kit/dom` |
| `@chelone/react/inspector` | `@dnd-kit/react` |
| `@chelone/react/mdx-editor` | `@mdxeditor/editor` |
| `@chelone/react/rich-text-input` | `@tiptap/core`, (中文(简体) ), `@tiptap/pm`, (中文(简体) ), `@tiptap/react`, (中文(简体) ), `@tiptap/starter-kit`, (中文(简体) ), `@tiptap/extensions`, (中文(简体) ), `@tiptap/extension-image`, (中文(简体) ), `@tiptap/extension-text-style`, (中文(简体) ), `@tiptap/extension-code-block`, (中文(简体) ), `@tiptap/extension-code-block-lowlight`, (中文(简体) ), `lowlight`, (中文(简体) ), `highlight.js`, (中文(简体) ), `dompurify` |
| `@chelone/react/block-editor` | `@tiptap/core`, (中文(简体) ), `@tiptap/pm`, (中文(简体) ), `@tiptap/react`, (中文(简体) ), `@tiptap/starter-kit`, (中文(简体) ), `@tiptap/extensions`, (中文(简体) ), `@tiptap/suggestion`, (中文(简体) ), `@dnd-kit/react`, (中文(简体) ), `@dnd-kit/dom`, (中文(简体) ), `recharts` |
| `@chelone/react/csv-import` | `papaparse` |
| `@chelone/react/maps` | `maplibre-gl` |
| `@chelone/react/maps/draw` | `maplibre-gl`, (中文(简体) ), `terra-draw`, (中文(简体) ), `terra-draw-maplibre-gl-adapter`, (中文(简体) ), `@turf/difference`, (中文(简体) ), `@turf/simplify` |
| `@chelone/react/maps/osm` | `maplibre-gl`, (中文(简体) ), `osm2geojson-lite`, (中文(简体) ), `@turf/buffer`, (中文(简体) ), `@turf/difference`, (中文(简体) ), `@turf/union` |
| `@chelone/react/supabase` | `@chelone/supabase` |

## 阴影登记册

从登记册中为您的项目添加组件 :

```bash
npx shadcn@latest add https://chelone.dev/r/<item>.json
```

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

## 常见问题

### @chelone/react 是什么？

Chelone的回放适配器,无头管理引擎,以及其shadcn组件注册的出处\.

### 如何安装 @chelone/react？

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

### @chelone/react 支持 TypeScript 吗？

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

### @chelone/react 支持 ESM 还是 CommonJS？

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

### @chelone/react 可以商用吗？

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

### @chelone/react 的下载量有多少？

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

### @chelone/react 还在维护吗？

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