# 品牌与域名

组织管理员在「基本信息与品牌」覆盖产品名称、颜色、术语、登录页文案、链接、标志与封面；在「域名」设置组织专属的平台子域地址并绑定自定义域名（用于工作台或托管站点），验证 DNS 的 TXT 记录后生效。

## 谁能用

- **适用角色**：仅管理员具备完整的读写与配置权限。审计员可直接访问页面查看已有配置，但页面处于只读状态，界面提示「只读」「审计员可以查看，但不能修改。」。
- **页面权限与分工**：
  | 页面 | 导航名称 | 所在分组 | 侧栏可见角色 | 页面权限 |
  |---|---|---|---|---|
  | `/brand` | 「基本信息与品牌」 | 「企业设置」 | 仅管理员 | 管理员可读写；审计员直开只读 |
  | `/domains` | 「域名」 | 「企业设置」 | 仅管理员 | 管理员可读写；审计员直开只读 |
- **无权限访问**：若账号角色不允许查看页面，界面显示「没有权限」，并提示「你的账号角色不允许查看这个页面。请联系租户管理员。」。
- **助手权限**：管理员、审计员及助手均可读取品牌与域名配置。通过助手执行写操作仅限管理员。
- **白标授权要求**：
  - 品牌定制依赖部署许可证中的白标字段。许可证中定义的可覆盖字段决定了具体能够自定义的项目。
  - 若许可证不包含白标授权（或可覆盖字段为空），管理员仍可进入页面，但保存与上传会被系统拒绝，界面提示「当前许可不包含白标」「品牌定制需要白标授权。请联系平台运营方开通。」。
  - 社区许可证不包含组织品牌覆盖功能，且席位限制为 10 席。
  - 标志与页面封面的上传还需要系统已配置文件对象存储，未配置时不可用。
- **自定义域名授权要求**：
  - 绑定自定义域名需要许可证中包含「域名」字段。若未包含，界面提示「当前许可不包含自定义域名」「请联系平台运营方开通。」。
  - 设置组织自身的平台子域地址不需要自定义域名授权。

## 怎么打开

你可以通过以下几种方式进入相关页面：

1. **从工作台导航进入**：
   - 在 [工作台](/guide/workspace) 左侧导航点击「我的组织」，展开「企业设置」分组。
   - 点击「基本信息与品牌」进入品牌设置页面（页头标题显示为「品牌」）。
   - 点击「域名」进入域名设置页面（页头标题显示为「域名」）。
2. **从概览开通清单进入**：
   - 在 [工作台](/guide/workspace) 概览页面的开通清单中，点击「设置品牌」任务旁的「去设置」，直接跳转至「品牌」页面。
   - 点击开通清单中的「绑定自己的域名」任务旁的「去绑定」，直接跳转至「域名」页面。
3. **从站点应用跳转**：
   - 在 [站点](/apps/site) 应用的「域名」管理页中，点击对应入口可直接跳转至本页并打开「添加域名」弹窗，自动携带并预选该站点。

## 界面一览

### 「品牌」页面（`/brand`）

![「品牌」](/shots/admin-brand.webp)

图：「品牌」

1. 「保存品牌」：有未存改动且对比度合格才可点
2. 页头「品牌」（导航名是「基本信息与品牌」）
3. 「产品名称」；无白标许可时保存会被拒
4. 「颜色」：浅色 / 深色；对比度须达到 WCAG AA

- **顶部操作栏**：
  - 「放弃修改」：丢弃当前未保存的所有表单修改。
  - 「保存品牌」：当表单存在未保存的修改项且颜色对比度校验达标时可点击。保存成功后弹出提示「品牌已保存，正在刷新」，随后页面会自动整页刷新。
- **页面分节**：页面按四节排布，侧栏与页内锚点依此定位：「名称与标志」（含「名称」「标志」）、「颜色与封面」（含「颜色」「页面封面」）、「登录页」、「术语与链接」（含「术语」「链接」）。以下各区域对应各节中的卡片。
- **「实时预览」区域**：
  - 预览区标题显示为「实时预览 · 」并跟随当前所选的「浅色」或「深色」。
  - 包含各类界面的实际视觉演示，涵盖「管理台」「本月概览」「主要操作」「次要操作」「删除」「草稿」「等待你确认」「应用」「正常」「待处理」「失败」等控件与状态标签。
  - 底部实时显示正文与按钮的对比度数值，格式如「对比度：正文 」加上数字并附带「 · 主按钮 」及数字。
