---
url: /zh/repo/settings-workspace.md
description: |
  通过 .cnb/settings.yml 定制云原生开发启动按钮的名称、描述、悬浮图片、 CPU 配置及禁用选项。
---
定制云原生开发启动按钮的外观和行为，让项目更具辨识度。

## 使用场景

* 为开源项目打造独特的启动体验
* 突出项目开发环境特色
* 控制开发环境资源配置（如 CPU 核心数）
* 禁用默认启动按钮（如使用自定义流水线替代）

## 配置方式

在仓库启动按钮所在分支的 `.cnb/settings.yml` 中添加 `workspace` 配置：

```yaml title=".cnb/settings.yml"
workspace:
  launch:
    button:
      name: 启动云原生开发
      description: 点击此按钮启动云原生开发环境
      hoverImage: .cnb/launch-hover.gif
    cpus: 4
    disabled: false
    autoOpenWebIDE: false
```

## 参数说明

| 参数                                  | 类型    | 默认值  | 说明                                        |
| ------------------------------------ | ------ | ------ | ------------------------------------------ |
| `workspace.launch.button.name`        | string | -      | 启动按钮的名称                              |
| `workspace.launch.button.description` | string | -      | 按钮描述                                    |
| `workspace.launch.button.hoverImage`  | string | -      | 悬浮图片（仓库相对路径或 raw 地址，≤10MB）   |
| `workspace.launch.cpus`               | number | 8      | CPU 核心数，仅对默认模板有效                 |
| `workspace.launch.disabled`           | boolean | false  | 是否禁用默认启动按钮                        |
| `workspace.launch.autoOpenWebIDE`     | boolean | false  | 环境创建后是否自动打开 WebIDE               |

**补充说明：**

* **`description`**：设为 `null` 则不显示按钮描述。
* **`hoverImage`**：支持仓库相对路径或 raw 地址，鼠标悬浮时显示，最大 10MB。
* **`autoOpenWebIDE`**：云原生开发环境创建成功后，
  自动在浏览器中打开 WebIDE，无需额外操作。

:::tip
所有参数均可选，按需配置即可。
:::