DeepFilterNet3 GUI (WPF-UI)

基于 WPF-UI 的实时语音降噪桌面客户端，使用仓库内置的 Rust bridge 和 DeepFilterNet runtime 进行推理。程序自带默认模型，不再依赖外部 df.dll 或 Models\DeepFilterNet3_onnx.tar.gz。

界面预览

致谢

• DeepFilterNet：https://github.com/Rikorose/DeepFilterNet

亮点

• 实时降噪：麦克风输入 -> 内置 DeepFilterNet runtime -> 扬声器输出。
• 内嵌默认模型：启动无需额外放置模型包。
• 多通道处理：输入支持双声道时默认按双声道处理，不再先混成单声道。
• 内部重采样：GUI 仅在输入侧对齐到输出采样率，runtime 内部自动完成与 48 kHz 模型采样率之间的转换。
• 后端与设备可选：WDM / MME / KS / ASIO。
• 监控与可视化：波形、频谱、RTF、帧耗时、推理耗时、处理通道模式。
• 托盘常驻、开机启动、文件日志。

环境要求

• Windows 10/11 x64
• .NET 10 SDK
• Rust 工具链（x86_64-pc-windows-msvc）
• 可用音频驱动（WDM/MME/KS/ASIO）
• Git 子模块已初始化

构建与运行

git submodule update --init --recursive
dotnet restore
dotnet build
dotnet run --project DeepFilterNetGui/DeepFilterNetGui.csproj

dotnet build / dotnet publish 会自动先执行 cargo build，然后把 deepfilter_runtime_bridge.dll 复制到输出目录。

依赖包

推理参数说明

使用流程

1. 选择输入/输出后端与设备。
2. 点击开始按钮启动实时推理。
3. 运行时可调降噪强度、后滤波强度；ReduceMask 在设置页调整并持久化。
4. 状态区会显示当前处理通道模式、采样率和性能指标。

音频后端说明

配置文件

配置文件路径：deepfilternet3.settings.json（与 exe 同目录）。

日志文件

文件日志默认关闭，开启后输出到 logs/deepfilternet3-*.log。

常见问题

1. 构建时提示找不到 DeepFilterNet 源码 先执行 git submodule update --init --recursive。
2. 构建时提示找不到 cargo 安装 Rust MSVC 工具链，并确认 cargo 在 PATH 中。
3. ASIO 启动失败 ASIO 输入输出必须选择同一驱动，并且输入/输出后端都为 ASIO。
4. KS 启动失败 驱动可能不支持当前格式或独占模式，建议切换 WDM/MME 进行验证。
5. 没有声音或输出很小 检查设备音量、输入输出设备选择和驱动采样率支持情况。

已知限制

• 仅支持 CPU 推理。
• 当前 GUI 仅暴露单幅波形/频谱监视图；双声道模式下监视数据为双声道平均结果。
• 运行中不支持切换模型，仅使用内嵌默认模型。

许可

本项目采用双许可证（MIT 或 Apache-2.0），详见根目录 LICENSE / LICENSE-MIT / LICENSE-APACHE。DeepFilterNet 上游子模块继续遵循其各自许可证。