---
url: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/reference/config-reference'
title: '配置参考 | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T08:21:14+00:00'
updated: '2026-10-24T09:09:48+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  DXPR Builder 将其配置存储在 Drupal 配置系统中。本页列出以下位置声明的每个键 config/schema/dxpr_builder.schema.yml
  带其类型、允许值和默认值。它还列出 status 每个配置实体的键，以及代码读取但无架构条目的设置键。粗体名称是表单标签。
  该模块不随附 config/install/dxpr_builder.settings.yml。默认值由 hook_install() 和 dxpr_builder.install 中的更新钩子设置，或在缺少键时由代码应用；默认值列说明是哪种情况。
  常规设置
  配置对象： dxpr_builder.settings
  管理路径：
  /admin/dxpr_studio/dxpr_builder/settings
  (src/Form/DxprBuilderSettingsForm.php)
tags:
  - 'Configuratie en API'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T09:09:48+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 配置参考
      description: |-
        DXPR Builder 将其配置存储在 Drupal 配置系统中。本页列出以下位置声明的每个键 config/schema/dxpr_builder.schema.yml
        带其类型、允许值和默认值。它还列出 status 每个配置实体的键，以及代码读取但无架构条目的设置键。粗体名称是表单标签。
        该模块不随附 config/install/dxpr_builder.settings.yml。默认值由 hook_install() 和 dxpr_builder.install 中的更新钩子设置，或在缺少键时由代码应用；默认值列说明是哪种情况。
        常规设置
        配置对象： dxpr_builder.settings
        管理路径：
        /admin/dxpr_studio/dxpr_builder/settings
        (src/Form/DxprBuilderSettingsForm.php)
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T08:21:14+0000'
      dateModified: '2026-10-24T09:09:48+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/reference/config-reference'
      articleSection: 'Configuratie en API'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/reference/config-reference'
      description: |-
        DXPR Builder 将其配置存储在 Drupal 配置系统中。本页列出以下位置声明的每个键 config/schema/dxpr_builder.schema.yml
        带其类型、允许值和默认值。它还列出 status 每个配置实体的键，以及代码读取但无架构条目的设置键。粗体名称是表单标签。
        该模块不随附 config/install/dxpr_builder.settings.yml。默认值由 hook_install() 和 dxpr_builder.install 中的更新钩子设置，或在缺少键时由代码应用；默认值列说明是哪种情况。
        常规设置
        配置对象： dxpr_builder.settings
        管理路径：
        /admin/dxpr_studio/dxpr_builder/settings
        (src/Form/DxprBuilderSettingsForm.php)
      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
---
[Help Center](/zh-hans/node/75)/[Documentation](/zh-hans/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Reference](/hc/documentation/learn-dxpr-builder/reference) /[Configuratie en API](/hc/documentation/learn-dxpr-builder/reference/config-and-api) # 配置参考.

 Learn DXPR BuilderReferenceConfiguratie en API

   ## In this guide

 Related guides

- [输入产品密钥和全站设置](/zh-hans/hc/documentation/learn-dxpr-builder/admin/general-settings)
- [Firewall and data residency](/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall)
- [API 端点](/zh-hans/hc/documentation/learn-dxpr-builder/reference/api-endpoints)

DXPR Builder 将其配置存储在 Drupal 配置系统中。本页列出以下位置声明的每个键 `config/schema/dxpr_builder.schema.yml`带其类型、允许值和默认值。它还列出 `status` 每个配置实体的键，以及代码读取但无架构条目的设置键。粗体名称是表单标签。

该模块不随附 `config/install/dxpr_builder.settings.yml`。默认值由 `hook_install()` 和 `dxpr_builder.install` 中的更新钩子设置，或在缺少键时由代码应用；**默认值**列说明是哪种情况。

## 常规设置

配置对象： `dxpr_builder.settings`

管理路径： `/admin/dxpr_studio/dxpr_builder/settings`(`src/Form/DxprBuilderSettingsForm.php`)

