QuietEQ

Windows 耳机与麦克风独立均衡器。调好，保存，关闭。

轻量、开源，无托盘图标，无后台控制面板，无开机启动项。界面关闭后，
Equalizer APO 在 Windows 音频引擎内继续执行已保存的配置。

QuietEQ 界面（演示设备）

下载与安装

QuietEQ-1.0.0-Setup-Offline-x64.exe：首次使用推荐，内含原版 Equalizer APO 1.4.2 安装程序。
QuietEQ-1.0.0-Setup-x64.exe：轻量安装包，适合已安装 Equalizer APO 的电脑。
EqualizerAPO-src-1.4.2.zip：随离线安装包提供的上游对应源码，普通使用不需要解压。
SHA256SUMS.txt：下载文件校验值。

支持 Windows 10 1903+ / Windows 11 x64，使用系统 .NET Framework 4.8。
v1.0.0 未做 Authenticode 签名，没有安装自签名证书或修改 Secure Boot 的步骤。
ARM64 和 32 位系统不在本版支持范围内。

安装 QuietEQ，从开始菜单打开 QuietEQ。
打开 音频引擎设置 → 安装音频引擎。离线包会启动内含的原版 Equalizer APO 安装向导；已有引擎可跳过。
在 设备选择器 分别勾选需要处理的播放设备和录音设备，完成其兼容性测试。不要勾选不想改变的设备。
点击 接入 QuietEQ 配置，按需完成管理员授权及音频服务/电脑重启。
选择耳机或麦克风、选择设备，调节 EQ，点击 保存设置 或按 Ctrl+S。现在可以关闭窗口。

接入前会备份并停用原 Equalizer APO 主配置，包括其自带的低频示例和卷积式 GraphicEQ，避免效果叠加。
接入也会关闭 Equalizer APO 自带的自动更新任务。QuietEQ 自身不联网检查更新、不采集遥测。
打开项目/下载帮助链接时，由浏览器联网；第三方安装程序遵循其自己的行为。

功能

输出与输入分开管理，每个 Windows 端点 ID 独立保存，设备改名不串用。
10 段参数式 IIR EQ：31.5、63、125、250、500、1k、2k、4k、8k、16k Hz；固定 Q=1.41，增益 ±12 dB，步进 0.5 dB。
前置增益 0 至 −36 dB、EQ 旁路、自动余量、48 kHz 响应预览。
平直、温暖、人声清晰、低频收敛预设，以及单设备 XML 预设导入/导出。
切换设备保留未保存修改；保存按钮保存本次打开的所有设备修改。关闭时提示保存或放弃。
已拔出设备保留配置；热插拔后点“刷新设备”。重装驱动若改变端点 ID，需导出/导入迁移。
保存使用原子文件替换、版本冲突检查、失败回滚和上次配置备份。

自动余量按所有正增益之和做保守衰减，可能明显降低音量；它不使用限幅或压缩。
可以关闭自动余量并手动设置前置增益，但应通过试听/测量避免削波。
这不保证其他音效或模拟输入级不会过载。

音质和延迟的边界

任何生效的 EQ 都会改变频率响应，IIR EQ 也会改变相位/群延迟，不能保证处理后位完全一致或绝对零延迟。
QuietEQ 选择原版 Equalizer APO 的参数式 IIR 滤镜，不建立虚拟声卡或录放音中转，不主动重采样，
不添加 Delay、卷积 GraphicEQ、前视处理或 VST 插件。主程序不接触实时音频缓冲。

这代表不额外设置音频缓冲延迟，不等同于整套硬件与驱动的延迟保证。
系统混音、硬件、蓝牙协议、OEM APO 和软件音频模式仍可能影响音质及延迟。
ASIO、WASAPI 独占、部分 RAW/硬件卸载路径或禁用音频增强时，可能绕过 EQ。
以设备选择器测试、实际播放/录音确认是否生效，界面的“已写入”不代表音频测量验证。

滤波频率达到设备采样率一半时自动跳过该频段，适配低采样率麦克风/蓝牙通话路径。
曲线显示的是 48 kHz 理论响应，低采样率设备的高频响应可能不同。
新配置是否立刻热加载，以及是否需要重开音频流，取决于 Equalizer APO 与驱动。

参考：Microsoft APO 架构、
Equalizer APO 配置规范。

数据、权限与卸载

设备配置为本机共享配置，不同 Windows 用户使用同一组设备设置。

| 文件 | 用途 |
| --- | --- |
| %ProgramData%\QuietEQ\profiles.xml | 所有设备设置 |
| %ProgramData%\QuietEQ\profiles.xml.bak | 上次成功保存前的备份 |
| Equalizer APO config\QuietEQ\filters.txt | 生成的音频配置 |
| Equalizer APO config\config.txt.quieteq-original | 接入前的原始主配置 |
| Equalizer APO config\config.txt.quieteq-backup-* | 接入/移除时的额外快照 |

仅首次接入、设备选择与卸载需要管理员权限。安装器允许普通用户修改 QuietEQ 的配置数据目录；
可执行文件位于受保护的 Program Files。请只向可信用户开放该电脑的账户。
不要用其他编辑器同时修改 QuietEQ 管理的文件，也不要移动主配置中的管理标记。

从 Windows 设置或开始菜单选择 Uninstall QuietEQ。卸载会恢复接入前的主配置，
保留手工添加在 QuietEQ 管理区外的内容、设备预设与备份。
Equalizer APO 作为独立组件保留；如不再需要，可在 Windows 设置中单独卸载。
恢复原配置也意味着原有 Equalizer APO 效果可能恢复生效。

构建与验证

不需要 Node、Electron、WebView、NuGet 或额外 .NET SDK。Windows 自带的 .NET Framework 编译器即可构建。

.\scripts\build.ps1 -Test
# build\QuietEQ.exe

# 需要安装 Inno Setup 6.7.3+，生成轻量版和离线版：
.\scripts\package.ps1

package.ps1 下载并核对固定版本的上游安装程序与源码 SHA-256。
构建工具、上游二进制、个人设备数据和测试音频不提交进本仓库。
离线发行时必须同时提供对应的上游源码归档与许可证，见第三方说明。

测试说明和发布验证记录见 docs/VALIDATION.md。
QuietEQ.exe --demo 可打开不会更改系统声音的演示界面。

许可证

QuietEQ 原创代码：MIT。独立 Equalizer APO 引擎：GPL-2.0-or-later。

欢迎通过 Issues 报告问题；
请提供 Windows 版本、设备/驱动、播放或录音模式与复现步骤，避免上传包含个人信息的完整设备列表。