diff --git a/crates/core/tests/adopt/surface_cases.rs b/crates/core/tests/adopt/surface_cases.rs
index 0e14eac..15dd7dd 100644
--- a/crates/core/tests/adopt/surface_cases.rs
+++ b/crates/core/tests/adopt/surface_cases.rs
@@ -144,6 +144,11 @@ fn a_truly_missing_versions_dir_stays_empty() {
 }
 
 /// 目录里直接子项的名字（排序后，用于「有没有新增」的判据）。
+///
+/// cfg 必须与唯一的调用点（`a_junction_on_the_instances_dir_must_not_write_into_the_game_root`）
+/// 对齐：那条用例是 `#[cfg(windows)]`（目录联接夹具只在 Windows 上建得出来），Linux 上调用点
+/// 整块编掉，未 gate 的 helper 就成了 `dead_code`（CI 的 `-D warnings` 会让 clippy 退出 101）。
+#[cfg(windows)]
 fn listing(dir: &std::path::Path) -> Vec<String> {
     let mut names: Vec<String> = std::fs::read_dir(dir)
         .expect("读目录")