# AK820 Pro Modder：在 macOS 上重建键盘 HID 控制

> AK820 Pro Modder 通过 Rust HID 协议库在 macOS 上控制 Epomaker/Ajazz AK820 Pro 键盘，Tauri 应用与 CLI 共用该库。协议文档区分两类固件接口，并记录灯效、键位映射、宏、TFT 显示屏和设备设置命令。

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

## 使用条件与局限

- **前提条件：**需要 macOS 11 或更高版本及 AK820 Pro 键盘；构建需要 Rust 1.90 或更高版本、Node.js 22 和 pnpm 10。
- **测试证据：**作者报告大部分功能在一把固件 1.07 的 ISO-DE 键盘上测试；此构建尚未测试 B 类固件支持。
- **局限：**B 类固件的板载键位映射和宏尚未解析；不支持 JIS 布局。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/wsclx/ak820pro-modder/blob/55a2ca250e7f7918e09eee506d54ef0d84fc66ff/README.md>
2. <https://github.com/wsclx/ak820pro-modder/blob/55a2ca250e7f7918e09eee506d54ef0d84fc66ff/docs/PROTOCOL.md>
3. <https://github.com/wsclx/ak820pro-modder/blob/55a2ca250e7f7918e09eee506d54ef0d84fc66ff/LICENSE>

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

- [dj-midi-sender：重建 Pro DJ Link 节拍通信](https://awesomerea.org/zh/resources/dj-midi-sender-case/index.md) · 案例
- [Wellue O2Ring-S：还原 OxyII BLE 协议](https://awesomerea.org/zh/resources/o2ring-s-protocol-case/index.md) · 案例
- [Blackmacro-lib：重建 Speed Editor USB HID 交互](https://awesomerea.org/zh/resources/blackmacro-lib-case/index.md) · 案例
- [libfprint Goodix SPI Driver：重建 GDIX51C0 指纹支持](https://awesomerea.org/zh/resources/libfprint-goodix-spi-case/index.md) · 案例
- [Insta360 GO Ultra：还原 Wi-Fi 相机协议](https://awesomerea.org/zh/resources/insta360-go-ultra-sdk-case/index.md) · 案例
- [Chuwi CoreBook X：在 Linux 上恢复左扬声器音频链路](https://awesomerea.org/zh/resources/chuwi-corebook-x-left-speaker-case/index.md) · 案例

## 关于此条目

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