---
url: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/development/drush-commands'
title: 'Drush 命令 | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T00:45:46+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  DXPR Builder 提供 Drush 命令，在命令行管理页面、模板、元素和内容迁移。除 dxb:migrate 外，每个命令都输出 YAML。
  页面命令
  dxb:page:create
  从 DXPR Builder 页面模板创建节点。
  drush dxb:page:create drag_and_drop_page my_template \
    --title="New Landing Page"

  参数：
tags:
  - Tooling
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T00:45:46+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'Drush 命令'
      description: |-
        DXPR Builder 提供 Drush 命令，在命令行管理页面、模板、元素和内容迁移。除 dxb:migrate 外，每个命令都输出 YAML。
        页面命令
        dxb:page:create
        从 DXPR Builder 页面模板创建节点。
        drush dxb:page:create drag_and_drop_page my_template \
          --title="New Landing Page"

        参数：
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T00:45:46+0000'
      dateModified: '2026-10-24T00:45:46+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/development/drush-commands'
      articleSection: Tooling
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/development/drush-commands'
      description: |-
        DXPR Builder 提供 Drush 命令，在命令行管理页面、模板、元素和内容迁移。除 dxb:migrate 外，每个命令都输出 YAML。
        页面命令
        dxb:page:create
        从 DXPR Builder 页面模板创建节点。
        drush dxb:page:create drag_and_drop_page my_template \
          --title="New Landing Page"

        参数：
      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) /[Extend](/hc/documentation/learn-dxpr-builder/extend) /[Tooling](/hc/documentation/learn-dxpr-builder/extend/tooling) # Drush 命令.

 Learn DXPR BuilderExtendTooling

   ## In this guide

DXPR Builder 提供 Drush 命令，在命令行管理页面、模板、元素和内容迁移。除 `dxb:migrate` 外，每个命令都输出 YAML。

## 页面命令

### dxb:page:create

从 DXPR Builder 页面模板创建节点。

```bash
drush dxb:page:create drag_and_drop_page my_template \
  --title="New Landing Page"

```

**参数：**

| 参数 | 说明 |
|---|---|
| `type` | 内容类型机器名 |
| `template_id` | 页面模板机器名 |

**选项：**

| 选项 | 说明 |
|---|---|
| `--title` | 节点标题（必填） |
| `--field` | 构建器字段名（自动检测） |
| `--status` | 发布状态：0 或 1（默认：0） |
| `--dry-run` | 只验证，不创建 |

别名：`dxpr-pc`

### dxb:page:get

获取实体的 DXPR Builder 标记。

```bash
drush dxb:page:get 42
drush dxb:page:get 5 --entity-type=block_content

```

**参数：**

| 参数 | 说明 |
|---|---|
| `entity_id` | 实体 ID |

**选项：**

| 选项 | 说明 |
|---|---|
| `--entity-type` | 实体类型（默认：node） |
| `--field` | 构建器字段名（自动检测） |

别名：`dxpr-pg`

### dxb:page:update

更新实体的 DXPR Builder 标记。

```bash
drush dxb:page:update 42 --markup="<div>new</div>"
drush dxb:page:update 42 --markup=@/tmp/page.html

```

**参数：**

| 参数 | 说明 |
|---|---|
| `entity_id` | 实体 ID |

**选项：**

| 选项 | 说明 |
|---|---|
| `--entity-type` | 实体类型（默认：node） |
| `--field` | 构建器字段名（自动检测） |
| `--markup` | 新 HTML（字符串或 @文件路径） |
| `--dry-run` | 显示将更改的内容 |

别名：`dxpr-pu`

## 模板命令

### dxb:template:list

列出可用的 DXPR Builder 页面模板。

```bash
drush dxb:template:list
drush dxb:template:list --category=Landing
drush dxb:template:list --detail

```

**选项：**

| 选项 | 说明 |
|---|---|
| `--category` | 按模板分类筛选 |
| `--profile` | 按档案 ID 筛选 |
| `--detail` | 包含模板标记正文 |

别名：`dxpr-tl`

## 用户模板命令

### dxb:user-template:list

列出所有 DXPR Builder 用户模板。

