如何集成 Tiptap Pro 扩展？

EditorContent AICollaborationDocuments

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

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

安全警告

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

获取您的访问令牌

登录您的 Tiptap 账户（或注册）。
开始您的试用或订阅 Tiptap 计划。
从我的功能 → Pro 扩展复制您的个人 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 环境非常有用。

登录您的 Tiptap 账户（或创建免费账户）。
开始您的试用或订阅 Tiptap 计划。
（可选）邀请团队成员参与您的 CI/CD 流程。
从我的功能 → Pro 扩展复制您的个人 NPM 令牌。

npm 或 Yarn 经典版

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

Yarn 现代版

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

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