# @bigbinary/neeto-editor 中文文档

规范地址：https://npmcn.com/package/%40bigbinary/neeto-editor/

版本：1\.47\.157
npm 元数据更新时间：2026-10-07T06:55:45.507Z
中文译文更新时间：2026-11-08T02:37:09.586Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40bigbinary/neeto-editor
原文对照：https://npmcn.com/package/%40bigbinary/neeto-editor/?lang=original
源码仓库：https://github.com/bigbinary/neeto-editor

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

- 包体积（解压后）：28.3 MB，219 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.13
- 运行依赖：0 个
- peer 依赖：qs 6\.11\.2，yjs ^13\.6\.18，yup ^0\.32\.11，antd 4\.24\.3，util 0\.12\.5，axios 1\.15\.0，ramda ^0\.29\.1，react ^18\.2\.0，formik ^2\.4\.5，i18next ^23\.6\.0，zustand 4\.3\.2，tippy\.js 6\.3\.7，dompurify ^2\.4\.0，js-logger ^1\.6\.1，react-dom ^18\.2\.0，classnames ^2\.3\.2，emoji-mart 5\.2\.2，autoprefixer 10\.4\.16，lucide-react ^0\.577\.0，react-helmet ^6\.1\.0，ua-parser-js ^2\.0\.3，linkify-react ^4\.1\.3，react-i18next ^13\.3\.1，@babel/runtime 7\.23\.2，@tippyjs/react 4\.2\.6，react-colorful 5\.6\.1，react-dropzone 14\.3\.8，react-toastify ^8\.2\.0，avvvatars-react 0\.4\.2，react-resizable 3\.0\.4，react-router-dom ^5\.3\.4，@bigbinary/neetoui \*，@honeybadger-io/js ^6\.5\.3，@rails/actioncable 7\.2\.100，react-drag-listview 2\.0\.0，@rails/activestorage 7\.0\.8-3，@bigbinary/neeto-cist \*，@honeybadger-io/react ^6\.1\.9，@tanstack/react-query 5\.59\.20，@bigbinary/neeto-atoms 1\.0\.144，@bigbinary/neeto-icons \*，@bigbinary/neeto-hotkeys 1\.0\.4，@bigbinary/neeto-molecules 5\.5\.2，@bigbinary/neeto-time-zones \*，@bigbinary/babel-preset-neeto \*，@tailwindcss/container-queries ^0\.1\.1，@bigbinary/neeto-commons-frontend \>=4\.13\.126，@bigbinary/neeto-filters-frontend 3\.3\.1，@wojtekmaj/react-timerange-picker 5\.5\.0，@bigbinary/neeto-team-members-frontend 5\.1\.6，@bigbinary/neeto-image-uploader-frontend 4\.0\.5
- 首次发布：2021-08-30T07:17:29.347Z
- 最新版本发布：2026-10-07T06:55:45.325Z
- 近 30 天下载量：2071（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：738（近 12 个月 88 个）

## 中文简介

needo Editor是驱动 BigBinary 所建所有 Needo 产品的丰富文本体验的图书馆

## 安装

```sh
npm install @bigbinary/neeto-editor
```

也可以使用：`pnpm add @bigbinary/neeto-editor`、`yarn add @bigbinary/neeto-editor`、`bun add @bigbinary/neeto-editor`

## README

# 新编辑器

