# @bigbinary/neeto-integrations-frontend 中文文档

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

版本：4\.2\.3
npm 元数据更新时间：2026-11-03T19:27:19.070Z
中文译文更新时间：2026-11-08T02:00:29.896Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40bigbinary/neeto-integrations-frontend
原文对照：https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/?lang=original
项目主页：https://github.com/bigbinary/neeto-integrations-nano

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

- 包体积（解压后）：2 MB，213 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.13
- 运行依赖：3 个
- peer 依赖：qs 6\.16\.2，url 0\.11\.4，yup 0\.32\.11，antd 5\.22\.1，util ^0\.12\.5，axios 1\.20\.0，ramda 0\.29\.0，react 18\.3\.1，buffer ^6\.0\.3，formik 2\.4\.6，i18next 22\.5\.1，zustand 4\.4\.2，dompurify 3\.4\.17，js-logger 1\.6\.1，react-dom 18\.3\.1，classnames 2\.5\.1，react-query ^3\.39\.3，stream-http 3\.2\.0，tailwindcss ^4\.1\.17，lucide-react ^0\.577\.0，react-helmet ^6\.1\.0，os-browserify 0\.3\.0，react-i18next 12\.3\.1，vm-browserify 1\.1\.2，@babel/runtime 7\.29\.7，react-toastify 8\.0\.2，tty-browserify 0\.0\.1，path-browserify ^1\.0\.1，https-browserify 1\.0\.0，mixpanel-browser ^2\.45\.0，react-router-dom 5\.3\.3，crypto-browserify 3\.12\.1，source-map-loader 4\.0\.1，stream-browserify ^3\.0\.0，@bigbinary/neetoui 8\.8\.3，@honeybadger-io/js 6\.10\.1，@bigbinary/neeto-cist 1\.0\.17，@honeybadger-io/react 6\.1\.25，@tanstack/react-query 5\.59\.20，@bigbinary/neeto-atoms 1\.1\.2，@bigbinary/neeto-icons 1\.20\.89，@bigbinary/neeto-molecules 5\.10\.1，@tailwindcss/container-queries ^0\.1\.1，@tanstack/react-query-devtools 5\.59\.20，@bigbinary/neeto-commons-frontend 4\.14\.8，@bigbinary/neeto-filters-frontend 4\.7\.1
- 首次发布：2023-06-21T13:50:13.169Z
- 最新版本发布：2026-11-03T19:27:18.883Z
- 近 30 天下载量：26130（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：132（近 12 个月 66 个）

## 中文简介

尼托产品集成的UI

## 安装

```sh
npm install @bigbinary/neeto-integrations-frontend
```

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

## README

# 必须融入-无

这个 `neeto-integrations-nano` 为第三方合并提供支助 需要申请。 纳米出口 `@bigbinary/neeto-integrations-frontend` 国家防范机制一揽子计划 `neeto-integrations-engine` 铁路发动机促进发展..

引擎处理认证、 Webhoks 和令牌管理 与下列提供者的融合.

-   Meta (Facebook, Instagram, WhatsApp) (英语)
-   谷歌 (Analytics, YouTube) (英语)
-   微软(MS团队)
-   扎皮尔
-   特维利奥

主机可以为支持的第三方整合提供所需的权限, 然后,引擎将处理认证、信使存储和刷新 主持人。 脚本、帐号细节和 Webhook 订阅细节存储于 由引擎处理的表格.

前端包提供组件处理集成卡,步骤, 断开连接和其他集成配置页面支持.

## 目录

