第一次使用，从这里开始

SUPPORTED SYSTEMS

选择你的系统

三个系统都可以下载 AutoClipboard，但测试成熟度不同。请只下载与你的电脑系统对应的桌面软件安装包。

CH343 是 Windows 串口驱动。日常蓝牙配对不需要安装它；只有 Windows 插入数据 Type-C 线后仍没有出现 COM 端口时，才需要查看驱动说明。

QUICK START

6 步完成首次使用

下面六步只做第一次连接需要的事情。先不要更新固件，也不要急着删除蓝牙记录。

1. 1

   下载正确的桌面软件

   Windows 选择 EXE，Ubuntu 选择 DEB，macOS 选择 DMG。浏览器显示下载完成，并且文件后缀与你的系统一致，就可以继续。

2. 2

   安装 AutoClipboard

   按照系统安装向导完成安装。能在应用列表里看到 AutoClipboard 就算成功；暂时不用打开，也不要进入固件更新。

3. 3

   给手柄充电并唤醒

   接上 USB Type-C 供电，打开或拿起手柄。小屏亮起并显示蓝牙状态就可以继续；只有需要串口诊断时，才必须使用支持数据传输的线。

4. 4

   连接 CommunistKB-XXXX

   打开电脑的蓝牙设置，选择扫描到的完整名称。系统显示“已连接”或“已配对”就算成功；末尾四位编号不需要自己输入。

5. 5

   确认从 PAIR 变成 LINK

   小屏显示 PAIR 表示可以配对；连接成功后会显示 LINK。如果显示 WAIT，手柄正在等待已经保存的电脑。

6. 6

   在纯文本输入框中测试，再打开完整功能

   打开记事本或其他纯文本编辑器，按一下 Enter 或 Ctrl+V 对应的宏键。能产生输入，说明蓝牙键盘功能已经正常；再启动 AutoClipboard 使用状态显示、配置和其他完整功能。

HARDWARE

先认识最常用的部件

BLUETOOTH

看懂三个蓝牙状态

手柄的完整蓝牙名称是 CommunistKB-XXXX。XXXX 是每台手柄自己的四位编号，系统扫描时已经包含在名称里。

1. 打开 Windows、Ubuntu 或 macOS 的系统蓝牙设置。
2. 选择“添加设备”，等待手柄显示 PAIR。
3. 选择完整的 CommunistKB-XXXX。
4. 配对后等待小屏显示 LINK，再去纯文本输入框测试宏键。

MULTI HOST

在三台电脑之间正确切换

手柄提供 3 个主机槽位。只在旧电脑上点击“断开”不会自动切换手柄槽位；每次换电脑，都要先在手柄的 BLE Hosts 页面选择目标槽位。

切回已经配对过的电脑

1. 双击波轮中键进入 Settings。
2. 拨动到 BLE Hosts，单击进入。
3. 找到目标电脑对应的 SAVED 槽位并短按。
4. 小屏会先显示 WAIT；打开目标电脑蓝牙后，连接成功会变成 LINK。

连接一台从未配对的新电脑

1. 进入 Settings > BLE Hosts。
2. 选择一个 EMPTY 空槽位并短按。
3. 看到 PAIR 后，在 120 秒内打开新电脑的系统蓝牙设置。
4. 添加完整名称 CommunistKB-XXXX，并等待手柄显示 LINK。

三个槽位都已占用时，只长按删除确认不再使用的 SAVED 槽位，再短按变成的 EMPTY 槽位进行配对。开机时按住中键约 5 秒会清空全部槽位，仅用于恢复出厂，不是日常切换操作。清槽只会删除手柄端密钥；电脑仍可能保留旧密钥，必须先在系统蓝牙设置中忽略或移除对应的 CommunistKB-XXXX，再让手柄保持 PAIR 并重新添加。

CONTROLS

波轮与小屏操作

波轮用于切换 Profile 和移动菜单，中键用于确认、进入设置或返回；小屏会同步显示当前 Profile、蓝牙状态和菜单提示。

不要尝试按住中键同时拨动波轮；机械结构不支持这种组合动作。

默认 Vibe Coding Profile 的四枚宏按键

默认的 Vibe Coding Profile 将四枚按键设置为 Right Alt、Enter、Ctrl+V 和 Ctrl+Alt+0。这四个按键都可以在 AutoClipboard 中重新配置。

Gauss、Compute 与 Einstein 的专用控制

新版默认配置让三个 Profile 分别承担导航、审批和鼠标控制。Gauss 的四向键属于标准蓝牙键盘输入；Compute 与 Einstein 的审批和相对鼠标动作需要 AutoClipboard 保持运行。

Einstein 移动的是系统相对鼠标，不是演讲光圈，也不是把姿态固定映射到绝对屏幕坐标。按住第三键相当于按下离合器：AutoClipboard 只计算相邻姿态帧的增量，并用启动/停止双阈值、逐帧重锚、重复帧与异常跳变丢弃来抑制漂移；松开后立即停止，不会继续滑行。第四键始终在鼠标当前位置执行左键点击。

Compute 的接受/拒绝按键只在 Agent 当前存在审批授权请求时生效；没有审批请求时会安全地不执行任何操作。

AUTOCLIPBOARD

宏键能用，不代表软件已经连接

系统把手柄当作蓝牙键盘后，四枚宏键就可以发送快捷键。AutoClipboard 使用另一条软件连接来读取状态、修改设置和显示 Agent 信息，所以两者可能一条正常、另一条还没有就绪。

基础蓝牙宏不依赖 AutoClipboard。Agent 状态、Profile 快开、Compute 审批、Einstein 相对鼠标、惯性测量单元（IMU）姿态预览、演讲光圈和深度设置需要 AutoClipboard 保持运行。这里的 Agent 状态连接配置，就是把编程助手的工作状态发送给 AutoClipboard，再显示到手柄上。

TROUBLESHOOTING

先按现象排查，不要急着重置

删除配对、重置蓝牙和更新固件都不应该是第一步。先找到属于你的现象，再做下面的低风险检查。