- **「名称」区域**：
  - 「产品名称」：输入组织希望展示的产品名称。若未覆盖，显示「继承」徽章，表示继承平台品牌名称。
- **「颜色」区域**：
  - 说明文字标注「浅色和深色各自设置。文字对比度需达到 WCAG AA（4.5:1）。」。
  - 顶部提供「浅色」与「深色」两个页签，可分别配置：
    - 「主色」：提示用于「按钮、链接、选中态」。
    - 「主色上的文字」：主色背景按钮上的文字颜色。
    - 「页面背景」：整体页面背景底色。
    - 「面板背景」：卡片与面板的背景色。
    - 「正文文字」：主要文本颜色。
    - 「次要文字」：说明与辅助文本颜色。
    - 「边框」：分割线与边框颜色。
    - 「危险色」：仅在「浅色」页签中配置。
    - 「圆角」：设置组件圆角大小，提示「例如 8px」。
    - 「资源缩略图风格」：提示「文档、文件、成员等名称前的小图；全组织一致」，提供单选选项「双色线条（默认）」「渐变色块」「柔和浅色」。
  - 未单独配置的颜色项旁均显示「继承」徽章。
  - **对比度校验**：若文字对比度不足 4.5:1，系统禁止保存，提示「对比度不足，无法保存」，并明确指出具体模式与未达标的项目（如提示浅色或深色模式下正文文字与页面背景、或主色上的文字与主色对比度不足，要求达到至少 4.5）。
- **「术语」区域**：
  - 允许自定义组织内的统称，覆盖范围包括工作台界面、登录页与系统邮件：
    - 「Agent 的称呼」：占位符为「助理」。
    - 「“草稿”的称呼」：占位符为「草稿」。
    - 「“应用”的称呼」：占位符为「应用」。
- **「登录页」区域**：
  - 说明文字标注「登录页左侧的标题、说明和要点，留空用默认文字，仅限纯文本。」。
  - 包含字段「登录页标题」「登录页说明」「要点 1」「要点 2」「要点 3」。每项最多输入 120 字纯文本，留空则使用系统默认文案。
- **「链接」区域**：
  - 配置页脚与帮助跳转的外链地址（支持 https、http 或 mailto）：
    - 「帮助中心」
    - 「服务条款」
    - 「支持入口」
    - 「隐私政策」
- **「标志」区域**：
  - 说明文字标注「PNG、JPEG、WebP、SVG，不超过 512 KB。上传后立即生效，无需保存。」。
  - 包含三项图标位：
    - 「浅色标志」：提示「未单独设置深色标志时，深色模式也用它。」。
    - 「深色模式使用单独的标志」：复选框。勾选后展开「深色标志」，提示「只在深色模式显示。」。取消勾选后深色标志被移除，提示「深色模式改用浅色标志」。
    - 「方形图标」：提示「方形，用于侧栏收起和浏览器标签页。」。
  - 未配置时显示「未设置」。支持点击「上传」本地文件或输入 https 链接。上传本地文件时可进行裁剪，弹窗标题为「裁剪」加上对应标志名。已配置项提供「移除」按钮。
  - 上传成功后弹出提示，显示对应标志名称与「已更新」；点击移除后提示「已移除」。**上传与移除立即生效，无需点击「保存品牌」**。
- **「页面封面」区域**：
  - 说明文字标注「PNG、JPEG、WebP，不超过 2 MB，比例约 4:1。上传后立即生效，无需保存。移除后，已用它的页面显示空白封面。」。
  - 点击「上传封面图」按钮上传。最多可保存 12 张封面图，界面显示张数进度（如已存数量加上「 / 」和上限 12）。
  - 上传成功后提示「已添加」。**上传与移除立即生效，无需点击「保存品牌」**。移除封面图后，已选用它的页面会变为显示空白封面。

### 「域名」页面（`/domains`）

![「域名」](/shots/admin-domains.webp)

图：「域名」

