Why the handoff must record MuQ's real blocker, not just its target model name

Constraint: The next challenger session should not misdiagnose the current MuQ state as 'package missing' when the actual blocker is a torchvision::nms runtime error
Rejected: Keep only the MuQ target name in docs | would hide the concrete runtime failure already observed on this host
Confidence: high
Scope-risk: narrow
Directive: Treat torchvision::nms import failure as the current MuQ blocker until a working import path is verified on this host
Tested: markdown link check on /workspace/docs after updating MuQ blocker notes
Not-tested: MuQ runtime import is still failing; this commit only records the verified blocker

@@ -3,6 +3,7 @@
 ## 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。
 - 新增 MuQ 接入线索固化：根据仓库现有 Phase-1 脚本与外部模型线索，下一步可优先尝试 `OpenMuQ/MuQ-large-msd-iter` 作为 MuQ challenger 的最小接入目标；官方加载入口可优先按 `from muq import MuQ` + `MuQ.from_pretrained("OpenMuQ/MuQ-large-msd-iter")`。
 - 新增 MuQ 接入线索固化：根据仓库现有 Phase-1 脚本与外部模型线索，下一步可优先尝试 `OpenMuQ/MuQ-large-msd-iter` 作为 MuQ challenger 的最小接入目标；官方加载入口可优先按 `from muq import MuQ` + `MuQ.from_pretrained("OpenMuQ/MuQ-large-msd-iter")`。
+- fresh MuQ 进展：当前 host 已完成 `muq` 包安装，但 `import muq` 仍被 `RuntimeError: operator torchvision::nms does not exist` 卡住；当前 blocker 已从“MuQ 未安装”推进为“torchvision 兼容问题”。
 - 收敛 `docs/` 到当前 song-centric 主线，只保留 `README / start-here / session-handoff / postgresql-data-model / postgres_db_schema_samples / CHANGELOG` 六份核心文档，删除旧的 v2 / planner-worker / registry 扩展文档，避免新同学误入已退居次线的设计。
 - 收敛 `docs/` 到当前 song-centric 主线，只保留 `README / start-here / session-handoff / postgresql-data-model / postgres_db_schema_samples / CHANGELOG` 六份核心文档，删除旧的 v2 / planner-worker / registry 扩展文档，避免新同学误入已退居次线的设计。
 - 重写 `docs/postgresql-data-model.md`，明确 `保存切片的数据 + 模型 + feature` 的落表方案：`window` 落 `audio_object`，模型身份落 `feature_fact.model_name/model_version/feature_set_name`，具体 `fingerprint/embedding` 也统一落 `feature_fact`。
 - 重写 `docs/postgresql-data-model.md`，明确 `保存切片的数据 + 模型 + feature` 的落表方案：`window` 落 `audio_object`，模型身份落 `feature_fact.model_name/model_version/feature_set_name`，具体 `fingerprint/embedding` 也统一落 `feature_fact`。
 - 重写 `docs/postgres_db_schema_samples.md` 与入口文档，补充当前 4 表主链的流程图、典型 SQL 样例、查询回溯路径与写入顺序，统一文档口径到 `media_entity -> audio_object -> feature_fact -> set_membership`。
 - 重写 `docs/postgres_db_schema_samples.md` 与入口文档，补充当前 4 表主链的流程图、典型 SQL 样例、查询回溯路径与写入顺序，统一文档口径到 `media_entity -> audio_object -> feature_fact -> set_membership`。

@@ -130,6 +130,7 @@ flowchart TD
 当前更具体的 MuQ 目标名可优先按下面口径尝试：
 当前更具体的 MuQ 目标名可优先按下面口径尝试：
 - Hugging Face / 代码线索：`OpenMuQ/MuQ-large-msd-iter`
 - Hugging Face / 代码线索：`OpenMuQ/MuQ-large-msd-iter`
 - 官方加载入口：`from muq import MuQ` + `MuQ.from_pretrained("OpenMuQ/MuQ-large-msd-iter")`
 - 官方加载入口：`from muq import MuQ` + `MuQ.from_pretrained("OpenMuQ/MuQ-large-msd-iter")`
+- 当前 host 状态：`muq` 包已安装，但 `import muq` 被 `RuntimeError: operator torchvision::nms does not exist` 卡住
 - 仓库现有 Phase-1 任务线索：`muq` + `large-msd-iter`
 - 仓库现有 Phase-1 任务线索：`muq` + `large-msd-iter`
 
 
 
 

@@ -118,6 +118,7 @@ flowchart TD
 - 当前最新主链产出已经是 `mert-v1-95m`；下一步可继续补 `MuQ` challenger
 - 当前最新主链产出已经是 `mert-v1-95m`；下一步可继续补 `MuQ` challenger
 - 当前 MuQ 的最具体候选名可优先按 `OpenMuQ/MuQ-large-msd-iter` 尝试
 - 当前 MuQ 的最具体候选名可优先按 `OpenMuQ/MuQ-large-msd-iter` 尝试
 - 官方加载入口可优先按：`from muq import MuQ` + `MuQ.from_pretrained("OpenMuQ/MuQ-large-msd-iter")`
 - 官方加载入口可优先按：`from muq import MuQ` + `MuQ.from_pretrained("OpenMuQ/MuQ-large-msd-iter")`
+- 当前 blocker 已更新：不是 `muq` 未安装，而是 `import muq` 时触发 `torchvision::nms does not exist`
 
 
 ---
 ---