Audacity — 开源音频编辑器
是什么
Audacity 跨平台开源音频编辑器，多轨录音、效果链与插件生态。
日常类比：像带调音台的录音棚软件，把波形编辑和效果器摆成可视化面板。
典型用法：克隆仓库读 README，跑官方最小示例，再对照源码目录理解模块边界。
为什么重要
- 学多轨音频 UI 与效果链编排
- 理解开源 DAW 插件 ABI
- 对照 sox CLI 与 GUI 分工
- 播客/数据标注前人工听检
核心要点
- 架构分层：先分清 UI/核心库/IO 边界，再读入口 main。
- 数据流：跟踪一份输入如何变成输出（帧、包、tensor）。
- 依赖：看清系统库与第三方，避免装错环境。
- 扩展点：插件、配置、钩子在哪里暴露。
- 运维：日志、指标、崩溃复现路径。
实践案例
案例 1：最小可运行
git clone <repo-url>cd audacity# 按官方文档安装依赖后运行 demo对照 README 的参数表，改一个选项观察输出变化。
案例 2：读源码入口
从 main / CMakeLists.txt / package.json 找模块图；画一张三框数据流草图。
案例 3：与邻居项目对照
对照 sox 的实现差异：协议、语言、部署形态各写一条笔记。
案例 4：接入自己的管线
把输出接到下游（播放器、训练 DataLoader、会议客户端），记录延迟与格式约束。
案例 5：与双千 atlas 交叉阅读
写完本篇后，在 projects-atlas 打开同子类邻居 1 篇，检查实践案例是否覆盖安装/命令/排障。
踩过的坑
- 依赖版本漂移：按文档锁版本，否则编译失败难定位。
- 硬编解码路径：GPU/驱动差异导致黑屏或崩溃，准备软解回退。
- 权限与端口：服务器组件忘开端口或 HTTPS 证书，客户端连不上。
- 路径写死：示例用绝对路径，换机器必挂。
- 行数与模板：交付前用 quality-gate 扫一遍，避免关联链到未写 slug。
适用 vs 不适用场景
适用：
- 学习该领域开源架构与模块边界
- 做原型验证或自建服务
- 与专题内邻居对照读
不适用：
- 闭源 SaaS 一键替代（若需合规审计）
- 超大规模不经优化的默认配置
- 不看文档直接改内核 fork
历史小故事（可跳过）
- 项目源于社区/公司开源贡献，Stars 随场景周期性上涨。
- 近年多与云原生、GPU、WebRTC 生态交叉。
- 文档与 issue 常比论文更新快，读 release note 很重要。
- 与 study 站邻居项目常构成「编码-传输-播放」全链。
学到什么
- 先跑通再读码，效率高于反过来。
- 开源多媒体/系统栈多为「薄壳 + 厚库」。
- 配置即架构，改一个 flag 可能换一条数据路径。
- 关联笔记要优先链到
written.txt已有 slug。
核心架构
Audacity 采用经典 MVC + 插件宿主 架构，主要组件如下：
- wxWidgets GUI：跨平台（Linux/macOS/Windows）UI 框架；波形视图（WaveTrack）、时间轴（RulerPanel）、工具栏均基于 wxWidget 自绘控件实现。
- PortAudio：跨平台音频 I/O 抽象层，统一封装 ALSA、CoreAudio、WASAPI、ASIO 等后端；录放音回调均通过
Pa_OpenStream接口。 - libsndfile / FFmpeg 桥：音频文件解码，支持 WAV/AIFF/FLAC/MP3/Ogg；FFmpeg 桥可选装，支持更多格式（AC3、AAC、WMA 等）。
- 效果链框架（Effects）：每个效果实现
EffectBase接口；执行时按顺序对选区样本块做变换；支持实时预览。 - Nyquist 脚本引擎：内嵌 Lisp 方言 Nyquist，可用脚本编写自定义效果；
Plug-Ins/目录下.ny文件启动时自动加载。
生态工具
| 插件类型 | 说明 |
|---|---|
| Nyquist（内置） | .ny 脚本，可实现噪声门、音调分析等自定义效果 |
| LADSPA | Linux 音频插件标准；swh-plugins 包含 100+ 效果器 |
| VST2（需启用） | Windows/macOS 商业插件；需在偏好设置中指定扫描路径 |
| LV2（实验性） | 现代 Linux 插件标准，稳定性优于 LADSPA |
| Noise Reduction | 内置降噪：先采集噪声轮廓（Profile），再全局降噪 |
| Compressor | 动态压缩：阈值/比率/起音/释放均可调 |
自动化脚本：Audacity 3.x 支持 Macros（宏录制），可批量对多个文件执行降噪→标准化→导出 MP3 的工作流。
代码示例
Nyquist 脚本：生成 440 Hz 正弦波（1 秒）
;nyquist plug-in;version 4;type generate;name "Sine 440Hz"(osc 69 1.0) ; MIDI note 69 = A4 = 440 Hz，时长 1 秒将上述内容保存为 sine440.ny，放入 Plug-Ins/ 目录，重启 Audacity 后在「效果」菜单可调用。
播客后期一键降噪流程
1. 录制 WAV（24bit/48kHz）2. 选中纯噪声段（2 秒以上）3. Effect → Noise Reduction → Get Profile（采集噪声特征）4. 全选（Ctrl+A）5. Effect → Noise Reduction → OK（Sensitivity=12, Smoothing=3）6. Effect → Normalize（-3 dBFS）7. File → Export → MP3（320 kbps）延伸阅读
关联
- sox —— 同专题对照阅读
- ffmpeg —— 同专题对照阅读
- ardour —— 同专题对照阅读
- librosa —— 同专题对照阅读
- essentia —— 同专题对照阅读
- opus —— 同专题对照阅读
维护备注
- 合并后运行
npm run atlas刷新反向链接。