Why the handoff should include MuQ's official loading entrypoint

Constraint: The next challenger implementation step should not rediscover MuQ's official model identifier and loader after the MERT baseline is already live
Rejected: Keep only the model name | still leaves the next session to infer the intended loading API from scratch
Confidence: medium
Scope-risk: narrow
Directive: Use the official MuQ loading entrypoint in future challenger work unless repo-local evidence establishes a better integration path
Tested: markdown link check on /workspace/docs after updating MuQ handoff notes
Not-tested: MuQ adapter implementation itself is still pending

@@ -2,7 +2,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 的最小接入目标。
+- 新增 MuQ 接入线索固化：根据仓库现有 Phase-1 脚本与外部模型线索，下一步可优先尝试 `OpenMuQ/MuQ-large-msd-iter` 作为 MuQ challenger 的最小接入目标；官方加载入口可优先按 `from muq import MuQ` + `MuQ.from_pretrained("OpenMuQ/MuQ-large-msd-iter")`。
 - 收敛 `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`。

@@ -129,6 +129,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")`
 - 仓库现有 Phase-1 任务线索：`muq` + `large-msd-iter`
 - 仓库现有 Phase-1 任务线索：`muq` + `large-msd-iter`
 
 
 
 

@@ -117,6 +117,7 @@ flowchart TD
 - 当前 `semantic_runtime_available = true`
 - 当前 `semantic_runtime_available = true`
 - 当前最新主链产出已经是 `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")`
 
 
 ---
 ---