# Better RGB：还原 Tongfang/ITE8291 键盘灯光协议

> Better RGB 还原采用 ITE8291 键盘控制器的 Tongfang 笔记本电脑的 USB HID 灯光协议，并实现 Windows 逐键 RGB 控制客户端。作者记录了如何对照厂商软件的抓包与实际灯光变化，识别 HID 功能报告中的命令、输出报告中的颜色缓冲区及各按键的字节偏移。

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

## 使用条件与局限

- **前提条件：**需要具备文中所述 USB HID 接口的 Tongfang/ITE8291 键盘及 Windows。
- **前提条件：**源码构建需要 MSYS2、mingw-w64、CMake 和 Ninja。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/EpicYamo/BetterRGB/blob/fd47ee8a3120165d3544c4b6a4c4ed1d1d4c04a7/README.md>

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

- [aiowapy：WhatsApp Multi-Device 协议的 Python 实现](https://awesomerea.org/zh/resources/aiowapy-whatsapp-protocol-case/index.md) · 案例
- [redmi-buds-linux：基于 JieLi RCSP 重建 Redmi 耳机控制功能](https://awesomerea.org/zh/resources/redmi-buds-linux-case/index.md) · 案例
- [iPod Classic LCD：还原显示屏引脚与总线协议](https://awesomerea.org/zh/resources/ipod-classic-lcd-protocol-case/index.md) · 案例
- [OBSBOT Tiny 3：USB 控制协议研究](https://awesomerea.org/zh/resources/obsbot-tiny3-protocol-case/index.md) · 案例
- [StargateCryo：基于串行协议研究的 Intel Cryo 控制面板](https://awesomerea.org/zh/resources/stargatecryo-case/index.md) · 案例
- [infrared：LG 与 Vityas 遥控器红外命令映射](https://awesomerea.org/zh/resources/infrared-remote-configs-case/index.md) · 案例

## 关于此条目

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