# 个人账号设置

账号设置是与 [工作台](/guide/workspace) 同源的独立页面。用于管理你的头像、显示名、用户名、查看只读的邮箱与角色、修改密码，以及设置「登录后提醒我设置通行密钥」。

## 谁能用

所有已登录的本组织成员均可使用，包括拥有「成员」「分析员」「管理员」「审计员」角色的用户。你在本页面修改的是本人资料：

- **本人修改**：你可以修改本人的头像、显示名、用户名与登录密码，并开启或关闭通行密钥登录提醒。
- **管理员代改**：管理员可在 [成员管理](/admin/members) 页面代改其他成员的显示名、用户名或头像。代改后系统会向对方发送通知消息。管理员不能替成员设置明文密码，只能向其发送一次性验证码。
- **只读权限**：邮箱与角色信息由组织管理员统一分配与管理，在本页面属于只读项，界面提示「邮箱和角色由管理员管理。」。
- **助手权限**：助手与委托令牌不能修改你的个人账号，禁止执行改密、换头像或修改用户名等操作。
- **未登录拦截**：未登录用户访问本页面会自动跳转到 [登录](/guide/sign-in) 流程。若页面加载失败，展示「无法打开账号设置」界面，并提供「回到工作台」链接。

## 怎么打开

你可以通过以下方式进入个人账号设置：

1. 在 [工作台](/guide/workspace) 左侧栏底部点击账号菜单。
2. 在弹出的菜单项中点击「账号设置」，页面跳转到账号设置。
3. 访问地址为 `https://app.{base}/account`，或组织专属域名下的账号设置页。该页面与工作台同源，与统一登录页面 `id.{base}` 不同源。
4. 「我的组织」里不再有「我的账号」页：本人的信息、权限和额度都在账号设置页。
5. 完成设置后，点击页面顶栏的「返回工作台」可回到工作台首页；点击「退出登录」可结束当前会话。
6. 页面顶栏右上角提供语言切换选项，支持切换「简体中文」与「English」。

> **提示**
>
> 页面数据加载过程中，辅助阅读提示为「加载中」。

## 界面一览

整页标题为「账号设置」，副标题为「头像、名字和密码，修改后对所有应用生效。」。在宽屏设备上，各区域左侧显示标题与说明，右侧显示表单内容（表单列宽度约为 460 像素，整页最大宽度约为 860 像素）。

![「账号设置」：头像、名字、登录与角色](/shots/account-profile.webp)

图：「账号设置」：头像、名字、登录与角色

1. 「返回工作台」：回到工作台欢迎页
2. 整页标题「账号设置」
3. 「头像」：PNG 或 JPEG，不超过 2 MB
4. 「显示名」：最多 60 个字，旁有「保存」
5. 「邮箱」只读：用来登录，暂时不能修改

页面自上而下包含五个设置区域：

| 区域 | 关键元素 | 界面说明 |
|---|---|---|
| 「头像」 | 「上传头像」或「更换头像」、「使用这张」、「移除」、图片预览区 | 管理个人头像。无头像时显示「上传头像」与字母占位；已有头像时显示「更换头像」与「移除」。规则要求「PNG 或 JPEG，不超过 2 MB」。选择新图片后提示「这是预览，点「使用这张」才会保存。」。 |
| 「名字」 | 「显示名」输入框、用户名输入框、「保存」按钮 | 修改对外展示的名字与组织内登录短名。显示名提示「最多 60 个字」；已有用户名提示规则「小写字母、数字、点、下划线、连字符，3–32 位，首尾必须是字母或数字」；尚未设置用户名时提示「你还没有用户名。设一个，在组织里更好认。」。 |
| 「登录与角色」 | 「邮箱」只读框、角色徽章 | 查看登录邮箱与当前组织角色。「邮箱」提示「用来登录，暂时不能修改。」。角色徽章展示「成员」「分析员」「审计员」「管理员」。页面不展示组织名称，没有当前组织信息行。 |
| 「修改密码」 | 「当前密码」「新密码」「再输一次新密码」输入框、「修改密码」按钮 | 修改登录密码。说明提示「忘记密码请回到登录页，用「忘记密码」重设。」。三项输入完整后提交按钮方可点击。 |
| 「通行密钥」 | 开关「登录后提醒我设置通行密钥」 | 设置登录后的通行密钥引导。说明提示「登录后，如果你还没有通行密钥，会提示你设置。选过「不再提示」的话，可以在这里重新打开。」。 |

## 常用操作

### 更换或移除头像