1. 页头「域名」
2. 「添加域名」；验证要真实 DNS，本清单不验证
3. 「组织的地址」：{名称}.{平台域}
4. 「自己的域名」：添加后须在 DNS 放 TXT 再验证

- **「组织的地址」区域**：
  - 标签显示为「名称」。
  - 状态文案：已设置时显示「现在是」加上完整二级域名地址；未设置时显示「还没有设置；可以用」加上系统建议名称。
  - 域名后缀固定为平台的组织子域名后缀。
  - 操作按钮：「设置」或「改名」。
  - 改名确认弹窗：提示是否确认将地址修改为新名称，附带警示「旧地址立即失效，用它保存的书签和分享的链接将打不开。」，确认按钮为「改名」。修改成功后提示已改为新地址；若名称已被其他组织占用，提示「这个名字已经有人用了」。
- **「自己的域名」区域**：
  - 当未绑定任何自定义域名时，显示空状态：「还没有自定义域名」「添加后需在 DNS 放一条 TXT 记录验证归属。」，并提供「添加域名」按钮。
  - 点击「添加域名」弹出对话框：
    - 弹窗说明标注「填写完整域名，不能是平台自身的域名。」。
    - 填写「域名」（完整域名，不可使用平台自身域名）。
    - 选择「用途」：「打开工作台（员工登录用的地址）」或「托管一个站点（营销页面，访客无需登录）」。
    - 若选择托管站点，需输入「站点编号」，提示在 [站点](/apps/site) 应用的「域名」页复制，以 `st_` 开头。
    - 警示文案标注「用途添加后不能修改。」。
    - 操作按钮：「取消」与「添加」。添加成功后提示已添加域名并提示「请完成 DNS 验证」；若域名重复或超限，提示「这个域名已被占用，或站点域名已达上限」。
  - 已添加的域名以卡片形式展示：
    - 状态徽章：显示「已验证」或「待验证」。
    - 站点标识：用途为托管站点时，展示「站点」徽章及站点编号。
    - 待验证卡片说明：提示「添加下面的 TXT 记录后点“检查验证”，并把域名解析（CNAME 或 A 记录）指向」平台入口，或指向站点入口（详见 [站点](/apps/site) 应用的「域名」页）。
    - 待验证 DNS 记录表：
      - 「类型」：TXT
      - 「主机记录」：`_kwork-challenge.{域名}`
      - 「记录值」：系统给出的验证字符串（格式为 `kwork-verify=` 加上对应十六进制字符）
    - 验证操作：点击卡片上的「检查验证」按钮。若验证通过，状态转为「已验证」，提示已验证；若尚未查到 DNS 记录，提示「还没有查到 TXT 记录。DNS 生效可能需要几分钟。」。
    - 已验证卡片信息：展示「验证于」时间戳，以及可访问的「访问地址」链接。
    - 释放操作：点击卡片上的「释放域名」按钮，弹出确认对话框提示「释放后域名不再指向你的工作台，可重新添加。」，点击「释放」确认，成功后提示「已释放」。

## 常用操作

### 修改产品名称与外观颜色

1. 在 [工作台](/guide/workspace) 左侧导航进入「我的组织」→「企业设置」→「基本信息与品牌」。
2. 在「名称」区域的「产品名称」输入框中输入新的名称。
3. 在「颜色」区域切换「浅色」或「深色」页签，修改主色、背景色、文字颜色，或输入「圆角」像素值、选择「资源缩略图风格」。若某项留空，系统自动标记为「继承」平台默认样式。
4. 在右侧「实时预览」区域检查视觉效果与对比度检测数据。正文文字与主按钮文字的对比度数值均需达到 4.5 以上。
5. 点击页面右上角的「保存品牌」按钮。保存成功后弹出提示「品牌已保存，正在刷新」，页面自动刷新并应用新配置。
6. 若需放弃未保存的修改，点击顶部的「放弃修改」按钮。

> **注意**
>
> 若文字对比度不足 4.5:1，「保存品牌」按钮将处于不可点击状态，界面显示「对比度不足，无法保存」并列出未达标的项目。

### 修改术语与登录页文案