这个 **需要编辑** 库驱动丰富的文本体验 [产品](https://neeto.com/) 建造于 [大边形](https://www.bigbinary.com/)。 。 。 .

## 安装

```
yarn add @bigbinary/neeto-editor
```

用于设置图像上传参考 https://neeto-editor.neeto.com/?path=/docs/examples-customize-options-addons-addons. 页面存档备份,存于互联网档案馆.

## 发展指示

通过执行以下命令安装所有依赖 .

```
yarn
```

运行 `yarn storybook` 命令启动故事本应用程序。 使用这个 用于测试更改的应用程序.

在开发前端软件包时,使用主机应用程序测试活环境的变化至关重要. 这样做有两种方法:

1.  使用 yalc 包管理器 : [https://youtu.be/F4zZFnrNTq8 请检查isbn=值 (帮助)](https://youtu.be/F4zZFnrNTq8)

> 注:如果使用雅尔克语,则需要运行 `yarn bundle` 在对软件包进行修改之后 `yarn build` 视频中描述的.

2.  直接更新主机应用程序的节点 模块.
    
    1.  启动主机应用程序服务器
        
    2.  在软件包内,执行命令:
        
        ```
          yarn bundle --watch --app ../neeto-site-web
        ```
        
        在此用主机项目的路径来替换./需要站点-web .
        
        现在,任何对netoEditor代码库的修改都会立即被反映在UI中.
        
    3.  删除本地安装
        
        运行以下命令以重置为初始状态 .
        
        ```
        yarn install --check-files
        ```
        
    4.  翻译文件更改( 可选)
        
        需要编辑的翻译文件中的修改不会自动更新UI. 为核实这些变化,请更新您的 neto-site-web/app/javascript/packs/application.js 文件,其代码如下:
        
        ```
        import en from "translations/en.json";
        
        import editorEn from "neetofilters/app/javascript/src/translations/en.json";
        
        import { mergeDeepLeft } from "ramda";
        
        initializeApplication({
          translationResources: { en: { translation: mergeDeepLeft(editorEn, en) } },
        });
        ```
        

## 出版指令

### 软件包发布进程

将标记为补丁、次要或主干件的PR合并到主分支后,将发布一个软件包。 补丁标签地址为错误修正, 小符号表示新特性的添加, 并主要表示断开更改, 坚持其中概述的原则 [语义版 (SemVer)](https://semver.org/)。 。 。 .

您可以在 GitHub 动作中检查并发布发布工作流程, 以获取实时更新 .

### 手册软件包出版

如果您错过了添加标签,可以手动发布软件包. 为此,首先需要创建一个PR来更新软件包.json文件中的版本号并合并到主分支. 合并公关后,您需要创建 [新 GitHub 发布](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) 从主分支。 当新版本号创建出新版本时,GitHub动作会自动将已建软件包发布到npm. 您可以在 GitHub 动作中查看 Publish to npm 工作流程以获取实时更新 .

> 注意: 在发布软件包之前, 您必须验证主机应用程序中的功能 [当地](https://npmcn.com/package/%40bigbinary/neeto-editor/#readme-instructions-for-development)。 。 。 .

## 文档

在这里阅读文件 : [https://neeto-editor.neeto.com (中文(简体) )](https://neeto-editor.neeto.com/)。 。 。 .

## 常见问题

### @bigbinary/neeto-editor 是什么？

needo Editor是驱动 BigBinary 所建所有 Needo 产品的丰富文本体验的图书馆

### 如何安装 @bigbinary/neeto-editor？

在项目目录运行 npm install @bigbinary/neeto-editor，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：qs（6\.11\.2）、yjs（^13\.6\.18）、yup（^0\.32\.11）、antd（4\.24\.3）、util（0\.12\.5）、axios（1\.15\.0）、ramda（^0\.29\.1）、react（^18\.2\.0）、formik（^2\.4\.5）、i18next（^23\.6\.0）、zustand（4\.3\.2）、tippy\.js（6\.3\.7）、dompurify（^2\.4\.0）、js-logger（^1\.6\.1）、react-dom（^18\.2\.0）、classnames（^2\.3\.2）、emoji-mart（5\.2\.2）、autoprefixer（10\.4\.16）、lucide-react（^0\.577\.0）、react-helmet（^6\.1\.0）、ua-parser-js（^2\.0\.3）、linkify-react（^4\.1\.3）、react-i18next（^13\.3\.1）、@babel/runtime（7\.23\.2）、@tippyjs/react（4\.2\.6）、react-colorful（5\.6\.1）、react-dropzone（14\.3\.8）、react-toastify（^8\.2\.0）、avvvatars-react（0\.4\.2）、react-resizable（3\.0\.4）、react-router-dom（^5\.3\.4）、@bigbinary/neetoui（\*）、@honeybadger-io/js（^6\.5\.3）、@rails/actioncable（7\.2\.100）、react-drag-listview（2\.0\.0）、@rails/activestorage（7\.0\.8-3）、@bigbinary/neeto-cist（\*）、@honeybadger-io/react（^6\.1\.9）、@tanstack/react-query（5\.59\.20）、@bigbinary/neeto-atoms（1\.0\.144）、@bigbinary/neeto-icons（\*）、@bigbinary/neeto-hotkeys（1\.0\.4）、@bigbinary/neeto-molecules（5\.5\.2）、@bigbinary/neeto-time-zones（\*）、@bigbinary/babel-preset-neeto（\*）、@tailwindcss/container-queries（^0\.1\.1）、@bigbinary/neeto-commons-frontend（\>=4\.13\.126）、@bigbinary/neeto-filters-frontend（3\.3\.1）、@wojtekmaj/react-timerange-picker（5\.5\.0）、@bigbinary/neeto-team-members-frontend（5\.1\.6）、@bigbinary/neeto-image-uploader-frontend（4\.0\.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @bigbinary/neeto-editor 支持 TypeScript 吗？

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

### @bigbinary/neeto-editor 支持 ESM 还是 CommonJS？

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

### @bigbinary/neeto-editor 需要什么版本的 Node\.js？

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

### @bigbinary/neeto-editor 可以商用吗？

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

### @bigbinary/neeto-editor 的下载量有多少？

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

### @bigbinary/neeto-editor 还在维护吗？

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