1. 在「头像」区域，点击「上传头像」（若已有头像则点击「更换头像」）。
2. 在弹出的系统文件选择窗口中，选择本地图片文件。
3. 选择图片后查看预览画面，界面提示「这是预览，点「使用这张」才会保存。」。
4. 确认后点击按钮「使用这张」。头像保存成功并立即生效，对所有应用可见。
5. 若需清除自定义头像，在「头像」区域点击「移除」，头像恢复为首字母占位。

> **注意**
>
> - 系统根据文件头信息识别真实格式，不依据文件扩展名。仅支持 PNG 或 JPEG 图片，不支持 SVG、GIF、WebP 格式。
> - 图片体积不得超过 2 MB，空文件无法上传。
> - 更换新头像后，旧头像的图片地址立即失效。

### 修改显示名

1. 在「名字」区域的「显示名」输入框中输入新的显示名。
2. 点击输入框右侧的「保存」按钮（如果输入内容与已保存的名字完全相同，或者仅修改了首尾空格，「保存」按钮保持不可用状态）。
3. 保存成功后，界面提示「已保存」。修改后的显示名对所有应用生效，工作台欢迎页将展示该名字的第一段。本人修改显示名不会发送消息通知。

### 修改用户名

1. 在「名字」区域的用户名输入框中输入新用户名。
2. 输入过程中，系统会即时检测该用户名是否可用。如果该用户名已被其他成员占用，界面提示「这个用户名已被占用，请换一个。」，并给出建议名称。
3. 等待检测通过且显示名称可用后，点击右侧的「保存」按钮。
4. 保存成功后，界面提示「已保存。原来的用户名已释放。」。
5. 保存后你可以使用新用户名登录系统（原有邮箱仍可继续使用）。

### 修改密码

![「修改密码」](/shots/account-password.webp)

图：「修改密码」

1. 区块「修改密码」
2. 须先填「当前密码」
3. 「新密码」须符合组织策略

1. 在「修改密码」区域，在「当前密码」输入框中输入你正在使用的密码。
2. 在「新密码」输入框中输入符合组织策略的新密码。
3. 在「再输一次新密码」输入框中重新输入一遍新密码。
4. 三个字段均填写完成后，点击按钮「修改密码」。
5. 修改成功后，界面提示「密码已修改。」。系统会向你的 [消息中心](/guide/messages) 发送一条内容为「密码已修改」的系统消息。系统审计日志中不会记录你的明文密码。

> **注意**
>
> - 如果连续输错当前密码，系统将触发安全限流：15 分钟内连续输错 5 次当前密码，改密接口将被锁定，提示「尝试太频繁了，请过几分钟再试。」。
> - 若忘记当前密码，本页面无法进行无旧密码重置。请退出登录，前往 [登录](/guide/sign-in) 页面，点击「输入激活码 / 验证码，设置密码」，通过邮件验证码或向管理员索取验证码完成密码重置。

### 管理两步验证

「两步验证」区域列出你的验证器 App 和通行密钥。每次修改前都要再输一次当前密码。

![「两步验证」：验证器 App 与通行密钥](/shots/account-mfa.webp)

图：「两步验证」：验证器 App 与通行密钥

1. 区块「两步验证」，修改前要再输当前密码
2. 验证器 App：设置、更换或移除
3. 通行密钥列表：在这里移除，在登录页添加
4. 开关：登录后是否再提示登记通行密钥

1. **设置验证器 App**：在「验证器 App」一行点击「设置」，输入当前密码后点击「继续」。用 Google Authenticator、Microsoft Authenticator 等 App 扫描二维码（或手动输入下方密钥），App 里会出现名为「Raise」的条目。再把 App 上的 6 位数字填进「验证码」，点击「完成设置」。之后登录时，输完密码还要输入验证码。
2. **更换验证器 App**（换手机时）：点击「更换」，输入当前密码。旧的验证器会立即失效，按第 1 步扫描新的二维码完成设置。
3. **移除验证器 App**：点击「移除」，输入当前密码后确认。
4. **移除通行密钥**：在对应通行密钥一行点击「移除」，输入当前密码后确认。通行密钥只能在登录页添加。
5. 每次设置或移除，[消息中心](/guide/messages) 都会收到一条系统消息。

> **提示**
>
> - 组织要求两步验证时，全部移除后，下次登录会要求重新设置。
> - 手机丢了、登不进来：请组织管理员在「我的组织」的「成员」页对你使用「重置两步验证」，然后重新登录设置。
> - 以前扫过、App 里显示为「ZITADEL」的条目仍然可用；想改成「Raise」，点「更换」重新扫码即可。

### 设置通行密钥登录提醒

