> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 自定义您的 AgencyHandy 工作区配色方案

> 将您的品牌颜色应用于 AgencyHandy 侧边栏和界面——主色、背景色、文字颜色和悬停状态——所有用户立即可见。

外观设置让您完全掌控 AgencyHandy 工作区的视觉呈现。您可以通过自定义主色、侧边栏背景色、侧边栏文字颜色以及侧边栏导航项悬停高亮颜色，使平台配色方案与代理机构的品牌形象保持一致。您保存的每项更改将立即在整个工作区对所有用户生效——无需刷新页面。

<Note>
  只有**超级管理员**和**管理员**才能访问和修改外观设置。如果您在**工作区配置**下看不到此选项，请请超级管理员检查您的角色权限。
</Note>

## 访问外观设置

<Steps>
  <Step title="打开工作区配置">
    在左侧导航菜单中，点击 **工作区配置**。
  </Step>

  <Step title="选择外观">
    从子菜单中点击 **外观**（有时标记为**视觉设置**）。
  </Step>
</Steps>

***

## 自定义各视觉元素

### 主色

主色应用于整个平台的按钮、活跃链接、高亮状态和关键界面元素。

* 选择能体现您核心品牌形象的颜色。
* 这是影响最大的颜色设置，因为它在界面的各处均会出现。

### 侧边栏背景色

侧边栏背景色设定左侧导航面板的基础色调。

* 使用能在侧边栏与主内容区域之间形成清晰视觉分隔的颜色。
* 深色背景搭配浅色文字通常具有最佳的可读性。

### 侧边栏文字颜色

侧边栏文字颜色控制左侧菜单中所有导航项的标签颜色。

* 始终选择与侧边栏背景色形成强烈对比的颜色。
* 低对比度会使链接更难阅读，并降低可访问性。

### 侧边栏悬停背景色

当用户将鼠标移至侧边栏导航项上时，此颜色将作为背景高亮显示。

* 它传达交互性，帮助用户了解即将点击的项目。
* 选择一个与默认侧边栏背景色和活跃项颜色均有明显区别的颜色。

***

## 应用您的颜色选择

<Steps>
  <Step title="为每个字段打开颜色选择器">
    点击四个外观字段（主色、侧边栏背景色、侧边栏文字颜色或侧边栏悬停背景色）中任意字段旁边的色板，打开颜色选择器。
  </Step>

  <Step title="输入十六进制代码或选择颜色">
    将品牌的精确十六进制代码（例如，`#3B5BDB`）直接输入到输入字段中，或使用可视化选择器选择色调。
  </Step>

  <Step title="预览更改效果">
    在保存之前，先查看更新后的颜色在侧边栏和整个界面中的效果。
  </Step>

  <Step title="点击保存更改">
    对结果满意后，点击 **保存更改**。更新后的外观将立即全局应用于工作区的所有用户。
  </Step>
</Steps>

<Tip>
  将品牌的十六进制颜色代码记录在便于访问的地方（品牌样式指南或笔记文件）。您会希望始终复用完全相同的值——尤其是在需要重置和重新配置外观设置时。
</Tip>

***

## 恢复默认主题

如果您想移除所有自定义品牌颜色并恢复原始 AgencyHandy 配色方案，请点击外观页面上的 **恢复默认设置** 按钮。

<Warning>
  恢复默认设置将永久丢弃所有自定义颜色更改。此操作无法撤销。如果您想保留当前设置，请在重置前记下您的十六进制代码。
</Warning>

***

## 颜色对比最佳实践

良好的颜色对比不仅仅是设计偏好——它直接影响团队和客户的可读性与可访问性。

<CardGroup cols={2}>
  <Card title="达到 WCAG AA 对比度标准" icon="eye">
    对于正文文字，文字与背景之间的对比度至少应达到 **4.5:1**。对于大号文字或图标，**3:1** 的对比度即可接受。使用 [WebAIM Contrast Checker](https://webaim.org/resources/contrastchecker/) 等工具进行验证。
  </Card>

  <Card title="避免低对比度组合" icon="triangle-exclamation">
    不要将浅灰色文字搭配白色背景，或黄色文字搭配白色背景——这些组合不符合可访问性标准，且长时间使用会造成视觉疲劳。
  </Card>

  <Card title="有意测试悬停状态" icon="arrow-pointer">
    悬停颜色应与静止状态和活跃状态明显不同。如果看起来相同，用户将失去重要的视觉反馈。
  </Card>

  <Card title="与品牌保持一致" icon="paintbrush">
    此处使用的主色应与您网站、提案和发票上的主色保持一致。一致性在所有客户接触点建立认知度和专业感。
  </Card>
</CardGroup>

***

## 重要说明

* **即时全局效果：** 所有已保存的外观更改立即在整个工作区生效。每位已登录的用户在下次导航操作时即可看到更新。
* **单一活跃主题：** 不支持多主题——一套颜色适用于所有角色的整个工作区。
* **角色限制：** 只有超级管理员和管理员才能进行外观更改。普通团队成员和客户无法修改颜色。
* **重置不可撤销：** **恢复默认设置** 按钮的操作无法撤销，因此仅在您有意移除所有自定义颜色时才使用它。