| 键 | 类型 | 可选值 | 默认值 | 描述 |
|---|---|---|---|---|
| `json_web_token` | string | DXPR 产品密钥（JWT） | empty | **Product key**，仅当 `api_key_storage` 为 `config`。密钥存入 Key 模块时清除；update 9026 清除遗留的值。 |
| `api_key_storage` | string | `config` (**Configuration storage**), `key` (**Key module**) | 未设置（视为 `config`); `key` 之后 `dxpr_builder_update_9020()` 移动现有密钥 | **Storage method** 用于产品密钥。 |
| `key_provider` | string | Key 实体 ID | empty; update 9020 sets `dxpr_builder_jwt` 当它移动现有密钥时 | **Key** 持有产品密钥的实体，条件为 `api_key_storage` 为 `key`. |
| `bootstrap` | string | `0`, `bs5` | 未设置（未加载 Bootstrap 文件） | **Sideload Bootstrap files**: `0` = **None (theme provides Bootstrap)**, `bs5` = **Bootstrap 5**。更新 8040 重写已移除的 `1` 和 `bs4` 值为 `bs5`. |
| `cke_stylesset` | string | One `[label]=[element].[class]` 每行一个条目 | empty（此时编辑器使用 DXPR Builder 自带的样式） | **Custom styles** 用于文本编辑器，例如 `Sassy Title=h1.sassy-title`. |
| `editor_assets_source` | integer | `0`, `1`, `2` | 未设置（`0`) | **Asset source**: `0` = **Cloud**, `1` = **Local (minified)**, `2` = **Local (unminified)**。仅当模块的以下位置存在本地构建时字段出现 `dxpr_builder/` 文件夹。当 `0` 已存储，仍使用此类构建，优先未压缩版。 |
| `format_filters` | boolean | `true`, `false` | 未设置（关闭） | **Apply text format filters to frontend content**. |
| `media_browser` | string | `''` (**Basic file upload**), `media_library` (**Media Library**), `media_library_acquia_dam` (**Media Library (Acquia DAM)**），或一个 Entity Browser ID | `media_library`（已安装 Media Library 模块时），否则 `dxpr_builder_media_modal`（已安装 `dxpr_builder_media` 时），否则 `''`（由 `hook_install()` 设置） | **Browser type** 图像字段使用。 |
| `offset_selector` | string | CSS 选择器 | `.dxpr-theme-header--sticky, .dxpr-theme-header--fixed`（为空时应用） | **Scroll offset selector** 用于固定页头。 |
| `controls_layout` | string | `element` (**On each element**), `breadcrumb` (**One row**) | `element`（为空时应用） | **Control bars** 编辑模式：每个元素上的条，或所指元素上方的一行。资料和用户自己的设置覆盖它。用户设置不是配置：它与用户账户一起存储（`user.data`，模块 `dxpr_builder`，名称 `controls_layout`). |

### AI 设置

存储在相同位置 `dxpr_builder.settings` 对象。

管理路径： `/admin/dxpr_studio/dxpr_builder/ai_settings`(`src/Form/DxprBuilderAiSettingsForm.php`)

| 键 | 类型 | 可选值 | 默认值 | 描述 |
|---|---|---|---|---|
| `ai_enabled` | boolean | `true`, `false` | `true` 缺失时；由 update 9008 设置 | **Enable text editing assistant**. |
| `ai_page_enabled` | boolean | `true`, `false` | `true` 缺失时；由 update 9012 设置 | **Enable page creation assistant**. |
| `ai_image_enabled` | boolean | `true`, `false` | `true` 缺失时；由 update 9015 设置 | **Enable image generation**. |
| `ai_user_model_selection` | boolean | `true`, `false` | `true` 缺失时；由 update 9016 设置 | **Allow users to choose model**。仅在以下情况显示 `ai_provider_dxpr` 未安装。 |
| `ai_model` | string | `dxai_kavya_m1`, `dxai_kavya_m1_eu`, `dxai_kavya_m1_fast` | `dxai_kavya_m1` (`AiModelConstants::getDefaultModel()`) | **Default model**。API 名称为 `kavya-m1`, `kavya-m1-eu` 和 `kavya-m1-fast`。仅在以下情况显示和保存 `ai_provider_dxpr` 未安装。 |
| `ai_provider_selection_mode` | string | `automatic` (**Automatic**), `manual` (**Manual priority**) | `automatic` | **Service providers** 模式。 `manual` 使用以下位置的顺序 `ai_providers`。仅在以下情况保存 `ai_provider_dxpr` 未安装。 |
| `ai_providers` | 以提供方 ID 为键的映射序列 | 键： `anthropic`, `gemini`, `mistral`, `openai`, `xai`。每个有 `enabled` （布尔值）， `weight` （整数）与 `region` (`enabled` 或 `disabled`) | empty（此时表单将五个全部列为已启用） | 以下内容的提供方优先级表 `manual` 模式。 `region` 是行所在的表格分区，而非地理区域。 |
| `tone_of_voice_vocabulary` | string | 分类词汇表 ID | `ai_tone_of_voice` （词汇表由 `hook_install()` 当 Taxonomy 启用时，以及通过更新 9007） | **Tone of voice vocabulary**。更新 9025 将值指回 `ai_tone_of_voice` 当存储的词汇表不再存在时。 |
| `enable_taxonomy_tones` | boolean | `true`, `false` | `true` 设置语气词汇表后 | 设为 `true` 带词汇表，通过 `hook_install()`，更新或表单。没有表单字段，也没有代码读取它。 |
| `commands_vocabulary` | string | 分类词汇表 ID | `ai_agent_commands` （由 `hook_install()` 当 Taxonomy 启用时，以及通过更新 9007，仅当键为空时） | **Commands vocabulary**. |
| `enable_taxonomy_commands` | boolean | `true`, `false` | `true` 设置命令词汇表后 | 设为 `true` 带词汇表，通过 `hook_install()`，更新 9007 或表单。没有表单字段，也没有代码读取它。 |
| `ai_output_allowed_domains` | text | 每行一个域名（允许 `*.wikipedia.org` 等通配符）；`*` 允许所有；empty 阻止所有外部 URL | `unsplash.com`, `images.unsplash.com`, `pexels.com`, `images.pexels.com`, `pixabay.com`, `promptahuman.com` （由 `hook_install()` 和更新 9013） | **Allowed domains**。取消勾选 **Filter AI output** 在表单上存储 `*`. |
| `ai_output_allowed_tags` | text | 每行一个 HTML 标签名 | 常见文本、列表、表格、内联、媒体和表单标签列表（`div` 到 `rp`），在键缺失时应用于表单 | **Allowed HTML tags**；未列出的标签去掉标记但保留文本。 |
| `ai_output_stripped_tags` | text | 每行一个 HTML 标签名 | `script`, `style` | **Blocked tags**，连同其内容一起移除。取消勾选 **Filter AI output** 存储默认值 `script` 和 `style`. |

