GUIDE

使用与支持

下载 BORING Console,完成首次配置,或从开源仓库开始自定义。

下载
BORING Console

选择与你的电脑系统对应的版本,下载安装后继续完成首次配置。

版本、大小与下载链接与官方发布索引自动同步。

WINDOWS
下载 Windows 版

正在获取下载信息…

MACOS
下载 macOS 版

正在获取下载信息…

首次打开时请注意

安装包尚未经过 Apple 签名与公证。首次打开如果出现“无法打开”警告(按钮为“完成”和“移到废纸篓”),点“完成”,再打开“系统设置”→“隐私与安全性”,滑到最底部点“允许打开”,然后重新打开 BORING Console。

装好之后,开始首次配置

第一次使用 MIST

从认识设备开始,完成一次基础配置。

  1. 1

    认识设备

    先找到旋钮、长条键和顶部数据接口。

    在哪里操作
    将设备按图示方向摆放:屏幕在左上,旋钮在左下。
    做什么
    找到旋钮、右下摇杆、长条键和顶部 Type-C 接口。
    怎样知道成功
    能够对照图示找到操作位置;此步不需要修改设置。
    MIST 垂直俯视图:六颗无编号 Agent 状态灯;03、08、09、10、11、12 为功能按键,13 为旋钮,14 为摇杆;灯色为状态示意

    一眼读懂 Agent 状态

    六颗雾透键帽,默认关联最近的 6 个对话,用灯色提示各自的任务状态。

    • 白色 · 空闲当前没有运行中的任务。
    • 蓝色 · 运行中Agent 正在处理任务。
    • 橙色 · 需要审批等待你的批准或回应。
    • 红色 · 问题 / 报警出现问题,需要查看和处理。
    • 绿色 · 完成待查看任务已完成,有未读更新。

    图中按从左到右、从上到下展示白、蓝、橙、红、绿、白;3 号键下方为白色空闲。灯色是教学示意,不代表设备实时状态,也不是每颗键固定一种颜色。

    颜色语义参考 Codex Micro 官方说明 ↗;具体反馈取决于当前模式、软件连接和配置。

    按键、旋钮与摇杆

    对照图中编号找到控件。以下为当前默认操作说明;自行修改配置后,以 Console 中的设置为准。

    03多功能键
    长按打开轮盘菜单,可进入番茄钟倒计时、设置或查看电池电量。
    08语音按键
    单击调用电脑上的语音转文字软件,开始录入;再次单击结束录音。快速双击为 Enter 发送。请先完成下方的语音软件配置。
    09批准 · Accept
    批准当前等待处理的请求。
    10拒绝或停止 · Reject
    拒绝当前请求,或停止正在进行的操作。
    11 / 12暂未配置专门功能
    当前应用程序端尚未为这两颗按键配置专门功能。
    13旋钮
    Normal 模式下,旋转滚动对话窗口或页面,按下为确定。长按 03 打开轮盘菜单后,旋转用于左右切换,按下选定。
    14摇杆
    支持上、下、左、右和按压。在默认 Normal Profile 下,四个方向各触发一个快捷提示词。
    完成语音输入配置 →

    蓝牙:在三个 Host 槽位之间切换

    默认提供 3 个蓝牙槽位。先按住右上角的多功能键,保持不松开,再短按另一颗橙框按键,切换到对应的电脑槽位。

    Host 1
    Host 1 切换示意:橙色粗外框标出右上角多功能键与语音按键;先按住多功能键,再短按语音按键
    按住多功能键,再短按语音按键
    Host 2
    Host 2 切换示意:橙色粗外框标出右上角多功能键与批准键;先按住多功能键,再短按批准键
    按住多功能键,再短按批准键
    Host 3
    Host 3 切换示意:橙色粗外框标出右上角多功能键与拒绝键;先按住多功能键,再短按拒绝键
    按住多功能键,再短按拒绝键
    看屏幕确认连接状态
    paired
    已配对
    linked
    已连接
    New PC
    未连接任何电脑
    换一台电脑:清除指定槽位的蓝牙配置

    此操作会清除所选 Host 槽位的配对信息,需要重新连接电脑。先确认要清除哪个槽位。

    1. 对照上方要清除的 Host 示意图,按住右上角的多功能键,保持不松开。
    2. 长按图中另一颗橙框按键:语音按键对应 Host 1,批准键对应 Host 2,拒绝键对应 Host 3。与切换槽位时的短按不同,这里需要持续按住。
    3. 观察屏幕进度条;达到 100% 并出现勾后,代表该槽位已清空,可以连接新的电脑。

    双击旋钮,切换默认 Profile

    三个默认 Profile 分别为 Normal、Codex 和 Claude Code。双击 13 号旋钮切换,屏幕图标随当前模式改变。Normal 模式显示与开机相同的 BORING logo。

    Normal 模式的默认屏幕图标及圆形点阵底网(源码还原)
    NormalBORING 开机 logo
    Codex 模式的默认屏幕图标及圆形点阵底网(源码还原)
    CodexCodex 模式
    Claude Code 模式的默认屏幕图标及圆形点阵底网(源码还原)
    Claude CodeClaude Code 模式

    屏幕图案取自 Console 导出流程所用的本地固件源码,保留原始圆形点阵网格;Normal 按最新固件说明使用 BORING 开机 logo。以上为源码还原,非实机截图;若已自定义图标,请以设备实际显示为准。

  2. 2

    安装 Console

    下载适合电脑系统的 BORING Console,按照对应说明完成安装。

    在哪里操作
    本页下载区域,选择 Windows 或 macOS。
    做什么
    macOS 打开 DMG 并拖入“应用程序”;Windows 运行 EXE 并按向导安装。
    怎样知道成功
    可以打开 BORING Console;安装提示与系统要求见上方下载说明。
  3. 3

    连接设备

    先开机,再连接 USB,最后打开 BORING Console。

    机器为模型操作示意,非软件截图;橙色表示按下的控件。USB 屏幕由本地固件源码还原,非实拍;Console 为实际界面截图,图中显示蓝牙连接,仅供认识主页面布局。

    1. 长按左下旋钮开机:旋钮呈下压状态并高亮为橙色
      橙色控件 · 按下状态

      01长按旋钮开机

      长按设备左下方的旋钮,打开电源。

      你会看到小屏幕播放 BORING logo 开机动画,进入首屏后仍显示 BORING logo。

    2. USB 数据线插入 MIST 顶部的 Type-C 接口

      02连接 USB

      将 USB 数据线连接电脑与设备顶部的 Type-C 接口。

      你会看到设备小屏幕出现 USB 有线连接图标。

      查看 USB 屏幕原图(固件源码还原)↗
    3. Console 实际界面:中央产品模型及两侧卡片,截图中显示蓝牙已连接、普通模式
      实际界面 · 图中为蓝牙连接状态
      点击查看完整界面

      03打开 Console

      打开已安装的 BORING Console,等待自动识别已连接的设备。

      你会看到首次打开先看到“待连接”画面,Console 会自动扫描;连接成功后进入主页面,中央显示产品模型、左右排列卡片,并弹出设备操作引导。连接卡片显示“已连接 USB”图标和设备名称。

  4. 4

    完成一次基础配置

    选好输入方式,用同一颗键完成输入与发送。

    以下两步适用于 macOS Console 0.2.1:选择并保存 → 实体练习。也可以先用键盘,稍后再设置语音。Windows 版本的向导尚待单独核对,请按当前应用提示操作;遇到不同页面可到本页支持区求助。

    1. 01

      选择并保存

      在 Console 的“常用 AI”设置中选择 AI 与输入方式,确认语音按键,应用配置;使用第三方语音时,先核对软件与设备的启停快捷键,再保存。下方选择只切换网页说明,不会修改设备。

      我自己的语音输入软件

      在 Console 选择“我自己的语音输入软件”。语音按键是长条多功能键:既可作为快捷键,也可控制语音输入。语音配置下,单击说话/结束,文字出现后双击同一颗键发送。

      先用键盘,稍后设置语音

      在 Console 选择“键盘输入,暂不设置语音”。本次先配置发送与换行;之后仍可回到“常用 AI”添加语音。

      AI 自带语音

      在 Console 选择“AI 自带语音”。通过 AI 应用自己的语音入口开始输入,本次不会把设备键设置成第三方语音软件的启停键。

      接下来,匹配你的语音软件

      在 Console 的语音向导里操作。这里仅提供说明,不会录音、录制快捷键或修改设备。

      Typeless
      1. 设置 Typeless 的启停快捷键

        macOS:打开 Typeless 设置 → 快捷键 → 语音输入。语音按键在电脑的键盘映射中对应的就是 F13,请将语音输入的启停快捷键设为 F13

        Windows:打开已安装软件的设置,查找语音输入的启停快捷键,并确认支持单击启停。源码未提供此软件的 Windows 专属菜单截图,请以当前软件设置为准。

      2. 让设备与软件使用同一个快捷键

        回到 Console,确认“单击 · 说话/结束”对应 F13;可通过“手动选择快捷键”选择 F13。Typeless 与 Console 两边的设置必须一致。

        回到 Console 的“单击 · 说话/结束”,用电脑键盘录制刚才查看的快捷键;没有对应实体键时,使用“手动选择快捷键”。不要默认所有语音软件都接受 F13

      3. 确认后,再开始练习

        确认“单击”负责说话/结束、“双击”负责发送。按当前 Console 提示保存,等待保存与设备核对完成,再开始实体练习;不要把网页上选择软件当作已完成设备设置。

      查看旧版 Console 中的Typeless设置参考Console 0.1.94 的Typeless语音设置引导,macOS 源码演示,非第三方软件设置截图

      Console 0.1.94 · macOS 源码演示;不是Typeless应用自身的设置截图,也不表示已经配置成功。

      豆包输入法
      1. 查看软件现有的快捷键

        macOS:打开豆包设置 → 语音输入 → 免按模式,查看现有快捷键。使用前切到豆包输入法,或开启全局唤起。

        Windows:打开已安装软件的设置,查找语音输入的启停快捷键,并确认支持单击启停。源码未提供此软件的 Windows 专属菜单截图,请以当前软件设置为准。

      2. 让设备与软件使用同一个快捷键

        macOS 分支要求使用输入法当前的 Control、Option、Command 单键或兼容组合键。不要直接照搬 F13;在 Console 中录制与你的输入法一致的快捷键。

        回到 Console 的“单击 · 说话/结束”,用电脑键盘录制刚才查看的快捷键;没有对应实体键时,使用“手动选择快捷键”。不要默认所有语音软件都接受 F13

      3. 确认后,再开始练习

        确认“单击”负责说话/结束、“双击”负责发送。按当前 Console 提示保存,等待保存与设备核对完成,再开始实体练习;不要把网页上选择软件当作已完成设备设置。

      查看旧版 Console 中的豆包输入法设置参考Console 0.1.94 的豆包输入法语音设置引导,macOS 源码演示,非第三方软件设置截图

      Console 0.1.94 · macOS 源码演示;不是豆包输入法应用自身的设置截图,也不表示已经配置成功。

      千问输入法
      1. 查看软件现有的快捷键

        macOS:从 Mac 顶部输入法菜单打开千问设置 → 语音输入,查看快捷键,并打开“短按也唤起语音输入”。

        Windows:打开已安装软件的设置,查找语音输入的启停快捷键,并确认支持单击启停。源码未提供此软件的 Windows 专属菜单截图,请以当前软件设置为准。

      2. 让设备与软件使用同一个快捷键

        macOS 分支要求录制千问当前使用的右 Option 或右 Command。不要直接照搬 F13;无法从 Console 打开设置时,从输入法菜单手动进入。

        回到 Console 的“单击 · 说话/结束”,用电脑键盘录制刚才查看的快捷键;没有对应实体键时,使用“手动选择快捷键”。不要默认所有语音软件都接受 F13

      3. 确认后,再开始练习

        确认“单击”负责说话/结束、“双击”负责发送。按当前 Console 提示保存,等待保存与设备核对完成,再开始实体练习;不要把网页上选择软件当作已完成设备设置。

      查看旧版 Console 中的千问输入法设置参考Console 0.1.94 的千问输入法语音设置引导,macOS 源码演示,非第三方软件设置截图

      Console 0.1.94 · macOS 源码演示;不是千问输入法应用自身的设置截图,也不表示已经配置成功。

      其他语音输入软件
      1. 查看软件现有的快捷键

        macOS:打开软件的语音或快捷键设置,找到“开始/结束语音输入”的快捷键。

        Windows:打开已安装软件的设置,查找语音输入的启停快捷键,并确认支持单击启停。源码未提供此软件的 Windows 专属菜单截图,请以当前软件设置为准。

      2. 让设备与软件使用同一个快捷键

        在 Console 的“单击 · 说话/结束”中录制相同快捷键,也可手动选择。确认软件支持外部键盘快捷键,并可“按一下开始,再按一下结束”;只有按住说话的方式不适用于这条教程。

        回到 Console 的“单击 · 说话/结束”,用电脑键盘录制刚才查看的快捷键;没有对应实体键时,使用“手动选择快捷键”。不要默认所有语音软件都接受 F13

      3. 确认后,再开始练习

        确认“单击”负责说话/结束、“双击”负责发送。按当前 Console 提示保存,等待保存与设备核对完成,再开始实体练习;不要把网页上选择软件当作已完成设备设置。

      查看旧版 Console 中的其他语音输入软件设置参考Console 0.1.94 的其他语音输入软件语音设置引导,macOS 源码演示,非第三方软件设置截图

      Console 0.1.94 · macOS 源码演示;不是其他语音输入软件应用自身的设置截图,也不表示已经配置成功。

      没有唤起语音,或多个软件同时响应?

      先核对软件是否运行、启停方式与两边快捷键是否一致。豆包还要检查当前输入法或全局唤起。若快捷键冲突,在语音软件中选择不冲突的快捷键,再回到 Console 重新录制;不要连续按键重试发送。

      以上匹配细节与图片参考 Console 0.1.94 源码,尚未逐项核对 0.2.1 实机;软件版本不同,设置名称可能变化。需要授权时,请在你选择的语音软件中按提示处理。

      等待 Console 提示保存与设备核对完成,再进入实体练习。如果出现冲突、应用失败或“等待重连确认”,先处理提示,不要把点击保存当作保存成功。

    2. 02

      实体练习

      先点击 Console 的练习输入框,再按所选方式输入一句无敏感信息的测试文字,用设备按键完成发送。

      语音练习

      单击语音按键开始说话 → 再单击结束 → 等文字出现并检查 → 双击同一颗键发送。

      键盘练习

      用电脑键盘输入一句话,再单击设备的长条键发送。

      先练习发送

      先用电脑键盘输入一句话,再单击设备的长条键发送;之后可自愿到 AI 应用中试用它的语音入口。

      看到练习成功提示,即可按 Console 提示完成设置。这一步仅在 Console 内练习,不会发送到 AI;语音转写仍由你选择的软件处理。无需先去外部 AI 发送,也不需要为此返回勾选确认。

      按下长条发送键:键帽呈下压状态并高亮为橙色
      橙色控件 · 按下状态

      语音按键 · 长条多功能键
      语音配置:单击说话/结束,双击发送。
      键盘输入配置:单击发送。

    可选:到 AI 中实际试用

    完成设置后,可以切换到目标 AI 的输入框,测试一次真实输入与发送。这不是完成设置的必做步骤。

    语音输入

    单击说话,再单击结束;等文字出现并检查后,双击语音按键发送。

    键盘输入

    输入测试文字,再单击语音按键发送。

    AI 自带语音

    先在 AI 中开启语音;确认文字出现在可编辑输入框后,再用设备发送键发送。各家语音入口和工作方式不同,以应用提示为准。

    这次文字会实际发送给目标 AI,请先检查内容,避免使用敏感信息。

    两步流程依据 macOS Console 0.2.1 发布说明更新;语音软件匹配细节及展开图片仍参考 0.1.94 源码,属于旧版演示,不是 0.2.1 实机截图,尚未进行实机验收。具体控件名称请以当前应用提示为准。

    没有出现预期结果?带上 Console 版本和当前画面向我们提问 →
