开始使用

第一次，把 Ego62 连起来。

先从 USB 接收器连接开始。你不需要先编译固件，也不需要先学会改键。

准备好这几样东西

• 左右两半 Ego62 键盘，以及接收器。
• 一条支持数据传输的 USB-C 线。只能充电的线不能替代数据线。
• 一台电脑。

连接步骤

1. 接收器连接电脑。将 USB 数据线接在接收器与电脑之间，不是只连接某一半键盘。
2. 开启左右两半键盘。确认两边都有电，等待约 5 秒建立连接。
3. 打开一个文本输入框。分别试按左右两半的字母键，确认两边都能输入。

开始使用

不必一次学会所有按键。

分体摆放、独立拇指区和分层功能，与传统键盘有所不同。先熟悉常用输入，再逐步调整。

从日常输入开始

先在稳定的桌面上摆好两半键盘，找到适合自己桌面与坐姿的距离和角度，再练习熟悉的文字内容。无需照搬产品照片里的摆位。

“层”是什么？

可以把它理解为同一颗实体按键的另一套功能。默认固件包含日常输入、功能导航和连接设置三层；按住层键时，部分按键会切换为功能键、方向键或系统操作。

怎么找到某一个功能？

先使用首页的交互键位图查找默认位置；如果你已经在 Studio 改过键位，请以设备上的实际配置为准。

连接设置

蓝牙连接与设备切换

蓝牙模式下，接收器仍需要通电。首次配对前，先确认 USB 连接能够正常输入。

1. 给接收器供电。连接电脑或使用合适的 USB 电源，保持接收器通电。
2. 切换为蓝牙输出。默认键位下，按住左侧 Fn，再按住右侧 Fn，进入系统层；按原 Tab 位置的“输出切换”键。
3. 选择蓝牙配置。系统层的数字 1–5 位置对应蓝牙配置 1–5。请记住你使用了哪一个配置。
4. 在电脑或手机中配对。打开系统蓝牙设置，查找“ego62”并按系统提示操作。如果系统显示验证码，用键盘输入数字后按回车。

换设备时要注意什么？

不同蓝牙配置可用于不同设备。选择对应配置即可尝试切换；如果无法重新配对，先确认当前配置是否正确。不要不加区分地清除所有设备的配对信息。

需要重新配对某个配置时，先在系统层选择该配置，再使用“清除配对”；在目标设备的蓝牙设置中移除旧记录后重新配对。这会移除当前配置的已有配对。

按你的习惯调整

用 ZMK Studio 修改键位

支持 Studio 的固件可以直接在网页上改键，无需为每次调整重新刷写固件。

1. 打开 ZMK Studio。访问 zmk.studio，按页面提示选择对应设备并连接。
2. 在键盘上解锁。进入 System（连接设置）层，按下 &studio_unlock 对应按键。默认键位可在首页键位图的第三层查找。
3. 选择想改的按键。在可视化布局里点击按键，选择普通按键、层切换、媒体键或现有的其他行为。
4. 点击 Save 保存。将修改写入设备，再打开文本框验证是否符合预期。

第一次建议怎么改？

先调整一两颗常用键，测试后再继续。改动前记下原来的位置，保留层切换、输出切换和 Studio 解锁入口，避免把自己锁在不熟悉的布局中。

浏览器兼容性与 Studio 功能依据 ZMK 官方文档。

按你的习惯调整

保存修改，或回到默认键位。

改了键位，重新连接后却没了？

先确认你在 ZMK Studio 中点击了 Save。仅在编辑界面修改，不等于已经将配置保存到设备。

想恢复原来的键位

1. 接收器通过 USB 连接电脑，打开 ZMK Studio 并解锁。
2. 查找 Restore Stock Settings（恢复固件默认设置）。
3. 确认操作后，检查常用输入和层切换功能。

Studio 和源文件是什么关系？

Studio 保存的是设备上的运行配置，不会修改 GitHub 仓库里的 .keymap 文件。已有 Studio 配置可能覆盖重新刷写固件中的默认键位；需要采用新的默认键位时，应先确认是否需要执行 Restore Stock Settings。

进阶使用

