# 成员快速上手

这是普通成员第一天使用 Raise 的快速上手指引。你将完成从接收管理员邀请、使用验证码激活并设置密码，到进入工作台、与助手开启第一次对话、打开业务应用以及处理草稿与消息的完整过程。

## 谁能用

- **本人**：被邀请加入组织的人员。登录后界面角色徽章至少为「成员」。分析员、管理员、审计员第一天的上手路径相同，区别仅在于能够打开的应用范围以及「我的组织」页面中能查看的内容。
- **邀请方**：由组织管理员（或部门管理员在「组织结构」里）发起邀请。成员自己不能邀请他人。当组织席位已用完时，管理员会看到「席位已用完」且无法继续邀请；成员侧无此提示。
- **不可用账号**：没有组织角色的账号（如运营员、开发者）登录后无法进入工作台，页面会显示标题「这个账号不能使用工作台」。

> **提示**
>
> 本指南适用于被邀请的普通成员。组织管理员开通组织的完整指引请参考 [管理员快速上手](/guide/quick-start-admin)。

## 怎么打开

普通成员通过以下三种方式之一获取工作台入口：

1. **邀请邮件**：组织配置了邮件服务时，身份服务会自动发出邀请邮件，邮件内包含验证码；管理员提示框中还会显示「登录地址：」`https://{组织主机}`。
2. **管理员当面提供的验证码与登录地址**：组织未配置邮件服务，或管理员邀请时勾选了「直接显示邮箱验证码」；管理员会将登录地址与一次性验证码直接提供给你。该验证码在管理员界面仅显示一次。
3. **公司账号**：组织接入了第三方身份源，且允许自动创建账号或你已被提前邀请。打开工作台登录页后，点击「或者用公司账号登录」区域里对应的「用……登录」按钮（按钮显示组织配置的公司名称）。

工作台访问地址为 `https://app.{base}`，或组织专用的 `{name}.{base}` 以及已验证的自定义域名。未登录状态下访问工作台，浏览器会自动跳转到登录页。

> **注意**
>
> 请从工作台或邀请里的登录地址进入，不要单独把登录页收藏为首页。

## 界面一览

第一天进入系统，你会依次接触到认证界面与工作台的核心区域：

![第一次进入工作台的欢迎页](/shots/member-welcome.webp)

图：第一次进入工作台的欢迎页

1. 左栏「新会话」
2. 欢迎页：尚未发出第一条消息，还没有会话
3. 「试试这样问」快捷问法
4. 输入框「输入问题或任务…」

| 界面 / 区域 | 界面内容 | 关键原文与说明 |
|---|---|---|
| 登录 · 识别页 | 输入登录账号 | 标题显示「登录」，提供输入框「登录名」与按钮「下一步」。组织允许时提供「用通行密钥登录」；配置了公司账号时提供「或者用公司账号登录」。详见 [登录与激活](/guide/sign-in)。 |
| 登录 · 密码页 | 密码验证与激活入口 | 标题显示「输入密码」。下方提供引导「第一次登录（还没有密码），或忘记了密码？」以及链接按钮「输入激活码 / 验证码，设置密码」。 |
| 登录 · 激活页 | 设置初始密码与用户名 | 标题显示「用验证码设置密码」。提供输入框「验证码」「新密码」「再输一次」；需自定义用户名时包含「你的用户名」。详见 [登录与激活](/guide/sign-in)。 |
| 工作台欢迎页 | 欢迎信息与对话起步 | 页面中间是按时段的问候（如「下午好，显示名」；无显示名时只有「下午好」），问候下面就是输入框；输入框下方是「试试：」快捷问法（点一下放进输入框，可改后再发）、「接着上次：」最近的会话，以及「工作区 / 可读 N 个应用」状态行。详见 [工作台概览](/guide/workspace)。 |
| 左侧栏 | 导航、会话与账号 | 包含品牌图标、搜索框「搜索会话」、按钮「新会话」、「置顶的应用」列表、历史会话列表，以及底部的个人账号菜单。尚无会话时显示「还没有会话。说点什么，助手就会开始。」。 |
| 应用面板 | 业务应用容器 | 位于工作台顶栏右侧，按钮显示为 **App**（无障碍标签为「打开应用面板」）。组织未安装应用时显示「你的组织还没有安装应用」与「请联系组织管理员安装。」。 |
| 草稿卡片 | 助手起草的数据修改 | 嵌入在会话消息中，标题缺省为「助手起草了一份修改」。待审状态显示「审阅」按钮，已处理状态显示「查看」按钮。 |
| 消息中心 | 系统通知与待办提醒 | 标题显示「消息中心」，包含「全部」与「未读」标签页。详见 [消息中心](/guide/messages)。 |

