Why the handoff must record MuQ's exact import-time environment facts

Constraint: The next session needs version-specific evidence for the MuQ blocker, not a generic note that import fails
Rejected: Leaving only the error string without package versions | makes compatibility triage slower and less reproducible
Confidence: high
Scope-risk: narrow
Directive: For runtime blockers, always capture both the failing import and the exact package versions in handoff docs
Tested: markdown link check under docs; import checks for torch, torchaudio, torchvision, transformers, and muq; pip show metadata capture
Not-tested: Attempting a package downgrade or reinstall in this commit

@@ -5,6 +5,7 @@
 - 修正 `docs/session-handoff.md` 中关于 semantic lane 的旧状态残留，统一到当前真实事实：live 默认已落 `chromaprint_matcher + mert-v1-95m`，MuQ 仍是下一阶段 challenger。
 - 修正 `docs/session-handoff.md` 中关于 semantic lane 的旧状态残留，统一到当前真实事实：live 默认已落 `chromaprint_matcher + mert-v1-95m`，MuQ 仍是下一阶段 challenger。
 - 继续补充可复核的 live 样例：把 `feature_id = 34 -> window_id = 22 -> asset_id = 20 -> song_beta` 的真实 PostgreSQL 回溯结果写入 handoff 与 schema sample 文档，方便下次 session 直接人工复核绑定链路。
 - 继续补充可复核的 live 样例：把 `feature_id = 34 -> window_id = 22 -> asset_id = 20 -> song_beta` 的真实 PostgreSQL 回溯结果写入 handoff 与 schema sample 文档，方便下次 session 直接人工复核绑定链路。
 - 继续补充 live 覆盖率口径：把当前默认主链的 `chromaprint_matcher=5`、`mert-v1-95m=5`、`muq-large-msd-iter=0` 统计写入 handoff，并明确提醒 schema 中仍有历史 placeholder / fallback 测试行，避免下次误把旧数据当当前 baseline。
 - 继续补充 live 覆盖率口径：把当前默认主链的 `chromaprint_matcher=5`、`mert-v1-95m=5`、`muq-large-msd-iter=0` 统计写入 handoff，并明确提醒 schema 中仍有历史 placeholder / fallback 测试行，避免下次误把旧数据当当前 baseline。
+- 继续补充 MuQ blocker 的环境事实：把当前 host 上 `torch=2.12.0+cpu`、`torchaudio=2.11.0+cpu`、`torchvision=0.27.0`、`transformers=5.10.1`、`muq=0.1.0` 以及 `import torchvision / import muq` 同样被 `torchvision::nms` 卡住的验证结果写入 handoff。
 
 
 ## 2026-06-04
 ## 2026-06-04
 - fresh runtime 进展：已在当前 host 成功安装 `torch-2.12.0+cpu`、`torchaudio-2.11.0+cpu` 与 `transformers-5.10.1`，重跑 song-centric 主链后确认 `semantic_runtime_available = true`、`semantic_runtime_ready_count = 5`、`semantic_fallback_count = 0`；当前 semantic 已从 fallback 推进到 `mert-v1-95m`，下一步可在不破坏当前 MERT 基线的前提下继续接 `MuQ` adapter。
 - fresh runtime 进展：已在当前 host 成功安装 `torch-2.12.0+cpu`、`torchaudio-2.11.0+cpu` 与 `transformers-5.10.1`，重跑 song-centric 主链后确认 `semantic_runtime_available = true`、`semantic_runtime_ready_count = 5`、`semantic_fallback_count = 0`；当前 semantic 已从 fallback 推进到 `mert-v1-95m`，下一步可在不破坏当前 MERT 基线的前提下继续接 `MuQ` adapter。

@@ -234,6 +234,29 @@ order by model_name, feature_type;
 - 当前 blocker：`import muq` 触发 `RuntimeError: operator torchvision::nms does not exist`
 - 当前 blocker：`import muq` 触发 `RuntimeError: operator torchvision::nms does not exist`
 - 结论：MuQ 仍是下一阶段 challenger，不是当前 live 默认基线
 - 结论：MuQ 仍是下一阶段 challenger，不是当前 live 默认基线
 
 
+### 当前 MuQ blocker 的环境事实
+
+本机当前已确认：
+- `torch = 2.12.0+cpu`
+- `torchaudio = 2.11.0+cpu`
+- `torchvision = 0.27.0`
+- `transformers = 5.10.1`
+- `muq = 0.1.0`
+
+直接导入检查结果：
+- `import torch` => OK
+- `import torchaudio` => OK
+- `import transformers` => OK
+- `import torchvision` => `RuntimeError: operator torchvision::nms does not exist`
+- `import muq` => `RuntimeError: operator torchvision::nms does not exist`
+- `from muq import MuQ` 当前也因此失败
+
+所以当前更准确的 blocker 不是“MuQ 没装上”，而是：
+
+> **当前这组 `torch / torchvision` 运行时组合使 `torchvision::nms` operator 不可用，从而连带阻塞 `muq` 导入。**
+
+下次继续时，优先检查的就不是 schema，而是这组包版本兼容性。
+
 ### 一个可直接复核的 live 样例
 ### 一个可直接复核的 live 样例
 
 
 当前可直接用 `feature_id = 34` 做人工复核：
 当前可直接用 `feature_id = 34` 做人工复核：