```bash
drush dxb:user-template:list
drush dxb:user-template:list --global
drush dxb:user-template:list --uid=1
drush dxb:user-template:list --status=disabled

```

**选项：**

| 选项 | 说明 |
|---|---|
| `--uid` | 按所有者用户 ID 筛选 |
| `--global` | 只显示全局模板 |
| `--status` | 按状态筛选：`enabled` 或 `disabled` |
| `--profile` | 按档案 ID 筛选 |
| `--detail` | 包含模板标记正文 |

每个模板的输出包含其 `status`。

别名：`dxpr-utl`

### dxb:user-template:create

创建可重复使用的 DXPR Builder 用户模板。

```bash
drush dxb:user-template:create "Hero Section" \
  --markup="<div class='container'>...</div>"
drush dxb:user-template:create "Hero" \
  --markup=@/tmp/hero.html --global

```

**参数：**

| 参数 | 说明 |
|---|---|
| `label` | 模板显示名 |

**选项：**

| 选项 | 说明 |
|---|---|
| `--markup` | HTML（字符串或 @文件路径） |
| `--global` | 供所有用户使用 |
| `--dry-run` | 只验证，不创建 |

别名：`dxpr-utc`

## 元素命令

### dxb:element:list

列出可用的 DXPR Builder 元素（区块、视图）。

```bash
drush dxb:element:list
drush dxb:element:list --type=block
drush dxb:element:list --profile=editor

```

**选项：**

| 选项 | 说明 |
|---|---|
| `--type` | 按类型筛选：block、view |
| `--profile` | 按档案 ID 筛选 |

别名：`dxpr-el`

## 设置命令

### dxb:setup-ai

在 Composer 项目根目录为代码助手安装 AI 技能：Claude Code 用 `.claude/skills/dxb`，Codex、Gemini、Copilot 和 Cursor 用 `.agents/skills/dxb`。每份包含 `SKILL.md`、`references/`（每个元素一个文件，视图和区块元素、解析规则、A/B 测试和工作流）和带标记验证器的 `scripts/`。`--check` 不做更改，列出每个未安装或过期的文件。

```bash
drush dxb:setup-ai
drush dxb:setup-ai --check
drush dxb:setup-ai --host=claude

```

**选项：**

| 选项 | 说明 |
|---|---|
| `--host` | 目标：`claude`、`agents` 或 `all`（默认：`all`） |
| `--check` | 检查安装的文件是否最新，不做更改 |

别名：`dxpr-sa`

## 迁移命令

### dxb:migrate

运行所有有待处理项的内容迁移，或只运行您指定的一个。它按迁移记录一行，某项失败时以非零码退出。同样的迁移列在 **DXPR Studio &gt; DXPR Builder &gt; Content Items &gt; Migrations**。

```bash
drush dxb:migrate
drush dxb:migrate --migration=circle_counter_circliful_to_bootstrap
drush dxb:migrate --migration=counter_duplicate_ids

```

**选项：**

| 选项 | 说明 |
|---|---|
| `--migration` | 只运行该迁移 ID，即使没有计为待处理的项 |
| `--force` | 在废弃运行后，接管仍标记为进行中的运行的锁 |

迁移 ID：`owl_carousel_to_bootstrap`、`circle_counter_circliful_to_bootstrap`、`progress_bar_legacy_to_bootstrap_extension`、`counter_duplicate_ids`、`entity_link_enrichment` 和 `alias_link_enrichment`。

该 `counter_duplicate_ids` 迁移移除与所属 Number counter 或 Circle counter ID 重复的内部显示 ID，包括已保存的 A/B 变体和额外 HTML 包裹中的显示。它保留包裹锚点、不同的自定义内部 ID 和嵌套元素边界。DXPR Builder 渲染已有内容时也会修复这些重复。

部署后运行 Drupal 数据库更新（`drush updb` 或 `update.php`）。专用的 `counter_duplicate_ids` 更新后迁移存放的字段和可重复使用模板，即使网站已运行早期的内容更新。之后导入的内容用上文命令。部署更新后的服务后重建 Drupal 缓存。

别名：`dxpr-migrate`