HarukaYamamoto0/attack-shark-x11-driver
GitHub: HarukaYamamoto0/attack-shark-x11-driver
为 Attack Shark X11 游戏鼠标提供跨平台 TypeScript 驱动，支持通过 USB HID 配置 DPI、宏、灯光和轮询率等参数。
Stars: 10 | Forks: 2
# attack-shark-x11-driver
[](https://www.npmjs.com/package/attack-shark-x11-driver)
[](https://github.com/HarukaYamamoto0/attack-shark-x11-driver/blob/main/LICENSE)
[](https://bun.sh)
[](https://deepwiki.com/HarukaYamamoto0/attack-shark-x11-driver)
一个用于 **Attack Shark X11 游戏鼠标** 的 TypeScript 驱动程序，提供跨平台支持（专注于 Linux），可通过 USB HID 配置 DPI、宏、灯光和轮询率。
官方软件仅支持 Windows；本项目提供了一种在任何支持 Node.js 或 Bun 的平台上与设备交互的方式。
## 功能
- ✅ **DPI 配置**：设置档位和当前档位。
- ✅ **按键重映射**：完全可自定义的按键行为。
- ✅ **宏**：支持自定义宏和模板。
- ✅ **灯光控制**：更改模式和速度。
- ✅ **轮询率**：支持 125 Hz 到 1000 Hz。
- ✅ **电池状态**：实时电池监控。
- ✅ **跨平台**：支持 Linux、macOS 和 Windows。
## 安装
```
bun add attack-shark-x11-driver
# 或者
npm install attack-shark-x11-driver
```
## 快速开始
```
import { AttackSharkX11, ConnectionMode, Rate } from 'attack-shark-x11-driver';
const driver = new AttackSharkX11({
connectionMode: ConnectionMode.Adapter, // or Wired
delayMs: 300, // Recommended safe delay between packets
});
try {
await driver.open();
// Set Polling Rate to 1000Hz (eSports)
await driver.setPollingRate(Rate.eSports);
// Configure DPI Stages
await driver.setDpi({
dpiValues: [800, 1600, 2400, 3200, 5000, 22000],
activeStage: 2,
});
// Get Battery Level
const battery = await driver.getBatteryLevel();
console.log(`Battery: ${battery}%`);
} catch (error) {
console.error('Driver error:', error);
} finally {
await driver.close();
}
```
## Linux 设置（udev）
要在 Linux 上无需 root 权限访问设备，需要创建 udev 规则：
1. 创建规则文件：
sudo nano /etc/udev/rules.d/99-attack-shark-x11.rules
2. 添加以下行：
SUBSYSTEM=="usb", ATTR{idVendor}=="1d57", ATTR{idProduct}=="fa60", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="1d57", ATTR{idProduct}=="fa55", MODE="0666", GROUP="plugdev"
3. 重新加载规则：
sudo udevadm control --reload-rules
sudo udevadm trigger
## 支持的硬件
| 设备 | 模式 | 状态 |
|------------------|-----------------|------------|
| Attack Shark X11 | 有线 | 支持 |
| Attack Shark X11 | 2.4GHz 无线 | 支持 |
| Attack Shark X11 | 蓝牙 | 未测试 |
_注意：Attack Shark R1 可能兼容，但尚未验证。_
## 重要警告 ⚠️
- **数据包延迟**：过快发送配置数据包可能导致固件卡死。请务必在命令之间保持至少 **250 ms**（建议 500 ms）的延迟。
- **恢复**：如果鼠标停止响应，请将其切换到蓝牙模式几秒钟，然后再切换回 2.4 GHz/有线模式。
## 贡献
本项目是逆向工程成果。欢迎贡献协议文档、新功能或使用不同硬件进行测试。
- **协议文档**：请参阅 `docs/` 目录下的数据包分析。
- **使用的工具**：Wireshark、USBPcap。
## 许可证
MIT © [HarukaYamamoto0](https://github.com/HarukaYamamoto0)
_免责声明：本项目与 Attack Shark 无关。使用需自行承担风险。_
标签：Attack Shark X11, Bun, DPI 配置, GNU通用公共许可证, HID 设备交互, Linux 驱动, MITM代理, Node.js, TypeScript, USB HID, 外设驱动, 安全插件, 宏定义, 游戏外设, 游戏鼠标驱动, 灯光控制, 电池监控, 硬件驱动, 自动化攻击, 轮询率, 鼠标自定义