1. 在「两步验证」区域底部，查看开关「登录后提醒我设置通行密钥」。
2. 拨动开关至开启状态：下方说明显示「下次登录会提示设置通行密钥（组织允许通行密钥、你还没有通行密钥时）。」。当组织开启通行密钥功能且你未绑定通行密钥时，下次登录将提示登记。
3. 拨动开关至关闭状态：下方说明显示「已关闭：登录后不再提示。」。下次登录时系统不再弹出通行密钥设置提示。
4. 开关状态跟随账号保存，在其他浏览器登录同样生效。

### 查看「我能做什么」和「模型额度」

在「登录与角色」之后有两个只读区域：

- 「我能做什么」：「精细权限」是「已开启：按业务角色」还是「未开启：按默认规则」；有的话还显示「所在部门」「组织角色」和具体权限及其范围（「本人的」「本部门的」「本部门及下级的」「全部的」「指定部门的」）。组织未细分权限时提示「组织未细分权限，按平台角色使用应用。」。
- 「模型额度」：「本月已用」的 tokens 数，以及「额度」状态（「你的模型使用被管理员暂停了」「没有设上限」「本月额度已用完」或「还剩 … tokens」）。

两处各自加载，一处失败只在该处显示错误，不影响其他设置。

### 切换界面语言

1. 在页面顶栏右上角找到语言切换区域。
2. 点击「简体中文」或「English」。
3. 语言偏好保存在当前浏览器的本地缓存中。账号设置表单内没有单独的语言设置项。

## 状态说明

### 角色徽章显示规则

系统在「登录与角色」区域根据你拥有的组织角色显示对应的身份徽章：

| 拥有角色 | 徽章显示 | 说明 |
|---|---|---|
| 仅普通成员 | 「成员」 | 仅拥有基础成员权限时显示。 |
| 拥有管理或专项角色 | 「分析员」「审计员」「管理员」 | 拥有额外角色时，显示对应的专属角色徽章，不再重复显示人人皆有的「成员」徽章。 |

### 用户名状态

- **未设置用户名**：输入框旁提示「你还没有用户名。设一个，在组织里更好认。」。
- **已设置用户名**：输入框旁显示格式规则提示「小写字母、数字、点、下划线、连字符，3–32 位，首尾必须是字母或数字」。修改保存后，原用户名立即释放供组织内其他成员使用。

### 通行密钥提醒状态

- **开启**：界面显示「下次登录会提示设置通行密钥（组织允许通行密钥、你还没有通行密钥时）。」。
- **关闭**：界面显示「已关闭：登录后不再提示。」。

## 让助手帮你做

助手无法在账号设置页面执行任何操作。

系统禁止通过委托令牌发起账号写操作。出于账号安全与凭据保护考虑：

- 助手不能修改你的登录密码。
- 助手不能上传、更换或移除你的头像。
- 助手不能修改你的显示名或用户名。
- 助手不能修改通行密钥提醒设置。

所有个人资料与凭据设置必须由你本人在页面中手动操作。若需代改资料，可联系管理员在后台协助处理。

## 设置

个人账号设置项汇总如下：

| 设置项 | 作用 | 取值与限制 | 默认值 | 谁能修改 |
|---|---|---|---|---|
| 「显示名」 | 对外展示的名字；工作台欢迎页第一段 | 1–60 个字，最多输入 80 个字符，不能包含控制字符 | 邀请时的名与姓，或留空 | 本人；管理员可在后台代改 |
| 用户名 | 组织内短标识，可用作登录名 | 3–32 位，包含小写字母、数字、点、下划线、连字符，首尾必须是字母或数字，全平台唯一 | 可能为空（激活时由成员设置） | 本人；管理员可在后台代改 |
| 「头像」 | 个人头像展示 | PNG 或 JPEG 图片，文件大小不超过 2 MB | 无头像时展示字母占位 | 本人；管理员可在后台代改 |
| 「邮箱」 | 登录名之一，用于接收通知与验证码 | 只读，提示「用来登录，暂时不能修改。」 | 邀请时填写的邮箱 | 无法修改（由管理员管理） |
| 「角色」 | 组织身份与权限展示 | 只读，徽章包括「成员」「分析员」「审计员」「管理员」 | 至少为「成员」 | 管理员在「成员」管理中修改 |
| 「修改密码」 | 修改登录凭据 | 需输入当前密码；新密码需符合组织密码要求，长度不超过 512 个字符，且不能与当前密码相同 | — | 仅限本人（必须验证当前密码） |
| 「登录后提醒我设置通行密钥」 | 控制登录后是否提示登记通行密钥 | 开启或关闭 | 开启（在登录页点过「不再提示」后为关闭） | 本人 |
| 语言 | 控制本页与全站的界面文案语言 | 「简体中文」「English」 | 未设置时为中文 | 本人（保存在当前浏览器） |