1. 进入「企业设置」中的「基本信息与品牌」页面。
2. 在「术语」区域，分别填写「Agent 的称呼」「“草稿”的称呼」与「“应用”的称呼」。
3. 在「登录页」区域，分别填写「登录页标题」「登录页说明」以及「要点 1」「要点 2」「要点 3」。每项输入纯文本，最多不超过 120 字。
4. 在「链接」区域，填写帮助中心、服务条款、支持入口与隐私政策的 URL 地址。
5. 点击页面右上角的「保存品牌」按钮。保存完成后，新的术语将立即生效于工作台、登录页面以及系统发出的邮件中。

### 上传与管理品牌标志

1. 进入「企业设置」中的「基本信息与品牌」页面，滚动至「标志」区域。
2. 准备符合格式要求的图片（支持 PNG、JPEG、WebP、SVG，单个文件不超过 512 KB）。
3. 上传浅色标志或方形图标：在对应项点击「上传」按钮选择本地文件，并在弹出的裁剪窗口中调整并确认；或者直接输入 https 图片地址。
4. 配置深色模式独立标志：勾选「深色模式使用单独的标志」，在展开的「深色标志」项旁点击「上传」并完成裁剪。
5. 上传成功后界面弹出对应标志的「已更新」提示。**上传后立即生效，无需点击「保存品牌」**。
6. 若需删除已配置的标志，点击对应项旁的「移除」按钮即可；取消勾选「深色模式使用单独的标志」会删除深色标志，界面提示「深色模式改用浅色标志」。

### 上传与管理页面封面图

1. 进入「企业设置」中的「基本信息与品牌」页面，滚动至「页面封面」区域。
2. 准备封面图片（支持 PNG、JPEG、WebP 格式，单个文件不超过 2 MB，宽高比建议约为 4:1）。
3. 点击「上传封面图」按钮选择文件上传。单个组织最多可上传 12 张封面图。
4. 上传完成后界面提示「已添加」，张数计数相应更新。**上传后立即生效，无需点击「保存品牌」**。
5. 若需删除某张封面图，在对应卡片上点击移除。移除后立即生效；若组织内已有页面引用了该封面，移除后这些页面将显示为空白封面。

### 设置或修改组织专属地址

1. 在 [工作台](/guide/workspace) 左侧导航进入「我的组织」→「企业设置」→「域名」。
2. 在「组织的地址」区域查看当前二级域名。点击右侧的「设置」或「改名」按钮。
3. 在「名称」输入框中输入组织子域名（规则：长度为 3–40 个字符，以小写字母开头，仅允许小写字母、数字和连字符 `-`，不能包含连续连字符 `--`，不能使用平台保留字）。
4. 点击「设置」或「改名」，在确认弹窗中阅读警示信息：「旧地址立即失效，用它保存的书签和分享的链接将打不开。」。
5. 确认无误后点击弹窗中的「改名」按钮。改名成功后提示已改为新地址。若名称已被占用，提示「这个名字已经有人用了」。

> **注意**
>
> 修改组织地址后，旧地址将立即失效。组织内所有成员必须使用新地址登录，之前保存的书签和历史分享链接均无法继续使用。组织的地址不能被释放，只能改名。

### 添加并验证自定义域名

![「添加域名」对话框](/shots/admin-domains-add.webp)

图：「添加域名」对话框

1. 「域名」：填写完整域名，不能是平台自身的域名
2. 用途：打开工作台，或托管一个站点；添加后不能改
3. 「添加」后去 DNS 放 TXT，再回来「检查验证」

1. 在「域名」页面的「自己的域名」区域，点击「添加域名」按钮。
2. 在弹出的「添加域名」对话框中进行配置：
   - 「域名」：输入完整的自定义域名（不能使用平台自身域名及其子域名）。
   - 「用途」：根据需要选择「打开工作台（员工登录用的地址）」或「托管一个站点（营销页面，访客无需登录）」。
   - 「站点编号」：若用途选择托管站点，需输入以 `st_` 开头的站点编号（可前往 [站点](/apps/site) 应用的「域名」页复制）。
