Overview
dsh-soundcheck
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- **片段 BPM 不等于全曲 BPM**:短片段会锁到别的拍层级,输出里会警告 - **和弦只到根音级**:七度、挂四、转位在混音里分不出来 - **歌词是候选**:音对字错是常态;非中文人声只给音译,不翻词义 - **中文乐器识别不可靠**:所以判断里不写配器行 - **音高是轮廓不是音符**:给不了调式、旋律走向的名字 - **人声证据不足时会跳过听写**:判据是**人声轨与混音之间的相对电平差**(不是人声轨单独的 dBFS), 分三档: - **≤ -20 dB** → 不跑 ASR,状态 `skipped_low_vocal_evidence` - **-20 ~ -15 dB(不含两端)** → 灰区,同样不跑 ASR,状态 `withheld_ambiguous_vocal_evidence` - **≥ -15 dB** → 允许跑 ASR,但结果仍须通过可信段筛选 两个阈值是初始工程参数,没有用人工标注样本校准过。这是**测量证据不足**, 不是「已判定为纯器乐」——个别纯器乐仍可能因分轨泄漏跑到 ASR,反之轻声吟唱也可能被挡下 - **没有可靠歌词时不给降级稿**:如果 ASR 跑了但没有任何一段通过可信度筛选, 只报数量、不提供正文——把没验证过的文字交给下游模型,它仍会当成歌词用
