# @chelone/vue 中文文档

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

版本：0\.12\.0
npm 元数据更新时间：2026-11-09T19:25:17.575Z
中文译文更新时间：2026-11-09T18:03:40.546Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：2.7 MB，1366 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：vue ^3\.4\.0，zod ^3\.25\.0 \|\| ^4\.0\.0，lowlight ^3\.3\.0，dompurify ^3\.4\.0，papaparse ^5\.4\.0，@tiptap/pm ^3\.33\.0，@unovis/ts ^1\.7\.1，terra-draw ^1\.39\.0，vue-router ^4\.0\.0 \|\| ^5\.0\.0，@turf/union ^7\.4\.0，@unovis/vue ^1\.7\.1，maplibre-gl ^6，@dnd-kit/dom ^0\.5\.3，@dnd-kit/vue ^0\.5\.3，@tiptap/core ^3\.33\.0，@turf/buffer ^7\.4\.0，highlight\.js ^11\.11\.1，@milkdown/kit ^7\.23\.0，@tiptap/vue-3 ^3\.33\.0，monaco-editor ^0\.57\.0，@turf/simplify ^7\.4\.0，@milkdown/crepe ^7\.23\.0，@turf/difference ^7\.4\.0，osm2geojson-lite ^2\.0\.1，@chelone/supabase 0\.12\.0，@tiptap/extensions ^3\.33\.0，@tiptap/suggestion ^3\.33\.0，@tanstack/vue-query ^5\.0\.0，@tiptap/starter-kit ^3\.33\.0，@tiptap/extension-image ^3\.33\.0，@guolao/vue-monaco-editor ^1\.6\.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.623Z
- 最新版本发布：2026-11-09T19:25:16.599Z
- 近 30 天下载量：2024（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

Vue 3适配器为Chelone,无头管理引擎,以及其shadcn-vue组件注册的来源.

## 安装

```sh
npm install @chelone/vue
```

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

## README

# @ chelone/ veue

Vue 3适配器为Chelone,无头管理引擎,以及其shadcn-vue组件注册的来源.

```bash
pnpm add @chelone/vue vue vue-router @tanstack/vue-query
```

## 可选切入点

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

| 条目 | 可选同伴 |
| --- | --- |
| `@chelone/vue/monaco` | `monaco-editor`, (中文(简体) ), `@guolao/vue-monaco-editor` |
| `@chelone/vue/charts` | `@unovis/vue`, (中文(简体) ), `@unovis/ts` |
| `@chelone/vue/kanban` | `@dnd-kit/vue`, (中文(简体) ), `@dnd-kit/dom` (需要3.5号) |
| `@chelone/vue/inspector` | `@dnd-kit/vue` (需要3.5号) |
| `@chelone/vue/mdx-editor` | `@milkdown/crepe`, (中文(简体) ), `@milkdown/kit` |
| `@chelone/vue/rich-text-input` | `@tiptap/core`, (中文(简体) ), `@tiptap/pm`, (中文(简体) ), `@tiptap/vue-3`, (中文(简体) ), `@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/vue/block-editor` | `@tiptap/core`, (中文(简体) ), `@tiptap/pm`, (中文(简体) ), `@tiptap/vue-3`, (中文(简体) ), `@tiptap/starter-kit`, (中文(简体) ), `@tiptap/extensions`, (中文(简体) ), `@tiptap/suggestion`, (中文(简体) ), `@dnd-kit/vue`, (中文(简体) ), `@dnd-kit/dom` (需要3.5号), `@unovis/vue`, (中文(简体) ), `@unovis/ts` |
| `@chelone/vue/csv-import` | `papaparse` |
| `@chelone/vue/maps` | `maplibre-gl` |
| `@chelone/vue/maps/draw` | `maplibre-gl`, (中文(简体) ), `terra-draw`, (中文(简体) ), `terra-draw-maplibre-gl-adapter`, (中文(简体) ), `@turf/difference`, (中文(简体) ), `@turf/simplify` |
| `@chelone/vue/maps/osm` | `maplibre-gl`, (中文(简体) ), `osm2geojson-lite`, (中文(简体) ), `@turf/buffer`, (中文(简体) ), `@turf/difference`, (中文(简体) ), `@turf/union` |
| `@chelone/vue/supabase` | `@chelone/supabase` |

## 阴影测试注册

从 Vue 登记册中添加您的工程组件 。 反应登记册 `https://chelone.dev/r/` 共享项目名称, 如 `admin`,所以请使用 `/r/vue/` 路径 :

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

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

## 常见问题

### @chelone/vue 是什么？

Vue 3适配器为Chelone,无头管理引擎,以及其shadcn-vue组件注册的来源\.

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

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

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

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

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

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

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

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

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

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

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

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