使用文档
按操作顺序介绍从安装到使用工作站各部分的步骤。
开始之前
Belay 不提供模型。它在代码所在的机器上运行你已安装且可用的 Agent，把每个会话呈现为一段完整的对话。开始前请准备两样东西：
- 至少一个 Agent：Claude Code、Codex、OpenCode、GitHub Copilot CLI 或 Pi，已安装且可用。Pi 需先配置模型服务，其他 Agent 可使用本机登录或模型服务。尚未安装时，也可以在新建会话时按提示安装。
- 一台存放代码的机器：可以是你正在使用的电脑，也可以是网络中的另一台机器。
客户端与服务端都支持 macOS、Windows 和 Linux，两者不必在同一台机器上。
安装客户端 0.130.0
客户端是桌面程序，三个平台的安装包见下载。
macOS
打开 Belay_universal.dmg（Apple 芯片与 Intel 通用），把 Belay 拖入「应用程序」。首次打开时，macOS 会询问是否打开从互联网下载的应用，点击「打开」即可。
Windows
运行 Belay_x64-setup.exe 或 Belay_x64_en-US.msi。安装包尚未签名，首次运行时 Windows 会提示「Windows 已保护你的电脑」：点击「更多信息」，再点击「仍要运行」。
Linux
AppImage 下载后，先添加可执行权限再运行：
chmod +x Belay_amd64.AppImageDebian 与 Ubuntu 也可以安装 deb 包：
sudo apt install ./Belay_amd64.deb首次打开
安装服务端 0.105.0
服务端安装在代码所在的机器上，负责运行 Agent，并承载这台机器上的所有工作区。每台机器只需安装一个。
「机器」页提供三种添加方式：
- 在本机安装。在你正在使用的电脑上安装或启动服务端，并自动完成配对。
- 通过 SSH 安装到另一台机器。用你自己的 SSH 登录方式连接那台机器，在客户端中完成安装与配对；需要输入时按提示作答。
- 连接现有机器。那台机器已装好服务端时，粘贴在它上面执行
belay pair得到的配对字符串。
也可以在那台机器上手动安装：
curl -fsSL https://updates.coldsmirk.com/belay/install.sh | shWindows 上使用 PowerShell：
irm "https://updates.coldsmirk.com/belay/install.ps1" | iex安装后，可以用以下命令管理服务端：
belay up | 启动本机的服务端，并设为登录后自动启动 |
|---|---|
belay pair | 生成配对字符串，默认五分钟内有效、可配对一台设备；--expires 与 --uses 可调整 |
belay pair list | 列出有效的配对码 |
belay pair revoke <编号> | 撤销一个配对码 |
belay devices | 列出已配对的设备 |
belay devices remove <指纹> | 移除设备，其连接立即断开；指纹写出开头几位即可 |
belay restart | 重启服务端，使设置生效；正在运行的 Agent 会随之停止 |
belay upgrade | 升级到新版本并重启 |
belay down | 停止服务端；下次登录时仍会自动启动 |
belay down --unregister | 停止服务端，并不再在登录后自动启动 |
服务端默认只允许本机连接。要让同一网络中的其他电脑直接连接，在该机器上执行：
belay config set remote.listen 0.0.0.0:4991执行后再运行 belay restart 生效；也可以在「机器」页该机器卡片的「设置」中修改。不在同一网络时，请为机器启用通道，见在手机上使用。
添加工作区
工作区对应一个项目根目录，Agent 在其中工作。在头部的工作区选择器中点击「添加工作区…」，填写服务端所在机器上的路径；目录不存在时，可以选择「创建目录并添加」。
同一台机器可以添加多个工作区，按 ⌘ E 随时切换。常用的工作区可以置顶，也可以为它设置显示名称与颜色，方便辨认。
工作区不需要打开或关闭，只有运行中的 Agent 会占用资源。Agent 闲置一段时间，或你点击「释放进程」后会停止运行，对话记录保留，下次发送消息时自动恢复。Belay 的数据单独保存，不写入你的项目。
新建会话
每个会话对应一个 Agent。点击会话栏顶部的「新建会话」，或按 ⌘ N，填写以下内容：
- Agent
- 可选 Claude Code、Codex、OpenCode、Copilot CLI 与 Pi。Pi 必须选择模型服务，无需登录账号。未安装的 Agent 仍可选择，选中后显示安装方法。安装完成后点击「重新检测」。
- 模型服务
- 这台机器添加了模型服务时显示；Pi 始终显示并要求选择一项。其他 Agent 默认「本机配置」，即使用 Agent 自己的登录与配置。选择模型服务后，会话使用这项服务的模型，创建后不可更改。
- 启动方式
- 在「服务端设置」中配置了启动方式时，可以让会话按它启动。
- 会话模式
- 「独立会话」只与你协作，不与其他会话互发消息或任务，但你仍可以通过任务面板交给它任务；「团队会话」加入团队，可以与其他团队会话互发消息、相互排任务，需要指定角色。默认为独立会话。
- 角色
- 团队会话在团队中的分工。内置
leader、builder、reviewer、tester、researcher五种，也可以在「服务端设置」的「角色」中自定义。创建后不可更改。 - 名称（可选）
- 名称也是会话的地址，消息与任务都按名称送达。留空时自动生成，例如 claude-1；团队会话默认以角色命名。之后可以双击名称修改。
- 会话目录
- Agent 工作的目录，可以选择多个。Git 仓库可以使用原目录、已有的工作树或新建工作树，多个会话并行修改同一个仓库也互不干扰。创建后不可更改。
- 接续已有会话
- 接续 Agent 自己保存的会话，例如你在终端里开始的会话。之前的对话 Agent 仍然记得，但不会显示在这里。
- 模型、思考强度
- 列出 Agent 提供的模型，也可以直接输入其他模型名称；选择模型服务时，列出这项服务的模型。
- 权限
- 会话的审批级别，见审批，随时可以修改。
- 上下文窗口
- Agent 支持时显示。「扩展」可以使用更大的上下文，但会更快消耗用量；创建后可以在输入框底部修改，从下一个回合起生效。
同一台机器的其他工作区已有一组会话时，可以点击会话栏上的「从其他工作区复制」，按原有设置建好同样一组会话；对话记录与任务不会复制。
一个回合
在输入框中写下要求，Enter 发送，Shift + Enter 换行。输入 @ 可以引用文件、数据源、主机、知识库、原型与会话，输入 / 可以调用 Agent 的命令与技能；图片和文件可以直接粘贴或拖入。
- 对话中显示 Agent 的回复和它做的每一步：读了哪些文件、运行了什么命令、改了哪些代码。回合结束后，这些步骤折叠为一行概要，点击即可展开；文件修改显示为差异。
- Agent 生成的图片、录屏与原型显示在回复下方，头部的「会话产出」汇总了会话中的全部产出。
- 回合结束时，页脚显示用时、上下文占用、Token 数与花费。
- Agent 工作时发送的内容会作为插话送达，不会另开回合；Agent 尚未读到的插话可以「撤回插话」。
- 按 Esc 停止当前回合，确认后生效。
- 「回合目录」列出每个回合，便于跳转；⌘ F 在整个会话中查找。
- 「旁问」可以在旁边单独提问，不打断 Agent，问答也不写入对话。
对话可以回溯：在你的消息上点击「编辑并重新发送」，从这里重新开始；点击回合页脚的「重新运行」，原样再发一次。Agent 支持时，回溯可以同时撤销文件改动。
输入框底部的圆环显示上下文占用，接近用满时点击即可压缩上下文。Agent 支持时还可以「设定目标」，让它持续推进直到完成。订阅额度用尽导致回合中断时，可以打开「额度恢复后自动继续」。
审批
Agent 要执行需要批准的操作时，请求显示在对话中，一直等你作答；Belay 不设超时，也从不代你回答。会话的「权限」决定哪些操作需要批准：
| 只读 | 只允许读取与规划，不做任何修改 |
|---|---|
| 询问 | 每项敏感操作都需要你批准 |
| 自动编辑 | 自动允许修改文件，运行命令仍需批准 |
| 自动审查 | 由 Agent 自带的审查判断，无法判定时再请你批准 |
| 完全放行 | 不再请求批准 |
「自动审查」仅在 Agent 提供该能力时可选。作答选项由 Agent 提供：「允许」与「拒绝」总会出现，Agent 支持时还有「本会话都允许」与「以后都允许」。
权限可以随时修改，个别修改从下一个回合起生效，对话中会注明。Pi 的权限变更立即生效；「只读」下，读取可直接执行，Belay 的操作工具需要审批，其余操作会被阻止，不提供「自动审查」。
Agent 也可能向你提问。选择一个选项，或填写自己的答案；也可以选择「不回答」，Agent 会知道你没有作答。
会话之间
消息
团队会话可以给另一个团队会话发消息。对方空闲时开始一个新回合，消息注明发送者；对方正在工作时，消息作为插话送达。每次投递都记入消息记录。
任务面板
你可以在任务面板中排入任务，团队会话也可以为其他会话排任务；每个任务都指定交给哪个会话。同一个会话一次只派一件，完成后再派下一件，结果交回排入任务的一方。任务可以定时派发，也可以等其他任务完成后再派；「立即派发」跳过排队，「撤回」把已派发的任务放回「待派发」。
回合结束时任务仍未完成的，Belay 会提醒一次，此后由你处理。计划有变时，你或排入任务的会话可以取消任务并说明原因，正在执行的会话会立即收到通知。
Belay 只把任务和消息送达指定的会话，从不自动转交，也从不自动重发；投递失败时会显示原因，由你决定下一步。
任务与消息位于右侧，⌘ ⇧ M 折叠或展开；「展开阅读任务」可以整页阅读任务内容。
工作站的其他部分
会话之外，工作站还包括以下部分。它们在同一个窗口中，使用同一台机器；你和 Agent 用的是同一批资源。
代码
- 工作台
- 浏览项目文件，在会话下方打开终端。⌘ B 打开工作台，⌘ P 按名称打开文件，⌘ ⇧ F 在全部代码中搜索，⌘ J 显示终端；选中的内容可以引用到输入框。PDF 与表格文件可以直接预览。
- 审阅
- 对比当前改动与基线，逐文件查看差异并写下行级批注；批注可以放进输入框发给当前会话，也可以排成任务交给其他会话。
- 语言服务
- 打开 Rust、C/C++、TypeScript、JavaScript、Vue、Svelte、Astro、Python、Go 或 Java 文件时按需启动，提供跳转定义、查看引用、悬停提示与诊断；Agent 也用它检查自己改过的文件。缺少的组件可以在工作台的「语言服务」中下载。
- 项目目录与工作树
- 工作区可以记住常用的项目目录。新建会话时为它选择目录或新的工作树，多个会话并行修改同一个仓库也互不干扰。
浏览器与设备
- 浏览器
- 会话工具栏上的「浏览器」在会话旁打开浏览器面板，可以直接访问服务端所在机器上的本地开发服务。你和 Agent 操作同一个页面；Agent 打开网页、操作页面前需经你批准。开启「批注页面」后，点选元素或框选区域写下意见，连同截图引用到输入框。登录状态会保留。
- 设备操控
- 把你的电脑或 Android 手机借给某台机器上的 Agent：它可以查看屏幕、点击和输入，在电脑上还可以直接运行命令，这些操作同样按会话的权限审批。在「机器」页该机器的卡片上打开「设备操控」即可，随时可以停止。你还可以把项目镜像到借出的电脑上，用那台电脑的开发工具构建和运行。
数据与主机
- 数据源
- 支持 PostgreSQL、MySQL、Oracle、SQL Server、DM、KingbaseES、ClickHouse、Doris、Redis、MongoDB 与 Elasticsearch。工作表左侧是表结构，中间编写查询，右侧查看结果，还可以查看执行计划、对比两个数据源并同步数据。Agent 使用同一批数据源：查询直接执行，写入须经你批准。
- 主机
- 「主机」首先列出服务端所在的机器，无需配置即可浏览文件、编辑文本、打开终端。你还可以添加用于部署或测试的远程主机：沿用你的 SSH 登录方式，执行命令、双向传输文件、直接编辑文件、打开终端，「概览」显示它的系统与资源。Agent 使用同一批主机。
Agent 的积累
- 知识库与记忆
- 两者都分为机器与工作区两个范围。记忆是简短的事实，每个会话启动时都会读入；知识库是文档，会话在需要时检索。你和 Agent 读写同一份内容，可以随时查看与修改。
- 技能
- 把做事的方法写成技能，Claude Code、Codex、OpenCode、Copilot CLI 与 Pi 通用。可以自己编写或上传，也可以在「发现」中从技能市场或 GitHub 安装；在输入框输入
/即可调用。 - 工具库
- Agent 可以把一段可复用的操作保存为工具，之后按名称直接调用；保存与运行都需经你批准。每个工具保留最近十个版本，可以在「工具库」中查看与恢复。
- 脚本
- Agent 可以直接运行 Python、JavaScript 与 TypeScript 脚本，所需环境由 Belay 自动准备，机器上无需预先安装。
- 原型
- 动手修改界面之前，Agent 可以先做一个可点击的原型给你看，你可以在会话的浏览器或独立窗口中预览并批注。在「服务端设置」的「原型发布」中填写 Vercel 令牌后，原型可以发布为网页分享。
回复中的内容
- 图表与幻灯片
- Agent 可以在回复中直接画出图表，或把方案、对比写成一页页幻灯片，可以全屏查看。
- 图片与视频
- 在「服务端设置」的「图片、视频与语音」中选择模型服务后，Agent 可以生成图标、配图或短视频，在对话中直接查看与下载。
连接与设置
- 模型服务
- 在「机器」页添加模型厂商、中转服务或本地部署的地址与密钥，新建会话时选用。密钥只保存在服务端所在的机器上，保存后不再显示；「测试」可以检查是否连得通。部分厂商的余额与套餐额度也会显示出来，并提供「前往充值」。
- 网络研究
- Agent 把问题交给能联网搜索的模型，得到标注来源的报告。默认关闭，在「服务端设置」的「网络研究」中开启。
- Agent 配置与 MCP 服务器
- 「服务端设置」中可以为每种 Agent 设置常用选项，也可以添加 MCP 服务器供 Agent 使用；这些设置不会改动 Agent 自己的配置。
- 唤醒
- Agent 可以为自己设置唤醒：到点、按固定间隔，或在某个条件满足时，Belay 叫醒它继续工作。会话头部列出待触发的唤醒，可以随时取消。
- 统计
- 「统计」显示机器与 Belay 的资源占用，以及近 7、30、90 天的订阅额度、每日花费与回合数等。
- 界面缩放
- 头部的「界面缩放」可以把整个界面放大到 150%。
营地与追风
- 营地
- 头部的「营地」把工作区呈现为一座立体的营地：团队会话按角色分坐在「统筹与调研」「开发」「审查与测试」等区域，独立会话、你的工位和休息区在前排。每个会话是一台机器人，脚下光环与双眼的颜色就是它的状态，动作随正在做的事而变：编辑时双手敲键盘，阅读时右手握鼠标、目光随行扫动，思考时托腮，等你审批时转向你的工位举手示意，出错时垂头，休眠的坐在休息区的沙发上；屏幕显示它正在做的事，会话之间的消息与任务以弧线显示。标题栏的状态计数可单独点亮某一状态，「总览」「俯视」「走近」切换视角。点击会话即可走近，右侧「现场」面板显示它在做什么，并可一键进入会话。
- 追风
- 营地标题栏上的「追风」是一个横版骑行小游戏：按住一个键压低车身，在坡顶松开腾空，赶在日落前骑得越远越好。工作区的每个会话都是路上的一位车手；有会话需要你处理时，骑行暂停并提示，一键即可前往。
在手机上使用 0.10.23
离开电脑时，手机端也能让工作继续推进：
- 查看所有机器上的会话，阅读对话，回答审批与问题，发送消息（可以附照片）或停止回合，回溯、压缩上下文、设定目标，新建与关闭会话。
- 在任务面板中排入任务，查看任务结果，立即派发、撤回或取消任务。
- 查看工作区的知识库、记忆、改动与原型；查看数据源与远程主机，并交给 Agent 处理。
- 升级服务端与 Agent，添加工作区，为其他设备生成配对码。
- 应用不在前台时，有会话等你回复、回合结束或出错，会收到通知。
工作台、终端、执行 SQL 与统计等仍在客户端中使用。目前提供 Android 版，适用于 Android 7.0 及以上的 64 位系统；iOS 版正在准备上架 App Store。
安装
- 下载安装包。在手机的浏览器中打开下载区，点击「下载 Android 安装包」；也可以在电脑上打开该页，用手机扫描「手机端」下的二维码。聊天应用的内置浏览器通常不能下载安装包，请改用系统浏览器打开。
- 允许安装。应用没有在应用商店上架，系统会询问是否允许该浏览器安装应用，按提示允许即可。
配对机器
- 启用通道。在客户端的「机器」页打开该机器的「设置」，进入「远程访问」，打开「启用通道」并保存，等到「当前状态」显示「已连接中继，可经通道访问」。启用后，手机在任何网络下都能连上这台机器，内容全程加密。默认使用 Belay 中继，也可以改用自建中继。
- 生成配对码。在同一页的「配对其他设备」下点击「生成配对码」。配对码默认五分钟内有效、只能配对一台设备，生成前可以调整「有效期」与「可配对设备」。拿到配对码的设备都能连上这台机器，请勿转发给他人。
- 扫码配对。在手机上打开 Belay，进入「机器」→「添加机器」，点击「扫码配对」并对准二维码；无法使用摄像头时，复制配对字符串粘贴到手机上，再点击「配对」。
手机与机器在同一网络时，也可以在该机器的终端执行 belay pair --qr，扫描终端中的二维码配对。已配对的手机列在机器卡片的「设备」下，可以随时移除，移除后立即断开。
更新手机端
手机端会自动检查更新。有新版本时，「设置」上会出现标记，在「关于」中点击「更新」即可安装。
自建中继 0.1.0
启用通道后默认使用 Belay 中继，无需配置。如果你的网络无法访问 Belay 中继，或希望连接只经过自己的服务器，可以自己部署一个中继。
部署条件
- 一台 Linux 服务器：x86_64 或 aarch64，可以用
sudo获得管理员权限。 - 公网地址与域名：域名直接解析到这台服务器，中间不要经过 HTTP 代理。
- 开放三个端口：443/tcp、80/tcp 与 7842/udp。
证书会在首次启动时自动申请，无需另行准备。
安装
在这台服务器上执行以下命令，把域名和邮箱换成你自己的：
curl -fsSL https://updates.coldsmirk.com/belay-relay/install.sh | sudo sh -s -- --hostname relay.example.com --contact you@example.com--hostname：设备访问中继所用的域名。--contact：申请证书时使用的联系邮箱。
两项只在首次安装时需要。命令结束时会列出需要开放的端口，以及要填入 Belay 的中继地址与令牌。
让服务端改用自建中继
- 填写中继。在客户端的「机器」页打开该机器的「设置」，进入「远程访问」，把「中继」切换为「自建中继」，在「中继地址」中填写
https://加中继的域名，在「令牌」中填写安装命令给出的令牌。 - 启用通道。打开「启用通道」并保存，设置立即生效。等到「当前状态」显示「已连接中继，可经通道访问」。
也可以在服务端所在机器的终端执行：
belay config set tunnel.relay https://relay.example.com
belay config set tunnel.token <令牌>
belay config set tunnel.enabled true如果连接仍时断时续，可以在「远程访问」中打开「仅经中继连接」：所有设备都只经中继访问这台机器，连接更稳定，速度受中继带宽限制。
改回 Belay 中继时，在「中继」中选择「Belay 中继」并保存即可。
维护
- 升级：再次执行上面的安装命令，可以省略两个参数，原有设置保持不变。
- 修改设置后：执行
sudo systemctl restart belay-relay生效。 - 启动失败时：执行
sudo journalctl -u belay-relay查看原因。
快捷键
下表中的 ⌘ 在 Windows 与 Linux 上为 Ctrl，⇧ 为 Shift。
| ⌘ E | 切换工作区 |
|---|---|
| ⌘ 1 ～ 9 | 进入置顶的工作区 |
| ⌘ N | 新建会话 |
| ⌘ B | 打开或关闭工作台 |
| ⌘ P | 在工作台中按名称打开文件 |
| ⌘ ⇧ F | 在工作台中搜索代码 |
| ⌘ J | 显示或收起终端 |
| ⌘ F | 查找：会话、文件或终端 |
| ⌘ ⇧ E | 打开或关闭旁问 |
| ⌘ ⇧ B | 折叠或展开会话栏 |
| ⌘ ⇧ M | 折叠或展开任务与消息 |
| ⌘ ⇧ D | 打开或关闭数据源 |
| ⌘ ⇧ H | 打开或关闭主机 |
| ⌘ ⇧ K | 打开或关闭知识库 |
| ⌘ ⇧ S | 打开或关闭统计 |
| ⌘ ⇧ Y | 打开或关闭营地 |
| ⌘ / | 显示全部快捷键 |
更新
客户端自动检查更新，有新版本时询问是否安装。
手机端自动检查更新，在「设置」中点击「更新」即可安装，见在手机上使用。
服务端有新版本时，「机器」页的机器卡片上会出现标记，点击「升级服务端」即可；有多台机器时，可以「全部升级」。在该机器上执行 belay upgrade 效果相同。
升级会重启服务端，正在运行的 Agent 随之停止，建议在两个回合之间进行。会话与对话不受影响，重启后的第一个回合会接着上次继续。
隐私与数据
Belay 在你的机器上运行，没有账号，也没有云端。代码与文件、提示词与对话、密钥与密码、数据源中的数据、远程主机上的内容，Belay 从不收集。客户端与服务端之间的连接全程加密；经中继转发时，中继也无法读取内容。
Belay 只会收到以下四类数据，用随机生成的匿名标识区分，并附带操作系统、机型与硬件容量等运行环境信息，不含序列号：
- 使用统计
- 程序的启动与退出，新建会话所用的 Agent 与角色，添加机器的方式，以及 Agent 调用工具的次数与失败情况，不含参数的内容与工具的输出。
- 错误报告
- Belay 自身的错误，附出错前的日志与操作记录。日志中的用户目录会被隐去，操作记录不含你输入的文字。因你的环境导致的失败，例如登录被拒或数据库连不上，不会上报。
- 性能数据
- 各项操作的耗时统计，只有计数与类别。
- 反馈
- 你在「反馈」中填写的内容、联系方式与附件。勾选「附带诊断日志」时才会附上日志，其中可能含有主机名、路径、命令与 Agent 的输出。
客户端与服务端的上报目前不能关闭；手机端在首次启动时征得你的同意后才上报，可以随时在「设置 → 隐私」中更改。完整说明见隐私政策。
何时联网
- 自动
- 检查更新；按需下载 Belay 管理的组件，例如语言服务与浏览器；查询 Agent 的最新版本。在「服务端设置」的「通用」中关闭「检查 Agent 新版本」后，不再查询，也不再自动更新这些组件。
- 启用通道后
- 连接中继：默认为 Belay 中继，也可以改用自建中继。
- 你操作或批准时
- 安装或升级 Agent；在「工具库」中填写依赖时查询可用的版本；把原型发布到 Vercel；Agent 运行脚本、保存工具或构建原型时，下载所需的依赖。
- 其余
- 只连接你自己配置的模型服务、数据源、远程主机、网络研究与 MCP 服务器。Agent 与模型之间的通信由 Agent 自己完成；原型页面可以自行访问网络。
Belay 永久免费，全部功能对所有人开放。它由 Coldsmirk 独立开发，目前没有开源计划，不排除未来开源。
常见问题
- macOS 提示「Belay 已损坏，无法打开」
0.104.0 之前的客户端未经签名，macOS 会显示这个提示。下载最新版本重新安装即可；也可以执行以下命令，再重新打开客户端：
xattr -cr /Applications/Belay.app- Windows 提示「Windows 已保护你的电脑」
- 安装包尚未签名，Windows 会拦截首次运行。点击「更多信息」，再点击「仍要运行」。
- 新建会话时没有可用的 Agent
- 服务端会在它所在的机器上自动查找已安装的 Agent。可以在新建会话表单的「查看安装方法」中直接安装，完成后点击「重新检测」。Agent 装在不常见的位置时，在该机器上执行
belay config set agents.claude <路径>（codex、opencode、copilot与pi同理），再执行belay restart。 - 无法连接另一台机器上的服务端
- 服务端默认只允许本机连接。允许其他电脑连接的方法见安装服务端，并确认该机器的防火墙已放行对应端口；不在同一网络时，请为机器启用通道。
- 配对字符串已过期
- 配对字符串默认五分钟内有效，配对一台设备后失效，在该机器上重新执行
belay pair即可。连续输错多次后需稍等片刻再试。 - 会话显示「出错」
- 对话中会写明回合提前结束的原因，例如 Agent 退出、找不到命令或登录过期。处理后再发送一条消息即可恢复。
- Rust 语言服务提示「cargo is not on the PATH」
Rust 的语言服务使用服务端所在机器上的 Rust 工具链。在该机器的终端执行以下命令，确认登录后能找到
cargo：$SHELL -i -l -c 'command -v cargo && cargo --version'如果没有同时输出路径与版本，请检查 shell 的启动文件（例如
~/.profile、~/.bashrc、~/.zshrc）是否把 Rust 加入了PATH。用 Linuxbrew 安装rustup时，需要先初始化 Homebrew：eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv bash)"
export PATH="$(brew --prefix rustup)/bin:$HOME/.cargo/bin:$PATH"修正后，在「机器」页点击「重新检测」，再在「语言服务」中重启 Rust。
- macOS 上窗口一片空白，只有拖动分隔线时出现一条亮线
这是该 Mac 的音频服务无响应导致的，并非 Belay 的故障；已经打开的程序不受影响，所以问题可能只出现在新打开的 Belay 上。在「终端」中执行以下命令，再重新打开 Belay：
sudo killall coreaudiod重启电脑也可以恢复。如果反复出现，请检查
/Library/Audio/Plug-Ins/HAL中的第三方虚拟声卡驱动，尤其是远程桌面软件安装的驱动。