# ak820：在 macOS 上重建 AJAZZ AK820 Pro 的 HID 控制协议

> ak820 通过 AJAZZ AK820 Pro 的厂商 HID feature report 协议在 macOS 上控制键盘。Python 命令行工具经 USB 设置时钟、RGB 灯光和休眠时间；附带文档记录 Windows 驱动分析、数据包封装、事务握手及尚未解决的按键重映射命令。

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

## 使用条件与局限

- **前提条件：**需要 macOS、Python 3.11+，以及通过 USB-C 数据线连接的 AJAZZ AK820 Pro。
- **前提条件：**Python 包依赖 hidapi。
- **局限：**macOS 上不支持上传 LCD 图片，按键重映射尚未实现。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/gusleig/ajazz-ak820-pro-mac/blob/2ad5c553140b50b62e1b93096dc089086976351e/README.md>
2. <https://github.com/gusleig/ajazz-ak820-pro-mac/blob/2ad5c553140b50b62e1b93096dc089086976351e/docs/DISCOVERY-LOG.md>
3. <https://github.com/gusleig/ajazz-ak820-pro-mac/blob/2ad5c553140b50b62e1b93096dc089086976351e/docs/protocol.md>

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

- [GameTrak Liberation：基于控制器 HID 协议的客户端](https://awesomerea.org/zh/resources/gametrak-liberation-case/index.md) · 案例
- [Cooper Hunter AC：UART 与红外协议调查](https://awesomerea.org/zh/resources/cooper-hunter-ac-protocol-case/index.md) · 案例
- [aw5d-linux：依据 USB-HID 协议研究驱动 iBUYPOWER 散热器屏幕](https://awesomerea.org/zh/resources/aw5d-linux-case/index.md) · 案例
- [MyJBxHeadsetControl：通过 USB HID 控制 JBL Quantum 950](https://awesomerea.org/zh/resources/myjbxheadsetcontrol-case/index.md) · 案例
- [zlt：MTN ZLT T10D MAX 路由器 API 还原](https://awesomerea.org/zh/resources/zltrouter-case/index.md) · 案例
- [claude-rc-api：还原 Claude Code Remote Control 接口](https://awesomerea.org/zh/resources/claude-rc-api-case/index.md) · 案例

## 关于此条目

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