--- url: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/guides/faq' title: 'FAQ | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T20:04:51+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: |- 如何向现有内容类型添加 DXPR Builder？ 请使用内容类型已有的长文本字段，例如 Body，或添加一个字段。然后将该字段的 Format 设为 DXPR Builder（在 Manage display 下）。不需要子模块；DXPR Builder 核心模块负责渲染。在内容类型上使用 DXPR Builder 中有具体步骤。 将鼠标悬停在内容区域上时，为什么不显示编辑控件？ 请按顺序检查以下各项： tags: - 'Get help' image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' published: true og: site_name: DXPR updated_time: '2026-10-24T20:04:51+0000' 'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.' schema: '@context': 'https://schema.org' '@graph': - mainEntity: { } - '@type': TechArticle headline: FAQ description: |- 如何向现有内容类型添加 DXPR Builder？ 请使用内容类型已有的长文本字段，例如 Body，或添加一个字段。然后将该字段的 Format 设为 DXPR Builder（在 Manage display 下）。不需要子模块；DXPR Builder 核心模块负责渲染。在内容类型上使用 DXPR Builder 中有具体步骤。 将鼠标悬停在内容区域上时，为什么不显示编辑控件？ 请按顺序检查以下各项： image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T20:04:51+0000' dateModified: '2026-10-24T20:04:51+0000' author: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' mainEntityOfPage: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/guides/faq' articleSection: 获取帮助 - '@type': WebPage '@id': 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/guides/faq' description: |- 如何向现有内容类型添加 DXPR Builder？ 请使用内容类型已有的长文本字段，例如 Body，或添加一个字段。然后将该字段的 Format 设为 DXPR Builder（在 Manage display 下）。不需要子模块；DXPR Builder 核心模块负责渲染。在内容类型上使用 DXPR Builder 中有具体步骤。 将鼠标悬停在内容区域上时，为什么不显示编辑控件？ 请按顺序检查以下各项： breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: 首页 item: 'https://dxpr.com/zh-hans' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: zh-hans --- [帮助中心](/zh-hans/node/75)/[文档](/zh-hans/hc/documentation) /[学习 DXPR Builder](/zh-hans/hc/documentation/learn-dxpr-builder) /[参考](/zh-hans/hc/documentation/learn-dxpr-builder/reference) /[获取帮助](/zh-hans/hc/documentation/learn-dxpr-builder/reference/get-help) # FAQ. 学习 DXPR Builder参考获取帮助 ## 本指南内容 ## 如何向现有内容类型添加 DXPR Builder？ 请使用内容类型已有的长文本字段，例如 **Body**，或添加一个字段。然后将该字段的 **Format** 设为 **DXPR Builder**（在 **Manage display** 下）。不需要子模块；DXPR Builder 核心模块负责渲染。[在内容类型上使用 DXPR Builder](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types) 中有具体步骤。 ## 将鼠标悬停在内容区域上时，为什么不显示编辑控件？ 请按顺序检查以下各项： 1. 您位于已保存的页面上，而不是编辑表单上。DXPR Builder 在页面本身上工作。 2. 您的角色拥有 **Edit with DXPR Builder** 权限（位于 `/admin/people/permissions`），并且可以编辑该内容。 3. 您的账户有有效的电子邮件地址。构建器不会为没有电子邮件地址的账户加载。 4. 免费版只允许一位编辑。更多编辑人员需要付费订阅。 5. 如果您的用户档案关闭了 **Start editor when page loads**，请先点击构建器工具栏上的眼睛图标。 ## 产品密钥控制什么？ 产品密钥将您的站点与您的 DXPR 账户关联，并决定您的许可数量（多少用户可以编辑）和内容项上限。请在 `/admin/dxpr_studio/dxpr_builder/settings` 输入它。请在 [dxpr.com/getting-started](/getting-started) 获取密钥。 ## 如何安全地存储产品密钥？ 请使用 Key 模块。请在 `/admin/config/system/keys` 使用 **File** 或 **Environment** 提供者创建一个密钥。然后，在 DXPR Builder 设置的 **License** 分区中，选择 **Key module** 作为 **Storage method** 并选择该密钥。使用 **Configuration** 提供者的密钥仍会进入配置导出。 ## DXPR Builder 是开源的吗？ Drupal 模块采用 GPL 许可，与 drupal.org 上的所有代码一样。只有编辑器的脚本会在有人编辑时从 DXPR CDN 加载。您的页面以标准 Bootstrap 5 HTML 保存在您自己的数据库中，访问者永远不会从 DXPR 服务器加载任何内容。 ## 如果取消订阅会怎样？ 您的站点继续正常运行，访问者仍能看到每个已发布的页面。免费版允许一位编辑和 100 个内容项。超出该上限的页面保持在线，但可视化编辑器不再在其上加载。请参见 [许可概览](/zh-hans/hc/documentation/learn-dxpr-builder/licensing/overview)。 ## DXPR Builder 需要 Bootstrap 吗？ DXPR Builder 生成 Bootstrap 5 HTML。如果您的主题已加载 Bootstrap 5，请将 **Sideload Bootstrap files** 设为 **None (theme provides Bootstrap)**（在 `/admin/dxpr_studio/dxpr_builder/settings` 中）。否则请选择 **Bootstrap 5**，DXPR Builder 会为您加载它。 ## 提供哪些 AI 功能？ 提供三项 AI 功能（每项可独立开关）： 1. **Text editing assistant**：内联 CKEditor 工具栏中的 AI 写作工具 2. **Page creation assistant**：根据文本描述生成完整页面布局 3. **Image generation**：根据文本提示词创建图像 这三项都需要 [AI](https://www.drupal.org/project/ai) 模块和 [DXPR AI Provider](https://www.drupal.org/project/ai_provider_dxpr)。请参见 [AI 功能指南](/zh-hans/hc/documentation/learn-dxpr-builder/ai)。 ## 如何设置 AI？ 1. 安装 `drupal/ai` 和 `drupal/ai_provider_dxpr` 2. 启用这两个模块，使用 `drush en ai ai_provider_dxpr` 3. 配置提供者：`/admin/config/ai/providers/dxpr` 4. 开关功能：`/admin/dxpr_studio/dxpr_builder/ai_settings` ## AI 积分如何运作？ 所有 AI 操作（文本编辑、页面创建、图像生成）都会消耗您 DXPR 订阅中的积分。请在 `/admin/dxpr_studio/dxpr_builder/ai_settings` 查看余额，或在 [dxpr.com/user/me/subscription/credits](/user/me/subscription/credits) 充值。 ## DXPR Builder AI 能处理现有内容吗？ 能。**Edit with AI** 可用于您之前构建的页面元素，构建器会将普通 Bootstrap 5 HTML 转换为可编辑元素。您无需先重建页面。 ## 可以撤销 AI 生成的更改吗？ 可以。AI 更改是撤销历史中的步骤，与其他编辑一样；请参见 [撤销与重做](/zh-hans/hc/documentation/learn-dxpr-builder/editing/undo-redo)。每次保存还会在保留修订的内容类型上创建 Drupal 修订。Diff 模块显示修订之间更改的内容。 ## 可以关闭 AI 功能吗？ 可以。请在 `/admin/dxpr_studio/dxpr_builder/ai_settings` 取消勾选 **Enable text editing assistant**、**Enable page creation assistant** 和 **Enable image generation**（在 **AI Features** 下）。没有 AI 模块时，构建器完全不显示 AI 功能，其他一切照常工作。 ## 页面模板和用户模板有什么区别？ **Page templates** 是由管理员在 `/admin/dxpr_studio/dxpr_builder/page_template` 管理的整页布局。编辑人员在空白页面上通过 **Choose a template** 选择其一。 **User templates** 是编辑人员在编辑器内保存的可复用版块，可以是私有（仅创建者可见）或全局（所有用户可见），显示在元素选择器的 **Saved templates** 选项卡上。全局模板在 `/admin/dxpr_studio/dxpr_builder/user_templates` 管理。 请参见 [Templates](/zh-hans/hc/documentation/learn-dxpr-builder/reusable-templates) 指南。 ## 用户档案如何工作？ 用户档案让您可以控制每个角色看到的元素、区块、视图、模板、图标集和文本编辑器按钮。请在 `/admin/dxpr_studio/dxpr_builder/profile` 创建档案，将其分配给角色，并配置可用功能。当用户匹配多个档案时，权重最低的档案生效。请参见 [用户档案指南](/zh-hans/hc/documentation/learn-dxpr-builder/admin/user-profiles-admin)。 ## 为什么新创建的区块、视图和模板不显示在元素选择器中？ 用户档案列出其允许的区块、视图、页面模板和全局用户模板。当列表的全选框（例如 **Check/Uncheck all Blocks**）被勾选时，新项目会自动出现。否则新项目保持隐藏：请在 `/admin/dxpr_studio/dxpr_builder/profile` 编辑档案，并在相关分区中勾选它们。 ## 可以将 DXPR Builder 与 Drupal 的 Layout Builder 一起使用吗？ DXPR Builder 作用于单个字段（通常是 Body 字段），而不是 Drupal 的 Layout Builder。两者用途不同：Layout Builder 管理页面的整体布局（区域和区块），而 DXPR Builder 在字段内提供丰富的内容编辑。您可以在同一站点、甚至同一页面上同时使用两者：DXPR CMS 将其构建器字段放在 Layout Builder 布局中。 ## 如何创建全宽版块？ 1. 添加 **Section** 元素（位于 **Layout** 选项卡）。 2. 在版块上打开 **More** 并选择 **Settings** 3. 打开 **Full width**（在 **General** 面板中）并点击 **Save** 4. 在版块内添加 **Row**，然后在行内添加您的内容 **Full width** 让行填满版块，从一边到另一边。只有当字段周围的主题区域也是全宽时，版块本身才能触及窗口边缘。请参见 [全宽布局](/zh-hans/hc/documentation/learn-dxpr-builder/design/full-width-layouts)。 ## 提供哪些图标集？ DXPR Builder 附带 14 个图标集：Bootstrap Icons、ET Line Icons、Font Awesome（v4 compat、Brands、Regular、Solid）、Glyphicon Halflings 和 Pixeden Line Icons。另外六个是 Phosphor Icons 变体：Regular、Bold、Duotone、Fill、Light 和 Thin。请在 `/admin/dxpr_studio/dxpr_builder/profile` 控制每个用户档案可用的图标集。 ## 如何更新 DXPR Builder？ ```bash composer update drupal/dxpr_builder --with-dependencies drush updatedb drush cr ``` 更新后请务必运行 `drush updatedb`；DXPR Builder 包含在版本之间迁移设置的数据库更新钩子。[更新 DXPR Builder](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/updating) 介绍了备份和回滚。 ## 接下来做什么？ [DXPR Builder 入门](/zh-hans/hc/documentation/learn-dxpr-builder/start-here/install)，继续探索 DXPR Builder。