KeyBot 支持中心

1. 先让手机连接要使用的路由器的 2.4GHz WiFi。
2. 给设备接通 USB 电源（电脑 USB 接口或 USB 充电器）。OLED 上会出现开机画面。
3. 如果没有已保存的 WiFi 信息，OLED 会显示 WIFI SETUP 画面和应用安装二维码，设备等待应用的 BLE 设置。（扫描二维码会打开 Google Play 上的 KeyBot 应用页面。）
4. 在 KeyBot 应用中进入 WiFi 设置菜单，手机当前连接的 SSID 会自动填入。输入密码并点击连接。如果 SSID 不对，请手动输入。
5. OLED 顶部显示出 IP 地址（例如 192.168.1.50）即表示连接成功。

从固件 v2.4.3 · 应用 2.5.1 起，即使有多台 SSID 和密码相同的路由器，也可以选择要连接的路由器。

• 如果发现 2 台及以上，应用中会弹出“发现多台同名路由器”窗口，请在列表中点击要连接的路由器。列表中会显示 MAC 地址末位（可与路由器背面标签上的 MAC 对照）、信号（dBm）和信道。
• 点击“自动选择”，或 90 秒内不选择，会连接信号最强的路由器。
• 所选路由器会保存在设备中，下次开机起直接连接。如果找不到该路由器，则连接信号最强的路由器。

只有应用 2.5.1 和固件 v2.4.3 都是最新版本时才会弹出选择窗口。与旧版本混用也能工作，但此时不会询问，直接连接信号最强的路由器。

KeyBot 仅支持 2.4GHz WiFi。无法连接只有 5GHz 的路由器，请确认路由器的 2.4GHz 频段已开启。连接失败时，设备最多自动重试 3 次。

不需要。WiFi 信息会永久保存在设备内部，断电重启后会自动重新连接，也不需要再做 BLE 设置。

应用和设备必须处于同一个 WiFi 网络。

• 点击应用首页的“搜索设备”，会自动查找网络中的设备。请在列表中选择 KeyBot。
• 也可以把 OLED 上显示的 IP 地址直接输入到应用设置中。
• 连接后会自动读取设备中保存的计划，屏幕顶部显示“已连接”。即使关闭应用后重新打开，也会尝试重新连接到上次的 IP。
• 即使重启路由器导致设备的 IP 变化，应用也会在同一 WiFi 中重新查找设备并自动连接。

1. 长按设备侧面的 WiFi 重置按键 3 秒以上。
2. OLED 切换到 WIFI SETUP 画面，说明已保存的 WiFi 信息被删除，设备进入了 BLE 设置模式。
3. 用与首次设置相同的方法，在应用中输入新的 WiFi 信息。

WiFi 重置只会删除 WiFi 信息。宏和计划数据会保留。

把 PRESS（保持按下）和 RELEASE（松开）配对使用。例如：PRESS(A) → DELAY(500ms) → RELEASE(A)。

• RELEASE 只会松开所选的按键，把按键留空则松开所有已按下的按键。
• 用 PRESS 按下的按键，即使期间执行了其他 CLICK·MOD，也会一直保持按下，主序列和定时器组共享同一个按下状态。（例如：在主序列中用 PRESS 保持方向键，同时让定时器 CLICK 技能键）
• 建议同时保持的按键最多 5 个，并务必用 RELEASE 配对。停止时会全部解除。

固件 v2.3.0 及以上支持。

使用 MOD 动作。它可以同时输入最多 6 个按键，所以可用于 Ctrl+C、Shift+Alt+Tab 这类组合键。

在动作中选择 MOUSE，然后在左侧单元格中选择左键单击、右键单击、滚轮↑、滚轮↓之一。此时会打开选择鼠标动作的窗口，代替按键选择器。

• DELAY：仅延时 / CLICK：按下再松开 / PRESS：保持按下 / RELEASE：松开按键 / MOD：最多 6 键同时输入 / MOUSE：鼠标输入
• 延时（ms）是该动作之后到下一个动作的等待时间（不是按住按键的时间），最小 20ms，DELAY 动作为 40ms。
• CLICK、MOD 和鼠标单击会把按键按住 60~110ms（每次单击随机）再松开，所以延时比这更短时，单击一结束就会立即执行下一个动作。想按住指定的时间，请使用 PRESS → DELAY → RELEASE。（固件 v2.4.0 及以上）
• 随机（+r）是加到延时上的随机范围，为 0 则是固定延时。
• 动作的顺序可以用列表中的拖动手柄（≡）调整。

• 主序列：每个计划最多 256 个动作
• 定时器组：每个计划最多 10 个，每组最多 64 个动作
• 最多可独立保存 4 个计划，所有设置在重启后都会自动恢复。

可以。向 ChatGPT · Claude · Gemini 等 AI 聊天机器人口述想要的动作，它会生成 KeyBot 应用可以读取的宏。

1. 在宏界面的“用 AI 创建”中点击“复制指引”，粘贴到 AI 聊天机器人的新对话中。
2. 当 AI 询问时，说明想要的动作。如果是游戏，请同时告诉它使用技能后的后摇延时。
3. 复制 AI 的回答（JSON），在应用中点击“粘贴”→“检查”。
4. 选择放入的计划（1~4）和保存名称，点击“应用并保存”，确认内容后用“开始”发送到设备。

如果检查出现错误，把“复制发给 AI 的修改请求”粘贴给 AI，就能得到修正后的 JSON。

在宏界面点击“保存”并命名，即可保存到应用中（可使用中文名称），再用“加载”载入到其他计划。只有当前所选的这一个计划的主序列和定时器内容会被保存或替换，其他计划保持不变。

