# GMK87 Configurator：重建 Zuoya 键盘 USB HID 控制协议

> GMK87 Configurator 根据官方应用的 USB 抓包重建 Zuoya GMK87 键盘的 HID 控制流程。项目记录了 64 字节报文结构和图片上传命令顺序，并提供桌面程序、命令行工具及 Node.js 接口，用于上传屏幕图片、设置 RGB 灯光和同步时钟。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-08
- 收录于：2026-11-09
- 原始资源：<https://github.com/codedgar/gmk87-node>
- 一手来源：<https://github.com/codedgar/gmk87-node/blob/a9a1e902944ff323f247ab8deb5d04f8f0a56601/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/gmk87-configurator-case/>
- 记录 JSON：<https://awesomerea.org/resources/gmk87-configurator-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/gmk87-configurator-case/index.md)

## 使用条件与局限

- **前提条件：**需要 Zuoya GMK87 键盘；命令行工具要求 Node.js 14 或更新版本。
- **前提条件：**Linux 用户若要免 root 访问 HID，需安装仓库附带的 udev 规则。
- **局限：**两个屏幕图片槽合计最多支持 36 帧。
- **许可：**MIT 许可证。

## 一手来源

1. <https://github.com/codedgar/gmk87-node/blob/a9a1e902944ff323f247ab8deb5d04f8f0a56601/README.md>
2. <https://github.com/codedgar/gmk87-node/blob/a9a1e902944ff323f247ab8deb5d04f8f0a56601/ANALYSIS.md>

## 同分区更多条目：协议

- [Ajazz AK820 Pro：在 Linux 上重建键盘灯光控制](https://awesomerea.org/zh/resources/ajazz-keyboard-software-linux-case/index.md) · 案例
- [OPUS-QUAD Pro DJ Link Reverse Engineer Packet Analysis：解析设备通信报文](https://awesomerea.org/zh/resources/opus-quad-pro-dj-link-analysis-case/index.md) · 案例
- [MiraBox StreamDock：重建 USB 设备控制方式](https://awesomerea.org/zh/resources/mirabox-streamdock-node-case/index.md) · 案例
- [SiriRemote-Linux：解码 Siri Remote 蓝牙输入](https://awesomerea.org/zh/resources/siriremote-linux-case/index.md) · 案例
- [ZydDash：解析 ePowerFun 滑板车遥测数据并制作 ESP32 仪表盘](https://awesomerea.org/zh/resources/zyddash-case/index.md) · 案例
- [catlink-local：还原 CATLINK Open X 本地控制](https://awesomerea.org/zh/resources/catlink-local-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。