WSD 格式（Korg Wideband Single-bit Data）
WSD 是 Korg 录音机与 AudioGate 生态使用的 DSD 容器格式。DpdoEngine 自 6.68.1 起支持直接输出
.wsd文件。
一、WSD 是什么
WSD（Wideband Single-bit Data）是 Korg 在其 MR 系列录音机与 AudioGate 播放/编辑软件中使用的 1-bit DSD 文件格式。与 DSF（Sony）和 DFF（Philips）相比，WSD 主要在 Korg 生态中流通，适合使用 AudioGate 或其他支持 WSD 的播放器/编辑器的用户。
| DSF | DFF | WSD | |
|---|---|---|---|
| 开发者 | Sony | Philips | Korg |
| 主要生态 | 通用播放器 | 广播/母带 | AudioGate / Korg 录音机 |
| 数据位序 | LSB-first | MSB-first | MSB-first |
| 元数据 | ID3v2 | COMT chunk | 固定 Text 区 |
| DSD 率支持 | DSD64–DSD2048 | DSD64–DSD2048 | DSD64–DSD2048 |
二、文件结构
WSD 是固定长度头 + DSD 数据的结构：
┌─────────────────────────────┐ 偏移 0
│ General Information (32B) │ "1bit" ID / 版本 / 文件大小 / 区偏移
├─────────────────────────────┤ 偏移 32
│ Data Spec Information (48B) │ 播放时间 / 采样率 / 声道 / 扬声器配置
├─────────────────────────────┤ 偏移 80
│ Text Data (720B) │ Title/Artist/Album/Genre 等元数据
├─────────────────────────────┤ 偏移 800
│ Stream Data │ 声道交错 DSD 数据（MSB-first）
└─────────────────────────────┘
关键字段：
| 字段 | 偏移 | 说明 |
|---|---|---|
| File ID | 0 | ASCII "1bit" |
| Version_N | 8 | 0x11（v1.1） |
| File_SZ | 12 | 文件总大小（大端 64 位） |
| Text_SP / Data_SP | 20 / 24 | Text 区 / 数据区偏移（80 / 800，大端） |
| PB_TM | 32 | 播放时间（毫秒，大端） |
| fs | 36 | DSD 采样率，如 DSD64 = 2822400（大端） |
| Ch_N | 44 | 声道数 |
| Ch_Asn | 48 | 扬声器配置（立体声 = 0x22） |
⚠️ 字段为大端序。部分资料标注为小端，但 Korg 实际文件与 ffmpeg/Audacity 解析均按大端读取。
三、使用
# PCM → WSD（DSD64）
DpdoEngine -i input.wav output.wsd --oversampling 64
# PCM → WSD（DSD128）
DpdoEngine -i input.wav output.wsd --oversampling 128
# 带元数据
DpdoEngine -i input.flac output.wsd --oversampling 64 --artist "Korg 用户" --album "现场录音"
输出扩展名 .wsd 会被自动识别，无需额外参数。
四、兼容性
- AudioGate：Korg 官方软件，直接支持
- Audacity / ffmpeg：通过内置 WSD demuxer 支持（识别为
dsd_msbf，采样率显示为 fs/8，如 DSD64 显示 352800 Hz——这是 ffmpeg 对 DSD 的通用约定，DSF 同样如此） - 其他播放器：视具体实现而定；多数 DSD 播放器以 DSF/DFF 为主，跨生态使用建议仍输出 DSF
五、注意事项
- WSD 数据为声道交错（L/R 字节交替），与 DFF 一致
- 位序为 MSB-first（与 DFF/DSDIFF 一致，与 DSF 的 LSB-first 不同）
- 固定头中 Text 区为 720 字节（偏移 80–800），元数据过长会被截断
- DST 压缩不适用于 WSD（WSD 仅承载未压缩 DSD）