加载和应用 AI 宏只会改变应用内的内容。要反映到设备上，请用“开始”发送。

• MAIN x1（主序列一次）：主序列运行一次后停止
• MAIN（主序列循环）：无限循环主序列（没有定时器）
• FULL（主序列 + 定时器循环）：主序列循环期间，定时器组会定期插入运行
• TMR x1（仅定时器一次）：不运行主序列，定时器组各运行一次后停止
• TIMER（仅定时器循环）：不运行主序列，仅无限循环定时器组
• FULL x1（主序列 + 定时器一次）：主序列和定时器各运行一次后停止

所选模式会保存在设备中，重启后物理按键仍以同样方式运行。FULL x1 模式适合“先执行一次登录动作，之后只定期发送保持活动状态的输入”这样的用途。

与定时器相关的模式（FULL、TMR x1、TIMER、FULL x1）至少需要 1 个定时器组才能工作。没有组时会立即停止。请在定时器循环标签页中用“添加定时器组”创建组。

• 周期（秒）：该组的触发间隔。120 表示每 120 秒运行一次，0 表示立即开始。
• 随机（+秒）：加到周期上的随机范围。+25 表示在 120~145 秒之间随机触发。
• 立即首次运行：开启后，开始时立即进行第一次触发；关闭则在第一个周期之后触发。
• 各组以不同的周期同时独立运行。例如：组 A（120 秒 ±25）、B（60 秒 ±10）、C（300 秒 ±0）

每个组可以设置为 普通 / 高 / 很高 / 最高（默认：普通）。当较高优先级的组正在运行时，比它低的序列（主序列始终为“普通”）会从下一个动作起等待，直到该组结束后再继续。优先级相同的序列会同时交错运行。

如果某组的运行时间比周期长，主序列几乎无法推进，请注意。固件 v2.4.0 及以上支持。

1. 点击底部的“开始”按钮，会打开开始选项弹窗。
2. 选择运行对象（仅主序列 / 仅定时器 / 主序列 + 定时器）和运行方式（一次 / 循环），根据组合会自动确定 6 种模式之一。
3. 点击弹窗中的“开始”，应用会把当前编辑的内容发送到设备并启动计划。所选模式会保存在设备中。

要停止，请点击底部的“停止”按钮。所有正在运行的计划会立即停止。

可以。通过应用设置过一次模式（发送并运行）后，之后无需 WiFi 连接，仅靠 USB 供电就能用按键运行。设备上的 4 个按键分别对应计划 1~4。

• 按一下按键，对应的计划会按已保存的模式启动。
• 运行中再按同一个按键会停止（切换）。
• 按其他按键，会先停止当前计划，再启动新的计划。

未设置模式的按键为防止误操作而不工作。请先在应用中把该计划发送并运行一次来保存模式，然后再按按键。另外，快速连续按键时部分输入可能会被忽略，请慢一点按。

这是 press（保持按下）之后，在 release 执行之前就停止了的情况。点击应用的“停止”按钮，所有按键都会被松开。在宏中，请为每个 PRESS 加上与之配对的 RELEASE。

WiFi 开启的瞬间电流会大幅增加。供电较弱的 USB 口、集线器或过长的线材可能导致重启或开机错误。请使用电脑主机的 USB 口，或 5V 2A 适配器配短数据线。

• 左上：WiFi IP 地址 / 右上：USB 连接状态和 WiFi 信号强度
• 计划方框 1~4：正在运行的计划会用白色方框突出显示。
• 底部文字：以“S1 RUN: FULL”的形式显示当前计划编号和模式。
• WIFI SETUP：正在等待 WiFi 设置（显示应用安装二维码），需要通过应用用 BLE 发送 WiFi 信息。
• OTA UPDATE：正在更新固件，更新完成前必须保持通电。

点击应用底部的“同步”按钮，选择“仅当前计划”或“全部计划”，就会把设备中保存的内容读取到应用中。连接应用时会自动执行全部同步，所以手动同步用于在设备上直接做了更改的情况。

在已连接 WiFi 的状态下，通过应用更新。

1. 在应用设置的“固件更新”标签页中，查看当前设备版本和最新版本。
2. 点击“更新”按钮，设备会自行下载固件，OLED 上显示进度。
3. 完成后设备会自动重启并运行新固件。

更新期间绝对不要关闭电源。OLED 显示“keep power on”期间必须保持通电。更新失败时会自动恢复到之前的固件。

当某些游戏或软件只允许特定键盘时，可以更改设备，让电脑把它识别为该键盘。在应用的 设置 → USB ID 中选择预设或手动输入，然后点击“应用”。

默认值为 VID 0x303A、PID 0x800B。更改后设备会自动重启，电脑可能会移除原有驱动并将其识别为新设备。

电脑会将其识别为 USB 键盘 + 鼠标复合设备（HID），无需另外安装驱动，在 Windows、Mac、Linux 上都能立即使用。用于设置的 KeyBot 应用提供 Android 版本。

应用支持 한국어、English、日本語、繁體中文、Deutsch、Français、Español、Bahasa Indonesia、ไทย、Tiếng Việt 共 10 种语言，并跟随设备（手机）的语言。不支持的语言会显示为英语。

• USB：HID 键盘 + 鼠标复合设备，免驱动，USB 2.0
• 无线：WiFi 802.11 b/g/n 2.4GHz，BLE 5.0（用于 WiFi 设置）
• 显示屏：0.96" OLED（SSD1306），128×64
• 按键：4 个计划按键，1 个 WiFi 重置按键
• 计划：4 个独立计划，6 种运行模式
• 存储：设置和按键序列永久保存，支持 OTA 更新（失败时自动恢复）
• 版本：固件 v2.4.3 · Android 应用 2.5.1