## 常用操作

### 接收邀请与获取信息

成员无需自行发起邀请，由管理员在「我的组织」的「成员」页面中点击「邀请成员」：

1. 管理员在邀请弹窗中填写必填项「邮箱」（占位文字为 `name@company.com`），选填「名」「姓」，并可按需设置「管理权限（可不选）」（可选分析员、管理员或审计员，不选则为普通成员）。
2. 管理员默认勾选「直接显示邮箱验证码」（说明文字为「未配置邮件服务时勾选，否则邀请邮件直接发给对方。」）并点击「邀请」。
3. 管理员提交后，系统提示已邀请该邮箱。若勾选了直接显示验证码，弹窗标题显示已邀请该邮箱，说明「把验证码发给对方，对方在登录页输入账号后填入验证码并设置密码。」，同时带有警示「验证码只显示这一次」及复制按钮，下方提供「登录地址：」与组织主机，管理员点击「完成」。
4. 若邮箱已被注册，系统提示「这个邮箱已经是成员」。若邮箱前缀的默认用户名被占用，系统会提示该名称已被同事占用，并提示给这位成员一个不同的用户名，管理员可选择推荐建议、「自己输入」或选择「让对方自己选」（提示「对方激活时自己选用户名。」）。
5. 在管理员的成员列表中，未完成激活的账号状态显示为「待激活」。管理员可点击「重发邀请」，生成新验证码并使旧验证码作废。

成员最终拿到的是：**邀请邮箱（登录名）**、**一次性验证码** 以及 **登录地址**。后台不会替你预设密码。

### 激活并第一次登录

1. 在浏览器中打开管理员提供的登录地址（或邀请邮件中的链接）。
2. 在「登录名」输入框中输入被邀请的邮箱地址，点击「下一步」。
3. 进入「输入密码」界面，因尚未设置过密码，点击下方的「输入激活码 / 验证码，设置密码」。
4. 进入「用验证码设置密码」界面：
   - **获取与填写验证码**：若组织配置了邮件服务，可点击「发送验证码」，系统提示「如果这个账号存在，验证码已发到它的邮箱。几分钟内没收到，请看垃圾邮件，或再发一次。」，按钮在 60 秒内显示倒计时，倒计时结束后显示「重新发送验证码」（也可以直接使用邀请邮件中的验证码）；若未配置邮件服务，页面说明「未配置邮件服务，请向管理员索取验证码。」，直接输入管理员提供的验证码。在「验证码」输入框填入收到的 4–32 位字母或数字验证码。若验证码错误或已失效，系统提示「验证码不对或已过期。可以重新发送一个。」。
   - **设置新密码**：在「新密码」与「再输一次」输入框中输入密码。密码规则由组织统一配置（包含长度、大小写字母、数字及符号要求）。若不符合规则，系统提示「密码不符合要求：请用更长的密码，并混合大小写字母、数字和符号。」；若两次输入的密码不一致，系统提示「两次输入的密码不一致」。
   - **设置用户名（若需要）**：若管理员设置了由你自行选择用户名，或默认用户名已被占用，页面会出现「你的用户名」输入框。格式规则为「小写字母、数字、点、下划线、连字符，3–32 位，首尾必须是字母或数字」。输入可用名称时提示「可以使用」；若被占用，提示「这个用户名已被占用，请换一个。」，并在旁边提供「试试：」候选建议。
   - 填写完毕后，点击「设置密码并登录」（若包含用户名输入框，按钮为「设置密码、用户名并登录」）。
5. **设置第二重验证（若组织强制要求）**：若组织启用了强制两步验证且你尚未配置，页面弹出标题「设置第二重验证」。使用认证应用扫描二维码或复制密钥，在输入框中填入 6 位验证码，点击「完成设置」。
6. **设置通行密钥（若组织允许）**：若组织支持通行密钥且你尚未绑定，页面弹出标题「设置通行密钥？」。你可以选择「设置通行密钥」完成登记，或选择「以后再说」，也可以选择「不再提示」。
7. 界面显示「正在进入…」，验证完成后自动进入工作台。

