MoonDropEQ

适用于 水月雨 MOONDROP耳机 的 Windows 桌面 EQ 预设遥控器。

把官网 水月雨在线调音工具 的「打开网页 → 选设备 → 开始使用 → 挑预设 → 点应用」五步，压缩成一次点击或一个热键。

功能

• 内置预设一键切换：默认 / 音乐游戏 / 3A 游戏 / FPS1 / FPS2
• 抓取当前曲线：在官网调好音后，一键把当前曲线存到本地
• 全局热键：任意预设可绑定组合键，窗口最小化也能切换
• 托盘常驻：关窗口即收进托盘，单击图标唤回
• 单文件 exe：免安装，体积约 65 MB（自包含运行时）
• 外观可调：Mica / 亚克力 / 纯色三种材质，深色 / 浅色 / 跟随系统三种主题，即时生效

支持设备

设备	Vendor ID	Product ID	HID Report ID
MOONDROP Rays（光束）	0x35D8	0x011B	0x4B

目前只适配 Rays。其他水月雨第二代 DSP 设备（FreeDSP Pro、DAWN PRO2 等）协议相近但未经验证，不要直接套用。

工作原理

官网调音工具使用 WebHID 与耳机通信，并非私有驱动。本工具用完全相同的 HID 报文直接对话：

帧格式：[reportId][op][cmd][len][payload...]，输出报告固定 64 字节

操作	报文
切换内置预设	01 0F 01 <index> → 写 preGain / globalGain → 01 01 00 保存
应用自定义曲线	01 0F 01 07 → 8 × 01 09 21 <33 字节参数> → 01 0A 04 00 00 FF FF → 写增益 → 01 01 00 保存

每段 PEQ 参数是 33 字节，工具只做原样存取、不解码，因此写入结果与官网完全一致。

设备槽位

• 0 默认 · 1 音乐游戏 · 2 3A 游戏 · 3 FPS1 · 4 FPS2
• 5 – 7 为无效索引（会沿用上一个有效预设的数据）
• 自定义曲线只有一块共享工作区，同一时刻只能生效一条，切换耗时约 0.5 秒

使用

1. 插上耳机（系统会识别为 MOONDROP Rays）
2. 双击 MoonDropEQ.exe
3. 点击预设卡片，或按对应热键

添加自己的曲线

1. 打开官网，连接耳机，挑选并应用你想用的预设（游戏板块 / 收藏夹都可以）
2. 回到本工具，点「抓取当前曲线」
3. 起个名字保存 —— 之后它就和内置预设一样，点击或热键即可切换

设置

点主窗口底部「设置」：

• 关闭窗口时：最小化到托盘（默认，热键继续可用）或直接退出程序
• 窗口材质：Mica（云母）/ 亚克力（磨砂）/ 纯色（无材质，性能最好）
• 主题：跟随系统 / 深色 / 浅色

改动即时生效，并写入 %APPDATA%\MoonDropEQ\settings.json。

管理预设

每个预设卡片下方都有「重命名 / 设置热键 / 删除」按钮，也可以直接右键卡片：

• 重命名：随时改名字
• 设置热键…：按下想要的组合键即可绑定；支持 Ctrl / Alt / Shift / Win + 字母、数字、F1–F24，单功能键仅支持 F1–F24
• 删除：只从本地列表移除，不会改动耳机内的设置

配置文件

路径：%APPDATA%\MoonDropEQ\presets.json（纯文本，可手改、可备份、可迁移）

{
  "version": 1,
  "presets": [
    {
      "id": "builtin-fps1",
      "name": "FPS1",
      "kind": "BuiltIn",      // BuiltIn：按索引切槽；Curve：写入 PEQ 工作区
      "index": 3,             // 仅 BuiltIn 使用
      "hotkey": "Ctrl+Alt+4"  // 支持 Ctrl / Alt / Shift / Win + 字母、数字、F1–F24
    },
    {
      "id": "curve-xxx",
      "name": "CS2",
      "kind": "Curve",
      "preGainDb": -7.5,
      "globalGainDb": 0,
      "bands": ["00 00 ...", "..."],  // 8 段，每段 33 字节十六进制
      "hotkey": "Ctrl+Alt+6"
    }
  ]
}

改完文件后重启程序生效。点「配置文件」按钮可直接在资源管理器中定位到该文件。

常见问题

现象	处理
显示「未连接」	确认耳机已插好；本工具会按 VID/PID 自动识别，无需选设备
应用失败 / 写入无反应	官网页面可能正占用设备。关闭网页（或点网页里断开）后重试
提示热键被占用	换一个组合键（改 presets.json 里的 hotkey）后重启
SmartScreen 拦截	exe 未签名，选「更多信息 → 仍要运行」
抓取曲线失败	先在官网成功应用一次，再点抓取

构建

只使用 GitHub Actions 云端构建，本地无需安装 .NET SDK：

• push 到 main → 自动构建并上传产物 MoonDropEQ-win-x64
• 推送 v* 标签 → 自动创建 Release 并附带 zip
• 工作流：.github/workflows/build.yml（windows-latest + dotnet publish -r win-x64 --self-contained）

维护

协议常量、抓包方法、固件升级后的适配步骤与发版流程，见 docs/maintenance.md。

安全说明

• 只写 EQ 参数区与「保存」命令，不触碰固件分区、不涉及 OTA 升级
• 写入内容与官网页面发出的字节完全一致
• 每次应用会写一次 flash，正常使用频率下远低于寿命
• 建议保留官网作为曲线编辑器，本工具负责日常快速切换

免责声明

非官方工具，与水月雨（MOONDROP）无隶属关系。协议基于官网公开前端实现分析得出，固件或官网更新后可能需要适配。使用风险自负。