固件更新与进阶自定义

普通键位调整优先使用 Studio。需要调整源配置或更新固件时，再使用下面的流程。

获取自己的固件

1. 在 GitHub Fork Ego62 固件仓库，按仓库教程启用 Actions。
2. 需要改源键位时，可使用 Nick Coutsos 键位编辑器，或编辑自己的配置文件后提交。
3. 等待 Actions 构建成功，从该次运行的 Artifacts 下载固件压缩包并解压。构建产物可能需要登录 GitHub，且可能过期。

按顺序刷写三个设备

仓库教程中的文件名为 ego62_left.uf2、ego62_right.uf2、ego62_dongle.uf2；实际构建产物名称可能包含板卡信息，请按 left / right / dongle 对应确认。

1. 将对应设备通过 USB 数据线连接电脑。
2. 双击设备背面的 Reset 按钮，进入刷写模式，电脑应出现 USB 磁盘。
3. 将对应 .uf2 拖入该磁盘，等待磁盘消失、设备自动重启。
4. 先完成左手、右手，最后刷写接收器，再重新检查连接。

进阶配置与后续变更请以 仓库完整教程 为准。本页不提供未经验证的“通用固件包”。

常见问题排查

连接后，键盘没有反应。

按下面的顺序检查，一次只改变一个条件，便于确认是哪一步解决了问题。

1. 检查数据线和供电。接收器是否接到了电脑？USB 线是否支持数据？左右两半是否开机、有电？可换一条已确认能传数据的线或电脑 USB 接口测试。
2. 确认输出模式。如果此前切换到蓝牙，连接 USB 后仍需确认输出端点。默认系统层的“输出切换”键用于在 USB 与蓝牙之间切换。
3. 重启接收器。单击接收器背面的 Reset，等待约 5 秒后，在文本框中重试。
4. 再重启两半键盘。如果仍无反应，可分别单击左右两半与接收器的 Reset，等待重新连接。

仍然无法输入时

先记录：电脑系统、USB 或蓝牙模式、左右哪边失效、是否刷写过固件、是否改过键位，以及已尝试的步骤。带着这些信息联系支持，比直接反复刷机更容易定位。

常见问题排查

只有一边能输入。

1. 确认没反应的那一半电源已打开，并有足够电量；可接 USB 线充电。
2. 单击该半区底部的 Reset 按钮，等待约 5 秒。
3. 再检查两边是否都能输入；若仍失效，重启接收器后重试。
4. 如果问题发生在更新固件之后，确认左右手刷写文件是否匹配，接收器是否最后刷写；不要直接尝试其他型号固件。

若只有某一颗键失效，而不是整个半区失效，请同时确认当前层与 Studio 键位是否将该位置设为了空键。本页不能替代硬件检测。

常见问题排查

Studio 无法连接，或改键没有生效。

找不到设备

• 使用 Chrome 或 Edge 打开网页端；不要假定所有浏览器都支持相同的设备连接能力。
• 通过 USB 数据线连接接收器，并确认固件支持 ZMK Studio。
• 若网页要求选择串口设备，选择对应接收器；USB 连接 Studio 时保持 USB 输出。

连接了但无法编辑

进入系统层，按下 Studio 解锁键。若曾修改过键位，请寻找实际的 &studio_unlock 位置，而非仅按默认位置。

改了但重新连接后恢复

先确认点击了 Save。需要采用固件中的默认键位时，查看 保存与恢复默认键位，并注意该操作会移除个人自定义。

某种高级功能无法在 Studio 中配置

Studio 的能力取决于固件中已定义的行为与当前支持范围，不能替代所有源代码级配置。需要进阶行为时，参考 固件更新与进阶自定义 及 ZMK 官方文档。

硬件与日常使用

充电、开关与重置按钮

怎么充电？

将需要充电的那一半键盘，通过 USB-C 线连接电脑即可。左右两半分别充电；接收器接电脑不代表两半都已在充电。根据项目 FAQ，键盘充电时可以继续使用。

底部按钮和开关分别做什么？

未提供统一续航、充电功率或充满时间承诺；具体表现取决于实际硬件、配置与使用方式。