### 代码读取但无表单字段的键

这些键不在架构中，但模块从以下位置读取 `dxpr_builder.settings`。通过以下方式设置它们 `drush config:set` 或以下位置的配置覆盖 `settings.php`.

| 键 | 类型 | 缺失时的默认值 | 描述 |
|---|---|---|---|
| `record_analytics` | boolean | `true` | 向以下位置发送编辑器使用分析 `tuur.dxpr.com` 为 true 时。 |
| `notifications` | boolean | `true` | 为 true 时在编辑器中显示 DXPR 通知。 |
| `cloud_url` | string | `https://cdn2.dxpr.com/VERSION/` | 编辑器资源的 CDN 基础 URL；`VERSION` 替换为模块版本。 |
| `license_endpoint` | string | `https://dxpr.com/api/central-user-storage/` | 许可用户同步端点。 |

## 页面模板

配置对象： `dxpr_builder.page_template.*`（实体类型 `dxpr_builder_page_template`)

管理路径： `/admin/dxpr_studio/dxpr_builder/page_template`

| 键 | 类型 | 可选值 | 默认值 | 描述 |
|---|---|---|---|---|
| `id` | string | 机器名 | required | 标识符。 |
| `label` | label | Any text | required | **Label**：模板选择器中显示的名称。 |
| `status` | boolean | `true`, `false` | `true` | **Enabled**。编辑器仅提供和加载已启用的模板。 |
| `category` | text | Any text | empty（表单中必填） | **Category** 模板分组所属的类别。 |
| `template` | string | DXPR Builder HTML | empty（表单中必填） | **Template** 标记。 |
| `weight` | integer | 任何整数 | empty（编辑器将其读为 `0`） | **Weight**：排序。 |
| `date` | integer | Unix 时间戳 | 编辑表单每次保存时设置 | 上次修改时间。 |
| `image` | string | Base64 编码的图像内容 | empty | **Image**：缩略图。 |
| `uuid` | string | UUID | generated | 全局唯一 ID。 |

该模块随附五个页面模板，位于 `config/install`: `about_me`, `about_us`, `homepage_basic`, `split_content_and_buttons` 和 `text_columns`.

## 用户资料

配置对象： `dxpr_builder.dxpr_builder_profile.*`（实体类型 `dxpr_builder_profile`)

管理路径： `/admin/dxpr_studio/dxpr_builder/profile`

在新资料上，表单勾选每个元素、区块、视图显示、已启用的页面模板、已启用的全局用户模板和图标集，以及一组默认文本编辑器按钮。以下默认值是实体自己的值。

