---
title: "如何集成 Tiptap Pro 扩展？"
description: "Tiptap Pro 扩展为 Tiptap 编辑器添加高级功能，并从私人 Tiptap NPM 注册表安装。"
canonical_url: "https://tiptap.zhcndoc.com/guides/pro-extensions"
---

# 如何集成 Tiptap Pro 扩展？

Tiptap Pro 扩展为 Tiptap 编辑器添加高级功能，并从私人 Tiptap NPM 注册表安装。

Tiptap Pro 扩展为 Tiptap 编辑器提供高级功能，例如版本控制和 AI 辅助内容生成。访问 Pro 扩展需要一个 Tiptap 账户。选择扩展（如快照、评论和内容 AI 扩展）还需要一个活跃的订阅。

Tiptap Pro 和云扩展解锁协作、版本历史、评论、AI 辅助编辑等功能。您可以通过您的个人访问令牌从 Tiptap 的私人 NPM 注册表安装它们。

> **安全警告:**
>
> 请像对待密码一样对待您的身份验证令牌，以防止未授权使用。每个 Tiptap 用户都有
> 一个不过期的唯一身份验证令牌。我们建议为
> CI/CD 应用程序创建一个专用用户。

## 获取您的访问令牌

1. 登录您的 Tiptap 账户（或[注册](https://cloud.tiptap.dev/register)）。
2. 开始您的 [试用或订阅](https://cloud.tiptap.dev/v2/billing) Tiptap 计划。
3. 从 [我的功能 → Pro 扩展](https://cloud.tiptap.dev/v2/features/pro-extensions) 复制您的个人 NPM 令牌。

## 为每个项目配置身份验证

将注册表和令牌添加到项目根目录下的包管理器配置。

> **提示:**
>
> 将 `TIPTAP_PRO_TOKEN` 作为环境变量引用，避免提交凭据。

### npm、pnpm 或 Yarn 经典版

创建或更新 `.npmrc` 文件：

```
@tiptap-pro:registry=https://registry.tiptap.dev/
//registry.tiptap.dev/:_authToken=${TIPTAP_PRO_TOKEN}
```

### Yarn 现代版 (Yarn 2+)

创建或更新 `.yarnrc.yml` 文件：

```
npmScopes:
 tiptap-pro:
   npmAlwaysAuth: true
   npmRegistryServer: "https://registry.tiptap.dev/"
   npmAuthToken: ${TIPTAP_PRO_TOKEN}
```

将 `.npmrc` 或 `.yarnrc.yml` 添加到 `.gitignore`。

> **警告:**
>
> 这对于避免在配置文件中直接指定身份验证令牌而泄露凭据至关重要。

配置好项目身份验证后，您可以像安装其他编辑器扩展一样安装 Pro 扩展。

如果您使用环境变量，请在安装时传递身份验证令牌：

```
TIPTAP_PRO_TOKEN=实际的认证令牌 npm install --save @tiptap-pro/extension-comments
```

## 配置全局身份验证

您可以通过更新用户级别的包管理器配置文件为**所有**项目一次性设置身份验证。这对于 CI/CD 环境非常有用。

1. 登录您的 Tiptap 账户（或创建免费账户）。
2. 开始您的 [试用或订阅](https://cloud.tiptap.dev/v2/billing) Tiptap 计划。
3. （可选）[邀请团队成员](https://cloud.tiptap.dev/v2/team/members) 参与您的 CI/CD 流程。
4. 从 [我的功能 → Pro 扩展](https://cloud.tiptap.dev/v2/features/pro-extensions) 复制您的个人 NPM 令牌。

### npm 或 Yarn 经典版

```bash
npm config set "@tiptap-pro:registry" https://registry.tiptap.dev/
npm config set "//registry.tiptap.dev/:_authToken" 实际的认证令牌
```

### Yarn 现代版

```bash
yarn config set --home npmScopes.@tiptap-pro.npmRegistryServer "https://registry.tiptap.dev/"
yarn config set --home npmScopes.@tiptap-pro.npmAlwaysAuth "true"
yarn config set --home npmScopes.@tiptap-pro.npmAuthToken "实际的认证令牌"
```

### pnpm

```bash
pnpm config set --global "@tiptap-pro:registry" https://registry.tiptap.dev/
pnpm config set "//registry.tiptap.dev/:_authToken" 实际的认证令牌
```

现在您可以在任何代码库中安装任何 Tiptap Pro 扩展：

```
npm install --save @tiptap-pro/extension-comments
```