# attack-shark-x11-driver：Attack Shark X11 HID 设置协议客户端

> attack-shark-x11-driver 以 TypeScript 客户端实现 Attack Shark X11 鼠标的 USB HID 配置协议，支持 DPI、配置档、按键、宏、灯效和轮询率设置，以及设备状态读取。协议笔记记录了 USBPcap 与 Wireshark 抓包、HID 功能报告、官方软件分析和固件调查所得的发现。

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

## 使用条件与局限

- **前提条件：**需要 Attack Shark X11 鼠标；支持有线和 2.4 GHz 无线连接。
- **前提条件：**主要在 Linux 上开发和测试；HID 实现兼容时支持 Node.js 和 Bun。
- **局限：**蓝牙连接尚未测试；唤醒模式设置及 Left-Click Macro 的 0x32–0x33 报告尚未实现。
- **许可：**MIT 许可证。

## 一手来源

1. <https://github.com/HarukaYamamoto0/attack-shark-x11-driver/blob/247eda6153bd517e953f7505a133d43f923fe32f/README.md>
2. <https://github.com/HarukaYamamoto0/attack-shark-x11-driver/blob/247eda6153bd517e953f7505a133d43f923fe32f/docs/messages/README.md>

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

- [Hisense/Hitachi H-NET-Protocol：解析热泵总线信号](https://awesomerea.org/zh/resources/hisense-h-net-protocol-case/index.md) · 案例
- [YenKeyControl：解析 Yenkee YKB3700 Rogue 键盘协议](https://awesomerea.org/zh/resources/yenkeycontrol-case/index.md) · 案例
- [Deye Battery Serial Bus：解析电池 CAN 数据帧](https://awesomerea.org/zh/resources/deye-battery-serial-bus-case/index.md) · 案例
- [Bonaparte：重建 Napoleon eFIRE 蓝牙控制协议](https://awesomerea.org/zh/resources/bonaparte-efire-case/index.md) · 案例
- [skyrcUSB：通过重建协议读取 skyRC 充电器](https://awesomerea.org/zh/resources/skyrcusb-case/index.md) · 案例
- [mqtt-energi：重建 myenergi 设备通信格式](https://awesomerea.org/zh/resources/mqtt-energi-case/index.md) · 案例

## 关于此条目

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