3. 确认用途无误（界面提示「用途添加后不能修改。」），点击「添加」按钮。添加成功后提示已添加域名并提示「请完成 DNS 验证」。
4. 登录你的域名 DNS 解析服务商控制台，添加以下解析记录：
   - **TXT 验证记录**：主机记录填写 `_kwork-challenge.{域名}`，记录值填写界面给出的验证字符串（`kwork-verify=` 加上对应十六进制字符）。
   - **访问解析记录**：添加 CNAME 或 A 记录，根据用途指向平台入口或站点入口。
5. 回到「域名」页面，在对应域名卡片上点击「检查验证」按钮。
6. 验证成功后，卡片状态转为「已验证」，提示已验证，并展示「访问地址」`https://{域名}`。若 DNS 记录尚未生效，系统提示「还没有查到 TXT 记录。DNS 生效可能需要几分钟。」，请等待解析生效后再次点击检查。

### 释放自定义域名

1. 在「域名」页面的「自己的域名」列表中，找到需要解绑的域名卡片。
2. 点击卡片上的「释放域名」按钮。
3. 在确认对话框中查看提示：「释放后域名不再指向你的工作台，可重新添加。」。
4. 点击对话框中的「释放」按钮。释放成功后提示「已释放」，该域名立即停止指向当前工作台或站点。后续如有需要可重新添加绑定。

## 状态说明

### 自定义域名状态

| 状态 | 触发条件 | 界面表现与可用功能 |
|---|---|---|
| 「待验证」 | 刚添加自定义域名，尚未完成 DNS 校验 | 卡片显示 TXT 与 CNAME/A 解析要求，提供「检查验证」与「释放域名」按钮，域名尚不可用于访问 |
| 「已验证」 | DNS TXT 记录校验通过 | 卡片显示「验证于」时间戳与 HTTPS 访问链接；工作台域名加入登录可用主机列表，站点域名对外提供免登录访问 |

### 权限与许可状态

| 状态/提示文案 | 触发条件 | 界面影响 |
|---|---|---|
| 「只读」 | 当前登录角色为审计员 | 审计员直接打开页面时显示「只读」「审计员可以查看，但不能修改。」，禁用所有保存、上传与改名操作 |
| 「没有权限」 | 账号角色无权查看本模块 | 页面阻断并提示「没有权限」「你的账号角色不允许查看这个页面。请联系租户管理员。」 |
| 「当前许可不包含白标」 | 部署许可证缺少白标授权或可覆盖字段为空 | 提示「品牌定制需要白标授权。请联系平台运营方开通。」，配置项无法保存，上传被拒绝 |
| 「当前许可不包含自定义域名」 | 部署许可证缺少「域名」字段授权 | 无法添加自定义域名，提示「请联系平台运营方开通。」 |
| 「继承」 | 某项品牌属性未单独配置覆盖值 | 字段旁显示「继承」徽章，系统沿用平台默认的品牌名称或颜色样式 |

## 让助手帮你做

助手可以协助管理员查询品牌与域名配置，并代为执行部分高风险的管理操作。所有通过助手发起的修改操作均需管理员在对话中进行二次确认。

### 助手支持的操作

- **修改品牌名称与用语**：修改产品名称、术语（如 Agent 的称呼）以及登录页文案。留空则恢复为平台默认。需要管理员确认：「保存后，组织里每个人在工作台、登录页和邮件里看到的名称与用语都会改变。」。
- **修改组织的地址**：修改组织在平台下的二级域名（长度 3–40 个字符）。需要管理员确认：「改地址后，旧地址的链接和书签全部失效，组织里每个人要用新地址登录。」。
- **添加自定义域名**：指定完整域名与用途（工作台或指定站点编号）。需要管理员确认：「这个域名验证通过后，会成为组织的登录与访问地址（或站点的地址）。」，执行后助手会返回所需的 TXT 与 CNAME 配置信息。
- **验证自定义域名**：触发检查域名的 DNS TXT 记录，通过后立即开始提供访问服务。
- **释放自定义域名**：解绑自定义域名。需要管理员确认：「释放后，这个域名立刻不再指向组织，用它的链接和书签全部失效。」。注意：组织的地址不支持释放。

### 助手不能做的事

- 助手**不能**修改颜色、圆角或资源缩略图风格。
- 助手**不能**上传或删除品牌标志（浅色标志、深色标志、方形图标）。
- 助手**不能**上传或删除页面封面。
- 助手**不能**修改帮助中心、服务条款等外链。
- 助手无法获取除验证密钥外的完整 DNS 解析细节，请以管理员在页面上查看到的记录为准。

