# @ada-support/embed2 中文文档

规范地址：https://npmcn.com/package/%40ada-support/embed2/

版本：1\.16\.24
npm 元数据更新时间：2026-11-05T21:15:50.822Z
中文译文更新时间：2026-11-05T21:04:17.955Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40ada-support/embed2
原文对照：https://npmcn.com/package/%40ada-support/embed2/?lang=original
项目主页：https://github.com/AdaSupport/monorepo#readme
源码仓库：https://github.com/AdaSupport/monorepo

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

- 包体积（解压后）：886 kB，85 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：11 个
- 首次发布：2020-10-29T21:27:49.993Z
- 最新版本发布：2026-11-05T21:15:50.609Z
- 近 30 天下载量：21467（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：354（近 12 个月 72 个）

## 中文简介

嵌入2允许客户端在其网络应用中设置Ada Web Chat. 有关如何使用Embed的更多信息,请查看 [文档](https://docs.ada.cx/chat/web/getting-started)。 。 。 .

## 安装

```sh
npm install @ada-support/embed2
```

也可以使用：`pnpm add @ada-support/embed2`、`yarn add @ada-support/embed2`、`bun add @ada-support/embed2`

## README

# 嵌入 2

嵌入2允许客户端在其网络应用中设置Ada Web Chat. 有关如何使用Embed的更多信息,请查看 [文档](https://docs.ada.cx/chat/web/getting-started)。 。 。 .

## 1\. 安装

国家预防机制:

```
npm install @ada-support/embed2
```

亚伦:

```
yarn add @ada-support/embed2
```

这将安装 Embed 2 软件包, 它是依赖性 .

## 2\. 使用费

首先,将嵌入 2 导入您的 App :

```
import adaEmbed from "@ada-support/embed2";
```

第二,在DOM准备好后将代码放入下方开始嵌入 2 :

```
adaEmbed.start({
  handle: "bot-handle",
});
```

在上述例子中 `handle` 键是 `AdaSettings`为进一步了解其他设置,请参考 [API 参考](https://docs.ada.cx/chat/web/sdk-api-reference)。 。 。 .

## 常见问题

### @ada-support/embed2 是什么？

嵌入2允许客户端在其网络应用中设置Ada Web Chat\. 有关如何使用Embed的更多信息,请查看 文档。 。 。 \.

### 如何安装 @ada-support/embed2？

在项目目录运行 npm install @ada-support/embed2，或使用 pnpm add / yarn add / bun add。

### @ada-support/embed2 支持 TypeScript 吗？

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

### @ada-support/embed2 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @ada-support/embed2 需要什么版本的 Node\.js？

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

### @ada-support/embed2 可以商用吗？

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

### @ada-support/embed2 的下载量有多少？

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

### @ada-support/embed2 还在维护吗？

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