> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/zh/system-administration/customizing-the-user-interface.md).

# 自定义用户界面

VergeOS 支持在每个租户层级（如获许可）使用 **主题** 功能。本指南将引导你使用组织的品牌元素（包括徽标、颜色和网站图标）来修改用户界面（UI）。

{% hint style="info" %}
**VergeOS v26 有哪些新内容**

* **浅色和深色模式**：VergeOS 包含默认的浅色和深色主题，并支持基于任一模式的自定义主题。
* **多个主题变体**：管理员可以创建多个带品牌的主题，例如浅色和深色版本，并将其提供给用户选择。
  {% endhint %}

## 如何更改你的 UI 品牌设置

按照以下步骤自定义你的 VergeOS 环境：

1. **上传徽标和图标文件**:
   * 请以上传所需的徽标，格式为 `.png` 或 `.jpg` 格式。为获得最佳效果，请使用 **144x36** 的图像作为大徽标，以及 **44x44** 作为小徽标。
   * 如有需要，请上传一个格式为 `.ico` 格式下载。

{% hint style="success" %}
**有关将文件上传到 vSAN 的说明可见于** [**这里**](/run-the-platform/storage/uploading-files-to-vsan.md)
{% endhint %}

2. **创建一个或多个自定义主题**：用于实现你的品牌设置\
   请参阅 [《主题产品指南》](/run-the-platform/system-administration/themes.md) 以获取说明。
3. **控制用户主题选项**：\
   所有已启用的主题都会作为选项显示给用户选择（从工具栏中）。 **若要强制仅使用自定义品牌，你必须禁用标准的 VergeOS 默认主题（浅色/深色）。**

## UI 自定义最佳实践

### 视觉设计

* **创建浅色和深色变体：** 为你的自定义主题同时提供浅色和深色版本，以适应不同的光照环境和用户偏好。浅色模式在明亮环境中可提升可见性，而深色模式可减少眩光，并可在 OLED 设备上节省电量。
* **一致性**：确保你为品牌选择的颜色和徽标与你组织的风格指南保持一致，以确保一致性。
* **徽标尺寸**：上传正确尺寸的徽标，以防止失真或缩放问题。

### 可访问性与可读性

* **可读性**：为文本和背景元素使用对比色，以确保在不同设备上的可读性。
* **跨主题测试：** 验证所有 UI 元素在浅色和深色模式下都保持清晰可读且视觉协调。

### 主题管理与用户体验

* **启用前预览**：将新主题初始设置为禁用，可以让你在启用供用户选择之前，有时间验证品牌指南和可用性。
* **禁用未使用的主题：** 用户可以从所有已启用的主题中进行选择。若要强制仅使用品牌主题，请禁用默认的 VergeOS 主题（浅色/深色）；并移除任何你不再希望提供的过时自定义主题。
* **清晰命名主题**：使用描述性名称（例如“Acme Light”或“Acme Dark”），帮助用户轻松识别合适的版本。

***

按照这些步骤并使用可用选项，你可以完全自定义 VergeOS UI，使其体现你组织的品牌。满意更改后，请确保保存设置。

***

{% hint style="info" %}
**文档信息**

* 最后更新：2025-10-29
* vergeOS 版本：26.0
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/zh/system-administration/customizing-the-user-interface.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.