### 你可以这样对助手说

> 把产品名改成某某协作。

> 把助手的称呼改成小智。

> 把组织地址改成 acme。

> 加一个工作台域名 www.example.com。

> 检查一下 example.com 的验证。

> 释放 example.com。

> **提示**
>
> 若操作不符合规范或条件不足，助手会提示具体原因，例如「品牌没有这一项」「没有要修改的品牌项」「品牌已经是这样，没有要修改的内容」「平台的许可不包括自定义域名」「用于只能是工作台（workspace）或某个站点（site:<站点>）」「不是有效的域名」「平台自己的域名下的地址不能作为自定义域名」「这个域名已经被占用」「组织的站点域名已经到上限」「找不到这个站点」「还没有查到验证用的 TXT 记录（DNS 生效可能要几分钟）」或「组织自己的地址不能释放，只能改」。

## 设置

| 设置项 | 作用 | 默认值 | 谁能改 / 条件 |
|---|---|---|---|
| 「产品名称」 | 自定义组织在工作台与登录页展示的系统名称 | 继承平台默认 | 管理员（须白标授权） |
| 颜色配置（「主色」「页面背景」等） | 全组织的浅色与深色界面主题色彩 | 继承平台默认 | 管理员（须白标授权） |
| 「圆角」 | 界面组件的圆角弧度（如 8px） | 继承平台默认 | 管理员（须白标授权） |
| 「资源缩略图风格」 | 文档、文件、成员等名称前的小图风格（双色线条、渐变色块、柔和浅色） | 双色线条（默认） | 管理员（须白标授权） |
| 「Agent 的称呼」等术语 | 工作台、邮件中助手的统称及草稿、应用等称谓 | 「助理」「草稿」「应用」 | 管理员（须白标授权） |
| 登录页标题、说明与要点 | 登录页面左侧展示的宣传文案（纯文本，每项最多 120 字） | 平台默认 | 管理员（须白标授权） |
| 「帮助中心」「服务条款」等外链 | 界面页脚与帮助入口的跳转链接 | 继承平台默认 | 管理员（须白标授权） |
| 品牌标志（浅色、深色、方形图标） | 顶栏、侧栏、深色模式与浏览器标签页图标（≤ 512 KB） | 未设置（继承平台） | 管理员（须标志授权及对象存储） |
| 「页面封面」 | 供组织内各页面选用的顶部封面图（≤ 2 MB，最多 12 张） | 无 | 管理员（须标志授权及对象存储） |
| 「组织的地址」 | 组织在平台下的专属二级域名（`{slug}.{平台域}`） | 平台建议名称（多为组织 ID） | 管理员（不依赖自定义域名授权） |
| 自定义域名 | 绑定专属独立域名，用于工作台登录或托管站点 | 无 | 管理员（须自定义域名授权） |

## 注意事项

- **白标授权与继承机制**：
  - 生效的品牌由平台默认品牌与组织自定义覆盖按许可字段合并生成。未覆盖的项显示「继承」徽章并使用平台默认值。
  - 若仅配置了方形图标或产品名称，未单独配置宽标志，系统**不会**继承平台的宽 Logo。
  - 未单独设置深色标志时，深色模式会自动复用浅色标志。
  - 邮件发件人（From）地址与功能隐藏项在当前页面中没有配置控件。
- **色彩规范与对比度要求**：
  - 文字对比度必须严格符合 WCAG AA 规范（4.5:1）。
  - 若正文文字与页面背景、或主色上的文字与主色的对比度低于 4.5，系统禁止保存并提示「对比度不足，无法保存」。
  - 浅色模式为必检项；仅在启用了深色模式自定义色彩时，系统才会同时校验深色模式的对比度。
- **文件上传与即时生效**：
  - 标志文件支持 PNG、JPEG、WebP、SVG 格式，大小不超过 512 KB。
  - 页面封面支持 PNG、JPEG、WebP 格式，大小不超过 2 MB，比例建议约 4:1，最多可上传 12 张。
  - **标志与封面的上传或移除操作均立即生效**，无需点击页面底部的「保存品牌」按钮。
  - 移除封面图后，已选用该封面的页面会直接显示为空白封面。
  - 文件上传依赖系统底层配置文件对象存储，未配置文件存储时上传功能不可用。