| 键 | 类型 | 可选值 | 默认值 | 描述 |
|---|---|---|---|---|
| `id` | string | 机器名 | required | 标识符。 |
| `label` | label | Any text | required | **Label**：资料名称。 |
| `uuid` | string | UUID | generated | 全局唯一 ID。 |
| `status` | boolean | `true`, `false` | `true` | **用户资料已启用**。匹配用户角色时跳过禁用的资料。 |
| `sidebar` | boolean | `true`, `false` | 不存储 | 遗留键：在架构中声明但实体不导出，因此从不保存。 |
| `dxpr_editor` | boolean | `true`, `false` | `true`；update 8008 已在现有资料上设置该值 | **Start editor when page loads**。当 `false`，控件只在用户点击主容器控件上的眼睛图标后出现。 |
| `controls_layout` | string | `default` (**Same as the site**), `element` (**On each element**), `breadcrumb` (**One row**) | `default` | **Control bars** 此资料的编辑模式。用户自己的设置覆盖它。 |
| `weight` | integer | `-10` 到 `10` 表单中 | `0` | **Weight**：当用户的角色匹配多个启用的资料时，最低权重获胜。 |
| `roles` | 字符串序列 | 角色机器名（表单省略 `anonymous` 和 `authenticated`) | empty | **Roles** 资料适用的角色。 |
| `elements` | 字符串序列 | 元素机器名（`az_text`, `az_image`, ...) | empty | Allowed **Elements**. |
| `all_elements` | boolean | `true`, `false` | `false` | **Check/Uncheck all Elements**。当 `true`，允许所有元素，并且 `elements` 被忽略。 |
| `blocks` | 字符串序列 | `az_block-<block plugin id>` 值 | empty | 允许的 **Blocks**. |
| `all_blocks` | boolean | `true`, `false` | `false` | **Check/Uncheck all Blocks**。当 `true`，允许所有区块，包括后来添加的。 |
| `views` | 字符串序列 | `az_view-<view id>-<display id>` 值 | empty | 允许的 **Views** 显示。 |
| `all_views` | boolean | `true`, `false` | `false` | **Check/Uncheck all Views**。当 `true`，允许所有视图显示，包括后来添加的。 |
| `page_templates` | 字符串序列 | 页面模板 UUID | empty | 允许的 **Page templates**. |
| `all_page_templates` | boolean | `true`, `false` | `false` | **Check/Uncheck all Page templates**。当 `true`，允许所有页面模板。 |
| `user_templates` | 字符串序列 | 全局用户模板 UUID | empty | 允许的 **Global user templates**. |
| `all_user_templates` | boolean | `true`, `false` | `false` | **Check/Uncheck all Global user templates**。当 `true`，允许所有全局用户模板。 |
| `icon_sets` | 字符串序列 | 图标集 ID 来自 `*.dxpr_icon_sets.yml` 文件 | empty | 允许的 **Icon sets**. |
| `all_icon_sets` | boolean | `true`, `false` | 未设置（计为 `true`) | **Check/Uncheck all Icon sets**。当 `true` 或缺失时，允许每个图标集。 |
| `inline_buttons` | 字符串序列 | CKEditor 5 按钮名称 | empty | **Text editor buttons (inline editing)**。更新 8036 迁移了此列表及以下位置中的 CKEditor 4 名称 `modal_buttons`. |
| `modal_buttons` | 字符串序列 | CKEditor 5 按钮名称 | empty | **Text editor buttons (modal editing)**。 |

## 用户模板

配置对象： `dxpr_builder.user_template.*`（实体类型 `dxpr_builder_user_template`)

管理路径： `/admin/dxpr_studio/dxpr_builder/user_templates`

| 键 | 类型 | 可选值 | 默认值 | 描述 |
|---|---|---|---|---|
| `id` | string | 机器名 | required | 标识符。 |
| `label` | label | Any text | required | **Label**：模板名称。 |
| `status` | boolean | `true`, `false` | `true` | 无表单字段。只有已启用的模板才能在编辑器中加载或复制到页面模板。 |
| `type` | string | 该 `data-azb` 模板所保存的元素类型，例如 `section`, `row`, `az_block`, `az_view`，或 `custom` | `custom` | **类型**。Update 9021 从标记回填该值；`az_block_*` 和 `az_view_*` 值合并为 `az_block` 和 `az_view`。 |
| `template` | string | DXPR Builder HTML | empty | **Template** 标记。更新 8013 将用户模板从数据库表移到配置中。 |
| `uid` | integer | 用户 ID | 表单中必填 | **UID**：所有者。 |
| `global` | boolean | `true`, `false` | `true` （编辑器的保存请求发送自己的值） | **Global**：`true` 使模板对所有用户可用（受资料限制）；`false` 仅对其所有者保持私有。 |
| `image` | string | Base64 编码的图像内容 | empty | **Image**：缩略图。 |
| `uuid` | string | UUID | generated | 全局唯一 ID。 |

## 导出配置

导出所有 DXPR Builder 配置：

```bash
drush config:export

```

这将设置、资料、页面模板和用户模板导出为配置同步目录中的 YAML 文件。当 `api_key_storage` 为 `key`，产品密钥不属于 `dxpr_builder.settings`。它位于所选 Key 实体中，遵循该键自己的提供方，如配置、文件或环境变量。

## 接下来做什么？

- [常规设置](/zh-hans/hc/documentation/learn-dxpr-builder/admin/general-settings)：设置表单
- [防火墙和数据驻留](/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall)：控制出站连接的键
- [API 端点](/zh-hans/hc/documentation/learn-dxpr-builder/reference/api-endpoints)：读取此配置的路由