1.  [带有主机应用程序的开发](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/#readme-development-with-host-application)
    -   [发动机](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/#readme-engine)
        -   [安装](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/#readme-installation)
        -   [细节](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/#readme-details)
        -   [目前使用此引擎的产品 neto](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/#readme-neeto-products-currently-using-this-engine)
    -   [前端软件包](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/#readme-frontend-package---bigbinaryneeto-integrations-frontend)
        -   [安装](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/#readme-installation-1)
        -   [使用量](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/#readme-usage)
        -   [产品集成](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/#readme-product-integrations)
2.  [出版说明](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/#readme-instructions-for-publishing)

## 带有主机应用程序的开发

### 发动机

#### 安装

1.  将宝石添加到您的 `Gemfile`。 。 。 .

```ruby
source "NEETO_GEM_SERVER_URL" do
  gem "neeto-integrations-engine"
end
```

2.  运行 `bundle install`
    
3.  将所需的嵌入变量添加到 `.env.development` 更新您的 `secrets.yml`。参考 [OAuth 配置](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/engine/oauth-config.md) 为了更多 具体整合的细节.
    
4.  导入您的项目迁移 :
    

```bash
bundle exec rails neeto_integrations_engine:install:migrations
```

5.  添加迁移到数据库 :

```bash
bundle exec rails db:migrate
```

6.  将所需的整合列表添加到 `config/neeto_integrations.yml`此外, 添加所需的集成( 并非由引擎本地支持) 为 `other_applications` 用于后集成用户界面支持.

```yml
applications:
  - title: "Instagram Chat"
    service_name: Instagram
    provider: Facebook
    service_type: Social
    scope:
      - email
      - public_profile
      - pages_show_list
      - instagram_manage_messages
      - instagram_basic
other_applications:
  - title: "neetoDesk"
    service_name: neetoDesk
    service_type: Support
    provider: neeto
```

参考 [奥思配置](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/engine/oauth-config.md) 用于支持的列表 `provider`, (中文(简体) ), `service_name` 财务报告和审定财务报表 `service_type`。 。 。 .

7.  导入数据迁移以更新与新添加的集成列表 从 `config/neeto_integrations.yml`数字 :

```bash
bundle exec rails generate neeto_integrations_engine:integrations_list:update
```

或者在所有环境中手动执行以下命令来更新 整合列表. 虽然建议采用上述办法.

```bash
bundle exec rails neeto_integrations_engine:integrations_list:update
```

8.  内托山集成到您的 `routes.rb`数字 :

```ruby
mount NeetoIntegrationsEngine::Engine, at: "/neeto_integrations"
```

9.  对于短消息集成(Twilio/Telnyx):绘制主机中的dev短消息路径 应用程序 `routes.rb`。如果应用程序不使用短消息,则跳过此步骤 一体化.

```ruby
NeetoCommonsBackend::Routes.draw :dev_sms # Defined in neeto-commons-backend; local (dev/test) and transit envs only
```

在本地和中转环境中,引擎会捕捉出行的短消息进入 Redis 而不是打电话给Telnyx/Twilio。 这些路线(需要-普通-后端- 2.20.8) 曝光抓获的信息 `/smsbox` 和通过 `api/v1/testing/sms` 页:1 开发与Playwright测试. 别的环境下都不行.

注:连接Telnyx/Twilio集成仍需要真正的证书—— 抓取只截取出入口的短消息,这些短消息存储在 Redis并显示 内 `/smsbox` 而不是通过提供者发送.

为了能捕捉到,在 `.env.local` 文件 :

```
RECORD_SMS_DELIVERIES=true
```

10.  添加关联到 `User` 模式 :

```ruby
has_many :auth_requests, class_name: "NeetoIntegrationsEngine::AuthRequest", dependent: :destroy
```

11.  添加关联到 `Organization` 模式 :

```ruby
has_many :integrated_apps, class_name: "NeetoIntegrationsEngine::IntegratedApp", dependent: :destroy
```

12.  如果你想要你的整合 特定于其他模式,比如 `User`, (中文(简体) ), `Form` 等,添加关联如下:

```ruby
has_many :integrated_apps, as: :integrable, class_name: "NeetoIntegrationsEngine::IntegratedApp", dependent: :destroy
```

13.  添加 `neeto_integrations_engine.organization.manage_integrations` 权限 给您的 `permissions.yml` 授权用户管理的文件 组织一级的一体化.

#### 细节

-   [终点](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/engine/endpoints.md)
-   [错误](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/engine/errors.md)
-   [团队证书和整合信息](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/engine/ms-teams.md)
-   [Telnyx 集成设置](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/engine/telnyx.md)
-   [短消息日志](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/engine/sms-logs.md)

#### 目前使用此引擎的产品 neto

| 产品 | 集成(用于生产) | 一体化(目前处于发展/发展阶段) |
| --- | :-: | :-: |
| 需要聊天时 | : x : | Instagram, WhatsApp, Twilio, Zapier, MS Teams 互联网档案馆的存檔,存档日期2013-12-02 |
| 社会需要 | (英文)Instagram (page), Facebook (page), Google (分析, YouTube), 推特 | : x : |
| 需要卡尔 | MS 团队 | : x : |
| 需要论坛 | : x : | MS 团队 |

### 前端软件包 - @ bigbinary/ neto- integrations- 前端

![npm](https://img.shields.io/npm/v/@bigbinary/neeto-integrations-frontend?color=greenyellow) ![npm](https://img.shields.io/npm/dw/@bigbinary/neeto-integrations-frontend?color=greenyellow)

用于所有neto产品的整合.

#### 安装

```bash
yarn add @bigbinary/neeto-integrations-frontend
```

#### 使用量

可用组件 :

-   构成部分
    -   [纸牌](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/Card/README.md)
    -   [连接](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/connect/README.md)
    -   [日报.co](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/daily.co/README.md)
    -   [演示](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/demo/README.md)
    -   [断开连接](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/DisconnectAlert/README.md)
    -   [完成](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/finish/README.md)
    -   [谷歌日历](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/GoogleCalendar/README.md)
    -   [模式](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/Modal/README.md)
    -   [特维利奥](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/twilio/README.md)
    -   [泰勒尼克斯语Name](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/telnyx/README.md)
    -   [走过莫达尔](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/WalkthroughModal/README.md)
    -   [缩放](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/components/zoom/README.md)
-   [出口和类型](https://npmcn.com/package/%40bigbinary/neeto-integrations-frontend/docs/frontend/exports-and-types.md)

#### 产品集成

| 项目 | 整合前端 |
| --- | :-: |
| 需要聊天时 | : 白色 检查 标记 : |
| 必须去德士克 | : 白色 检查 标记 : |
| 需要论坛 | : 白色 检查 标记 : |
| 需要发声 | : 白色 检查 标记 : |
| 需要KB吗 | : 白色 检查 标记 : |
| 需要监视 | : 白色 检查 标记 : |
| 需要卡尔 | : 白色 检查 标记 : |

### 发展指示

检查 [前端软件包开发指南](https://neeto-engineering.neetokb.com/p/a-d34cb4b0) 用于开发前端软件包的分步指令.

## 出版指令

咨询 [构建和释放软件包](https://neeto-engineering.neetokb.com/articles/building-and-releasing-packages) 关于如何出版的详细指南.

## 常见问题

### @bigbinary/neeto-integrations-frontend 是什么？

尼托产品集成的UI

### 如何安装 @bigbinary/neeto-integrations-frontend？

在项目目录运行 npm install @bigbinary/neeto-integrations-frontend，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：qs（6\.16\.2）、url（0\.11\.4）、yup（0\.32\.11）、antd（5\.22\.1）、util（^0\.12\.5）、axios（1\.20\.0）、ramda（0\.29\.0）、react（18\.3\.1）、buffer（^6\.0\.3）、formik（2\.4\.6）、i18next（22\.5\.1）、zustand（4\.4\.2）、dompurify（3\.4\.17）、js-logger（1\.6\.1）、react-dom（18\.3\.1）、classnames（2\.5\.1）、react-query（^3\.39\.3）、stream-http（3\.2\.0）、tailwindcss（^4\.1\.17）、lucide-react（^0\.577\.0）、react-helmet（^6\.1\.0）、os-browserify（0\.3\.0）、react-i18next（12\.3\.1）、vm-browserify（1\.1\.2）、@babel/runtime（7\.29\.7）、react-toastify（8\.0\.2）、tty-browserify（0\.0\.1）、path-browserify（^1\.0\.1）、https-browserify（1\.0\.0）、mixpanel-browser（^2\.45\.0）、react-router-dom（5\.3\.3）、crypto-browserify（3\.12\.1）、source-map-loader（4\.0\.1）、stream-browserify（^3\.0\.0）、@bigbinary/neetoui（8\.8\.3）、@honeybadger-io/js（6\.10\.1）、@bigbinary/neeto-cist（1\.0\.17）、@honeybadger-io/react（6\.1\.25）、@tanstack/react-query（5\.59\.20）、@bigbinary/neeto-atoms（1\.1\.2）、@bigbinary/neeto-icons（1\.20\.89）、@bigbinary/neeto-molecules（5\.10\.1）、@tailwindcss/container-queries（^0\.1\.1）、@tanstack/react-query-devtools（5\.59\.20）、@bigbinary/neeto-commons-frontend（4\.14\.8）、@bigbinary/neeto-filters-frontend（4\.7\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @bigbinary/neeto-integrations-frontend 支持 TypeScript 吗？

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

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

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

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

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

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

@bigbinary/neeto-integrations-frontend 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

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

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

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

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