- **组织地址修改约束**：
  - 组织地址必须由小写字母开头，长度为 3–40 个字符，仅包含小写字母、数字和连字符 `-`，不能包含连续连字符 `--`，且不能使用平台保留字（如 admin、api、app、apps、ops 等）。
  - 修改组织地址后，**旧地址立即失效**。所有使用旧地址保存的浏览器书签、分享链接均无法访问，组织成员须使用新地址登录。
  - 组织自身的地址不支持释放，只能改名。若底层身份服务添加新地址失败，系统将整单回滚操作。
- **自定义域名绑定与用途限制**：
  - 域名用途分为「打开工作台（员工登录用的地址）」与「托管一个站点（营销页面，访客无需登录）」。**用途在添加后无法修改**；如需变更用途，必须先释放域名后再重新添加。
  - 不能将平台自身的域名或其子域名绑定为自定义域名。
  - 一个自定义域名只能绑定一个组织。
  - 根域名通常不支持 CNAME 解析，建议使用 `www` 等子域名，或通过 DNS 供应商的 ALIAS / ANAME 记录进行解析。
  - 组织内站点域名配额上限默认为 10 个（包含未验证状态的域名）。
  - DNS 验证通过后，系统会在用户首次通过 HTTPS 访问该域名时自动申请 SSL 证书。
  - 工作台自定义域名验证通过后会自动加入登录可用主机列表；托管站点域名仅用于免登录营销页面展示，不加入登录主机列表。
  - 产品本身不检查域名备案状态；若系统部署于中国大陆机房并向公众开放，需自行办理完成域名 ICP 备案。
  - 若微信公众号需要配置相关集成，要求使用自有域名（详见 [连接器与集成](/admin/connectors)）。

## 目前不支持

- 在组织控制台内自定义邮件发件人地址（From）或设置功能隐藏（页面未提供配置控件）。
- 通过助手直接上传或删除品牌标志与页面封面。
- 在产品界面内提供域名备案向导或微信公众号后台配置向导。
- 自定义域名验证后自动变更用途（如直接在工作台与托管站点之间切换）或自动迁移 DNS 解析记录。
- 在「域名」页面通过 URL 参数（如 `?domain=`）自动滚动定位到指定域名卡片。

## 常见问题

#### 为什么调整了主色或背景色后，点击「保存品牌」没有反应或提示无法保存？
系统要求界面文字对比度必须符合 WCAG AA 规范（至少 4.5:1）。当「正文文字与页面背景」或「主色上的文字与主色」对比度低于 4.5 时，界面会提示「对比度不足，无法保存」，并明确指出哪个模式下的对比度未达标。请根据实时预览下方的对比度数值调整颜色明暗，数值达到 4.5 以上后即可正常保存。

#### 为什么上传了新的品牌标志或封面图，没有点击「保存品牌」就已经在页面上生效了？
品牌标志与页面封面的上传与移除属于即时生效操作。文件上传或删除成功后会直接写入存储系统并更新组织配置，无需点击底部的「保存品牌」按钮。

#### 修改了「组织的地址」（平台子域）后，原有的链接还能访问吗？可以释放该地址吗？
不能。修改组织地址后，原地址会立即失效，使用旧地址保存的书签和历史分享链接将全部打不开，全体成员必须使用新地址登录。此外，组织自己的平台专属地址不支持释放，只能进行改名。

#### 自定义域名的「用途」选错了，可以直接在卡片上修改吗？
不能直接修改。域名用途在添加后无法变更。如果需要更改用途（例如从「打开工作台」改为「托管一个站点」），你必须先点击该域名卡片上的「释放域名」将域名解绑，然后重新点击「添加域名」，输入域名并选择正确的用途。

#### 为什么界面上看不到深色标志的上传控件？
默认情况下，深色模式会自动复用浅色标志。如果你需要为深色模式设置单独的 Logo，请在「标志」区域勾选「深色模式使用单独的标志」，勾选后界面会展开「深色标志」的上传与设置项。