3

CustomKeyboard/Model/KBKey.h

@@ -20,13 +20,29 @@ typedef NS_ENUM(NSInteger, KBKeyType) {
     KBKeyTypeSymbolsToggle    // 数字面板内的“#+=/123”切换
 };
 
+/// 字母键的大小写变体标记（非字母键使用 KBKeyCaseVariantNone）
+typedef NS_ENUM(NSInteger, KBKeyCaseVariant) {
+    KBKeyCaseVariantNone  = 0,
+    KBKeyCaseVariantLower = 1,
+    KBKeyCaseVariantUpper = 2,
+};
+
 @interface KBKey : NSObject
 
 @property (nonatomic, assign) KBKeyType type;
 @property (nonatomic, copy) NSString *title;      // 显示标题
 @property (nonatomic, copy) NSString *output;     // 字符键插入的文本
+/// 逻辑按键标识，用于皮肤映射（如 @"letter_q" @"space" @"backspace"）
+@property (nonatomic, copy, nullable) NSString *identifier;
+/// 字母键的大小写变体（便于皮肤为大小写准备不同图）
+@property (nonatomic, assign) KBKeyCaseVariant caseVariant;
 
 + (instancetype)keyWithTitle:(NSString *)title output:(NSString *)output;
 + (instancetype)keyWithTitle:(NSString *)title type:(KBKeyType)type;
+/// 通用构造方法：用于指定 identifier，便于皮肤做精细控制
++ (instancetype)keyWithIdentifier:(nullable NSString *)identifier
+                            title:(NSString *)title
+                           output:(NSString *)output
+                             type:(KBKeyType)type;
 
 @end

CustomKeyboard/Model/KBKey.m

@@ -12,6 +12,7 @@
     k.type = KBKeyTypeCharacter;
     k.title = title ?: @"";
     k.output = output ?: title ?: @"";
+    k.caseVariant = KBKeyCaseVariantNone;
     return k;
 }
 
@@ -20,8 +21,21 @@
     k.type = type;
     k.title = title ?: @"";
     k.output = @"";
+    k.caseVariant = KBKeyCaseVariantNone;
+    return k;
+}
+
++ (instancetype)keyWithIdentifier:(NSString *)identifier
+                            title:(NSString *)title
+                           output:(NSString *)output
+                             type:(KBKeyType)type {
+    KBKey *k = [[KBKey alloc] init];
+    k.type = type;
+    k.identifier = identifier;
+    k.title = title ?: @"";
+    k.output = output ?: @"";
+    k.caseVariant = KBKeyCaseVariantNone;
     return k;
 }
 
 @end
-