完成本教程后，你可以
- 在 Bosi 中与助手协作处理开发任务，使用插件和交付文件。
- 在 Bosi 的对话中使用项目，并理解项目会话的切换规则。
- 通过“创建你的 Bosi”开启本机 Shell，或使用已启用 Desktop Shell 的助手。
- 配置本机终端，并理解三种执行权限的区别。
- 在对话中审批或拒绝助手请求的本机命令。
- 在云电脑中打开编程工具，并理解“模型兼容”等标签的含义。
- 区分本机命令、服务端沙箱命令和云电脑三种执行位置。
- 将 Bosi 连接到自行部署或本地开发的 Xpert 服务。
- 为助手配置定时计划等自动化。
三种开发方式
这些方式可以一起使用：在项目会话中处理任务，需要操作本机时再由助手请求本机命令，需要编程命令行工具时在云电脑中打开。
开始前的准备
项目、本机 Shell 和云电脑的功能和限制可能随版本调整，以你所用版本的界面提示为准。
与助手协作处理开发任务
在 Bosi 中选择助手后，右侧的对话区域提供消息、附件、历史会话、工具、技能、连接器和工作台。处理开发任务时，常用的方式有：- 描述目标，让助手拆解：直接说明要完成的工作和验收方式，例如“检查当前项目目录结构，并说明如何运行测试”。
- 上传附件：把需要分析的文件作为附件发送给助手。
- 选择插件：在 发现与添加 → 插件 中可以查看租户或组织内已安装的插件及其包含的能力。已安装的插件可以直接在会话的 插件 菜单中选择使用，所需的连接仍按现有流程配置和授权。
- 查看交付文件：助手生成文件后，点击对话中的交付卡片，可以预览交付时保存的文件版本并下载。暂不支持预览的格式可以直接下载。
方式一：通过项目进行开发
项目是 Xpert 平台的协作功能，可以把数字专家、工具集、文件资源和会话记录集中在一起，让参与的智能体基于共享的文件和项目级指令完成任务。项目本身的创建、成员、文件、工具集和执行模式，见项目。在 Bosi 中使用项目
Bosi 的对话区域嵌入了 Xpert ChatKit，并在输入框中启用了项目功能。因此，你可以在 Bosi 的对话中直接使用项目，无需切换到网页端。项目相关的按钮、菜单和确认步骤由 ChatKit 提供，具体名称和位置以所连接的 ChatKit 版本为准。 使用项目进行开发时，建议：- 把需求文档、接口说明等资料作为项目文件上传，让项目中的智能体都能读取。
- 为项目添加需要的工具集，并设置项目级指令，例如代码规范、目录约定和提交要求。
- 在项目会话中描述开发目标，让助手拆解任务并逐步推进。
- 需要在本机查看代码或运行命令时，使用下文的本机 Shell。
打开项目与切换会话
- 从工作台或对话中打开某个项目时，Bosi 会切换到该项目的会话，并使用该项目绑定的助手。
- 打开一个属于项目的历史会话时，Bosi 会在该会话所属的项目和助手下继续对话。
- 项目的访问权限由服务端检查。没有权限时，打开项目会失败，Bosi 保持当前助手不变，不会改用其他助手打开该项目。
- 重新打开会话时，会话中尚未确认的项目操作会保留，可以继续处理。
方式二：通过内置本机 Shell 进行开发
Bosi 内置了“此电脑的 Shell”（设置中显示为 本机终端）。助手在对话中请求执行命令后，命令在你的 Mac 上运行，输出和退出码返回到对话中。 本机 Shell 不提供可以手动输入命令的交互式终端窗口。每条命令都由助手发起，在一个新的非交互 Shell 中执行，并按你设置的执行权限审批。需要直接使用编程命令行工具时，可以使用云电脑中的编程工具，见下文的方式三。第一步：为助手开启本机 Shell
可以通过以下任一方式，让助手具备本机命令能力。 通过“创建你的 Bosi”开启 在所连接的服务端支持、并且你在当前组织中还没有创建个人 Bosi 时，登录后主区域会显示 创建你的 Bosi：- 阅读介绍后点击 继续。
- 在 让 Bosi 更懂你的工作 中选择需要的能力并连接账号，也可以点击 稍后设置。
- 在 选择 Bosi 的工作方式 中打开需要的能力：
- Bosi 的电脑：使用服务端电脑及其中的应用。服务端提供此能力时默认开启。
- 此电脑的 Shell：运行本机命令，沿用现有命令审批。只能在 macOS 原生应用中开启。
- 选择助手模型。开启 Bosi 的电脑时，需要选择支持视觉和工具调用的兼容模型。
- 点击 创建 Bosi。初始化中断后，可以点击 恢复初始化 继续。
第二步：配置本机终端
打开 设置 → 本机终端，在这里管理这台电脑上的命令执行：
修改电脑名称、Shell、默认工作目录或命令搜索路径后，点击 应用 Shell 设置。这些更改需要在本机终端中单独应用，不受设置页底部 保存设置 的影响。应用 Shell 设置会断开当前连接并撤销尚未执行的授权，下一次命令请求时按新设置重新连接。
三种执行权限的区别：
执行权限仅适用于当前账号、当前组织和这台电脑。除非你完全信任该组织中会请求本机命令的助手，否则建议保留 每条命令先询问。
无需手动连接或为会话单独授权：助手请求本机命令时，Bosi 会按需自动连接。本机终端页面会显示当前状态，例如按需自动连接、正在连接或已连接。
第三步：请求并审批本机命令
在已开启本机 Shell 的助手对话中发送：- 助手请求本机命令后，消息中会出现审批卡片，写明要执行的命令、电脑、工作目录和访问说明。
- 核对命令内容。在你作出选择之前，命令不会执行。
- 在卡片上选择只允许这一次执行，或者拒绝。卡片上的权限入口会打开 本机执行权限 窗口，内容与本机终端设置相同。
- 批准后，命令在本机执行，输出和退出码返回给助手。下一条命令需要再次审批。
- 拒绝后，命令不会执行。助手应停止这次操作，不会改用服务端 Shell 代替执行。
bosi-test.txt，确认文件内容与预期一致。以实际文件和退出码为准，不要只看助手的文字描述。
对话页头可以显示助手可以使用的电脑及其状态。从对话中打开本机电脑时，Bosi 同样会弹出 本机执行权限 窗口。
查看和停止命令
在 设置 → 本机终端 或 本机执行权限 窗口中，可以查看最近的命令，包括工作目录、状态（等待中、运行中、正在停止、已成功、已失败、已取消、已超时、已拒绝、未知）和最近的输出。需要中断正在运行的命令时，点击 停止命令。 状态为“未知”时，表示无法确认命令是否完成。Bosi 不会重复执行这条命令；请自行检查实际结果，再决定是否重新请求。了解本机命令的执行方式
安全边界- 命令以你当前登录的操作系统用户权限执行。工作目录只是起始目录，不是隔离沙箱，不会限制文件访问范围。
- 命令的输出会发送给 Xpert，并保存在服务端。输出中可能包含业务数据，请避免执行会输出敏感信息的命令。
- 每条命令使用一个新的非交互 Shell，只继承少量环境变量，不会继承平台账号或设备凭证。
- 不提供交互式终端（PTY）、交互输入、持续的 Shell 会话、文件同步或本地智能体运行时。需要交互输入的命令无法正常使用。
何时会停止
- 关闭 macOS 窗口后，应用和本机终端仍在运行。
- 切换组织、修改服务连接、退出登录或退出应用，都会停止本机终端。
- 重启应用后，已选择的执行权限会保留，但临时授权不会保留。
- 已过期的审批无法执行。请拒绝或停止这次请求，再发起新的请求。
区分三种执行位置
同一个助手可以同时具备多种执行能力。请在提问时说明希望在哪里执行，并核对返回结果中的执行位置。
验证本机执行时，服务端沙箱返回的结果不算作本机执行。云电脑类任务需要支持视觉和工具调用的模型，组织中是否提供此能力以服务端配置为准。
方式三：通过云电脑的编程工具进行开发
云电脑是服务端为你提供的私有 Ubuntu 桌面，你和 Agent 可以同时操作。云电脑面板中的 编程工具 列出本会话可以使用的编程命令行工具（CLI），例如 Codex、OpenCode、Aider、Claude Code、Qwen Code、Kimi Code 和 CodeBuddy。实际列出的工具以组织的配置为准。 与本机 Shell 不同，编程工具运行在云电脑中，使用当前会话助手的模型，你可以直接打开这些工具处理代码。连接并操作云电脑
- 在助手的工作台中打开 电脑 视图，进入 云电脑 面板。
- 点击 连接查看。连接后，桌面上方会显示 人类与 Agent 共享桌面，底部显示控制栏。
- 需要操作桌面时，点击控制栏中的 开始操作。控制栏左侧显示 你可以操作。
- 只想观看时，点击 仅查看。
打开编程工具
- 点击控制栏中的终端图标，打开 编程工具。
- 面板顶部显示提示“使用本会话可用的模型。退出电脑接管后，任务仍可继续运行。”，以及当前助手、模型和工作目录。
- 在列表中找到需要的工具，查看它的标签，然后点击 打开。
了解工具标签
每个工具下方显示三个标签：
只有同时显示 已安装 和 模型兼容 的工具才可以打开。
编程工具不使用单独的模型，而是使用当前会话的模型，并且该模型需要支持此工具所用的协议。显示 模型不兼容 时，该工具无法使用本会话的模型，即使已安装也不能打开。例如，Codex 显示模型不兼容时，在本会话中运行它可能会返回错误“requested model is not available for this execution”。需要使用这类工具时，请为助手选择该工具兼容的模型后再试。
模型由平台按会话提供，不需要在云电脑中配置自己的模型 API Key。
管理编程会话
打开工具后，编程会话会显示在面板下方的列表中，包括工具名称、状态、助手和模型以及工作目录。状态包括正在启动、运行中、正在停止、已退出和状态未知。还没有会话时，列表显示 暂无编程会话。- 需要结束某个会话时，点击该会话旁的 停止。已退出的会话不再显示停止按钮。
- 点击 仅查看 退出电脑接管后，编程任务仍可继续运行。
推荐的编程助手指令
云电脑的默认镜像中内置了云编程技能/opt/xpert/skills/cloud-coding/SKILL.md，提供以命令行工具为主的任务、审批、恢复和交付指引。希望助手在处理开发任务时遵循这套流程，可以在助手的 编辑资料 中，将下面的内容加入提示词，然后点击 保存并发布：
sandbox_shell 工具。创建 Bosi 时开启了 Bosi 的电脑，Bosi 的提示词中已经包含云编程技能的指引，无需重复添加。
连接自己的 Xpert 服务
开发或测试时，可以把 Bosi 连接到自行部署或本地运行的 Xpert 服务：- 在登录页点击 连接设置，或在登录后打开 设置 → 服务连接。
- 填写 API 服务地址、Xpert 网页地址和 ChatKit 地址。远程服务需要使用 HTTPS；本机
localhost地址可以使用 HTTP。 - 等待页面检查地址和证书。使用你信任的自签名证书时，开启 允许不受信任的服务证书。此设置同样作用于本机终端到所配置 API 服务的连接。
- 保存设置，重新登录。
- 本机终端通过 API 服务的 Socket.IO 端点（
/socket.io/）建立 WebSocket 连接。反向代理需要允许 WebSocket 升级。 - 本机电脑不会开放任何监听端口，连接由 Bosi 主动发起。
- 升级时，请同时部署匹配版本的服务端、Bosi 和 ChatKit。只更新 Bosi 不会让旧的 ChatKit 获得新能力。
配置自动化
自动化让助手在指定时间、按计划或事件发生时自动开始工作，并复用助手已发布的指令、技能、工具和连接器。管理自动化需要助手已经发布，并且你拥有工作空间的编辑权限。- 将鼠标停在侧栏中的助手头像上，打开助手资料面板，切换到 自动化。
- 新建一个自动化。
-
选择触发方式：
定时计划以外的触发方式，需要先在 Xpert 中安装对应类型的 Provider 插件。
- 设置条件和范围。定时计划可以选择每小时、每天、每个工作日、每周，或者使用自定义计划填写 Cron 表达式（依次为分钟、小时、日期、月份、星期）。定时计划使用 Xpert 服务器的时区。
- 按需填写补充指令，例如“汇总昨天合并的代码变更和未关闭的问题”。助手的职责、技能、工具和连接器会自动继承，无需重复配置。
- 确认配置并保存。