完成本教程后，你可以
- 为自己的电脑选择并安装合适的 Bosi 安装包。
- 连接官方 Xpert 服务或组织自行部署的 Xpert 服务，并完成登录。
- 选择组织和助手，开始对话，并整理侧栏中的助手列表。
- 在设置中调整语言、外观和服务连接，查看用量与积分。
- 更新 Bosi，并排查常见的连接与登录问题。
开始前的准备
使用官方服务时，无需准备服务地址，Bosi 默认连接官方服务。
第一步：下载并安装 Bosi
从以下任一位置下载安装包：- Bosi 下载页
- GitHub Releases：桌面应用的版本以
desktop-v开头，提供全部安装包、压缩包和 SHA-256 校验文件。
各平台安装包的签名与公证情况以对应版本的发布说明为准。未签名的安装包在安装或首次打开时，可能需要你在操作系统的安全提示中确认。
第二步：连接 Xpert 服务
使用官方服务时可以跳过这一步。Bosi 默认连接以下地址：
连接组织自行部署的 Xpert 服务：
- 在登录页点击 连接设置。
- 按管理员提供的信息填写 API 服务地址、Xpert 网页地址和 ChatKit 地址。API 地址可以包含
/api，也兼容原有的服务根地址。 - 等待页面自动检查地址和证书，确认没有错误提示。
- 点击 保存设置，再点击 返回登录。
- 服务地址需要使用 HTTPS；只有本机
localhost地址可以使用 HTTP。地址不能包含账号或查询参数。 - 如果组织使用自签名证书或你信任的私有部署，可以开启 允许不受信任的服务证书。此项默认关闭，只对当前配置的 API、网页和 ChatKit 服务主机生效，开启后不再校验这些主机的证书身份。
- 修改服务地址或证书设置并保存后，Bosi 会重新加载连接，需要重新登录。
- 如果组织提供了定制安装包，服务地址可能已经预先配置好。已保存过的连接设置会优先于新安装包的默认值。
第三步：注册与登录
- 还没有 Xpert 账号时，在登录页点击 注册账号。Bosi 会在系统浏览器中打开注册页面，完成注册和验证后，回到 Bosi 登录。
- 使用 Xpert 邮箱和密码 登录。
- 登录后，Bosi 会加载你所在的组织和可以使用的已发布助手。在侧栏切换到目标组织。
- 在侧栏选择一个助手开始对话，或者从目录中添加专家、应用和助手。
第四步：添加助手并开始对话
发现与添加
点击侧栏的 + 打开 发现与添加，可以搜索并添加：- 数字专家：可访问的专家可以直接使用；需要授权的专家可以填写使用场景并提交申请，审批通过后即可使用。
- 应用：已安装的应用可以直接使用；尚未安装的应用，先查看安装要求，选择需要的向量模型或视觉模型，再完成初始化。点击应用名称或查看详情，可以浏览应用截图。
- 插件：查看租户或组织内已安装的插件。已安装的插件可以直接在会话的 插件 菜单中选择使用。
- 智能体模板：选择你有编辑权限的工作空间，填写助手名称，完成初始化和发布。
对话
窗口右侧是对话区域，嵌入的是 Xpert 的 ChatKit。消息、附件、历史会话、工具、技能、连接器和工作台都在这里使用。可以使用哪些能力，取决于所连接 Xpert 服务的功能和你的权限。群组对话
在菜单 文件 → 新建群组 中，或使用快捷键Cmd/Ctrl+Shift+G，可以创建群组，邀请同事与数字专家在同一个群组中讨论。群组中未 @ 成员时，由默认助手回复；创建后可以继续邀请成员。
第五步：管理侧栏中的助手
右键菜单
在助手上点击右键（包括置顶卡片和收起后的头像栏），可以：- 置顶或取消置顶。
- 移至个人分组，或新建分组。
- 标为已读或标为未读。
- 编辑资料、创建副本。
- 复制会话 ID。
- 编辑个人资料和创建副本只影响这台电脑上的列表，不会修改服务器上的助手。副本与原助手连接同一个助手，共用会话记录。
- 置顶、个人分组和侧栏布局保存在本机，按服务、账号和组织分别记录，不会同步到其他设备。
- 阅读会话或选择 标为已读 会更新平台上的已读状态；标为未读 只是本机提醒。
动态与未读提醒
Bosi 大约每 15 秒刷新一次助手动态，窗口重新获得焦点时也会刷新。列表中显示每个助手最新的会话标题。在 macOS 上，Dock 图标会显示当前组织的未读消息总数；需要在系统设置中允许 Bosi 显示通知和标记。调整侧栏
- 拖动侧栏分隔条，可以在 240 到 520 像素之间调整宽度。
- 向左拖过最小宽度后，侧栏会收起为头像栏。
- 双击分隔条，恢复默认宽度。
助手资料面板
将鼠标停在助手头像上，会打开助手资料面板，包含 动态、渠道、自动化 和 关于 等标签。也可以聚焦头像后按Alt+Down，固定打开面板。
- 动态：查看最近的会话，点击可以打开对应会话。
- 渠道：在常用应用中与当前助手对话。已安装飞书插件时，可以使用 扫码连接。其他渠道是否可以连接，取决于服务端是否安装了对应的 Provider 插件。
- 自动化：在指定时间、按计划或事件发生时，让助手自动开始工作。
- 关于：查看助手的详细说明、发布信息，以及已发布的技能、工具和子智能体数量。
第六步：调整设置
打开设置的方式：- 点击侧栏的用户菜单，选择 设置。
- 使用快捷键
Cmd/Ctrl+,。 - macOS 在 Bosi 菜单中选择 设置；Windows 和 Linux 在 文件 菜单中选择 设置。
修改设置时：
- 改动会立即预览。点击 保存设置 保存，点击 取消更改 恢复已保存的值。
- 点击 返回工作区 回到原来的助手和会话；如果有未保存的改动，Bosi 会提示你确认是否放弃。
- 本机终端的设置需要在该页面单独应用。
- 首次使用时，界面语言根据系统语言初始化。登录后，优先使用账号在平台上设置的语言。
第七步：更新 Bosi
已安装的正式版支持应用内更新：- 有新版本时，侧栏底部的账号区域会出现下载图标，鼠标悬停时显示 更新。
- 点击后开始下载，并显示下载进度。
- 下载完成后，选择 安装并重启 或 稍后。选择安装并重启时，Bosi 会退出、安装更新并重新打开，请先保存当前工作。