1

Shared/KBSkinManager.m

@@ -387,6 +387,20 @@ static void KBSkinDarwinCallback(CFNotificationCenterRef center, void *observer,
             }
         }
     }
+    
+    // 调试日志：打印未找到映射的按键 ID
+    if (value.length == 0 && identifier.length > 0) {
+        static NSMutableSet<NSString *> *kb_loggedMissingIds = nil;
+        static dispatch_once_t onceToken;
+        dispatch_once(&onceToken, ^{
+            kb_loggedMissingIds = [NSMutableSet set];
+        });
+        if (![kb_loggedMissingIds containsObject:identifier]) {
+            [kb_loggedMissingIds addObject:identifier];
+            NSLog(@"[SkinManager] ⚠️ Missing icon mapping: id='%@' skin='%@' mapCount=%lu",
+                  identifier, self.current.skinId ?: @"default", (unsigned long)map.count);
+        }
+    }
 
     // 若在 keyIconMap 中找到了 value，按约定加载
     if (value.length > 0) {