## 注意事项

- **头像上传限制**：
  - 上传空文件时，提示「这个文件是空的」。
  - 图片体积超出 2 MB 时，本地校验提示「图片 … MB，超过了 2 MB 的上限，请换一张小一点的」，服务端校验提示「图片太大了，不能超过 2 MB。」。
  - 选择非 PNG 或 JPEG 图片时，提示「头像只支持 PNG 或 JPEG 图片（不支持 SVG、GIF、WebP）」。
- **显示名校验规则**：
  - 显示名留空点击保存时，提示「请输入显示名」。
  - 长度超过 60 个字时，提示「最多 60 个字」。
  - 包含控制字符时，提示「不能包含控制字符」。
- **用户名校验规则**：
  - 用户名留空点击保存时，提示「请输入用户名」。
  - 长度少于 3 个字符时，提示「至少 3 位」。
  - 长度超过 32 个字符时，提示「最多 32 位」。
  - 格式不符合规则时，提示「小写字母、数字、点、下划线、连字符，3–32 位，首尾必须是字母或数字」。
  - 用户名已被他人占用时，提示「这个用户名已被占用，请换一个。」，并附带替代建议。
- **修改密码校验规则与限流**：
  - 未填当前密码时，提示「请输入当前密码」。
  - 未填新密码时，提示「请输入新密码」。
  - 新密码长度超过 512 个字符时，提示「密码太长」。
  - 新密码与当前密码相同时，提示「新密码不能和当前密码相同」。
  - 两次输入的新密码不一致时，提示「两次输入的新密码不一致」。
  - 当前密码输入错误时，提示「当前密码不对。」。
  - 密码输入错误计入安全限流：15 分钟内连续输错 5 次当前密码，接口将被锁定，提示「尝试太频繁了，请过几分钟再试。」。
  - 新密码不符合组织策略时，提示「新密码不符合组织的密码要求。」，并在下方列出具体未满足的条文要求（如「至少 12 位」等）。
- **系统服务异常**：
  - 若身份服务暂时不可达，提示「身份服务暂时不可用，请稍后再试。」。
  - 若发生其他通用错误，提示「出错了，请重试。」。
- **通知与审计记录**：
  - 本人修改显示名、用户名或头像时，不会向系统消息中心发送通知。
  - 管理员在后台代改你的显示名、用户名或头像时，系统会向你发送系统通知，并记录组织审计日志。
  - 修改密码成功后，系统会向本人消息中心发送通知，但不会在审计日志中记录任何密码明文。
- **组织信息展示**：账号设置页面不显示组织名称，界面中没有当前组织信息行。

## 目前不支持

- 自主修改登录邮箱（需由管理员统一管理）。
- 在本页面查看通行密钥列表、重命名、删除或直接登记通行密钥。
- 查看当前会话、已登录设备列表或执行设备下线操作。
- 在本页面切换深色或浅色外观（外观设置位于工作台账号菜单）。
- 在本页面管理两步验证器（第二重验证设置由登录流程触发）。
- 在本页面配置通知邮箱偏好（消息推送偏好位于消息中心的通知偏好设置）。

## 常见问题

#### 1. 为什么在账号设置页面无法修改邮箱？
邮箱是系统登录与接收通知的核心凭据，由组织管理员在邀请成员时设定，页面提示「用来登录，暂时不能修改。」。成员无法自行变更，如需变更请联系组织管理员在 [成员管理](/admin/members) 页面处理。

#### 2. 忘记了当前密码，可以在本页面直接重置吗？
不能。本页面的「修改密码」功能要求必须提供正确的「当前密码」。如果你忘记了当前密码，请退出登录并前往 [登录](/guide/sign-in) 页面，点击「输入激活码 / 验证码，设置密码」，通过邮箱验证码或向管理员索取一次性验证码来重设密码。

#### 3. 为什么修改密码时提示「尝试太频繁了，请过几分钟再试。」？
为了防止暴力破解密码，系统设置了安全频次限制：在 15 分钟内如果输错当前密码达到 5 次，改密接口将被临时锁定。请等待几分钟后再试。

#### 4. 可以在账号设置页面直接添加或删除通行密钥吗？
不能。账号设置页面仅提供「登录后提醒我设置通行密钥」开关，用于控制下次登录时是否引导设置。系统目前不提供在本页面查看通行密钥列表、重命名、删除或直接登记通行密钥的功能。通行密钥登记需在登录过程中根据系统提示完成。

#### 5. 可以让助手帮我修改用户名或密码吗？
不能。系统禁止通过委托令牌进行任何账号写操作。助手没有权限修改你的密码、头像、显示名或用户名等个人资料，所有修改必须由你本人手动操作。