### 浏览工作台

成功登录后，先进入欢迎页；发出第一条消息后才会建立会话（[在产品里打开工作台](https://app.kwork.cloud/)）：

- **欢迎屏**：页面中间显示按时段的问候（早上好 / 上午好 / 下午好 / 晚上好，有显示名时接在后面），问候下面就是输入框（「想让助手做什么？」）。输入框下方是「试试：」快捷问法（已安装应用时为「我现在能用哪些应用？分别能做什么？」、帮我看看某个应用里有什么、「总结一下最近有什么需要我处理的」；未安装应用时为「你能帮我做什么？」；组织在「助手」设置里写了自己的问法时用组织的），点一下放进输入框，可修改后按 Enter 发送；有过会话时还有「接着上次：」最近三个会话。最下面一行是「工作区」和「可读 N 个应用」。助手仅具备读取与起草权限（输入框里「只读」的说明），修改需由人工确认后生效。
- **左侧栏导航**：包含品牌图标、搜索框「搜索会话」、操作项「新会话」、「置顶的应用」列表、历史会话列表，以及底部的个人账号菜单。当没有历史会话时，侧栏提示「还没有会话。说点什么，助手就会开始。」。
- **工作台布局**：宽屏环境下展示完整的三栏布局；在移动端或平板等窄屏设备下会自动折叠响应，详见 [移动端与平板设备](/guide/devices)。

### 第一次和助手对话

![发出第一条消息后的对话](/shots/member-first-chat.webp)

图：发出第一条消息后的对话

1. 对话区：第一条发出后才创建会话
2. 你的消息（角色「你」）
3. 助手回复（流式结束后可展开思考过程）
4. 输入框仍在底部，可继续发或排队
5. 「发送」（Enter）

1. 在欢迎页点击「试试这样问」中的任意一条示例，或在输入框「输入问题或任务…」中输入内容。按 Enter 键发送消息，按 Shift+Enter 换行。
2. **创建会话**：发出第一条消息后，系统才会正式创建会话，左侧栏也会同步新增该会话记录。未发送消息前刷新欢迎页不会产生空白会话。
3. **查看回复**：助手会以流式打字效果输出内容。助手的思考过程会折叠为「思考中…」，处理完成后显示为「思考过程」或用时时间。
4. **处理交互卡片**：对话中可能出现以下交互卡片：
   - **提问卡**：卡片标题为「助手想先确认一下」，支持单选、多选或手动输入选项，提交反馈后当前轮次继续进行。
   - **动作卡**：卡片标题为「助手想执行一个动作」，提供「确认」与「取消」按钮。未经你手动点击确认，动作不会被执行。
   - **草稿卡**：标题缺省为「助手起草了一份修改」，待审状态显示「审阅」按钮，已处理状态显示「查看」按钮。点击后会在对应的业务应用中打开草稿详情。
   - **对象链接**：消息中的对象链接必须由你主动点击，才会打开对应应用。
5. **排队与停止生成**：在助手正在回复处理时，你可以继续在输入框中输入并发送新消息，消息将标记为「排队中」（队列最多支持 20 条），并可点击「撤回排队的消息」取消发送；输入框为空且助手正在生成时，输入框旁显示「停止」按钮。
6. **添加引用与附件**：
   - 点击「引用」按钮可关联知识库、文档、云盘、资料库或成员信息，单条消息最多可添加 20 条引用。
   - 点击「添加附件」可上传文件，支持图片（单文件 ≤ 5 MB）与文本类文件（单文件 ≤ 512 KB），单次最多上传 6 个附件。

> **注意**
>
> 若组织管理员尚未配置可用的大模型，输入框将被禁用，并提示「你的组织还没有可用的模型，请联系管理员（「我的组织」→ 模型与额度）」。

### 打开与管理应用

![点「App」打开应用面板](/shots/member-apps.webp)

图：点「App」打开应用面板

1. 「App」（无障碍「打开应用面板」）
2. 套件菜单第一项是「全部应用」
3. 「最大化」

1. 在助手顶部栏点击 **App** 按钮（无障碍标签为「打开应用面板」）。系统会自动打开上一次查看的应用；若首次使用，则打开列表中的第一个应用。
2. 若组织尚未安装任何业务应用，管理员会看到「去应用市场安装」，普通成员会看到「你的组织还没有安装应用」以及「请联系组织管理员安装。」。
3. **切换与排序页签**：已打开的应用以标签页展示，支持直接点击切换以及拖拽排序。当前套件内已包含但尚未在面板中打开的应用会显示为**虚线页签**，点击后才会正式加载打开。点击套件下拉菜单的第一项「全部应用」可浏览所有可用应用。
4. **系统常驻应用**：系统自带的基础应用始终常驻，包括「我的组织」、「消息中心」，以及 Agent 应用（内置「定时任务」「草稿」「自动应用」入口）。
5. **置顶应用**：点击页签上应用名称旁的菜单，选择「置顶到侧栏」，该应用将固定显示在左侧栏的「置顶的应用」列表中，方便随时直达。

> **提示**
>
> 应用面板仅在你主动点击时才会展开打开。助手只能在对话中提供跳转链接，不会主动替你打开面板。

### 审阅与处理草稿

1. 在对话消息中点击草稿卡片上的「审阅」或「查看」，或者打开 Agent 应用并进入「草稿」页面。
2. **在业务应用中执行**：草稿必须在**拥有数据的对应业务应用**的审阅页面中查看，并由你手动点击应用或放弃。工作台对话界面的草稿卡片上**没有**「应用」按钮。
3. 审阅完成后，草稿卡片副标题会根据处理结果更新显示。
4. **配置自动应用（可选）**：可以在「自动应用」页签中配置规则，对特定类型的变更授权自动生效。第一天上手使用时通常无需配置。

### 查看消息与通知

1. 打开「消息中心」（位于套件「办公」中；或者当工作台弹出新消息浮层提示有新消息时，直接点击「查看」进入）。
2. 在「全部」与「未读」标签页间切换。点击任意单条消息即可展开查看详情，并自动将其标记为已读。若消息包含关联链接，可点击「查看」（跳转至对应应用页面）或「打开链接」（打开外部链接）。
3. 点击顶部的「全部标为已读」按钮，可一键清除所有未读标记。点击齿轮图标可进入「通知偏好」设置外部推送渠道（详见 [消息中心](/guide/messages)）。
4. 工作台最顶部可能出现「全局通知」横幅。对于非紧急通知，可点击「关闭通知」隐藏横幅（关闭状态仅保存在当前浏览器中）。

### 调整个人资料（可选）

1. 点击左侧栏底部的账号菜单，选择「账号设置」。
2. 在账号设置中可以配置个人头像、显示名、修改用户名、修改登录密码，以及设置通行密钥提醒开关（详见 [个人账号设置](/guide/account)）。
3. 界面外观模式（「浅色」「深色」「跟随系统」）与显示语言（「简体中文」「English」）直接在账号弹出菜单中切换，无需进入账号设置页。

## 状态说明

### 账号激活状态

| 状态 | 说明 |
|---|---|
| 「待激活」 | 管理员已在后台发出邀请，成员尚未完成验证码验证与密码设置。 |
| 已激活 | 成员已成功验证身份并设置初始密码，可正常登录进入工作台。 |

### 草稿卡片状态流转

草稿卡片第二行的状态说明会随着审阅进度发生流转：

「不会自动生效，由你审阅后应用」→ 显示有几项等你审阅后应用 → 已应用几项 / 已应用几项并放弃几项 / 「已放弃，没有执行任何修改」

- **初始状态**：显示「不会自动生效，由你审阅后应用」。
- **等待审阅**：显示具体有几项等你审阅后应用。
- **终态**：根据处理结果显示已应用具体项数、已应用并放弃具体项数，或显示「已放弃，没有执行任何修改」。

## 让助手帮你做

在进入工作台的第一天，你可以尝试以下常见指令开启工作：

> 我现在能用哪些应用？分别能做什么？

> 帮我看看具体应用里有什么

> 总结一下最近有什么需要我处理的

> 你能帮我做什么？

> 起草一份修改，我来审阅。

> 把这个页面引用进来。

> **助手的操作边界与确认机制**
>
> - 助手默认仅具备读取与起草权限，无法直接变更业务数据。
> - 助手不能替你点击草稿上的「应用」按钮，所有数据修改必须由你人工审阅确认。
> - 助手不能自动展开或打开应用面板，只能在对话中提供对应的链接。
> - 助手无法在未安装或你没有访问权限的应用中执行操作。
> - 运营员或开发者账号无法登录进入工作台。

## 设置

新成员第一天建议调整的偏好设置如下（除个人账号资料外，其余偏好均保存在当前浏览器本地）：

| 设置项 | 入口位置 | 默认值 | 说明 |
|---|---|---|---|
| 语言选择 | 登录页、账号页、工作台账号菜单 | 简体中文（未设置时） | 支持选择「简体中文」或「English」。 |
| 外观模式 | 工作台账号菜单「外观」 | 跟随系统 | 支持选择「浅色」、「深色」或「跟随系统」。 |
| 「提醒设置」 | 工作台账号菜单 | 全部开启；音色「清脆（双音）」；音量 60% | 控制消息通知与事件提示音的开关、音色与音量。 |
| 「登录后提醒我设置通行密钥」 | 账号设置「通行密钥」 | 开启（除非登录时曾点击「不再提示」） | 控制每次登录进入系统时是否弹出通行密钥绑定提示。 |

## 注意事项

- **验证码一次性与时效**：管理员在后台生成的验证码仅展示一次；若管理员点击「重发邀请」，旧验证码将立即作废，必须使用最新生成的验证码。
- **登录名不可修改**：账号激活后，绑定的邮箱（登录名）本人无法修改。若设置了用户名，后续可以在账号设置中修改，修改后原用户名将被释放供他人使用。
- **配置不跨设备同步**：工作台的偏好设置（包括主题外观、所选套件、置顶应用、页签状态及声音提醒等）保存在本地浏览器中，不会跨设备同步。
- **首次发消息创建会话**：在欢迎页刷新浏览器不会产生空白会话记录，只有在发送第一条消息后系统才会正式建立会话。
- **通知机制**：系统未提供操作系统级的桌面通知，离开浏览器标签页时通过页面标题滚动、标签页红点与提示音进行提醒。
- **套餐配额限制**：组织的席位数量、大模型额度与存储上限受组织套餐限制。成员遇到配额耗尽时会提示「请联系管理员」，无法自行购买或升级。
- **输入与附件规格**：在对话中，排队发送的消息最多支持 20 条；单条消息最多可添加 20 条引用；单次最多上传 6 个附件，其中图片单个 ≤ 5 MB，文本文件单个 ≤ 512 KB。

## 目前不支持

- 成员在前台自助注册账号（必须由组织管理员邀请加入）。
- 登录页提供名为「忘记密码」的独立按钮（需通过「输入激活码 / 验证码，设置密码」流程重置）。
- 在账号设置页面直接登记新的通行密钥（仅能重新开启登录时的设置提示）。
- 全局快捷搜索与命令面板。
- 跨设备同步工作台布局与自定义排版。

## 常见问题

### 收到邀请但没有收到邮件怎么办？
若组织尚未配置邮件服务，系统不会发送邀请邮件。管理员在邀请弹窗中勾选了「直接显示邮箱验证码」，你可以直接向管理员索取一次性验证码与登录地址。若组织已配置邮件服务，请检查邮箱中的垃圾邮件箱，或联系管理员点击「重发邀请」。

### 登录时提示「这个账号不能使用工作台」是怎么回事？
只有具备组织角色（如「成员」、分析员、管理员、审计员）的账号才能进入工作台。没有组织角色的运营员或开发者账号无法使用工作台。

### 为什么输入框是灰色的，不能发送消息？
当组织尚未配置可用的大模型时，工作台输入框会被禁用，并提示「你的组织还没有可用的模型，请联系管理员（「我的组织」→ 模型与额度）」。请联系组织管理员添加模型并分配可用额度。

### 为什么对话里助手给出了修改，但没有直接生效？
助手默认仅具备读取与起草权限。所有的业务修改都会先生成草稿，必须由你在对应业务应用的审阅页面中审阅并点击应用后才会正式生效。工作台对话卡片上不提供直接应用按钮。