某一步没有成功?到支持区域提问
OPEN SOURCE

从源码开始,
自定义更多。

在 GitHub 公开仓库获取 BORING 的控制台与固件源码、Python SDK、扩展示例及设备协议。想进一步修改设备行为,可以从仓库中的说明开始。

公开控制台源码为 0.1.46,与本页的 Windows、macOS 安装包版本不同。

原创源码采用 PolyForm Noncommercial 1.0.0 非商业许可;商业复用需要另行授权。这是非商业源码开放,不等同于允许任意商业使用的开源许可。查看许可说明

软件源码
固件源码
SDK
使用文档
前往 GitHub

源码与开发说明以仓库内容为准。

SUPPORT

需要帮助?

使用中遇到问题,或想交流自己的配置方式,欢迎加入 BORING 用户交流群。

提问时,可以说明:

  • 01电脑系统
  • 02Console 版本
  • 03遇到的现象
  • 04已经尝试的操作
BORING 用户交流群微信二维码

使用微信扫描二维码,加入交流群。

本二维码在 前有效。

查看二维码原图

在手机上:打开原图并保存,再到微信「扫一扫」里从相册识别。

常见问题

Console 支持哪些电脑系统?

首版提供 Windows 和 macOS 安装包;具体要求见下载说明。

在哪里获取源码与 SDK?

前往本页 GitHub 入口所指向的公开仓库。

还没有设备,可以先加入交流群吗?

可以,欢迎先了解产品、交流玩法。