应用的皮肤不能删除

2：修改键盘AI点击必须要登录装填

.claude/settings.local.json

@@ -2,7 +2,12 @@
   "permissions": {
     "allow": [
       "WebSearch",
-      "Bash(git checkout:*)"
+      "Bash(git checkout:*)",
+      "Bash(xcodebuild:*)",
+      "Bash(plutil:*)",
+      "Bash(find:*)",
+      "Bash(ls:*)",
+      "Bash(wc:*)"
     ]
   }
 }

CustomKeyboard/KeyboardViewControllerHelp/KeyboardViewController+Chat.m

@@ -0,0 +1,712 @@
+//
+//  KeyboardViewController+Chat.m
+//  CustomKeyboard
+//
+//  Created by Codex on 2026/02/22.
+//
+
+#import "KeyboardViewController+Private.h"
+
+#import "KBChatLimitPopView.h"
+#import "KBChatMessage.h"
+#import "KBChatPanelView.h"
+#import "KBFullAccessManager.h"
+#import "KBHostAppLauncher.h"
+#import "KBInputBufferManager.h"
+#import "KBNetworkManager.h"
+#import "KBVM.h"
+#import "Masonry.h"
+
+#import <AVFoundation/AVFoundation.h>
+
+static const NSUInteger kKBChatMessageLimit = 6;
+
+@implementation KeyboardViewController (Chat)
+
+#pragma mark - KBChatPanelViewDelegate
+
+- (void)chatPanelView:(KBChatPanelView *)view didSendText:(NSString *)text {
+  NSString *trim =
+      [text stringByTrimmingCharactersInSet:
+                [NSCharacterSet whitespaceAndNewlineCharacterSet]];
+  if (trim.length == 0) {
+    return;
+  }
+  [self kb_sendChatText:trim];
+}
+
+- (void)chatPanelView:(KBChatPanelView *)view
+       didTapMessage:(KBChatMessage *)message {
+  if (message.audioFilePath.length == 0) {
+    return;
+  }
+  [self kb_playChatAudioAtPath:message.audioFilePath];
+}
+
+- (void)chatPanelView:(KBChatPanelView *)view
+    didTapVoiceButtonForMessage:(KBChatMessage *)message {
+  if (!message)
+    return;
+
+  // 如果有 audioData，直接播放
+  if (message.audioData && message.audioData.length > 0) {
+    [self kb_playChatAudioData:message.audioData];
+    return;
+  }
+
+  // 如果有 audioFilePath，播放文件
+  if (message.audioFilePath.length > 0) {
+    [self kb_playChatAudioAtPath:message.audioFilePath];
+    return;
+  }
+
+  NSLog(@"[Keyboard] 没有音频数据可播放");
+}
+
+- (void)chatPanelViewDidTapClose:(KBChatPanelView *)view {
+  // 清空 chatPanelView 内部的消息
+  [view kb_reloadWithMessages:@[]];
+  if (self.chatAudioPlayer.isPlaying) {
+    [self.chatAudioPlayer stop];
+  }
+  self.chatAudioPlayer = nil;
+  [self kb_setPanelMode:KBKeyboardPanelModeMain animated:YES];
+}
+
+#pragma mark - Chat Helpers
+
+- (void)kb_handleChatSendAction {
+  if (!self.chatPanelVisible) {
+    return;
+  }
+  [[KBInputBufferManager shared]
+      refreshFromProxyIfPossible:self.textDocumentProxy];
+  NSString *fullText = [KBInputBufferManager shared].liveText ?: @"";
+
+  // 去掉打开聊天面板前宿主输入框里已有的基线文本，只取新增部分
+  NSString *baseline = self.chatPanelBaselineText ?: @"";
+  NSString *rawText = fullText;
+  if (baseline.length > 0 && [fullText hasPrefix:baseline]) {
+    rawText = [fullText substringFromIndex:baseline.length];
+  }
+
+  NSString *trim =
+      [rawText stringByTrimmingCharactersInSet:
+                  [NSCharacterSet whitespaceAndNewlineCharacterSet]];
+  NSString *textToClear = rawText;
+  if (trim.length == 0) {
+    // 兼容「先输入再打开聊天面板」场景：
+    // 此时新增文本为空，但当前输入框已有可发送内容，应该允许直接发送。
+    NSString *fullTrim =
+        [fullText stringByTrimmingCharactersInSet:
+                      [NSCharacterSet whitespaceAndNewlineCharacterSet]];
+    if (fullTrim.length > 0) {
+      trim = fullTrim;
+      textToClear = fullText;
+    }
+  }
+  if (trim.length == 0) {
+    [KBHUD showInfo:KBLocalized(@"请输入内容")];
+    return;
+  }
+  [self kb_sendChatText:trim];
+  // 默认只清新增文本；若命中兜底则清当前全文，避免“已发送但输入框残留”。
+  [self kb_clearHostInputForText:textToClear];
+}
+
+- (void)kb_sendChatText:(NSString *)text {
+  if (text.length == 0) {
+    return;
+  }
+  NSLog(@"[KB] 发送消息: %@", text);
+
+  KBChatMessage *outgoing = [KBChatMessage userMessageWithText:text];
+  outgoing.avatarURL = [self kb_sharedUserAvatarURL];
+  [self.chatPanelView kb_addUserMessage:text];
+  [self kb_prefetchAvatarForMessage:outgoing];
+
+  if (![[KBFullAccessManager shared] ensureFullAccessOrGuideInView:self.view]) {
+    [KBHUD showInfo:KBLocalized(@"请开启完全访问后使用")];
+    return;
+  }
+
+  // 添加 loading 消息
+  [self.chatPanelView kb_addLoadingAssistantMessage];
+
+  // 调用新的聊天接口
+  [self kb_requestChatMessageWithContent:text];
+}
+
+#pragma mark - Chat Limit Pop
+
+- (void)kb_showChatLimitPopWithMessage:(NSString *)message {
+  [self kb_dismissChatLimitPop];
+
+  UIControl *mask = [[UIControl alloc] init];
+  mask.backgroundColor = [[UIColor blackColor] colorWithAlphaComponent:0.4];
+  mask.alpha = 0.0;
+  [mask addTarget:self
+                action:@selector(kb_dismissChatLimitPop)
+      forControlEvents:UIControlEventTouchUpInside];
+  [self.contentView addSubview:mask];
+  [mask mas_makeConstraints:^(MASConstraintMaker *make) {
+    make.edges.equalTo(self.contentView);
+  }];
+
+  CGFloat width = 252.0;
+  CGFloat height = 252.0 + 18.0 + 53.0 + 18.0 + 28.0;
+  KBChatLimitPopView *content =
+      [[KBChatLimitPopView alloc] initWithFrame:CGRectMake(0, 0, width, height)];
+  content.message = message ?: @"";
+  content.delegate = self;
+  [mask addSubview:content];
+  [content mas_makeConstraints:^(MASConstraintMaker *make) {
+    make.center.equalTo(mask);
+    make.width.mas_equalTo(width);
+    make.height.mas_equalTo(height);
+  }];
+
+  self.chatLimitMaskView = mask;
+  [self.contentView bringSubviewToFront:mask];
+  [UIView animateWithDuration:0.18
+                   animations:^{
+                     mask.alpha = 1.0;
+                   }];
+}
+
+- (void)kb_dismissChatLimitPop {
+  if (!self.chatLimitMaskView) {
+    return;
+  }
+  UIControl *mask = self.chatLimitMaskView;
+  self.chatLimitMaskView = nil;
+  [UIView animateWithDuration:0.15
+                   animations:^{
+                     mask.alpha = 0.0;
+                   }
+                   completion:^(__unused BOOL finished) {
+                     [mask removeFromSuperview];
+                   }];
+}
+
+- (void)kb_clearHostInputForText:(NSString *)text {
+  if (text.length == 0) {
+    return;
+  }
+  NSUInteger count = [self kb_composedCharacterCountForString:text];
+  for (NSUInteger i = 0; i < count; i++) {
+    [self.textDocumentProxy deleteBackward];
+  }
+  [[KBInputBufferManager shared] clearAllLiveText];
+  [self kb_clearCurrentWord];
+}
+
+- (NSUInteger)kb_composedCharacterCountForString:(NSString *)text {
+  if (text.length == 0) {
+    return 0;
+  }
+  __block NSUInteger count = 0;
+  [text enumerateSubstringsInRange:NSMakeRange(0, text.length)
+                           options:NSStringEnumerationByComposedCharacterSequences
+                        usingBlock:^(__unused NSString *substring,
+                                     __unused NSRange substringRange,
+                                     __unused NSRange enclosingRange,
+                                     __unused BOOL *stop) {
+                          count += 1;
+                        }];
+  return count;
+}
+
+- (NSString *)kb_sharedUserAvatarURL {
+  NSUserDefaults *ud = [[NSUserDefaults alloc] initWithSuiteName:AppGroup];
+  NSString *url = [ud stringForKey:AppGroup_UserAvatarURL];
+  return url ?: @"";
+}
+
+- (void)kb_prefetchAvatarForMessage:(KBChatMessage *)message {
+  if (!message || message.avatarImage) {
+    return;
+  }
+  NSString *urlString = message.avatarURL ?: @"";
+  if (urlString.length == 0) {
+    return;
+  }
+  if (![[KBFullAccessManager shared] hasFullAccess]) {
+    return;
+  }
+  __weak typeof(self) weakSelf = self;
+  [[KBVM shared] downloadAvatarFromURL:urlString
+                             completion:^(UIImage *image, NSError *error) {
+                               __strong typeof(weakSelf) self = weakSelf;
+                               if (!self || !image)
+                                 return;
+
+                               message.avatarImage = image;
+                               [self kb_reloadChatRowForMessage:message];
+                             }];
+}
+
+- (void)kb_reloadChatRowForMessage:(KBChatMessage *)message {
+  // 头像预加载完成后不需要刷新表格
+  // 因为键盘扩展的聊天面板不显示头像，所以这里直接返回
+  // 如果将来需要显示头像，可以只刷新特定行而不是整个表格
+}
+
+- (void)kb_requestChatAudioForText:(NSString *)text {
+  NSString *mockPath = [self kb_mockChatAudioPath];
+  if (mockPath.length > 0) {
+    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.35 * NSEC_PER_SEC)),
+                   dispatch_get_main_queue(), ^{
+                     NSString *displayText = KBLocalized(@"语音回复");
+                     KBChatMessage *incoming =
+                         [KBChatMessage messageWithText:displayText
+                                                outgoing:NO
+                                           audioFilePath:mockPath];
+                     incoming.displayName = KBLocalized(@"AI助手");
+                     [self kb_appendChatMessage:incoming];
+                     [self kb_playChatAudioAtPath:mockPath];
+                   });
+    return;
+  }
+  NSDictionary *payload = @{@"message" : text ?: @""};
+  __weak typeof(self) weakSelf = self;
+  [[KBNetworkManager shared] POST:API_AI_TALK
+                         jsonBody:payload
+                          headers:nil
+                       completion:^(NSDictionary *json, NSURLResponse *response,
+                                    NSError *error) {
+                         dispatch_async(dispatch_get_main_queue(), ^{
+                           __strong typeof(weakSelf) self = weakSelf;
+                           if (!self) {
+                             return;
+                           }
+                           if (error) {
+                             NSString *tip = error.localizedDescription
+                                                 ?: KBLocalized(@"请求失败");
+                             [KBHUD showInfo:tip];
+                             return;
+                           }
+                           NSString *displayText =
+                               [self kb_chatTextFromJSON:json];
+                           NSString *audioURL =
+                               [self kb_chatAudioURLFromJSON:json];
+                           NSString *audioBase64 =
+                               [self kb_chatAudioBase64FromJSON:json];
+                           if (audioURL.length > 0) {
+                             [self kb_downloadChatAudioFromURL:audioURL
+                                                   displayText:displayText];
+                             return;
+                           }
+                           if (audioBase64.length > 0) {
+                             NSData *data = [[NSData alloc]
+                                 initWithBase64EncodedString:audioBase64
+                                                      options:0];
+                             if (data.length == 0) {
+                               [KBHUD showInfo:KBLocalized(@"音频数据解析失败")];
+                               return;
+                             }
+                             [self kb_handleChatAudioData:data
+                                              fileExtension:@"m4a"
+                                                 displayText:displayText];
+                             return;
+                           }
+                           [KBHUD showInfo:KBLocalized(@"未获取到音频文件")];
+                         });
+                       }];
+}
+
+#pragma mark - New Chat API (with typewriter effect and audio preload)
+
+/// 调用新的聊天接口（返回文本和 audioId）
+- (void)kb_requestChatMessageWithContent:(NSString *)content {
+  if (content.length == 0) {
+    [self.chatPanelView kb_removeLoadingAssistantMessage];
+    return;
+  }
+
+  NSInteger companionId = [[KBVM shared] selectedCompanionIdFromAppGroup];
+  NSLog(@"[KB] 请求聊天: companionId=%ld", (long)companionId);
+
+  __weak typeof(self) weakSelf = self;
+  [[KBVM shared] sendChatMessageWithContent:content
+                                companionId:companionId
+                                 completion:^(KBChatResponse *response) {
+                                   __strong typeof(weakSelf) self = weakSelf;
+                                   if (!self)
+                                     return;
+
+                                   if (response.code != 0) {
+                                     if (response.code == 50030) {
+                                       NSLog(@"[KB] ⚠️ 次数用尽: %@",
+                                             response.message);
+                                       [self.chatPanelView
+                                           kb_removeLoadingAssistantMessage];
+                                       [self kb_showChatLimitPopWithMessage:
+                                                 response.message];
+                                       return;
+                                     }
+                                     NSLog(@"[KB] ❌ 请求失败: %@",
+                                           response.message);
+                                     [self.chatPanelView
+                                         kb_removeLoadingAssistantMessage];
+                                     [KBHUD showInfo:response.message
+                                                        ?: KBLocalized(@"请求失败")];
+                                     return;
+                                   }
+
+                                   NSLog(@"[KB] ✅ 收到回复: %@",
+                                         response.data.aiResponse);
+
+                                   if (response.data.aiResponse.length == 0) {
+                                     [self.chatPanelView
+                                         kb_removeLoadingAssistantMessage];
+                                     [KBHUD showInfo:KBLocalized(@"未获取到回复内容")];
+                                     return;
+                                   }
+
+                                   // 添加 AI 消息（带打字机效果）
+                                   NSLog(@"[KB] 准备添加 AI 消息");
+                                   [self.chatPanelView
+                                       kb_addAssistantMessage:response.data.aiResponse
+                                                     audioId:response.data.audioId];
+                                   NSLog(@"[KB] AI 消息添加完成");
+
+                                   // 通知主 App 刷新对应 persona 的聊天记录
+                                   [self kb_notifyMainAppChatUpdatedWithCompanionId:companionId];
+
+                                   // 如果有 audioId，开始预加载音频
+                                   if (response.data.audioId.length > 0) {
+                                     [self kb_preloadAudioWithAudioId:
+                                               response.data.audioId];
+                                   }
+                                 }];
+}
+
+/// 从 AppGroup 获取选中的 persona companionId
+- (NSInteger)kb_selectedCompanionId {
+  return [[KBVM shared] selectedCompanionIdFromAppGroup];
+}
+
+#pragma mark - Audio Preload
+
+/// 预加载音频（轮询获取 audioURL）
+- (void)kb_preloadAudioWithAudioId:(NSString *)audioId {
+  if (audioId.length == 0)
+    return;
+
+  NSLog(@"[Keyboard] 开始预加载音频，audioId: %@", audioId);
+
+  __weak typeof(self) weakSelf = self;
+  [[KBVM shared] pollAudioURLWithAudioId:audioId
+                              maxRetries:10
+                                interval:1.0
+                              completion:^(KBAudioResponse *response) {
+                                __strong typeof(weakSelf) self = weakSelf;
+                                if (!self)
+                                  return;
+
+                                if (!response.success ||
+                                    response.audioURL.length == 0) {
+                                  NSLog(@"[Keyboard] ❌ 预加载音频 URL 获取失败: %@",
+                                        response.errorMessage);
+                                  return;
+                                }
+
+                                NSLog(@"[Keyboard] ✅ 预加载音频 URL 获取成功");
+
+                                // 下载音频
+                                [[KBVM shared]
+                                    downloadAudioFromURL:response.audioURL
+                                             completion:^(
+                                                 KBAudioResponse *audioResponse) {
+                                               if (!audioResponse.success) {
+                                                 NSLog(@"[Keyboard] ❌ 预加载音频下载失败: %@",
+                                                       audioResponse.errorMessage);
+                                                 return;
+                                               }
+
+                                               // 更新最后一条 AI 消息的音频数据
+                                               [self.chatPanelView
+                                                   kb_updateLastAssistantMessageWithAudioData:
+                                                       audioResponse.audioData
+                                                                                 duration:
+                                                                                     audioResponse.duration];
+                                               NSLog(@"[Keyboard] ✅ 预加载音频完成，音频时长: %.2f秒",
+                                                     audioResponse.duration);
+                                             }];
+                              }];
+}
+
+- (void)kb_downloadChatAudioFromURL:(NSString *)audioURL
+                        displayText:(NSString *)displayText {
+  __weak typeof(self) weakSelf = self;
+  [[KBVM shared] downloadAudioFromURL:audioURL
+                           completion:^(KBAudioResponse *response) {
+                             __strong typeof(weakSelf) self = weakSelf;
+                             if (!self)
+                               return;
+
+                             if (!response.success) {
+                               [KBHUD showInfo:response.errorMessage
+                                                   ?: KBLocalized(@"下载失败")];
+                               return;
+                             }
+
+                             if (!response.audioData ||
+                                 response.audioData.length == 0) {
+                               [KBHUD showInfo:KBLocalized(@"未获取到音频数据")];
+                               return;
+                             }
+
+                             NSString *ext = @"m4a";
+                             NSURL *url = [NSURL URLWithString:audioURL];
+                             if (url.pathExtension.length > 0) {
+                               ext = url.pathExtension;
+                             }
+                             [self kb_handleChatAudioData:response.audioData
+                                            fileExtension:ext
+                                               displayText:displayText];
+                           }];
+}
+
+- (void)kb_handleChatAudioData:(NSData *)data
+                 fileExtension:(NSString *)extension
+                    displayText:(NSString *)displayText {
+  if (data.length == 0) {
+    [KBHUD showInfo:KBLocalized(@"音频数据为空")];
+    return;
+  }
+  NSString *ext = extension.length > 0 ? extension : @"m4a";
+  NSString *fileName = [NSString
+      stringWithFormat:@"kb_chat_%@.%@",
+                       @((long long)([NSDate date].timeIntervalSince1970 *
+                                     1000)),
+                       ext];
+  NSString *filePath =
+      [NSTemporaryDirectory() stringByAppendingPathComponent:fileName];
+  if (![data writeToFile:filePath atomically:YES]) {
+    [KBHUD showInfo:KBLocalized(@"音频保存失败")];
+    return;
+  }
+  NSString *text =
+      displayText.length > 0 ? displayText : KBLocalized(@"语音消息");
+  KBChatMessage *incoming =
+      [KBChatMessage messageWithText:text outgoing:NO audioFilePath:filePath];
+  incoming.displayName = KBLocalized(@"AI助手");
+  [self kb_appendChatMessage:incoming];
+}
+
+- (void)kb_appendChatMessage:(KBChatMessage *)message {
+  if (!message) {
+    return;
+  }
+  [self.chatMessages addObject:message];
+  if (self.chatMessages.count > kKBChatMessageLimit) {
+    NSUInteger overflow = self.chatMessages.count - kKBChatMessageLimit;
+    NSArray<KBChatMessage *> *removed =
+        [self.chatMessages subarrayWithRange:NSMakeRange(0, overflow)];
+    [self.chatMessages removeObjectsInRange:NSMakeRange(0, overflow)];
+    for (KBChatMessage *msg in removed) {
+      if (msg.audioFilePath.length > 0) {
+        NSString *tmpRoot = NSTemporaryDirectory();
+        if (tmpRoot.length > 0 && [msg.audioFilePath hasPrefix:tmpRoot]) {
+          [[NSFileManager defaultManager] removeItemAtPath:msg.audioFilePath
+                                                     error:nil];
+        }
+      }
+    }
+  }
+  [self.chatPanelView kb_reloadWithMessages:self.chatMessages];
+}
+
+- (NSString *)kb_mockChatAudioPath {
+  NSString *path = [[NSBundle mainBundle] pathForResource:@"ai_test"
+                                                   ofType:@"m4a"];
+  return path ?: @"";
+}
+
+- (NSString *)kb_chatTextFromJSON:(NSDictionary *)json {
+  NSDictionary *data = [self kb_chatDataDictionaryFromJSON:json];
+  NSString *text =
+      [self kb_stringValueInDict:data keys:@[ @"text", @"message", @"content" ]];
+  if (text.length == 0) {
+    text = [self kb_stringValueInDict:json
+                                  keys:@[ @"text", @"message", @"content" ]];
+  }
+  return text ?: @"";
+}
+
+- (NSString *)kb_chatAudioURLFromJSON:(NSDictionary *)json {
+  NSDictionary *data = [self kb_chatDataDictionaryFromJSON:json];
+  NSArray<NSString *> *keys =
+      @[ @"audioUrl", @"audioURL", @"audio_url", @"url", @"fileUrl",
+         @"file_url", @"audioFileUrl", @"audio_file_url" ];
+  NSString *url = [self kb_stringValueInDict:data keys:keys];
+  if (url.length == 0) {
+    url = [self kb_stringValueInDict:json keys:keys];
+  }
+  return url ?: @"";
+}
+
+- (NSString *)kb_chatAudioBase64FromJSON:(NSDictionary *)json {
+  NSDictionary *data = [self kb_chatDataDictionaryFromJSON:json];
+  NSArray<NSString *> *keys =
+      @[ @"audioBase64", @"audio_base64", @"audioData", @"audio_data",
+         @"base64" ];
+  NSString *b64 = [self kb_stringValueInDict:data keys:keys];
+  if (b64.length == 0) {
+    b64 = [self kb_stringValueInDict:json keys:keys];
+  }
+  return b64 ?: @"";
+}
+
+- (NSDictionary *)kb_chatDataDictionaryFromJSON:(NSDictionary *)json {
+  if (![json isKindOfClass:[NSDictionary class]]) {
+    return @{};
+  }
+  id dataObj = json[@"data"] ?: json[@"result"] ?: json[@"response"];
+  if ([dataObj isKindOfClass:[NSDictionary class]]) {
+    return (NSDictionary *)dataObj;
+  }
+  return @{};
+}
+
+- (NSString *)kb_stringValueInDict:(NSDictionary *)dict
+                               keys:(NSArray<NSString *> *)keys {
+  if (![dict isKindOfClass:[NSDictionary class]]) {
+    return @"";
+  }
+  for (NSString *key in keys) {
+    id value = dict[key];
+    if ([value isKindOfClass:[NSString class]] &&
+        ((NSString *)value).length > 0) {
+      return (NSString *)value;
+    }
+  }
+  return @"";
+}
+
+- (void)kb_playChatAudioAtPath:(NSString *)path {
+  if (path.length == 0) {
+    return;
+  }
+  NSURL *url = [NSURL fileURLWithPath:path];
+  if (![NSFileManager.defaultManager fileExistsAtPath:path]) {
+    [KBHUD showInfo:KBLocalized(@"音频文件不存在")];
+    return;
+  }
+
+  if (self.chatAudioPlayer && self.chatAudioPlayer.isPlaying) {
+    NSURL *currentURL = self.chatAudioPlayer.url;
+    if ([currentURL isEqual:url]) {
+      [self.chatAudioPlayer stop];
+      self.chatAudioPlayer = nil;
+      return;
+    }
+    [self.chatAudioPlayer stop];
+    self.chatAudioPlayer = nil;
+  }
+
+  NSError *sessionError = nil;
+  AVAudioSession *session = [AVAudioSession sharedInstance];
+  if ([session respondsToSelector:@selector(setCategory:options:error:)]) {
+    [session setCategory:AVAudioSessionCategoryPlayback
+             withOptions:AVAudioSessionCategoryOptionDuckOthers
+                   error:&sessionError];
+  } else {
+    [session setCategory:AVAudioSessionCategoryPlayback error:&sessionError];
+  }
+  [session setActive:YES error:nil];
+
+  NSError *playerError = nil;
+  AVAudioPlayer *player =
+      [[AVAudioPlayer alloc] initWithContentsOfURL:url error:&playerError];
+  if (playerError || !player) {
+    [KBHUD showInfo:KBLocalized(@"音频播放失败")];
+    return;
+  }
+  self.chatAudioPlayer = player;
+  [player prepareToPlay];
+  [player play];
+}
+
+/// 播放音频数据
+- (void)kb_playChatAudioData:(NSData *)audioData {
+  if (!audioData || audioData.length == 0) {
+    NSLog(@"[Keyboard] 音频数据为空");
+    return;
+  }
+
+  // 如果正在播放，先停止
+  if (self.chatAudioPlayer && self.chatAudioPlayer.isPlaying) {
+    [self.chatAudioPlayer stop];
+    self.chatAudioPlayer = nil;
+  }
+
+  // 配置音频会话
+  NSError *sessionError = nil;
+  AVAudioSession *session = [AVAudioSession sharedInstance];
+  if ([session respondsToSelector:@selector(setCategory:options:error:)]) {
+    [session setCategory:AVAudioSessionCategoryPlayback
+             withOptions:AVAudioSessionCategoryOptionDuckOthers
+                   error:&sessionError];
+  } else {
+    [session setCategory:AVAudioSessionCategoryPlayback error:&sessionError];
+  }
+  [session setActive:YES error:nil];
+
+  // 创建播放器
+  NSError *playerError = nil;
+  AVAudioPlayer *player =
+      [[AVAudioPlayer alloc] initWithData:audioData error:&playerError];
+  if (playerError || !player) {
+    NSLog(@"[Keyboard] 音频播放器初始化失败: %@",
+          playerError.localizedDescription);
+    [KBHUD showInfo:KBLocalized(@"音频播放失败")];
+    return;
+  }
+
+  self.chatAudioPlayer = player;
+  player.volume = 1.0;
+  [player prepareToPlay];
+  [player play];
+
+  NSLog(@"[Keyboard] 开始播放音频，时长: %.2f秒", player.duration);
+}
+
+#pragma mark - Notify Main App
+
+/// 通知主 App 刷新对应 persona 的聊天记录
+- (void)kb_notifyMainAppChatUpdatedWithCompanionId:(NSInteger)companionId {
+    NSUserDefaults *ud = [[NSUserDefaults alloc] initWithSuiteName:AppGroup];
+    [ud setInteger:companionId forKey:AppGroup_ChatUpdatedCompanionId];
+    [ud synchronize];
+
+    CFNotificationCenterPostNotification(
+        CFNotificationCenterGetDarwinNotifyCenter(),
+        (__bridge CFStringRef)kKBDarwinChatUpdated,
+        NULL, NULL, true);
+
+    NSLog(@"[KB] 已通知主 App 刷新 companionId=%ld 的聊天记录", (long)companionId);
+}
+
+#pragma mark - KBChatLimitPopViewDelegate
+
+- (void)chatLimitPopViewDidTapCancel:(KBChatLimitPopView *)view {
+  [self kb_dismissChatLimitPop];
+}
+
+- (void)chatLimitPopViewDidTapRecharge:(KBChatLimitPopView *)view {
+  [self kb_dismissChatLimitPop];
+  NSString *urlString =
+      [NSString stringWithFormat:@"%@://recharge?src=keyboard&vipType=svip",
+                                 KB_APP_SCHEME];
+  NSURL *scheme = [NSURL URLWithString:urlString];
+  BOOL success = [KBHostAppLauncher openHostAppURL:scheme
+                                     fromResponder:self.view];
+  if (!success) {
+    [KBHUD showInfo:KBLocalized(@"Please open the App to finish purchase")];
+  }
+}
+
+@end

CustomKeyboard/KeyboardViewControllerHelp/KeyboardViewController+Layout.m

@@ -0,0 +1,96 @@
+//
+//  KeyboardViewController+Layout.m
+//  CustomKeyboard
+//
+//  Created by Codex on 2026/02/22.
+//
+
+#import "KeyboardViewController+Private.h"
+
+// 以 375 宽设计稿为基准的键盘总高度
+static const CGFloat kKBKeyboardBaseHeight = 250.0f;
+static const CGFloat kKBChatPanelHeight = 180;
+
+@implementation KeyboardViewController (Layout)
+
+- (CGFloat)kb_portraitWidth {
+  CGSize s = [UIScreen mainScreen].bounds.size;
+  return MIN(s.width, s.height);
+}
+
+- (CGFloat)kb_keyboardHeightForWidth:(CGFloat)width {
+  if (width <= 0) {
+    width = KB_DESIGN_WIDTH;
+  }
+  CGFloat scale = width / KB_DESIGN_WIDTH;
+  CGFloat baseHeight = kKBKeyboardBaseHeight * scale;
+  CGFloat chatHeight = kKBChatPanelHeight * scale;
+  if (self.chatPanelVisible) {
+    return baseHeight + chatHeight;
+  }
+  return baseHeight;
+}
+
+- (CGFloat)kb_keyboardBaseHeightForWidth:(CGFloat)width {
+  if (width <= 0) {
+    width = KB_DESIGN_WIDTH;
+  }
+  CGFloat scale = width / KB_DESIGN_WIDTH;
+  return kKBKeyboardBaseHeight * scale;
+}
+
+- (CGFloat)kb_chatPanelHeightForWidth:(CGFloat)width {
+  if (width <= 0) {
+    width = KB_DESIGN_WIDTH;
+  }
+  CGFloat scale = width / KB_DESIGN_WIDTH;
+  return kKBChatPanelHeight * scale;
+}
+
+- (void)kb_updateKeyboardLayoutIfNeeded {
+  CGFloat portraitWidth = [self kb_portraitWidth];
+  CGFloat keyboardHeight = [self kb_keyboardHeightForWidth:portraitWidth];
+  CGFloat keyboardBaseHeight =
+      [self kb_keyboardBaseHeightForWidth:portraitWidth];
+  CGFloat chatPanelHeight = [self kb_chatPanelHeightForWidth:portraitWidth];
+  CGFloat containerWidth = CGRectGetWidth(self.view.superview.bounds);
+  if (containerWidth <= 0) {
+    containerWidth = CGRectGetWidth(self.view.window.bounds);
+  }
+  if (containerWidth <= 0) {
+    containerWidth = CGRectGetWidth([UIScreen mainScreen].bounds);
+  }
+
+  BOOL widthChanged = (fabs(self.kb_lastPortraitWidth - portraitWidth) >= 0.5);
+  BOOL heightChanged =
+      (fabs(self.kb_lastKeyboardHeight - keyboardHeight) >= 0.5);
+  if (!widthChanged && !heightChanged && containerWidth > 0 &&
+      self.kb_widthConstraint.constant == containerWidth) {
+    return;
+  }
+  self.kb_lastPortraitWidth = portraitWidth;
+  self.kb_lastKeyboardHeight = keyboardHeight;
+
+  if (self.kb_heightConstraint) {
+    self.kb_heightConstraint.constant = keyboardHeight;
+  }
+  if (containerWidth > 0 && self.kb_widthConstraint) {
+    self.kb_widthConstraint.constant = containerWidth;
+  }
+  if (self.contentWidthConstraint) {
+    [self.contentWidthConstraint setOffset:portraitWidth];
+  }
+  if (self.contentHeightConstraint) {
+    [self.contentHeightConstraint setOffset:keyboardHeight];
+  }
+  if (self.keyBoardMainHeightConstraint) {
+    [self.keyBoardMainHeightConstraint setOffset:keyboardBaseHeight];
+  }
+  if (self.chatPanelHeightConstraint) {
+    [self.chatPanelHeightConstraint setOffset:chatPanelHeight];
+  }
+  [self.view layoutIfNeeded];
+}
+
+@end
+

CustomKeyboard/KeyboardViewControllerHelp/KeyboardViewController+Panels.m

@@ -0,0 +1,656 @@
+//
+//  KeyboardViewController+Panels.m
+//  CustomKeyboard
+//
+//  Created by Codex on 2026/02/22.
+//
+
+#import "KeyboardViewController+Private.h"
+
+#import "KBAuthManager.h"
+#import "KBBackspaceUndoManager.h"
+#import "KBChatMessage.h"
+#import "KBChatPanelView.h"
+#import "KBFunctionView.h"
+#import "KBFullAccessManager.h"
+#import "KBHostAppLauncher.h"
+#import "KBInputBufferManager.h"
+#import "KBKey.h"
+#import "KBKeyBoardMainView.h"
+#import "KBKeyboardSubscriptionView.h"
+#import "KBSettingView.h"
+#import "Masonry.h"
+#import <SDWebImage/SDWebImage.h>
+#import <AVFoundation/AVAudioPlayer.h>
+
+@implementation KeyboardViewController (Panels)
+
+#pragma mark - Panel Mode
+
+- (void)kb_setPanelMode:(KBKeyboardPanelMode)mode animated:(BOOL)animated {
+  if (mode == self.kb_panelMode) {
+    return;
+  }
+
+  KBKeyboardPanelMode fromMode = self.kb_panelMode;
+
+  // AI 入口先判完全访问：未开启时仅展示引导，不再继续登录态判断。
+  if (mode == KBKeyboardPanelModeFunction &&
+      ![[KBFullAccessManager shared] ensureFullAccessOrGuideInView:self.view]) {
+    return;
+  }
+
+  // 未登录时，不要提前写入面板状态，避免 mode 被错误卡在 Function 导致后续点击无响应。
+  BOOL islogin = YES;
+  if (mode == KBKeyboardPanelModeFunction) {
+    [[KBAuthManager shared] reloadFromKeychain];
+    islogin = KBAuthManager.shared.isLoggedIn;
+  }
+#if DEBUG
+  if (mode == KBKeyboardPanelModeFunction) {
+    NSString *token = [KBAuthManager shared].current.accessToken ?: @"";
+    NSLog(@"[AuthTrace][Ext] tapAI mode=%ld isLoggedIn=%d tokenLen=%lu",
+          (long)mode, islogin, (unsigned long)token.length);
+  }
+#endif
+  if (mode == KBKeyboardPanelModeFunction && !islogin) {
+    [KBHUD showInfo:KBLocalized(@"请先登录后使用AI功能")];
+    NSString *schemeStr =
+        [NSString stringWithFormat:@"%@://login?src=keyboard", KB_APP_SCHEME];
+    NSURL *scheme = [NSURL URLWithString:schemeStr];
+    BOOL ok = [KBHostAppLauncher openHostAppURL:scheme fromResponder:self.view];
+    if (!ok) {
+      [KBHUD showInfo:KBLocalized(@"请回到桌面手动打开App登录")];
+    }
+    return;
+  }
+
+  self.kb_panelMode = mode;
+
+  // 主键盘视图是基础承载：确保存在（键盘隐藏后会被释放）
+  [self kb_ensureKeyBoardMainViewIfNeeded];
+
+  // 1) 先收起所有面板（再展开目标面板），避免互相调用导致漏关/层级错乱
+  [self kb_setSubscriptionPanelVisible:NO animated:animated];
+  [self kb_setSettingViewVisible:NO animated:animated];
+  [self kb_setChatPanelVisible:NO animated:animated];
+  [self kb_setFunctionPanelVisible:NO];
+
+  // 2) 再展开目标面板
+  switch (mode) {
+  case KBKeyboardPanelModeFunction:
+    [self kb_setFunctionPanelVisible:YES];
+    break;
+  case KBKeyboardPanelModeChat:
+    [self kb_setChatPanelVisible:YES animated:animated];
+    break;
+  case KBKeyboardPanelModeSettings:
+    [self kb_setSettingViewVisible:YES animated:animated];
+    break;
+  case KBKeyboardPanelModeSubscription:
+    [self kb_setSubscriptionPanelVisible:YES animated:animated];
+    break;
+  case KBKeyboardPanelModeMain:
+  default:
+    break;
+  }
+
+  // 3) 事件埋点：保持原逻辑（仅功能面板/主面板会互相曝光）
+  if (mode == KBKeyboardPanelModeFunction) {
+    [[KBMaiPointReporter sharedReporter]
+        reportPageExposureWithEventName:@"enter_keyboard_function_panel"
+                                 pageId:@"keyboard_function_panel"
+                                  extra:nil
+                             completion:nil];
+  } else if (mode == KBKeyboardPanelModeMain &&
+             fromMode == KBKeyboardPanelModeFunction) {
+    [[KBMaiPointReporter sharedReporter]
+        reportPageExposureWithEventName:@"enter_keyboard_main_panel"
+                                 pageId:@"keyboard_main_panel"
+                                  extra:nil
+                             completion:nil];
+  } else if (mode == KBKeyboardPanelModeSettings) {
+    [[KBMaiPointReporter sharedReporter]
+        reportPageExposureWithEventName:@"enter_keyboard_settings"
+                                 pageId:@"keyboard_settings"
+                                  extra:nil
+                             completion:nil];
+  } else if (mode == KBKeyboardPanelModeSubscription) {
+    [[KBMaiPointReporter sharedReporter]
+        reportPageExposureWithEventName:@"enter_keyboard_subscription_panel"
+                               pageId:@"keyboard_subscription_panel"
+                                extra:nil
+                           completion:nil];
+  }
+
+  // 4) 层级：保证当前面板在最上层
+  if (mode == KBKeyboardPanelModeSubscription) {
+    [self.contentView bringSubviewToFront:self.subscriptionView];
+  } else if (mode == KBKeyboardPanelModeSettings) {
+    [self.contentView bringSubviewToFront:self.settingView];
+  } else if (mode == KBKeyboardPanelModeChat) {
+    [self.contentView bringSubviewToFront:self.chatPanelView];
+  } else if (mode == KBKeyboardPanelModeFunction) {
+    [self.contentView bringSubviewToFront:self.functionView];
+  } else {
+    [self.contentView bringSubviewToFront:self.keyBoardMainView];
+  }
+}
+
+/// 对外兼容：切换显示功能面板/键盘主视图
+- (void)showFunctionPanel:(BOOL)show {
+  if (show) {
+    [self kb_setPanelMode:KBKeyboardPanelModeFunction animated:NO];
+    return;
+  }
+  if (self.kb_panelMode == KBKeyboardPanelModeFunction) {
+    [self kb_setPanelMode:KBKeyboardPanelModeMain animated:NO];
+  }
+}
+
+/// 对外兼容：显示/隐藏设置页（高度与 keyBoardMainView 一致），右侧滑入/滑出
+- (void)showSettingView:(BOOL)show {
+  if (show) {
+    [self kb_setPanelMode:KBKeyboardPanelModeSettings animated:YES];
+    return;
+  }
+  if (self.kb_panelMode == KBKeyboardPanelModeSettings) {
+    [self kb_setPanelMode:KBKeyboardPanelModeMain animated:YES];
+  }
+}
+
+/// 对外兼容：显示/隐藏聊天面板（覆盖整个键盘区域）
+- (void)showChatPanel:(BOOL)show {
+  if (show) {
+    [self kb_setPanelMode:KBKeyboardPanelModeChat animated:YES];
+    return;
+  }
+  if (self.kb_panelMode == KBKeyboardPanelModeChat) {
+    [self kb_setPanelMode:KBKeyboardPanelModeMain animated:YES];
+  }
+}
+
+- (void)kb_setFunctionPanelVisible:(BOOL)visible {
+  if (visible) {
+    [self kb_ensureFunctionViewIfNeeded];
+  }
+  if (_functionView) {
+    _functionView.hidden = !visible;
+  } else if (visible) {
+    // ensure 后按理已存在；这里兜底一次，避免异常情况下状态不一致
+    self.functionView.hidden = NO;
+  }
+  self.keyBoardMainView.hidden = visible;
+}
+
+- (void)kb_setChatPanelVisible:(BOOL)visible animated:(BOOL)animated {
+  if (visible == self.chatPanelVisible) {
+    return;
+  }
+  self.chatPanelVisible = visible;
+
+  if (visible) {
+    // 记录打开聊天面板时宿主输入框已有的文本，发送时只取新增部分
+    [[KBInputBufferManager shared]
+        refreshFromProxyIfPossible:self.textDocumentProxy];
+    self.chatPanelBaselineText = [KBInputBufferManager shared].liveText ?: @"";
+    [self kb_ensureChatPanelViewIfNeeded];
+    self.chatPanelView.hidden = NO;
+    self.chatPanelView.alpha = 0.0;
+    if (animated) {
+      [UIView animateWithDuration:0.2
+                            delay:0
+                          options:UIViewAnimationOptionCurveEaseOut
+                       animations:^{
+                         self.chatPanelView.alpha = 1.0;
+                       }
+                       completion:nil];
+    } else {
+      self.chatPanelView.alpha = 1.0;
+    }
+  } else {
+    // 从未创建过聊天面板时，直接返回，避免 show/hide 触发额外内存分配
+    if (!_chatPanelView) {
+      [self kb_updateKeyboardLayoutIfNeeded];
+      return;
+    }
+    if (animated) {
+      [UIView animateWithDuration:0.18
+          delay:0
+          options:UIViewAnimationOptionCurveEaseIn
+          animations:^{
+            self.chatPanelView.alpha = 0.0;
+          }
+          completion:^(BOOL finished) {
+            self.chatPanelView.hidden = YES;
+          }];
+    } else {
+      self.chatPanelView.alpha = 0.0;
+      self.chatPanelView.hidden = YES;
+    }
+  }
+  [self kb_updateKeyboardLayoutIfNeeded];
+}
+
+- (void)kb_setSettingViewVisible:(BOOL)visible animated:(BOOL)animated {
+  if (visible) {
+    KBSettingView *settingView = self.settingView;
+    if (!settingView.superview) {
+      settingView.hidden = YES;
+      [self.contentView addSubview:settingView];
+      [settingView mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.edges.equalTo(self.contentView);
+      }];
+      [settingView.backButton addTarget:self
+                                 action:@selector(onTapSettingsBack)
+                       forControlEvents:UIControlEventTouchUpInside];
+    }
+    [self.contentView bringSubviewToFront:settingView];
+    // 以 keyBoardMainView 的实际宽度为准，避免首次添加时 self.view 宽度尚未计算
+    [self.contentView layoutIfNeeded];
+    CGFloat w = CGRectGetWidth(self.keyBoardMainView.bounds);
+    if (w <= 0) {
+      w = CGRectGetWidth(self.contentView.bounds);
+    }
+    if (w <= 0) {
+      w = [self kb_portraitWidth];
+    }
+    settingView.transform = CGAffineTransformMakeTranslation(w, 0);
+    settingView.hidden = NO;
+    if (animated) {
+      [UIView animateWithDuration:0.25
+                            delay:0
+                          options:UIViewAnimationOptionCurveEaseOut
+                       animations:^{
+                         settingView.transform = CGAffineTransformIdentity;
+                       }
+                       completion:nil];
+    } else {
+      settingView.transform = CGAffineTransformIdentity;
+    }
+  } else {
+    KBSettingView *settingView = _settingView;
+    if (!settingView) {
+      return;
+    }
+    if (!settingView.superview || settingView.hidden) {
+      return;
+    }
+    CGFloat w = CGRectGetWidth(self.keyBoardMainView.bounds);
+    if (w <= 0) {
+      w = CGRectGetWidth(self.contentView.bounds);
+    }
+    if (w <= 0) {
+      w = [self kb_portraitWidth];
+    }
+    if (animated) {
+      [UIView animateWithDuration:0.22
+          delay:0
+          options:UIViewAnimationOptionCurveEaseIn
+          animations:^{
+            settingView.transform = CGAffineTransformMakeTranslation(w, 0);
+          }
+          completion:^(BOOL finished) {
+            settingView.hidden = YES;
+          }];
+    } else {
+      settingView.transform = CGAffineTransformMakeTranslation(w, 0);
+      settingView.hidden = YES;
+    }
+  }
+}
+
+- (void)kb_setSubscriptionPanelVisible:(BOOL)visible animated:(BOOL)animated {
+  if (visible) {
+    KBKeyboardSubscriptionView *panel = self.subscriptionView;
+    if (!panel.superview) {
+      panel.hidden = YES;
+      [self.contentView addSubview:panel];
+      [panel mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.edges.equalTo(self.contentView);
+      }];
+    }
+    [self.contentView bringSubviewToFront:panel];
+    panel.hidden = NO;
+    panel.alpha = 0.0;
+    CGFloat height = CGRectGetHeight(self.contentView.bounds);
+    if (height <= 0) {
+      height = 260;
+    }
+    panel.transform = CGAffineTransformMakeTranslation(0, height);
+    [panel refreshProductsIfNeeded];
+    if (animated) {
+      [UIView animateWithDuration:0.25
+                            delay:0
+                          options:UIViewAnimationOptionCurveEaseOut
+                       animations:^{
+                         panel.alpha = 1.0;
+                         panel.transform = CGAffineTransformIdentity;
+                       }
+                       completion:nil];
+    } else {
+      panel.alpha = 1.0;
+      panel.transform = CGAffineTransformIdentity;
+    }
+    return;
+  }
+
+  KBKeyboardSubscriptionView *panel = _subscriptionView;
+  if (!panel) {
+    return;
+  }
+  if (!panel.superview || panel.hidden) {
+    return;
+  }
+  CGFloat height = CGRectGetHeight(panel.bounds);
+  if (height <= 0) {
+    height = CGRectGetHeight(self.contentView.bounds);
+  }
+  if (animated) {
+    [UIView animateWithDuration:0.22
+        delay:0
+        options:UIViewAnimationOptionCurveEaseIn
+        animations:^{
+          panel.alpha = 0.0;
+          panel.transform = CGAffineTransformMakeTranslation(0, height);
+        }
+        completion:^(BOOL finished) {
+          panel.hidden = YES;
+          panel.alpha = 1.0;
+          panel.transform = CGAffineTransformIdentity;
+        }];
+  } else {
+    panel.hidden = YES;
+    panel.alpha = 1.0;
+    panel.transform = CGAffineTransformIdentity;
+  }
+}
+
+// 延迟创建：仅在用户真正打开功能面板时才创建/布局，降低默认内存占用。
+- (void)kb_ensureFunctionViewIfNeeded {
+  if (_functionView && _functionView.superview) {
+    return;
+  }
+  KBFunctionView *v = self.functionView;
+  if (!v.superview) {
+    v.hidden = YES;
+    [self.contentView addSubview:v];
+    [v mas_makeConstraints:^(MASConstraintMaker *make) {
+      make.edges.equalTo(self.contentView);
+    }];
+  }
+}
+
+// 延迟创建：仅在用户打开聊天面板时才创建/布局。
+- (void)kb_ensureChatPanelViewIfNeeded {
+  if (_chatPanelView && _chatPanelView.superview) {
+    return;
+  }
+  CGFloat portraitWidth = [self kb_portraitWidth];
+  CGFloat chatPanelHeight = [self kb_chatPanelHeightForWidth:portraitWidth];
+  KBChatPanelView *v = self.chatPanelView;
+  if (!v.superview) {
+    [self.contentView addSubview:v];
+    [v mas_makeConstraints:^(MASConstraintMaker *make) {
+      make.left.right.equalTo(self.contentView);
+      make.bottom.equalTo(self.keyBoardMainView.mas_top);
+      self.chatPanelHeightConstraint =
+          make.height.mas_equalTo(chatPanelHeight);
+    }];
+    v.hidden = YES;
+  }
+}
+
+// 延迟创建：键盘主面板（按键区）在隐藏时会被释放；再次显示时需要重建。
+- (void)kb_ensureKeyBoardMainViewIfNeeded {
+  if (_keyBoardMainView && _keyBoardMainView.superview) {
+    return;
+  }
+  CGFloat portraitWidth = [self kb_portraitWidth];
+  CGFloat keyboardBaseHeight =
+      [self kb_keyboardBaseHeightForWidth:portraitWidth];
+  KBKeyBoardMainView *v = self.keyBoardMainView;
+  if (!v.superview) {
+    [self.contentView addSubview:v];
+    [v mas_makeConstraints:^(MASConstraintMaker *make) {
+      make.left.right.equalTo(self.contentView);
+      make.bottom.equalTo(self.contentView);
+      self.keyBoardMainHeightConstraint =
+          make.height.mas_equalTo(keyboardBaseHeight);
+    }];
+  }
+  [self.contentView bringSubviewToFront:v];
+}
+
+// 键盘隐藏时释放可重建资源（背景图/缓存/非必需面板），降低扩展内存峰值。
+- (void)kb_releaseMemoryWhenKeyboardHidden {
+  [KBHUD setContainerView:nil];
+  self.bgImageView.image = nil;
+  self.kb_cachedGradientImage = nil;
+  [self.kb_defaultGradientLayer removeFromSuperlayer];
+  self.kb_defaultGradientLayer = nil;
+  [[SDImageCache sharedImageCache] clearMemory];
+
+  // 聊天相关可能持有音频数据/临时文件，键盘隐藏时直接清空，避免累计占用。
+  if (self.chatAudioPlayer) {
+    [self.chatAudioPlayer stop];
+    self.chatAudioPlayer = nil;
+  }
+  if (_chatMessages.count > 0) {
+    NSString *tmpRoot = NSTemporaryDirectory();
+    for (KBChatMessage *msg in _chatMessages.copy) {
+      if (tmpRoot.length > 0 && msg.audioFilePath.length > 0 &&
+          [msg.audioFilePath hasPrefix:tmpRoot]) {
+        [[NSFileManager defaultManager] removeItemAtPath:msg.audioFilePath
+                                                   error:nil];
+      }
+    }
+    [_chatMessages removeAllObjects];
+  }
+
+  if (_keyBoardMainView) {
+    [_keyBoardMainView removeFromSuperview];
+    _keyBoardMainView = nil;
+  }
+  self.keyBoardMainHeightConstraint = nil;
+
+  if (_functionView) {
+    [_functionView removeFromSuperview];
+    _functionView = nil;
+  }
+  if (_chatPanelView) {
+    [_chatPanelView removeFromSuperview];
+    _chatPanelView = nil;
+  }
+  self.chatPanelVisible = NO;
+  self.kb_panelMode = KBKeyboardPanelModeMain;
+
+  if (_subscriptionView) {
+    [_subscriptionView removeFromSuperview];
+    _subscriptionView = nil;
+  }
+  if (_settingView) {
+    [_settingView removeFromSuperview];
+    _settingView = nil;
+  }
+}
+
+// MARK: - KBKeyBoardMainViewDelegate
+
+- (void)keyBoardMainView:(KBKeyBoardMainView *)keyBoardMainView
+               didTapKey:(KBKey *)key {
+  switch (key.type) {
+  case KBKeyTypeCharacter: {
+    [[KBBackspaceUndoManager shared] registerNonClearAction];
+    NSString *text = key.output ?: key.title ?: @"";
+    [self.textDocumentProxy insertText:text];
+    [self kb_updateCurrentWordWithInsertedText:text];
+    [[KBInputBufferManager shared] appendText:text];
+  } break;
+  case KBKeyTypeBackspace:
+    [[KBInputBufferManager shared]
+        refreshFromProxyIfPossible:self.textDocumentProxy];
+    [[KBInputBufferManager shared]
+        prepareSnapshotForDeleteWithContextBefore:
+            self.textDocumentProxy.documentContextBeforeInput
+                                            after:
+                                                self.textDocumentProxy
+                                                    .documentContextAfterInput];
+    [[KBBackspaceUndoManager shared]
+        captureAndDeleteBackwardFromProxy:self.textDocumentProxy
+                                    count:1];
+    [self kb_scheduleContextRefreshResetSuppression:NO];
+    [[KBInputBufferManager shared] applyHoldDeleteCount:1];
+    break;
+  case KBKeyTypeSpace:
+    [[KBBackspaceUndoManager shared] registerNonClearAction];
+    [self.textDocumentProxy insertText:@" "];
+    [self kb_clearCurrentWord];
+    [[KBInputBufferManager shared] appendText:@" "];
+    break;
+  case KBKeyTypeReturn:
+    if (self.chatPanelVisible) {
+      [self kb_handleChatSendAction];
+      break;
+    }
+    [[KBBackspaceUndoManager shared] registerNonClearAction];
+    [self.textDocumentProxy insertText:@"\n"];
+    [self kb_clearCurrentWord];
+    [[KBInputBufferManager shared] appendText:@"\n"];
+    break;
+  case KBKeyTypeGlobe:
+    [self advanceToNextInputMode];
+    break;
+  case KBKeyTypeCustom:
+    [[KBBackspaceUndoManager shared] registerNonClearAction];
+    // 点击自定义键切换到功能面板
+    [self kb_setPanelMode:KBKeyboardPanelModeFunction animated:NO];
+    [self kb_clearCurrentWord];
+    break;
+  case KBKeyTypeModeChange:
+  case KBKeyTypeShift:
+    // 这些已在 KBKeyBoardMainView/KBKeyboardView 内部处理
+    break;
+  }
+}
+
+- (void)keyBoardMainView:(KBKeyBoardMainView *)keyBoardMainView
+    didTapToolActionAtIndex:(NSInteger)index {
+  NSDictionary *extra = @{@"index" : @(index)};
+  [[KBMaiPointReporter sharedReporter]
+      reportClickWithEventName:@"click_keyboard_toolbar_action"
+                        pageId:@"keyboard_main_panel"
+                     elementId:@"toolbar_action"
+                         extra:extra
+                    completion:nil];
+  if (index == 0) {
+    [self kb_setPanelMode:KBKeyboardPanelModeFunction animated:YES];
+    [self kb_clearCurrentWord];
+    return;
+  }
+  if (index == 1) {
+    [self kb_setPanelMode:KBKeyboardPanelModeChat animated:YES];
+    return;
+  }
+  [self kb_setPanelMode:KBKeyboardPanelModeMain animated:YES];
+}
+
+- (void)keyBoardMainViewDidTapSettings:(KBKeyBoardMainView *)keyBoardMainView {
+  [[KBMaiPointReporter sharedReporter]
+      reportClickWithEventName:@"click_keyboard_settings_btn"
+                        pageId:@"keyboard_main_panel"
+                     elementId:@"settings_btn"
+                         extra:nil
+                    completion:nil];
+  [self kb_setPanelMode:KBKeyboardPanelModeSettings animated:YES];
+}
+
+- (void)keyBoardMainView:(KBKeyBoardMainView *)keyBoardMainView
+          didSelectEmoji:(NSString *)emoji {
+  if (emoji.length == 0) {
+    return;
+  }
+  [[KBBackspaceUndoManager shared] registerNonClearAction];
+  [self.textDocumentProxy insertText:emoji];
+  [self kb_clearCurrentWord];
+  [[KBInputBufferManager shared] appendText:emoji];
+}
+
+- (void)keyBoardMainViewDidTapUndo:(KBKeyBoardMainView *)keyBoardMainView {
+  [[KBMaiPointReporter sharedReporter]
+      reportClickWithEventName:@"click_keyboard_undo_btn"
+                        pageId:@"keyboard_main_panel"
+                     elementId:@"undo_btn"
+                         extra:nil
+                    completion:nil];
+  [[KBBackspaceUndoManager shared] performUndoFromResponder:self.view];
+  [self kb_scheduleContextRefreshResetSuppression:YES];
+}
+
+- (void)keyBoardMainViewDidTapEmojiSearch:
+    (KBKeyBoardMainView *)keyBoardMainView {
+  //  [[KBMaiPointReporter sharedReporter]
+  //      reportClickWithEventName:@"click_keyboard_emoji_search_btn"
+  //                        pageId:@"keyboard_main_panel"
+  //                     elementId:@"emoji_search_btn"
+  //                         extra:nil
+  //                    completion:nil];
+  [KBHUD showInfo:KBLocalized(@"Search coming soon")];
+}
+
+// MARK: - KBFunctionViewDelegate
+
+- (void)functionView:(KBFunctionView *)functionView
+    didTapToolActionAtIndex:(NSInteger)index {
+  // 需求：当 index == 0 时，切回键盘主视图
+  if (index == 0) {
+    [self kb_setPanelMode:KBKeyboardPanelModeMain animated:NO];
+  }
+}
+
+- (void)functionView:(KBFunctionView *_Nullable)functionView
+    didRightTapToolActionAtIndex:(NSInteger)index {
+  [[KBMaiPointReporter sharedReporter]
+      reportClickWithEventName:@"click_keyboard_function_right_action"
+                        pageId:@"keyboard_function_panel"
+                     elementId:@"right_action"
+                         extra:@{@"action" : @"login_or_recharge"}
+                    completion:nil];
+  if (!KBAuthManager.shared.isLoggedIn) {
+    NSString *schemeStr =
+        [NSString stringWithFormat:@"%@://login?src=keyboard", KB_APP_SCHEME];
+    NSURL *scheme = [NSURL URLWithString:schemeStr];
+    // 从当前视图作为起点，通过响应链找到 UIApplication 再调起主 App
+    BOOL ok = [KBHostAppLauncher openHostAppURL:scheme fromResponder:self.view];
+    return;
+  }
+  NSString *schemeStr =
+      [NSString stringWithFormat:@"%@://recharge?src=keyboard", KB_APP_SCHEME];
+  NSURL *scheme = [NSURL URLWithString:schemeStr];
+  // 从当前视图作为起点，通过响应链找到 UIApplication 再调起主 App
+  BOOL ok = [KBHostAppLauncher openHostAppURL:scheme fromResponder:self.view];
+
+  if (!ok) {
+    // 失败兜底：给个文案提示
+    // 比如：请回到桌面手动打开 XXX App 进行设置/充值
+    [KBHUD showInfo:@"请回到桌面手动打开App进行充值"];
+  }
+}
+
+- (void)functionViewDidRequestSubscription:(KBFunctionView *)functionView {
+  [self showSubscriptionPanel];
+}
+
+#pragma mark - Actions
+
+- (void)onTapSettingsBack {
+  [[KBMaiPointReporter sharedReporter]
+      reportClickWithEventName:@"click_keyboard_settings_back_btn"
+                        pageId:@"keyboard_settings"
+                     elementId:@"back_btn"
+                         extra:nil
+                    completion:nil];
+  [self kb_setPanelMode:KBKeyboardPanelModeMain animated:YES];
+}
+
+@end

CustomKeyboard/KeyboardViewControllerHelp/KeyboardViewController+Private.h

@@ -0,0 +1,154 @@
+//
+//  KeyboardViewController+Private.h
+//  CustomKeyboard
+//
+//  Created by Codex on 2026/02/22.
+//
+
+#import "KeyboardViewController.h"
+#import "Masonry.h"
+
+@class AVAudioPlayer;
+@class CAGradientLayer;
+@class KBChatMessage;
+@class KBChatPanelView;
+@class KBFunctionView;
+@class KBKeyBoardMainView;
+@class KBKeyboardSubscriptionView;
+@class KBSettingView;
+@class KBSuggestionEngine;
+
+@protocol KBChatLimitPopViewDelegate;
+@protocol KBChatPanelViewDelegate;
+@protocol KBFunctionViewDelegate;
+@protocol KBKeyBoardMainViewDelegate;
+@protocol KBKeyboardSubscriptionViewDelegate;
+
+typedef NS_ENUM(NSInteger, KBKeyboardPanelMode) {
+  KBKeyboardPanelModeMain = 0,
+  KBKeyboardPanelModeFunction,
+  KBKeyboardPanelModeChat,
+  KBKeyboardPanelModeSettings,
+  KBKeyboardPanelModeSubscription,
+};
+
+@interface KeyboardViewController () <KBKeyBoardMainViewDelegate,
+                                      KBFunctionViewDelegate,
+                                      KBKeyboardSubscriptionViewDelegate,
+                                      KBChatPanelViewDelegate,
+                                      KBChatLimitPopViewDelegate>
+{
+  UIButton *_nextKeyboardButton;
+  UIView *_contentView;
+  KBKeyBoardMainView *_keyBoardMainView;
+  KBFunctionView *_functionView;
+  KBSettingView *_settingView;
+  UIImageView *_bgImageView;
+  KBChatPanelView *_chatPanelView;
+  KBKeyboardSubscriptionView *_subscriptionView;
+  KBSuggestionEngine *_suggestionEngine;
+  NSString *_currentWord;
+  UIControl *_chatLimitMaskView;
+  MASConstraint *_contentWidthConstraint;
+  MASConstraint *_contentHeightConstraint;
+  MASConstraint *_keyBoardMainHeightConstraint;
+  MASConstraint *_chatPanelHeightConstraint;
+  NSLayoutConstraint *_kb_heightConstraint;
+  NSLayoutConstraint *_kb_widthConstraint;
+  CGFloat _kb_lastPortraitWidth;
+  CGFloat _kb_lastKeyboardHeight;
+  UIImage *_kb_cachedGradientImage;
+  CGSize _kb_cachedGradientSize;
+  CAGradientLayer *_kb_defaultGradientLayer;
+  NSString *_kb_lastAppliedThemeKey;
+  NSMutableArray<KBChatMessage *> *_chatMessages;
+  AVAudioPlayer *_chatAudioPlayer;
+  BOOL _suppressSuggestions;
+  BOOL _chatPanelVisible;
+  NSString *_chatPanelBaselineText;
+  id _kb_fullAccessObserverToken;
+  id _kb_skinObserverToken;
+  KBKeyboardPanelMode _kb_panelMode;
+}
+
+@property(nonatomic, strong)
+    UIButton *nextKeyboardButton; // 系统“下一个键盘”按钮（可选）
+@property(nonatomic, strong) UIView *contentView;
+@property(nonatomic, strong) KBKeyBoardMainView
+    *keyBoardMainView; // 功能面板视图（点击工具栏第0个时显示）
+@property(nonatomic, strong)
+    KBFunctionView *functionView; // 功能面板视图（点击工具栏第0个时显示）
+@property(nonatomic, strong) KBSettingView *settingView; // 设置页
+@property(nonatomic, strong) UIImageView *bgImageView;   // 背景图（在底层）
+@property(nonatomic, strong) KBChatPanelView *chatPanelView;
+@property(nonatomic, strong) KBKeyboardSubscriptionView *subscriptionView;
+@property(nonatomic, strong) KBSuggestionEngine *suggestionEngine;
+@property(nonatomic, copy) NSString *currentWord;
+@property(nonatomic, assign) BOOL suppressSuggestions;
+@property(nonatomic, strong) UIControl *chatLimitMaskView;
+@property(nonatomic, strong) MASConstraint *contentWidthConstraint;
+@property(nonatomic, strong) MASConstraint *contentHeightConstraint;
+@property(nonatomic, strong) MASConstraint *keyBoardMainHeightConstraint;
+@property(nonatomic, strong) MASConstraint *chatPanelHeightConstraint;
+@property(nonatomic, strong) NSLayoutConstraint *kb_heightConstraint;
+@property(nonatomic, strong) NSLayoutConstraint *kb_widthConstraint;
+@property(nonatomic, assign) CGFloat kb_lastPortraitWidth;
+@property(nonatomic, assign) CGFloat kb_lastKeyboardHeight;
+@property(nonatomic, strong) UIImage *kb_cachedGradientImage;
+@property(nonatomic, assign) CGSize kb_cachedGradientSize;
+@property(nonatomic, strong, nullable) CAGradientLayer *kb_defaultGradientLayer;
+@property(nonatomic, copy, nullable) NSString *kb_lastAppliedThemeKey;
+@property(nonatomic, strong) NSMutableArray<KBChatMessage *> *chatMessages;
+@property(nonatomic, strong) AVAudioPlayer *chatAudioPlayer;
+@property(nonatomic, assign) BOOL chatPanelVisible;
+@property(nonatomic, copy) NSString *chatPanelBaselineText; // 打开聊天面板时宿主输入框已有的文本
+@property(nonatomic, strong, nullable) id kb_fullAccessObserverToken;
+@property(nonatomic, strong, nullable) id kb_skinObserverToken;
+@property(nonatomic, assign) KBKeyboardPanelMode kb_panelMode;
+
+@end
+
+@interface KeyboardViewController (KBPrivate)
+
+// UI
+- (void)setupUI;
+- (nullable KBFunctionView *)kb_functionViewIfCreated;
+
+// Panels
+- (void)showFunctionPanel:(BOOL)show;
+- (void)showSettingView:(BOOL)show;
+- (void)showChatPanel:(BOOL)show;
+- (void)showSubscriptionPanel;
+- (void)hideSubscriptionPanel;
+- (void)kb_setPanelMode:(KBKeyboardPanelMode)mode animated:(BOOL)animated;
+- (void)kb_ensureFunctionViewIfNeeded;
+- (void)kb_ensureChatPanelViewIfNeeded;
+- (void)kb_ensureKeyBoardMainViewIfNeeded;
+- (void)kb_releaseMemoryWhenKeyboardHidden;
+
+// Suggestions
+- (void)kb_updateCurrentWordWithInsertedText:(NSString *)text;
+- (void)kb_clearCurrentWord;
+- (void)kb_scheduleContextRefreshResetSuppression:(BOOL)resetSuppression;
+- (void)kb_refreshCurrentWordFromDocumentContextResetSuppression:
+    (BOOL)resetSuppression;
+- (void)kb_updateSuggestionsForCurrentWord;
+
+// Chat
+- (void)kb_handleChatSendAction;
+
+// Theme
+- (void)kb_applyTheme;
+- (void)kb_applyDefaultSkinIfNeeded;
+- (void)kb_consumePendingShopSkin;
+- (void)kb_registerDarwinSkinInstallObserver;
+- (void)kb_unregisterDarwinSkinInstallObserver;
+
+// Layout
+- (CGFloat)kb_portraitWidth;
+- (CGFloat)kb_keyboardHeightForWidth:(CGFloat)width;
+- (CGFloat)kb_keyboardBaseHeightForWidth:(CGFloat)width;
+- (CGFloat)kb_chatPanelHeightForWidth:(CGFloat)width;
+- (void)kb_updateKeyboardLayoutIfNeeded;
+
+@end

CustomKeyboard/KeyboardViewControllerHelp/KeyboardViewController+Subscription.m

@@ -0,0 +1,117 @@
+//
+//  KeyboardViewController+Subscription.m
+//  CustomKeyboard
+//
+//  Created by Codex on 2026/02/22.
+//
+
+#import "KeyboardViewController+Private.h"
+
+#import "KBAuthManager.h"
+#import "KBFullAccessManager.h"
+#import "KBHostAppLauncher.h"
+#import "KBKeyboardSubscriptionProduct.h"
+#import "KBKeyboardSubscriptionView.h"
+
+@implementation KeyboardViewController (Subscription)
+
+- (void)showSubscriptionPanel {
+  // 1) 先判断权限：未开启“完全访问”则走引导逻辑
+  if (![[KBFullAccessManager shared] hasFullAccess]) {
+    // 未开启完全访问：保持原有引导路径
+    //        [KBHUD showInfo:KBLocalized(@"处理中…")];
+    [[KBFullAccessManager shared] ensureFullAccessOrGuideInView:self.view];
+    return;
+  }
+  // 点击充值要先判断是否登录
+  // 2) 权限没问题，再判断是否登录：未登录 -> 直接拉起主 App，由主 App 负责完成登录
+  if (!KBAuthManager.shared.isLoggedIn) {
+    NSString *schemeStr =
+        [NSString stringWithFormat:@"%@://login?src=keyboard", KB_APP_SCHEME];
+    NSURL *scheme = [NSURL URLWithString:schemeStr];
+    // 从当前视图作为起点，通过响应链找到 UIApplication 再调起主 App
+    BOOL ok = [KBHostAppLauncher openHostAppURL:scheme fromResponder:self.view];
+    return;
+  }
+  [self kb_setPanelMode:KBKeyboardPanelModeSubscription animated:YES];
+}
+
+- (void)hideSubscriptionPanel {
+  if (self.kb_panelMode != KBKeyboardPanelModeSubscription) {
+    return;
+  }
+  [self kb_setPanelMode:KBKeyboardPanelModeMain animated:YES];
+}
+
+#pragma mark - KBKeyboardSubscriptionViewDelegate
+
+- (void)subscriptionViewDidTapClose:(KBKeyboardSubscriptionView *)view {
+  [[KBMaiPointReporter sharedReporter]
+      reportClickWithEventName:@"click_keyboard_subscription_close_btn"
+                        pageId:@"keyboard_subscription_panel"
+                     elementId:@"close_btn"
+                         extra:nil
+                    completion:nil];
+  [self hideSubscriptionPanel];
+}
+
+- (void)subscriptionView:(KBKeyboardSubscriptionView *)view
+    didTapPurchaseForProduct:(KBKeyboardSubscriptionProduct *)product {
+  NSMutableDictionary *extra = [NSMutableDictionary dictionary];
+  if ([product.productId isKindOfClass:NSString.class] &&
+      product.productId.length > 0) {
+    extra[@"product_id"] = product.productId;
+  }
+  [[KBMaiPointReporter sharedReporter]
+      reportClickWithEventName:@"click_keyboard_subscription_product_btn"
+                        pageId:@"keyboard_subscription_panel"
+                     elementId:@"product_btn"
+                         extra:extra.copy
+                    completion:nil];
+  [self hideSubscriptionPanel];
+  [self kb_openRechargeForProduct:product];
+}
+
+#pragma mark - Actions
+
+- (void)kb_openRechargeForProduct:(KBKeyboardSubscriptionProduct *)product {
+  if (![product isKindOfClass:KBKeyboardSubscriptionProduct.class] ||
+      product.productId.length == 0) {
+    [KBHUD showInfo:KBLocalized(@"Product unavailable")];
+    return;
+  }
+  NSString *encodedId = [self.class kb_urlEncodedString:product.productId];
+  NSString *title = [product displayTitle];
+  NSString *encodedTitle = [self.class kb_urlEncodedString:title];
+  NSMutableArray<NSString *> *params =
+      [NSMutableArray arrayWithObjects:@"autoPay=1", @"prefill=1", nil];
+  if (encodedId.length) {
+    [params addObject:[NSString stringWithFormat:@"productId=%@", encodedId]];
+  }
+  if (encodedTitle.length) {
+    [params
+        addObject:[NSString stringWithFormat:@"productTitle=%@", encodedTitle]];
+  }
+  NSString *query = [params componentsJoinedByString:@"&"];
+  NSString *urlString = [NSString
+      stringWithFormat:@"%@://recharge?src=keyboard&%@", KB_APP_SCHEME, query];
+  NSURL *scheme = [NSURL URLWithString:urlString];
+  BOOL success = [KBHostAppLauncher openHostAppURL:scheme fromResponder:self.view];
+  if (!success) {
+    [KBHUD showInfo:KBLocalized(@"Please open the App to finish purchase")];
+  }
+}
+
++ (NSString *)kb_urlEncodedString:(NSString *)value {
+  if (value.length == 0) {
+    return @"";
+  }
+  NSString *reserved = @"!*'();:@&=+$,/?%#[]";
+  NSMutableCharacterSet *allowed =
+      [[NSCharacterSet URLQueryAllowedCharacterSet] mutableCopy];
+  [allowed removeCharactersInString:reserved];
+  return [value stringByAddingPercentEncodingWithAllowedCharacters:allowed]
+             ?: @"";
+}
+
+@end

CustomKeyboard/KeyboardViewControllerHelp/KeyboardViewController+Suggestions.m

@@ -0,0 +1,178 @@
+//
+//  KeyboardViewController+Suggestions.m
+//  CustomKeyboard
+//
+//  Created by Codex on 2026/02/22.
+//
+
+#import "KeyboardViewController+Private.h"
+
+#import "KBBackspaceUndoManager.h"
+#import "KBInputBufferManager.h"
+#import "KBKeyBoardMainView.h"
+#import "KBSuggestionEngine.h"
+
+@implementation KeyboardViewController (Suggestions)
+
+// MARK: - Suggestions
+
+- (void)kb_updateCurrentWordWithInsertedText:(NSString *)text {
+  if (text.length == 0) {
+    return;
+  }
+  if ([self kb_isAlphabeticString:text]) {
+    NSString *current = self.currentWord ?: @"";
+    self.currentWord = [current stringByAppendingString:text];
+    self.suppressSuggestions = NO;
+    [self kb_updateSuggestionsForCurrentWord];
+  } else {
+    [self kb_clearCurrentWord];
+  }
+}
+
+- (void)kb_clearCurrentWord {
+  self.currentWord = @"";
+  [self.keyBoardMainView kb_setSuggestions:@[]];
+  self.suppressSuggestions = NO;
+}
+
+- (void)kb_scheduleContextRefreshResetSuppression:(BOOL)resetSuppression {
+  dispatch_async(dispatch_get_main_queue(), ^{
+    [self kb_refreshCurrentWordFromDocumentContextResetSuppression:
+              resetSuppression];
+  });
+}
+
+- (void)kb_refreshCurrentWordFromDocumentContextResetSuppression:
+    (BOOL)resetSuppression {
+  NSString *context = self.textDocumentProxy.documentContextBeforeInput ?: @"";
+  NSString *word = [self kb_extractTrailingWordFromContext:context];
+  self.currentWord = word ?: @"";
+  if (resetSuppression) {
+    self.suppressSuggestions = NO;
+  }
+  [self kb_updateSuggestionsForCurrentWord];
+}
+
+- (NSString *)kb_extractTrailingWordFromContext:(NSString *)context {
+  if (context.length == 0) {
+    return @"";
+  }
+  static NSCharacterSet *letters = nil;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    letters = [NSCharacterSet
+        characterSetWithCharactersInString:
+            @"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"];
+  });
+
+  NSInteger idx = (NSInteger)context.length - 1;
+  while (idx >= 0) {
+    unichar ch = [context characterAtIndex:(NSUInteger)idx];
+    if (![letters characterIsMember:ch]) {
+      break;
+    }
+    idx -= 1;
+  }
+  NSUInteger start = (NSUInteger)(idx + 1);
+  if (start >= context.length) {
+    return @"";
+  }
+  return [context substringFromIndex:start];
+}
+
+- (BOOL)kb_isAlphabeticString:(NSString *)text {
+  if (text.length == 0) {
+    return NO;
+  }
+  static NSCharacterSet *letters = nil;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    letters = [NSCharacterSet
+        characterSetWithCharactersInString:
+            @"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"];
+  });
+  for (NSUInteger i = 0; i < text.length; i++) {
+    if (![letters characterIsMember:[text characterAtIndex:i]]) {
+      return NO;
+    }
+  }
+  return YES;
+}
+
+- (void)kb_updateSuggestionsForCurrentWord {
+  NSString *prefix = self.currentWord ?: @"";
+  if (prefix.length == 0) {
+    [self.keyBoardMainView kb_setSuggestions:@[]];
+    return;
+  }
+  if (self.suppressSuggestions) {
+    [self.keyBoardMainView kb_setSuggestions:@[]];
+    return;
+  }
+  NSArray<NSString *> *items =
+      [self.suggestionEngine suggestionsForPrefix:prefix limit:5];
+  NSArray<NSString *> *cased = [self kb_applyCaseToSuggestions:items
+                                                        prefix:prefix];
+  [self.keyBoardMainView kb_setSuggestions:cased];
+}
+
+- (NSArray<NSString *> *)kb_applyCaseToSuggestions:(NSArray<NSString *> *)items
+                                            prefix:(NSString *)prefix {
+  if (items.count == 0 || prefix.length == 0) {
+    return items;
+  }
+  BOOL allUpper = [prefix isEqualToString:prefix.uppercaseString];
+  BOOL firstUpper = [[prefix substringToIndex:1]
+      isEqualToString:[[prefix substringToIndex:1] uppercaseString]];
+
+  if (!allUpper && !firstUpper) {
+    return items;
+  }
+
+  NSMutableArray<NSString *> *result =
+      [NSMutableArray arrayWithCapacity:items.count];
+  for (NSString *word in items) {
+    if (allUpper) {
+      [result addObject:word.uppercaseString];
+    } else {
+      NSString *first = [[word substringToIndex:1] uppercaseString];
+      NSString *rest = (word.length > 1) ? [word substringFromIndex:1] : @"";
+      [result addObject:[first stringByAppendingString:rest]];
+    }
+  }
+  return result.copy;
+}
+
+// MARK: - KBKeyBoardMainViewDelegate (Suggestion)
+
+- (void)keyBoardMainView:(KBKeyBoardMainView *)keyBoardMainView
+     didSelectSuggestion:(NSString *)suggestion {
+  if (suggestion.length == 0) {
+    return;
+  }
+  NSDictionary *extra = @{@"suggestion_len" : @(suggestion.length)};
+  //  [[KBMaiPointReporter sharedReporter]
+  //      reportClickWithEventName:@"click_keyboard_suggestion_item"
+  //                        pageId:@"keyboard_main_panel"
+  //                     elementId:@"suggestion_item"
+  //                         extra:extra
+  //                    completion:nil];
+  [[KBBackspaceUndoManager shared] registerNonClearAction];
+  NSString *current = self.currentWord ?: @"";
+  if (current.length > 0) {
+    for (NSUInteger i = 0; i < current.length; i++) {
+      [self.textDocumentProxy deleteBackward];
+    }
+  }
+  [self.textDocumentProxy insertText:suggestion];
+  self.currentWord = suggestion;
+  [self.suggestionEngine recordSelection:suggestion];
+  self.suppressSuggestions = YES;
+  [self.keyBoardMainView kb_setSuggestions:@[]];
+  [[KBInputBufferManager shared] replaceTailWithText:suggestion
+                                         deleteCount:current.length];
+}
+
+@end
+

CustomKeyboard/KeyboardViewControllerHelp/KeyboardViewController+Theme.m

@@ -0,0 +1,376 @@
+//
+//  KeyboardViewController+Theme.m
+//  CustomKeyboard
+//
+//  Created by Codex on 2026/02/22.
+//
+
+#import "KeyboardViewController+Private.h"
+
+#import "KBFunctionView.h"
+#import "KBKeyBoardMainView.h"
+#import "KBSkinInstallBridge.h"
+#import "KBSkinManager.h"
+#import "UIImage+KBColor.h"
+#import <QuartzCore/QuartzCore.h>
+
+static NSString *const kKBDefaultSkinIdLight = @"normal_them";
+static NSString *const kKBDefaultSkinZipNameLight = @"normal_them";
+static NSString *const kKBDefaultSkinIdDark = @"normal_hei_them";
+static NSString *const kKBDefaultSkinZipNameDark = @"normal_hei_them";
+
+// 提前声明一个类别，使编译器在 static 回调中识别 kb_consumePendingShopSkin 方法。
+@interface KeyboardViewController (KBSkinShopBridge)
+- (void)kb_consumePendingShopSkin;
+@end
+
+static void KBSkinInstallNotificationCallback(CFNotificationCenterRef center,
+                                              void *observer, CFStringRef name,
+                                              const void *object,
+                                              CFDictionaryRef userInfo) {
+  KeyboardViewController *strongSelf =
+      (__bridge KeyboardViewController *)observer;
+  if (!strongSelf) {
+    return;
+  }
+  dispatch_async(dispatch_get_main_queue(), ^{
+    if ([strongSelf respondsToSelector:@selector(kb_consumePendingShopSkin)]) {
+      [strongSelf kb_consumePendingShopSkin];
+    }
+  });
+}
+
+@implementation KeyboardViewController (Theme)
+
+- (void)kb_registerDarwinSkinInstallObserver {
+  CFNotificationCenterAddObserver(
+      CFNotificationCenterGetDarwinNotifyCenter(),
+      (__bridge const void *)(self), KBSkinInstallNotificationCallback,
+      (__bridge CFStringRef)KBDarwinSkinInstallRequestNotification, NULL,
+      CFNotificationSuspensionBehaviorDeliverImmediately);
+}
+
+- (void)kb_unregisterDarwinSkinInstallObserver {
+  CFNotificationCenterRemoveObserver(
+      CFNotificationCenterGetDarwinNotifyCenter(),
+      (__bridge const void *)(self),
+      (__bridge CFStringRef)KBDarwinSkinInstallRequestNotification, NULL);
+}
+
+- (void)kb_applyTheme {
+  @autoreleasepool {
+    KBSkinTheme *t = [KBSkinManager shared].current;
+    UIImage *img = nil;
+    BOOL isDefaultTheme = [self kb_isDefaultKeyboardTheme:t];
+    BOOL isDarkMode = [self kb_isDarkModeActive];
+
+    NSString *skinId = t.skinId ?: @"";
+    NSString *themeKey =
+        [NSString stringWithFormat:@"%@|default=%d|dark=%d", skinId,
+                                   isDefaultTheme, isDarkMode];
+    BOOL themeChanged =
+        (self.kb_lastAppliedThemeKey.length == 0 ||
+         ![self.kb_lastAppliedThemeKey isEqualToString:themeKey]);
+    if (themeChanged) {
+      self.kb_lastAppliedThemeKey = themeKey;
+    }
+
+    CGSize size = self.bgImageView.bounds.size;
+    if (isDefaultTheme) {
+      if (isDarkMode) {
+        // 暗黑模式：直接使用背景色，不使用图片渲染
+        // 这样可以避免图片渲染时的色彩空间转换导致颜色不一致
+        img = nil;
+        self.bgImageView.image = nil;
+        [self.kb_defaultGradientLayer removeFromSuperlayer];
+        self.kb_defaultGradientLayer = nil;
+        // 使用与系统键盘底部完全相同的颜色
+        if (@available(iOS 13.0, *)) {
+          // iOS 系统键盘使用的实际颜色 (RGB: 44, 44, 46 in sRGB, 或 #2C2C2E)
+          // 但为了完美匹配，我们使用动态颜色并直接设置为背景
+          UIColor *kbBgColor =
+              [UIColor colorWithDynamicProvider:^UIColor *_Nonnull(
+                           UITraitCollection *_Nonnull traitCollection) {
+                if (traitCollection.userInterfaceStyle ==
+                    UIUserInterfaceStyleDark) {
+                  // 暗黑模式下系统键盘实际背景色
+                  return [UIColor colorWithRed:43.0 / 255.0
+                                         green:43.0 / 255.0
+                                          blue:43.0 / 255.0
+                                         alpha:1.0];
+                } else {
+                  return [UIColor colorWithRed:209.0 / 255.0
+                                         green:211.0 / 255.0
+                                          blue:219.0 / 255.0
+                                         alpha:1.0];
+                }
+              }];
+          self.contentView.backgroundColor = kbBgColor;
+          self.bgImageView.backgroundColor = kbBgColor;
+        } else {
+          UIColor *darkColor = [UIColor colorWithRed:43.0 / 255.0
+                                               green:43.0 / 255.0
+                                                blue:43.0 / 255.0
+                                               alpha:1.0];
+          self.contentView.backgroundColor = darkColor;
+          self.bgImageView.backgroundColor = darkColor;
+        }
+      } else {
+        // 浅色模式：使用渐变层（避免生成大位图导致内存上涨）
+        if (size.width <= 0 || size.height <= 0) {
+          [self.view layoutIfNeeded];
+          size = self.bgImageView.bounds.size;
+        }
+        if (size.width <= 0 || size.height <= 0) {
+          size = self.view.bounds.size;
+        }
+        if (size.width <= 0 || size.height <= 0) {
+          size = [UIScreen mainScreen].bounds.size;
+        }
+        UIColor *topColor = [UIColor colorWithHex:0xDEDFE4];
+        UIColor *bottomColor = [UIColor colorWithHex:0xD1D3DB];
+        UIColor *resolvedTopColor = topColor;
+        UIColor *resolvedBottomColor = bottomColor;
+        if (@available(iOS 13.0, *)) {
+          resolvedTopColor =
+              [topColor resolvedColorWithTraitCollection:self.traitCollection];
+          resolvedBottomColor =
+              [bottomColor resolvedColorWithTraitCollection:self.traitCollection];
+        }
+        CAGradientLayer *layer = self.kb_defaultGradientLayer;
+        if (!layer) {
+          layer = [CAGradientLayer layer];
+          layer.startPoint = CGPointMake(0.5, 0.0);
+          layer.endPoint = CGPointMake(0.5, 1.0);
+          [self.bgImageView.layer insertSublayer:layer atIndex:0];
+          self.kb_defaultGradientLayer = layer;
+        }
+        layer.colors =
+            @[ (id)resolvedTopColor.CGColor, (id)resolvedBottomColor.CGColor ];
+        layer.frame = (CGRect){CGPointZero, size};
+        img = nil;
+        self.bgImageView.image = nil;
+        self.contentView.backgroundColor = [UIColor clearColor];
+        self.bgImageView.backgroundColor = [UIColor clearColor];
+      }
+      NSLog(@"===");
+    } else {
+      // 自定义皮肤：清除背景色，使用皮肤图片
+      self.contentView.backgroundColor = [UIColor clearColor];
+      self.bgImageView.backgroundColor = [UIColor clearColor];
+      [self.kb_defaultGradientLayer removeFromSuperlayer];
+      self.kb_defaultGradientLayer = nil;
+      img = [[KBSkinManager shared] currentBackgroundImage];
+    }
+    NSLog(@"⌨️[Keyboard] apply theme id=%@ hasBg=%d", t.skinId, (img != nil));
+    [self kb_logSkinDiagnosticsWithTheme:t backgroundImage:img];
+    self.bgImageView.image = img;
+
+	    // 触发键区按主题重绘
+	    if (themeChanged &&
+	        [self.keyBoardMainView respondsToSelector:@selector(kb_applyTheme)]) {
+	      // method declared in KBKeyBoardMainView.h
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
+	      [self.keyBoardMainView performSelector:@selector(kb_applyTheme)];
+#pragma clang diagnostic pop
+	    }
+	    // 注意：这里不能直接访问 self.functionView，否则会导致功能面板提前创建，占用内存。
+	    KBFunctionView *functionView = [self kb_functionViewIfCreated];
+	    if (themeChanged && functionView &&
+	        [functionView respondsToSelector:@selector(kb_applyTheme)]) {
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
+	      [functionView performSelector:@selector(kb_applyTheme)];
+#pragma clang diagnostic pop
+	    }
+	  }
+	}
+
+- (BOOL)kb_isDefaultKeyboardTheme:(KBSkinTheme *)theme {
+  NSString *skinId = theme.skinId ?: @"";
+  if (skinId.length == 0 || [skinId isEqualToString:@"default"]) {
+    return YES;
+  }
+  if ([skinId isEqualToString:kKBDefaultSkinIdLight]) {
+    return YES;
+  }
+  return [skinId isEqualToString:kKBDefaultSkinIdDark];
+}
+
+- (BOOL)kb_isDarkModeActive {
+  if (@available(iOS 13.0, *)) {
+    return self.traitCollection.userInterfaceStyle == UIUserInterfaceStyleDark;
+  }
+  return NO;
+}
+
+- (NSString *)kb_defaultSkinIdForCurrentStyle {
+  return [self kb_isDarkModeActive] ? kKBDefaultSkinIdDark
+                                    : kKBDefaultSkinIdLight;
+}
+
+- (NSString *)kb_defaultSkinZipNameForCurrentStyle {
+  return [self kb_isDarkModeActive] ? kKBDefaultSkinZipNameDark
+                                    : kKBDefaultSkinZipNameLight;
+}
+
+- (UIImage *)kb_defaultGradientImageWithSize:(CGSize)size
+                                    topColor:(UIColor *)topColor
+                                 bottomColor:(UIColor *)bottomColor {
+  if (size.width <= 0 || size.height <= 0) {
+    return nil;
+  }
+
+  // 尺寸未变则复用缓存，避免反复创建图片撑爆键盘扩展内存
+  if (self.kb_cachedGradientImage &&
+      CGSizeEqualToSize(self.kb_cachedGradientSize, size)) {
+    return self.kb_cachedGradientImage;
+  }
+
+  UIColor *resolvedTopColor = topColor;
+  UIColor *resolvedBottomColor = bottomColor;
+  if (@available(iOS 13.0, *)) {
+    resolvedTopColor =
+        [topColor resolvedColorWithTraitCollection:self.traitCollection];
+    resolvedBottomColor =
+        [bottomColor resolvedColorWithTraitCollection:self.traitCollection];
+  }
+
+  CAGradientLayer *layer = [CAGradientLayer layer];
+  layer.frame = CGRectMake(0, 0, size.width, size.height);
+  layer.startPoint = CGPointMake(0.5, 0.0);
+  layer.endPoint = CGPointMake(0.5, 1.0);
+  layer.colors =
+      @[ (id)resolvedTopColor.CGColor, (id)resolvedBottomColor.CGColor ];
+
+  UIGraphicsBeginImageContextWithOptions(size, YES, 0);
+  [layer renderInContext:UIGraphicsGetCurrentContext()];
+  UIImage *image = UIGraphicsGetImageFromCurrentImageContext();
+  UIGraphicsEndImageContext();
+
+  self.kb_cachedGradientImage = image;
+  self.kb_cachedGradientSize = size;
+  return image;
+}
+
+- (void)kb_logSkinDiagnosticsWithTheme:(KBSkinTheme *)theme
+                       backgroundImage:(UIImage *)image {
+#if DEBUG
+  NSString *skinId = theme.skinId ?: @"";
+  NSString *name = theme.name ?: @"";
+  NSMutableArray<NSString *> *roots = [NSMutableArray array];
+  NSURL *containerURL = [[NSFileManager defaultManager]
+      containerURLForSecurityApplicationGroupIdentifier:AppGroup];
+  if (containerURL.path.length > 0) {
+    [roots addObject:containerURL.path];
+  }
+  NSString *cacheRoot = NSSearchPathForDirectoriesInDomains(
+                            NSCachesDirectory, NSUserDomainMask, YES)
+                            .firstObject;
+  if (cacheRoot.length > 0) {
+    [roots addObject:cacheRoot];
+  }
+
+  NSFileManager *fm = [NSFileManager defaultManager];
+  NSMutableArray<NSString *> *lines = [NSMutableArray array];
+  for (NSString *root in roots) {
+    NSString *iconsDir = [[root stringByAppendingPathComponent:@"Skins"]
+        stringByAppendingPathComponent:skinId];
+    iconsDir = [iconsDir stringByAppendingPathComponent:@"icons"];
+    BOOL isDir = NO;
+    BOOL exists = [fm fileExistsAtPath:iconsDir isDirectory:&isDir] && isDir;
+    NSArray *contents =
+        exists ? [fm contentsOfDirectoryAtPath:iconsDir error:nil] : nil;
+    NSUInteger count = contents.count;
+    BOOL hasQ =
+        exists &&
+        [fm fileExistsAtPath:[iconsDir
+                                 stringByAppendingPathComponent:@"key_q.png"]];
+    BOOL hasQUp =
+        exists && [fm fileExistsAtPath:[iconsDir stringByAppendingPathComponent:
+                                                     @"key_q_up.png"]];
+    BOOL hasDel =
+        exists && [fm fileExistsAtPath:[iconsDir stringByAppendingPathComponent:
+                                                     @"key_del.png"]];
+    BOOL hasShift =
+        exists &&
+        [fm fileExistsAtPath:[iconsDir
+                                 stringByAppendingPathComponent:@"key_up.png"]];
+    BOOL hasShiftUpper =
+        exists && [fm fileExistsAtPath:[iconsDir stringByAppendingPathComponent:
+                                                     @"key_up_upper.png"]];
+    NSString *line = [NSString
+        stringWithFormat:@"root=%@ icons=%@ exist=%d count=%tu key_q=%d "
+                         @"key_q_up=%d key_del=%d key_up=%d key_up_upper=%d",
+                         root, iconsDir, exists, count, hasQ, hasQUp, hasDel,
+                         hasShift, hasShiftUpper];
+    [lines addObject:line];
+  }
+
+  NSLog(@"[Keyboard] theme id=%@ name=%@ hasBg=%d\n%@", skinId, name,
+        (image != nil), [lines componentsJoinedByString:@"\n"]);
+#endif
+}
+
+- (void)kb_consumePendingShopSkin {
+  KBWeakSelf [KBSkinInstallBridge
+      consumePendingRequestFromBundle:NSBundle.mainBundle
+                           completion:^(BOOL success,
+                                        NSError *_Nullable error) {
+                             if (!success) {
+                               if (error) {
+                                 NSLog(@"[Keyboard] skin request failed: %@",
+                                       error);
+                                 [KBHUD
+                                     showInfo:
+                                         KBLocalized(
+                                             @"皮肤资源准备失败，请稍后再试")];
+                               }
+                               return;
+                             }
+                             [weakSelf kb_applyTheme];
+                             [KBHUD showInfo:KBLocalized(
+                                                 @"皮肤已更新，立即体验吧")];
+                           }];
+}
+
+- (void)kb_applyDefaultSkinIfNeeded {
+  NSDictionary *pending = [KBSkinInstallBridge pendingRequestPayload];
+  if (pending.count > 0) {
+    return;
+  }
+
+  NSString *currentId = [KBSkinManager shared].current.skinId ?: @"";
+  BOOL isDefault =
+      (currentId.length == 0 || [currentId isEqualToString:@"default"]);
+  BOOL isLightDefault = [currentId isEqualToString:kKBDefaultSkinIdLight];
+  BOOL isDarkDefault = [currentId isEqualToString:kKBDefaultSkinIdDark];
+  if (!isDefault && !isLightDefault && !isDarkDefault) {
+    // 用户已应用自定义皮肤：不随深色模式切换默认皮肤
+    return;
+  }
+  NSString *targetId = [self kb_defaultSkinIdForCurrentStyle];
+  NSString *targetZip = [self kb_defaultSkinZipNameForCurrentStyle];
+  if (currentId.length > 0 && [currentId isEqualToString:targetId]) {
+    return;
+  }
+
+  NSError *applyError = nil;
+  if ([KBSkinInstallBridge applyInstalledSkinWithId:targetId error:&applyError]) {
+    return;
+  }
+
+  [KBSkinInstallBridge publishBundleSkinRequestWithId:targetId
+                                                 name:targetId
+                                              zipName:targetZip
+                                       iconShortNames:nil];
+  [KBSkinInstallBridge
+      consumePendingRequestFromBundle:NSBundle.mainBundle
+                           completion:^(__unused BOOL success,
+                                        __unused NSError *_Nullable error) {
+                             // 已通过通知触发主题刷新，这里无需额外处理
+                           }];
+}
+
+@end

CustomKeyboard/KeyboardViewControllerHelp/KeyboardViewController+UI.m

@@ -0,0 +1,151 @@
+//
+//  KeyboardViewController+UI.m
+//  CustomKeyboard
+//
+//  Created by Codex on 2026/02/22.
+//
+
+#import "KeyboardViewController+Private.h"
+
+#import "KBChatMessage.h"
+#import "KBChatPanelView.h"
+#import "KBFunctionView.h"
+#import "KBKeyBoardMainView.h"
+#import "KBKeyboardSubscriptionView.h"
+#import "KBSettingView.h"
+#import "Masonry.h"
+
+@implementation KeyboardViewController (UI)
+
+- (void)setupUI {
+  self.view.translatesAutoresizingMaskIntoConstraints = NO;
+
+  // 按“短边”宽度等比缩放，横屏保持竖屏布局比例
+  CGFloat portraitWidth = [self kb_portraitWidth];
+  CGFloat keyboardHeight = [self kb_keyboardHeightForWidth:portraitWidth];
+  CGFloat keyboardBaseHeight = [self kb_keyboardBaseHeightForWidth:portraitWidth];
+  CGFloat screenWidth = CGRectGetWidth([UIScreen mainScreen].bounds);
+
+  // FIX: iOS 26 键盘闪烁问题
+  // iOS 26 在键盘滑入动画开始前，会对 self.view 做一次离屏预渲染快照（非实时 view），
+  // 该快照会短暂显示在屏幕中间。如果此时 view 已有完整高度和内容，用户就会看到
+  // 键盘 UI 在屏幕中间闪现一帧，然后键盘才从底部正常滑入。
+  // 解决方案：初始高度设为 0，让系统快照时无内容可渲染；
+  // 在 viewWillAppear: 中恢复正确高度，此时系统已准备好滑入动画。
+  // （iOS 18 及更早版本无此预渲染机制，不受影响）
+  NSLayoutConstraint *h = [self.view.heightAnchor constraintEqualToConstant:0];
+  NSLayoutConstraint *w =
+      [self.view.widthAnchor constraintEqualToConstant:screenWidth];
+  self.kb_heightConstraint = h;
+  self.kb_widthConstraint = w;
+
+  h.priority = UILayoutPriorityRequired;
+  w.priority = UILayoutPriorityRequired;
+  [NSLayoutConstraint activateConstraints:@[ h, w ]];
+  // 关闭 UIInputView 自适应（某些系统版本会尝试放大为全屏高度导致冲突）
+  if ([self.view isKindOfClass:[UIInputView class]]) {
+    UIInputView *iv = (UIInputView *)self.view;
+    if ([iv respondsToSelector:@selector(setAllowsSelfSizing:)]) {
+      iv.allowsSelfSizing = NO;
+    }
+  }
+  // 内容容器：横屏时保持竖屏宽度，居中显示
+  [self.view addSubview:self.contentView];
+  [self.contentView mas_makeConstraints:^(MASConstraintMaker *make) {
+    make.centerX.equalTo(self.view);
+    make.bottom.equalTo(self.view);
+    self.contentWidthConstraint = make.width.mas_equalTo(portraitWidth);
+    self.contentHeightConstraint = make.height.mas_equalTo(keyboardHeight);
+  }];
+
+  // 背景图铺底（仅在内容容器内）
+  [self.contentView addSubview:self.bgImageView];
+  [self.bgImageView mas_makeConstraints:^(MASConstraintMaker *make) {
+    make.edges.equalTo(self.contentView);
+  }];
+
+  [self.contentView addSubview:self.keyBoardMainView];
+  [self.keyBoardMainView mas_makeConstraints:^(MASConstraintMaker *make) {
+    make.left.right.equalTo(self.contentView);
+    make.bottom.equalTo(self.contentView);
+    self.keyBoardMainHeightConstraint =
+        make.height.mas_equalTo(keyboardBaseHeight);
+  }];
+
+  // 初始隐藏，避免布局完成前闪烁
+  self.contentView.hidden = YES;
+}
+
+#pragma mark - Lazy
+
+- (nullable KBFunctionView *)kb_functionViewIfCreated {
+  return _functionView;
+}
+
+- (UIView *)contentView {
+  if (!_contentView) {
+    _contentView = [[UIView alloc] init];
+    _contentView.backgroundColor = [UIColor clearColor];
+  }
+  return _contentView;
+}
+
+- (UIImageView *)bgImageView {
+  if (!_bgImageView) {
+    _bgImageView = [[UIImageView alloc] init];
+    _bgImageView.contentMode = UIViewContentModeScaleAspectFill;
+    _bgImageView.clipsToBounds = YES;
+  }
+  return _bgImageView;
+}
+
+- (KBKeyBoardMainView *)keyBoardMainView {
+  if (!_keyBoardMainView) {
+    _keyBoardMainView = [[KBKeyBoardMainView alloc] init];
+    _keyBoardMainView.delegate = self;
+  }
+  return _keyBoardMainView;
+}
+
+- (KBFunctionView *)functionView {
+  if (!_functionView) {
+    _functionView = [[KBFunctionView alloc] init];
+    _functionView.delegate = self; // 监听功能面板顶部Bar点击
+  }
+  return _functionView;
+}
+
+- (KBSettingView *)settingView {
+  if (!_settingView) {
+    _settingView = [[KBSettingView alloc] init];
+  }
+  return _settingView;
+}
+
+- (KBChatPanelView *)chatPanelView {
+  if (!_chatPanelView) {
+    NSLog(@"[Keyboard] ⚠️ chatPanelView 被创建！");
+    _chatPanelView = [[KBChatPanelView alloc] init];
+    _chatPanelView.delegate = self;
+  }
+  return _chatPanelView;
+}
+
+- (NSMutableArray<KBChatMessage *> *)chatMessages {
+  if (!_chatMessages) {
+    _chatMessages = [NSMutableArray array];
+  }
+  return _chatMessages;
+}
+
+- (KBKeyboardSubscriptionView *)subscriptionView {
+  if (!_subscriptionView) {
+    _subscriptionView = [[KBKeyboardSubscriptionView alloc] init];
+    _subscriptionView.delegate = self;
+    _subscriptionView.hidden = YES;
+    _subscriptionView.alpha = 0.0;
+  }
+  return _subscriptionView;
+}
+
+@end

CustomKeyboard/Network/KBNetworkManager.m

@@ -41,38 +41,10 @@ NSErrorDomain const KBNetworkErrorDomain = @"com.company.keyboard.network";
 }
 
 - (void)getSignWithParare:(NSDictionary *)bodyParams{
-   
-    NSString *appId    = @"loveKeyboard";
-    NSString *secret   = @"kZJM39HYvhxwbJkG1fmquQRVkQiLAh2H"; // 和服务端保持一致
-    NSString *timestamp = [KBSignUtils currentTimestamp];
-    NSString *nonce     = [KBSignUtils generateNonceWithLength:16];
-    // 1. 组装参与签名的所有参数
-    NSMutableDictionary<NSString *, NSString *> *signParams = [NSMutableDictionary dictionary];
-    signParams[@"appId"]     = appId;
-    signParams[@"timestamp"] = timestamp;
-    signParams[@"nonce"]     = nonce;
-    // 把 body 里的字段也加入签名参数
-    [bodyParams enumerateKeysAndObjectsUsingBlock:^(id key, id obj, BOOL *stop) {
-        if ([obj isKindOfClass:[NSString class]]) {
-            signParams[key] = obj;
-        } else {
-            signParams[key] = [obj description];
-        }
-    }];
-    NSString *sign = [KBSignUtils signWithParams:signParams secret:secret];
-
-    // 将签名相关字段合并进默认请求头
+    NSDictionary<NSString *, NSString *> *signHeaders = [KBSignUtils signHeadersWithBodyParams:bodyParams];
     NSMutableDictionary<NSString *, NSString *> *headers =
     [self.defaultHeaders mutableCopy] ?: [NSMutableDictionary dictionary];
-
-    if (sign.length > 0) {
-        headers[@"X-Sign"] = sign;
-    }
-    headers[@"X-App-Id"]    = appId;
-    headers[@"X-Timestamp"] = timestamp;
-    headers[@"X-Nonce"]     = nonce;
-
-    // 触发 copy 语义，确保对外仍是不可变字典
+    [headers addEntriesFromDictionary:signHeaders ?: @{}];
     self.defaultHeaders = headers;
 }
 

CustomKeyboard/PrivacyInfo.xcprivacy

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>NSPrivacyTracking</key>
+	<false/>
+	<key>NSPrivacyTrackingDomains</key>
+	<array/>
+	<key>NSPrivacyCollectedDataTypes</key>
+	<array>
+		<dict>
+			<key>NSPrivacyCollectedDataType</key>
+			<string>NSPrivacyCollectedDataTypeOtherUserContent</string>
+			<key>NSPrivacyCollectedDataTypeLinked</key>
+			<true/>
+			<key>NSPrivacyCollectedDataTypeTracking</key>
+			<false/>
+			<key>NSPrivacyCollectedDataTypePurposes</key>
+			<array>
+				<string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+			</array>
+		</dict>
+	</array>
+	<key>NSPrivacyAccessedAPITypes</key>
+	<array>
+		<dict>
+			<key>NSPrivacyAccessedAPIType</key>
+			<string>NSPrivacyAccessedAPICategoryUserDefaults</string>
+			<key>NSPrivacyAccessedAPITypeReasons</key>
+			<array>
+				<string>CA92.1</string>
+			</array>
+		</dict>
+		<dict>
+			<key>NSPrivacyAccessedAPIType</key>
+			<string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
+			<key>NSPrivacyAccessedAPITypeReasons</key>
+			<array>
+				<string>C617.1</string>
+			</array>
+		</dict>
+	</array>
+</dict>
+</plist>

CustomKeyboard/View/Function/KBFunctionTagListView.m

@@ -67,6 +67,8 @@ static CGFloat  const kKBItemSpace = 4;
 - (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout minimumLineSpacingForSectionAtIndex:(NSInteger)section { return kKBItemSpace; }
 
 - (void)collectionView:(UICollectionView *)collectionView didSelectItemAtIndexPath:(NSIndexPath *)indexPath {
+    // 有cell正在loading时，不允许点击其他cell
+    if (self.loadingIndexes.count > 0) { return; }
     KBTagItemModel *model = (indexPath.item < self.items.count) ? self.items[indexPath.item] : [KBTagItemModel new];
     NSInteger personaId = 0;
     if ([model isKindOfClass:KBTagItemModel.class]) {

CustomKeyboard/View/KBFunctionView.m

@@ -19,6 +19,7 @@
 #import "KBHostAppLauncher.h"
 #import "KBInputBufferManager.h"
 #import "KBResponderUtils.h" // 统一查找 UIInputViewController 的工具
+#import "KBSignUtils.h"
 #import "KBSkinManager.h"
 #import "KBStreamOverlayView.h" // 带关闭按钮的流式层
 #import "KBStreamTextView.h"    // 流式文本视图
@@ -435,11 +436,32 @@
                               cachePolicy:NSURLRequestReloadIgnoringCacheData
                           timeoutInterval:60];
   request.HTTPMethod = @"POST";
+  [request setValue:@"text/event-stream" forHTTPHeaderField:@"Accept"];
   [request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
+  // 签名头（后端要求，否则会 401：Missing sign headers）
+  NSDictionary<NSString *, NSString *> *signHeaders =
+      [KBSignUtils signHeadersWithBodyParams:payload];
+  [signHeaders enumerateKeysAndObjectsUsingBlock:^(NSString *key, NSString *obj,
+                                                   BOOL *stop) {
+    if (key.length == 0 || obj.length == 0) {
+      return;
+    }
+    [request setValue:obj forHTTPHeaderField:key];
+  }];
   NSString *token = KBAuthManager.shared.current.accessToken ?: @"";
   if (token.length > 0) {
     [request setValue:token forHTTPHeaderField:@"auth-token"];
   }
+  // 与主 App 的请求头保持一致（Bearer）
+  NSDictionary<NSString *, NSString *> *authHeader =
+      [[KBAuthManager shared] authorizationHeader];
+  [authHeader enumerateKeysAndObjectsUsingBlock:^(NSString *key, NSString *obj,
+                                                  BOOL *stop) {
+    if (key.length == 0 || obj.length == 0) {
+      return;
+    }
+    [request setValue:obj forHTTPHeaderField:key];
+  }];
   request.HTTPBody = bodyData;
 
   self.streamHasOutput = NO;
@@ -463,7 +485,7 @@
         __strong typeof(weakSelf) self = weakSelf;
         if (!self)
           return;
-        [self kb_handleEventSourceError:event.error];
+//        [self kb_handleEventSourceError:event.error];
       }
          forEvent:WJXEventNameError
             queue:NSOperationQueue.mainQueue];

CustomKeyboard/View/KBKeyBoardMainView.m

@@ -95,6 +95,10 @@
         [self.keyboardView mas_makeConstraints:^(MASConstraintMaker *make) {
             make.top.equalTo(self.topBar.mas_bottom).offset(barSpacing);
         }];
+        // 首次创建时立即生成按键，避免只出现 4 行容器但按键未渲染的情况。
+        [self.keyboardView reloadKeys];
+        // 同步应用一次主题，确保键盘背景与按键皮肤在首帧可见。
+        [self kb_applyTheme];
         // 功能面板切换交由外部控制器处理；此处不直接创建/管理
         [[NSNotificationCenter defaultCenter] addObserver:self
                                                  selector:@selector(kb_undoStateChanged)

CustomKeyboard/View/KBKeyboardView.m

@@ -125,6 +125,39 @@ static const CGFloat kKBLettersRow2EdgeSpacerMultiplier = 0.5;
     [self buildRow:self.row2 withRowConfig:rows[1]];
     [self buildRow:self.row3 withRowConfig:rows[2]];
     [self buildRow:self.row4 withRowConfig:rows[3]];
+
+    NSUInteger totalButtons = [self kb_totalKeyButtonCount];
+    if (totalButtons == 0) {
+        NSLog(@"[KBKeyboardView] config layout produced no keys, fallback to legacy.");
+        for (UIView *row in @[self.row1, self.row2, self.row3, self.row4]) {
+            [row.subviews makeObjectsPerformSelector:@selector(removeFromSuperview)];
+        }
+        [self kb_buildLegacyLayout];
+    }
+}
+
+- (void)didMoveToWindow {
+    [super didMoveToWindow];
+    if (!self.window) { return; }
+    if ([self kb_totalKeyButtonCount] > 0) { return; }
+    // 兜底：系统编辑菜单切出切回等场景下，若按键丢失则自动重建。
+    [self reloadKeys];
+    // 自动重建后再触发一次上层主题应用，避免“按键恢复了但皮肤背景没恢复”。
+    UIView *container = self.superview;
+    if ([container respondsToSelector:@selector(kb_applyTheme)]) {
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
+        [container performSelector:@selector(kb_applyTheme)];
+#pragma clang diagnostic pop
+    }
+}
+
+- (NSUInteger)kb_totalKeyButtonCount {
+    NSUInteger total = 0;
+    for (UIView *row in @[self.row1, self.row2, self.row3, self.row4]) {
+        total += [self kb_collectKeyButtonsInView:row].count;
+    }
+    return total;
 }
 
 #pragma mark - Hit Test

Shared/KBAPI.h

@@ -28,11 +28,14 @@
 
 
 #define API_LOGOUT @"/user/logout"   // 退出登录
+#define API_USER_CANCEL_ACCOUNT @"/user/cancelAccount"   // 注销账户
+#define API_CANCEL_ACCOUNT_WARNING @"/keyboardWarningMessage/byLocale"   // 按locale查询注销提示信息
 
 #define API_UPDATA_INFO @"/user/updateInfo"   // 更新用户
 
 #define KB_API_USER_DETAIL @"/user/detail"    // 用户详情
 #define API_USER_INVITE_CODE @"/user/inviteCode"    // 查询邀请码
+#define API_USER_CUSTOMER_MAIL @"/user/customerMail"    // 获取客服邮箱
 #define API_CHARACTER_LIST @"/character/list"          // 排行榜角色列表（综合）
 #define API_NOT_LOGIN_CHARACTER_LIST @"/character/listWithNotLogin"          //未登录用户人设列表
 

Shared/KBConfig.h

@@ -30,6 +30,12 @@
 /// 用户头像 URL（主 App 写入，键盘扩展读取）
 #define AppGroup_UserAvatarURL @"AppGroup_UserAvatarURL"
 
+/// 键盘扩展聊天更新的 companionId（键盘写入，主 App 读取后刷新对应聊天记录）
+#define AppGroup_ChatUpdatedCompanionId @"AppGroup_ChatUpdatedCompanionId"
+
+/// Darwin 跨进程通知：键盘扩展发送聊天消息后通知主 App 刷新
+#define kKBDarwinChatUpdated @"com.loveKey.nyx.chat.updated"
+
 /// 皮肤图标加载模式：
 /// 0 = 使用本地 Assets 图片名（key_icons 的 value 写成图片名，例如 "kb_q_melon"）
 /// 1 = 使用远程 Zip 皮肤包（skinJSON 中提供 zip_url；key_icons 的 value 写成 Zip 内图标文件名，例如 "key_a"）

Shared/KBMaiPointReporter.m

@@ -296,7 +296,7 @@ static NSDictionary<NSString *, NSDictionary *> *KBMaiPoint_PageExposureMap(void
             @"HomeHotVC": @{@"event_name": @"enter_home_hot", @"page_id": @"home_hot"},
             @"HomeRankVC": @{@"event_name": @"enter_home_rank", @"page_id": @"home_rank"},
             @"HomeRankContentVC": @{@"event_name": @"enter_home_rank_content", @"page_id": @"home_rank_content"},
-            @"HomeSheetVC": @{@"event_name": @"enter_home_sheet", @"page_id": @"home_sheet"},
+//            @"HomeSheetVC": @{@"event_name": @"enter_home_sheet", @"page_id": @"home_sheet"},
             @"KBCommunityVC": @{@"event_name": @"enter_community", @"page_id": @"community"},
             @"KBSearchVC": @{@"event_name": @"enter_search", @"page_id": @"search"},
             @"KBSearchResultVC": @{@"event_name": @"enter_search_result", @"page_id": @"search_result"},

Shared/KBSignUtils.h

@@ -30,6 +30,10 @@ NS_ASSUME_NONNULL_BEGIN
 /// 简单 nonce 生成（默认 16 位）
 + (NSString *)generateNonceWithLength:(NSUInteger)length;
 
+/// 生成本项目后端约定的签名请求头（X-Sign/X-App-Id/X-Timestamp/X-Nonce）。
+/// bodyParams：参与签名的业务参数（如 JSON body 字段）。内部会做类型容错与空值过滤。
++ (NSDictionary<NSString *, NSString *> *)signHeadersWithBodyParams:(nullable NSDictionary *)bodyParams;
+
 @end
 
 NS_ASSUME_NONNULL_END

Shared/KBSignUtils.m

@@ -10,6 +10,32 @@
 
 @implementation KBSignUtils
 
+static NSString *const KBSignAppId = @"loveKeyboard";
+static NSString *const KBSignSecret = @"kZJM39HYvhxwbJkG1fmquQRVkQiLAh2H";
+
+static NSString *KBSignStringFromObject(id obj) {
+    if (!obj || obj == (id)kCFNull) {
+        return nil;
+    }
+    if ([obj isKindOfClass:[NSString class]]) {
+        return (NSString *)obj;
+    }
+    if ([obj isKindOfClass:[NSNumber class]]) {
+        return [(NSNumber *)obj stringValue];
+    }
+    if ([obj isKindOfClass:[NSArray class]] || [obj isKindOfClass:[NSDictionary class]]) {
+        NSJSONWritingOptions options = 0;
+        if (@available(iOS 11.0, *)) {
+            options = NSJSONWritingSortedKeys;
+        }
+        NSData *data = [NSJSONSerialization dataWithJSONObject:obj options:options error:nil];
+        if (data.length > 0) {
+            return [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
+        }
+    }
+    return [obj description];
+}
+
 + (NSString *)urlEncode:(NSString *)value {
     if (!value) return @"";
     // 按 application/x-www-form-urlencoded 规则编码（更贴近后端常见实现）
@@ -96,4 +122,50 @@
     return [uuid substringToIndex:length];
 }
 
++ (NSDictionary<NSString *, NSString *> *)signHeadersWithBodyParams:(NSDictionary *)bodyParams {
+    NSString *timestamp = [self currentTimestamp];
+    NSString *nonce = [self generateNonceWithLength:16];
+
+    NSMutableDictionary<NSString *, NSString *> *signParams = [NSMutableDictionary dictionary];
+    if (KBSignAppId.length > 0) {
+        signParams[@"appId"] = KBSignAppId;
+    }
+    if (timestamp.length > 0) {
+        signParams[@"timestamp"] = timestamp;
+    }
+    if (nonce.length > 0) {
+        signParams[@"nonce"] = nonce;
+    }
+
+    if ([bodyParams isKindOfClass:[NSDictionary class]] && bodyParams.count > 0) {
+        [bodyParams enumerateKeysAndObjectsUsingBlock:^(id key, id obj, BOOL *stop) {
+            if (![key isKindOfClass:[NSString class]]) {
+                return;
+            }
+            NSString *value = KBSignStringFromObject(obj);
+            if (value.length == 0) {
+                return;
+            }
+            signParams[(NSString *)key] = value;
+        }];
+    }
+
+    NSString *sign = [self signWithParams:signParams secret:KBSignSecret ?: @""];
+
+    NSMutableDictionary<NSString *, NSString *> *headers = [NSMutableDictionary dictionary];
+    if (sign.length > 0) {
+        headers[@"X-Sign"] = sign;
+    }
+    if (KBSignAppId.length > 0) {
+        headers[@"X-App-Id"] = KBSignAppId;
+    }
+    if (timestamp.length > 0) {
+        headers[@"X-Timestamp"] = timestamp;
+    }
+    if (nonce.length > 0) {
+        headers[@"X-Nonce"] = nonce;
+    }
+    return [headers copy];
+}
+
 @end

Shared/KBSkinInstallBridge.m

@@ -443,7 +443,7 @@ static NSString * const kKBSkinMetadataThemeKey        = @"theme_json";
 #if __has_include("KBNetworkManager.h")
         // 远程下载（http/https）
         NSLog(@"🌐[SkinBridge] will GET zip: %@", zipURL);
-        [KBHUD showWithStatus:@"正在下载..."];
+        [KBHUD showWithStatus:KBLocalized(@"Downloading...")];
         [[KBNetworkManager shared] GETData:zipURL parameters:nil headers:nil completion:^(NSData *data, NSURLResponse *response, NSError *error) {
             NSLog(@"🌐[SkinBridge] GET finished id=%@ error=%@", skinId, error);
             if (error || data.length == 0) {

Shared/KBUserSessionManager.m

@@ -99,10 +99,22 @@ static NSString * const kKBSessionInstallFlagKey = @"KBSession.installInitialize
     // 先写 Keychain（统一走 KBAuthManager）
     NSString *token = user.token;
     if (token.length > 0) {
-        [[KBAuthManager shared] saveAccessToken:token
-                                   refreshToken:nil
-                                     expiryDate:nil
-                                 userIdentifier:nil];
+        BOOL saveOK = [[KBAuthManager shared] saveAccessToken:token
+                                                 refreshToken:nil
+                                                   expiryDate:nil
+                                               userIdentifier:nil];
+#if DEBUG
+        NSLog(@"[AuthTrace][App] saveAccessToken tokenLen=%lu saveOK=%d",
+              (unsigned long)token.length, saveOK);
+#endif
+        // 主动 reload 一次，便于立即验证当前进程读到的登录态
+        [[KBAuthManager shared] reloadFromKeychain];
+#if DEBUG
+        NSString *savedToken = [KBAuthManager shared].current.accessToken ?: @"";
+        NSLog(@"[AuthTrace][App] reloadAfterSave isLoggedIn=%d tokenLen=%lu",
+              [KBAuthManager shared].isLoggedIn,
+              (unsigned long)savedToken.length);
+#endif
     }
 
     // 再缓存用户信息，供 App/键盘使用

Shared/Localization/en.lproj/Localizable.strings

@@ -82,6 +82,7 @@
 "Network error" = "Network error";
 "Saved" = "Saved";
 "Copy Success" = "Copy Success";
+"Email  Copy Success" = "Email  Copy Success";
 
 // Network
 "Network unavailable" = "Network unavailable";
@@ -171,6 +172,11 @@
 "Delete" = "Delete";
 "Points\nMall" = "Points\nMall";
 "Log Out" = "Log Out";
+"Cancel Account" = "Cancel Account";
+"After cancellation, your account will be deactivated and local login data will be cleared. Continue?" = "After cancellation, your account will be deactivated and local login data will be cleared. Continue?";
+"Please enter your password" = "Please enter your password";
+"Cancel Account Notice" = "Cancel Account Notice";
+"Confirm Cancel Account" = "Confirm Cancel Account";
 "Ranking List" = "Ranking List";
 "Persona circle" = "Persona circle";
 "Clear" = "Clear";
@@ -206,3 +212,4 @@
 "Purchase pending approval." = "Purchase pending approval.";
 "Unable to obtain transaction payload." = "Unable to obtain transaction payload.";
 "Resume Purchase" = "Resume Purchase";
+"Downloading..." = "Downloading...";

Shared/Localization/zh-Hans.lproj/Localizable.strings

@@ -83,6 +83,7 @@
 "Network error" = "网络错误";
 "Saved" = "已保存";
 "Copy Success" = "复制成功";
+"Email  Copy Success" = "Email  Copy Success";
 
 // 网络相关（英文 key）
 "Network unavailable" = "网络不可用";
@@ -171,6 +172,11 @@
 "Delete" = "删除";
 "Points\nMall" = "积分\n商城";
 "Log Out" = "退出";
+"Cancel Account" = "注销账户";
+"After cancellation, your account will be deactivated and local login data will be cleared. Continue?" = "注销后账号将被停用，并清除本地登录数据，是否继续？";
+"Please enter your password" = "请输入密码";
+"Cancel Account Notice" = "注销账户须知";
+"Confirm Cancel Account" = "确认注销";
 "Ranking List" = "排行榜";
 "Persona circle" = "圈子";
 "Clear" = "立刻清空";
@@ -208,3 +214,4 @@
 "Purchase pending approval." = "购买等待确认";
 "Unable to obtain transaction payload." = "无法获取交易凭据";
 "Resume Purchase" = "恢复购买";
+"Downloading..." = "正在下载...";

keyBoard.xcodeproj/project.pbxproj

@@ -8,8 +8,14 @@
 
 /* Begin PBXBuildFile section */
 		04050ECB2F10FB8F008051EB /* UIImage+KBColor.m in Sources */ = {isa = PBXBuildFile; fileRef = 047C655D2EBCD5B20035E841 /* UIImage+KBColor.m */; };
+		040B620F2F4BF2560099DEAC /* KeyboardViewController+Theme.m in Sources */ = {isa = PBXBuildFile; fileRef = 040B620C2F4BF2560099DEAC /* KeyboardViewController+Theme.m */; };
+		040B62102F4BF2560099DEAC /* KeyboardViewController+Chat.m in Sources */ = {isa = PBXBuildFile; fileRef = 040B62052F4BF2560099DEAC /* KeyboardViewController+Chat.m */; };
+		040B62112F4BF2560099DEAC /* KeyboardViewController+Panels.m in Sources */ = {isa = PBXBuildFile; fileRef = 040B62082F4BF2560099DEAC /* KeyboardViewController+Panels.m */; };
+		040B62122F4BF2560099DEAC /* KeyboardViewController+Layout.m in Sources */ = {isa = PBXBuildFile; fileRef = 040B62062F4BF2560099DEAC /* KeyboardViewController+Layout.m */; };
+		040B62132F4BF2560099DEAC /* KeyboardViewController+UI.m in Sources */ = {isa = PBXBuildFile; fileRef = 040B620D2F4BF2560099DEAC /* KeyboardViewController+UI.m */; };
+		040B62142F4BF2560099DEAC /* KeyboardViewController+Subscription.m in Sources */ = {isa = PBXBuildFile; fileRef = 040B620A2F4BF2560099DEAC /* KeyboardViewController+Subscription.m */; };
+		040B62162F4BF2560099DEAC /* KeyboardViewController+Suggestions.m in Sources */ = {isa = PBXBuildFile; fileRef = 040B620B2F4BF2560099DEAC /* KeyboardViewController+Suggestions.m */; };
 		041007D22ECE012000D203BB /* KBSkinIconMap.strings in Resources */ = {isa = PBXBuildFile; fileRef = 041007D12ECE012000D203BB /* KBSkinIconMap.strings */; };
-		041007D42ECE012500D203BB /* 002.zip in Resources */ = {isa = PBXBuildFile; fileRef = 041007D32ECE012500D203BB /* 002.zip */; };
 		04122F5D2EC5E5A900EF7AB3 /* KBLoginVM.m in Sources */ = {isa = PBXBuildFile; fileRef = 04122F5B2EC5E5A900EF7AB3 /* KBLoginVM.m */; };
 		04122F622EC5F41D00EF7AB3 /* KBUser.m in Sources */ = {isa = PBXBuildFile; fileRef = 04122F612EC5F41D00EF7AB3 /* KBUser.m */; };
 		04122F7E2EC5FC5500EF7AB3 /* KBJfPayCell.m in Sources */ = {isa = PBXBuildFile; fileRef = 04122F7C2EC5FC5500EF7AB3 /* KBJfPayCell.m */; };
@@ -28,7 +34,6 @@
 		04286A032ECB0A1600CE730C /* KBSexSelVC.m in Sources */ = {isa = PBXBuildFile; fileRef = 04286A022ECB0A1600CE730C /* KBSexSelVC.m */; };
 		04286A062ECC81B200CE730C /* KBSkinService.m in Sources */ = {isa = PBXBuildFile; fileRef = 04286A052ECC81B200CE730C /* KBSkinService.m */; };
 		04286A0B2ECD88B400CE730C /* KeyboardAssets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 04286A0A2ECD88B400CE730C /* KeyboardAssets.xcassets */; };
-		04286A0F2ECDA71B00CE730C /* 001.zip in Resources */ = {isa = PBXBuildFile; fileRef = 04286A0E2ECDA71B00CE730C /* 001.zip */; };
 		04286A132ECDEBF900CE730C /* KBSkinIconMap.strings in Resources */ = {isa = PBXBuildFile; fileRef = 041007D12ECE012000D203BB /* KBSkinIconMap.strings */; };
 		043FBCD22EAF97630036AFE1 /* KBPermissionViewController.m in Sources */ = {isa = PBXBuildFile; fileRef = 04C6EAE12EAF940F0089C901 /* KBPermissionViewController.m */; };
 		0450AA742EF013D000B6AF06 /* KBEmojiCollectionCell.m in Sources */ = {isa = PBXBuildFile; fileRef = 0450AA732EF013D000B6AF06 /* KBEmojiCollectionCell.m */; };
@@ -53,7 +58,7 @@
 		0459D1B42EBA284C00F2D189 /* KBSkinCenterVC.m in Sources */ = {isa = PBXBuildFile; fileRef = 0459D1B32EBA284C00F2D189 /* KBSkinCenterVC.m */; };
 		0459D1B72EBA287900F2D189 /* KBSkinManager.m in Sources */ = {isa = PBXBuildFile; fileRef = 0459D1B62EBA287900F2D189 /* KBSkinManager.m */; };
 		0459D1B82EBA287900F2D189 /* KBSkinManager.m in Sources */ = {isa = PBXBuildFile; fileRef = 0459D1B62EBA287900F2D189 /* KBSkinManager.m */; };
-		0460866B2F18D75500757C95 /* ai_test.m4a in Resources */ = {isa = PBXBuildFile; fileRef = 0460866A2F18D75500757C95 /* ai_test.m4a */; };
+		045ED5212F52AF9200131114 /* KBCancelAccountVC.m in Sources */ = {isa = PBXBuildFile; fileRef = 045ED5202F52AF9200131114 /* KBCancelAccountVC.m */; };
 		046086752F191CC700757C95 /* AI技术分析.txt in Resources */ = {isa = PBXBuildFile; fileRef = 046086742F191CC700757C95 /* AI技术分析.txt */; };
 		0460869A2F19238500757C95 /* KBAiWaveformView.m in Sources */ = {isa = PBXBuildFile; fileRef = 046086992F19238500757C95 /* KBAiWaveformView.m */; };
 		0460869C2F19238500757C95 /* KBAiRecordButton.m in Sources */ = {isa = PBXBuildFile; fileRef = 046086972F19238500757C95 /* KBAiRecordButton.m */; };
@@ -68,7 +73,6 @@
 		046086D82F1A093400757C95 /* KBAIReplyCell.m in Sources */ = {isa = PBXBuildFile; fileRef = 046086D52F1A093400757C95 /* KBAIReplyCell.m */; };
 		046086D92F1A093400757C95 /* KBAICommentHeaderView.m in Sources */ = {isa = PBXBuildFile; fileRef = 046086D12F1A093400757C95 /* KBAICommentHeaderView.m */; };
 		046131142ECF454500A6FADF /* KBKeyPreviewView.m in Sources */ = {isa = PBXBuildFile; fileRef = 046131132ECF454500A6FADF /* KBKeyPreviewView.m */; };
-		0477BDF02EBB76E30055D639 /* HomeSheetVC.m in Sources */ = {isa = PBXBuildFile; fileRef = 0477BDEF2EBB76E30055D639 /* HomeSheetVC.m */; };
 		0477BDF32EBB7B850055D639 /* KBDirectionIndicatorView.m in Sources */ = {isa = PBXBuildFile; fileRef = 0477BDF22EBB7B850055D639 /* KBDirectionIndicatorView.m */; };
 		0477BDFA2EBC66340055D639 /* HomeHeadView.m in Sources */ = {isa = PBXBuildFile; fileRef = 0477BDF92EBC66340055D639 /* HomeHeadView.m */; };
 		0477BDFD2EBC6A170055D639 /* HomeHotVC.m in Sources */ = {isa = PBXBuildFile; fileRef = 0477BDFC2EBC6A170055D639 /* HomeHotVC.m */; };
@@ -81,7 +85,6 @@
 		04791F952ED48028004E8522 /* KBFeedBackVC.m in Sources */ = {isa = PBXBuildFile; fileRef = 04791F942ED48028004E8522 /* KBFeedBackVC.m */; };
 		04791F982ED49CE7004E8522 /* KBFont.m in Sources */ = {isa = PBXBuildFile; fileRef = 04791F972ED49CE7004E8522 /* KBFont.m */; };
 		04791F992ED49CE7004E8522 /* KBFont.m in Sources */ = {isa = PBXBuildFile; fileRef = 04791F972ED49CE7004E8522 /* KBFont.m */; };
-		04791FF72ED5B985004E8522 /* Christmas.zip in Resources */ = {isa = PBXBuildFile; fileRef = 04791FF62ED5B985004E8522 /* Christmas.zip */; };
 		04791FFC2ED71D17004E8522 /* UIColor+Extension.m in Sources */ = {isa = PBXBuildFile; fileRef = 04FC95E42EB220B5007BD342 /* UIColor+Extension.m */; };
 		04791FFF2ED830FA004E8522 /* KBKeyboardMaskView.m in Sources */ = {isa = PBXBuildFile; fileRef = 04791FFE2ED830FA004E8522 /* KBKeyboardMaskView.m */; };
 		047920072ED86ABC004E8522 /* kb_guide_keyboard.gif in Resources */ = {isa = PBXBuildFile; fileRef = 047920062ED86ABC004E8522 /* kb_guide_keyboard.gif */; };
@@ -227,6 +230,8 @@
 		04E0B2022F300002002CA5A0 /* KBVoiceRecordManager.m in Sources */ = {isa = PBXBuildFile; fileRef = 04E0B2012F300002002CA5A0 /* KBVoiceRecordManager.m */; };
 		04E161832F10E6470022C23B /* normal_hei_them.zip in Resources */ = {isa = PBXBuildFile; fileRef = 04E161812F10E6470022C23B /* normal_hei_them.zip */; };
 		04E161842F10E6470022C23B /* normal_them.zip in Resources */ = {isa = PBXBuildFile; fileRef = 04E161822F10E6470022C23B /* normal_them.zip */; };
+		04E2277D2F516EBD001A8F14 /* PrivacyInfo.xcprivacy in Resources */ = {isa = PBXBuildFile; fileRef = 04E2277C2F516EBD001A8F14 /* PrivacyInfo.xcprivacy */; };
+		04E2277F2F516ED3001A8F14 /* PrivacyInfo.xcprivacy in Resources */ = {isa = PBXBuildFile; fileRef = 04E2277E2F516ED3001A8F14 /* PrivacyInfo.xcprivacy */; };
 		04F4C0AA2F32274000E8F08C /* KBPayMainVC.m in Sources */ = {isa = PBXBuildFile; fileRef = 04F4C0A92F32274000E8F08C /* KBPayMainVC.m */; };
 		04F4C0AD2F32288600E8F08C /* KBPaySvipVC.m in Sources */ = {isa = PBXBuildFile; fileRef = 04F4C0AC2F32288600E8F08C /* KBPaySvipVC.m */; };
 		04F4C0B02F322EF200E8F08C /* PagingViewTableHeaderView.m in Sources */ = {isa = PBXBuildFile; fileRef = 04F4C0AF2F322EF200E8F08C /* PagingViewTableHeaderView.m */; };
@@ -331,8 +336,16 @@
 /* End PBXCopyFilesBuildPhase section */
 
 /* Begin PBXFileReference section */
+		040B62052F4BF2560099DEAC /* KeyboardViewController+Chat.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "KeyboardViewController+Chat.m"; sourceTree = "<group>"; };
+		040B62062F4BF2560099DEAC /* KeyboardViewController+Layout.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "KeyboardViewController+Layout.m"; sourceTree = "<group>"; };
+		040B62072F4BF2560099DEAC /* KeyboardViewController+Legacy.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "KeyboardViewController+Legacy.m"; sourceTree = "<group>"; };
+		040B62082F4BF2560099DEAC /* KeyboardViewController+Panels.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "KeyboardViewController+Panels.m"; sourceTree = "<group>"; };
+		040B62092F4BF2560099DEAC /* KeyboardViewController+Private.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "KeyboardViewController+Private.h"; sourceTree = "<group>"; };
+		040B620A2F4BF2560099DEAC /* KeyboardViewController+Subscription.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "KeyboardViewController+Subscription.m"; sourceTree = "<group>"; };
+		040B620B2F4BF2560099DEAC /* KeyboardViewController+Suggestions.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "KeyboardViewController+Suggestions.m"; sourceTree = "<group>"; };
+		040B620C2F4BF2560099DEAC /* KeyboardViewController+Theme.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "KeyboardViewController+Theme.m"; sourceTree = "<group>"; };
+		040B620D2F4BF2560099DEAC /* KeyboardViewController+UI.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "KeyboardViewController+UI.m"; sourceTree = "<group>"; };
 		041007D12ECE012000D203BB /* KBSkinIconMap.strings */ = {isa = PBXFileReference; lastKnownFileType = text.plist.strings; path = KBSkinIconMap.strings; sourceTree = "<group>"; };
-		041007D32ECE012500D203BB /* 002.zip */ = {isa = PBXFileReference; lastKnownFileType = archive.zip; path = 002.zip; sourceTree = "<group>"; };
 		04122F592EC5D40000EF7AB3 /* KBAPI.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBAPI.h; sourceTree = "<group>"; };
 		04122F5A2EC5E5A900EF7AB3 /* KBLoginVM.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBLoginVM.h; sourceTree = "<group>"; };
 		04122F5B2EC5E5A900EF7AB3 /* KBLoginVM.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBLoginVM.m; sourceTree = "<group>"; };
@@ -367,7 +380,6 @@
 		04286A042ECC81B200CE730C /* KBSkinService.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBSkinService.h; sourceTree = "<group>"; };
 		04286A052ECC81B200CE730C /* KBSkinService.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBSkinService.m; sourceTree = "<group>"; };
 		04286A0A2ECD88B400CE730C /* KeyboardAssets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = KeyboardAssets.xcassets; sourceTree = "<group>"; };
-		04286A0E2ECDA71B00CE730C /* 001.zip */ = {isa = PBXFileReference; lastKnownFileType = archive.zip; path = 001.zip; sourceTree = "<group>"; };
 		0450AA722EF013D000B6AF06 /* KBEmojiCollectionCell.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBEmojiCollectionCell.h; sourceTree = "<group>"; };
 		0450AA732EF013D000B6AF06 /* KBEmojiCollectionCell.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBEmojiCollectionCell.m; sourceTree = "<group>"; };
 		0450AAE02EF03D5100B6AF06 /* keyBoard-Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "keyBoard-Bridging-Header.h"; sourceTree = "<group>"; };
@@ -393,7 +405,8 @@
 		0459D1B32EBA284C00F2D189 /* KBSkinCenterVC.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBSkinCenterVC.m; sourceTree = "<group>"; };
 		0459D1B52EBA287900F2D189 /* KBSkinManager.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBSkinManager.h; sourceTree = "<group>"; };
 		0459D1B62EBA287900F2D189 /* KBSkinManager.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBSkinManager.m; sourceTree = "<group>"; };
-		0460866A2F18D75500757C95 /* ai_test.m4a */ = {isa = PBXFileReference; lastKnownFileType = file; path = ai_test.m4a; sourceTree = "<group>"; };
+		045ED51F2F52AF9200131114 /* KBCancelAccountVC.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBCancelAccountVC.h; sourceTree = "<group>"; };
+		045ED5202F52AF9200131114 /* KBCancelAccountVC.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBCancelAccountVC.m; sourceTree = "<group>"; };
 		046086742F191CC700757C95 /* AI技术分析.txt */ = {isa = PBXFileReference; lastKnownFileType = text; path = "AI技术分析.txt"; sourceTree = "<group>"; };
 		046086962F19238500757C95 /* KBAiRecordButton.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBAiRecordButton.h; sourceTree = "<group>"; };
 		046086972F19238500757C95 /* KBAiRecordButton.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBAiRecordButton.m; sourceTree = "<group>"; };
@@ -420,8 +433,6 @@
 		046086D52F1A093400757C95 /* KBAIReplyCell.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBAIReplyCell.m; sourceTree = "<group>"; };
 		046131122ECF454500A6FADF /* KBKeyPreviewView.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBKeyPreviewView.h; sourceTree = "<group>"; };
 		046131132ECF454500A6FADF /* KBKeyPreviewView.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBKeyPreviewView.m; sourceTree = "<group>"; };
-		0477BDEE2EBB76E30055D639 /* HomeSheetVC.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = HomeSheetVC.h; sourceTree = "<group>"; };
-		0477BDEF2EBB76E30055D639 /* HomeSheetVC.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = HomeSheetVC.m; sourceTree = "<group>"; };
 		0477BDF12EBB7B850055D639 /* KBDirectionIndicatorView.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBDirectionIndicatorView.h; sourceTree = "<group>"; };
 		0477BDF22EBB7B850055D639 /* KBDirectionIndicatorView.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBDirectionIndicatorView.m; sourceTree = "<group>"; };
 		0477BDF82EBC66340055D639 /* HomeHeadView.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = HomeHeadView.h; sourceTree = "<group>"; };
@@ -442,7 +453,6 @@
 		04791F942ED48028004E8522 /* KBFeedBackVC.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBFeedBackVC.m; sourceTree = "<group>"; };
 		04791F962ED49CE7004E8522 /* KBFont.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBFont.h; sourceTree = "<group>"; };
 		04791F972ED49CE7004E8522 /* KBFont.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBFont.m; sourceTree = "<group>"; };
-		04791FF62ED5B985004E8522 /* Christmas.zip */ = {isa = PBXFileReference; lastKnownFileType = archive.zip; path = Christmas.zip; sourceTree = "<group>"; };
 		04791FFD2ED830FA004E8522 /* KBKeyboardMaskView.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBKeyboardMaskView.h; sourceTree = "<group>"; };
 		04791FFE2ED830FA004E8522 /* KBKeyboardMaskView.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBKeyboardMaskView.m; sourceTree = "<group>"; };
 		047920062ED86ABC004E8522 /* kb_guide_keyboard.gif */ = {isa = PBXFileReference; lastKnownFileType = image.gif; path = kb_guide_keyboard.gif; sourceTree = "<group>"; };
@@ -706,6 +716,8 @@
 		04E0B2012F300002002CA5A0 /* KBVoiceRecordManager.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBVoiceRecordManager.m; sourceTree = "<group>"; };
 		04E161812F10E6470022C23B /* normal_hei_them.zip */ = {isa = PBXFileReference; lastKnownFileType = archive.zip; path = normal_hei_them.zip; sourceTree = "<group>"; };
 		04E161822F10E6470022C23B /* normal_them.zip */ = {isa = PBXFileReference; lastKnownFileType = archive.zip; path = normal_them.zip; sourceTree = "<group>"; };
+		04E2277C2F516EBD001A8F14 /* PrivacyInfo.xcprivacy */ = {isa = PBXFileReference; lastKnownFileType = text.xml; path = PrivacyInfo.xcprivacy; sourceTree = "<group>"; };
+		04E2277E2F516ED3001A8F14 /* PrivacyInfo.xcprivacy */ = {isa = PBXFileReference; lastKnownFileType = text.xml; path = PrivacyInfo.xcprivacy; sourceTree = "<group>"; };
 		04F4C0A82F32274000E8F08C /* KBPayMainVC.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBPayMainVC.h; sourceTree = "<group>"; };
 		04F4C0A92F32274000E8F08C /* KBPayMainVC.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = KBPayMainVC.m; sourceTree = "<group>"; };
 		04F4C0AB2F32288600E8F08C /* KBPaySvipVC.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = KBPaySvipVC.h; sourceTree = "<group>"; };
@@ -877,18 +889,31 @@
 /* End PBXFrameworksBuildPhase section */
 
 /* Begin PBXGroup section */
+		040B620E2F4BF2560099DEAC /* KeyboardViewControllerHelp */ = {
+			isa = PBXGroup;
+			children = (
+				040B62052F4BF2560099DEAC /* KeyboardViewController+Chat.m */,
+				040B62062F4BF2560099DEAC /* KeyboardViewController+Layout.m */,
+				040B62072F4BF2560099DEAC /* KeyboardViewController+Legacy.m */,
+				040B62082F4BF2560099DEAC /* KeyboardViewController+Panels.m */,
+				040B62092F4BF2560099DEAC /* KeyboardViewController+Private.h */,
+				040B620A2F4BF2560099DEAC /* KeyboardViewController+Subscription.m */,
+				040B620B2F4BF2560099DEAC /* KeyboardViewController+Suggestions.m */,
+				040B620C2F4BF2560099DEAC /* KeyboardViewController+Theme.m */,
+				040B620D2F4BF2560099DEAC /* KeyboardViewController+UI.m */,
+			);
+			path = KeyboardViewControllerHelp;
+			sourceTree = "<group>";
+		};
 		041007D02ECE010100D203BB /* Resource */ = {
 			isa = PBXGroup;
 			children = (
-				0460866A2F18D75500757C95 /* ai_test.m4a */,
 				04E161812F10E6470022C23B /* normal_hei_them.zip */,
 				04E161822F10E6470022C23B /* normal_them.zip */,
 				A1B2C3EC2F20000000000001 /* kb_words.txt */,
 				A1B2C3F02F20000000000002 /* kb_keyboard_layout_config.json */,
 				0498BDF42EEC50EE006CC1D5 /* emoji_categories.json */,
 				041007D12ECE012000D203BB /* KBSkinIconMap.strings */,
-				041007D32ECE012500D203BB /* 002.zip */,
-				04791FF62ED5B985004E8522 /* Christmas.zip */,
 			);
 			path = Resource;
 			sourceTree = "<group>";
@@ -1234,7 +1259,6 @@
 				0479200A2ED87CEE004E8522 /* permiss_video.mp4 */,
 				047920102ED98E7D004E8522 /* permiss_video_2.mp4 */,
 				047920062ED86ABC004E8522 /* kb_guide_keyboard.gif */,
-				04286A0E2ECDA71B00CE730C /* 001.zip */,
 			);
 			path = Resource;
 			sourceTree = "<group>";
@@ -1536,16 +1560,10 @@
 			path = Localization;
 			sourceTree = "<group>";
 		};
-		04BBF8E52F3B50C000B1FBB2 /* KeyboardViewControllerHelp */ = {
-			isa = PBXGroup;
-			children = (
-			);
-			path = KeyboardViewControllerHelp;
-			sourceTree = "<group>";
-		};
 		04C6EAB92EAF86530089C901 /* keyBoard */ = {
 			isa = PBXGroup;
 			children = (
+				04E2277C2F516EBD001A8F14 /* PrivacyInfo.xcprivacy */,
 				04FC95F52EB33B52007BD342 /* keyBoard.entitlements */,
 				04FC95BF2EB1E3B1007BD342 /* Class */,
 				04C6EAE32EAF942E0089C901 /* VC */,
@@ -1566,6 +1584,7 @@
 		04C6EAD72EAF870B0089C901 /* CustomKeyboard */ = {
 			isa = PBXGroup;
 			children = (
+				04E2277E2F516ED3001A8F14 /* PrivacyInfo.xcprivacy */,
 				0419C9632F2C7630002E86D3 /* VM */,
 				041007D02ECE010100D203BB /* Resource */,
 				0477BD942EBAFF4E0055D639 /* Utils */,
@@ -1576,7 +1595,7 @@
 				04C6EAD42EAF870B0089C901 /* Info.plist */,
 				04C6EAD52EAF870B0089C901 /* KeyboardViewController.h */,
 				04C6EAD62EAF870B0089C901 /* KeyboardViewController.m */,
-				04BBF8E52F3B50C000B1FBB2 /* KeyboardViewControllerHelp */,
+				040B620E2F4BF2560099DEAC /* KeyboardViewControllerHelp */,
 				04C6EADE2EAF8D680089C901 /* PrefixHeader.pch */,
 				04286A0A2ECD88B400CE730C /* KeyboardAssets.xcassets */,
 			);
@@ -1710,8 +1729,6 @@
 			children = (
 				0477BE022EBC83130055D639 /* HomeMainVC.h */,
 				0477BE032EBC83130055D639 /* HomeMainVC.m */,
-				0477BDEE2EBB76E30055D639 /* HomeSheetVC.h */,
-				0477BDEF2EBB76E30055D639 /* HomeSheetVC.m */,
 				0477BDFB2EBC6A170055D639 /* HomeHotVC.h */,
 				0477BDFC2EBC6A170055D639 /* HomeHotVC.m */,
 				0477BDFE2EBC6A330055D639 /* HomeRankVC.h */,
@@ -1828,6 +1845,8 @@
 				A1F0C1A52F1234567890ABCD /* KBConsumptionRecordVC.m */,
 				049FB2212EC311F900FAB05D /* KBPersonInfoVC.h */,
 				049FB2222EC311F900FAB05D /* KBPersonInfoVC.m */,
+				045ED51F2F52AF9200131114 /* KBCancelAccountVC.h */,
+				045ED5202F52AF9200131114 /* KBCancelAccountVC.m */,
 				04791F902ED48010004E8522 /* KBNoticeVC.h */,
 				04791F912ED48010004E8522 /* KBNoticeVC.m */,
 				04791F932ED48028004E8522 /* KBFeedBackVC.h */,
@@ -2234,13 +2253,11 @@
 				04E161832F10E6470022C23B /* normal_hei_them.zip in Resources */,
 				04E161842F10E6470022C23B /* normal_them.zip in Resources */,
 				04A9FE202EB893F10020DB6D /* Localizable.strings in Resources */,
-				0460866B2F18D75500757C95 /* ai_test.m4a in Resources */,
-				041007D42ECE012500D203BB /* 002.zip in Resources */,
 				041007D22ECE012000D203BB /* KBSkinIconMap.strings in Resources */,
+				04E2277F2F516ED3001A8F14 /* PrivacyInfo.xcprivacy in Resources */,
 				A1B2C3ED2F20000000000001 /* kb_words.txt in Resources */,
 				A1B2C3F12F20000000000002 /* kb_keyboard_layout_config.json in Resources */,
 				0498BDF52EEC50EE006CC1D5 /* emoji_categories.json in Resources */,
-				04791FF72ED5B985004E8522 /* Christmas.zip in Resources */,
 				04286A0B2ECD88B400CE730C /* KeyboardAssets.xcassets in Resources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
@@ -2249,9 +2266,9 @@
 			isa = PBXResourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
-				04286A0F2ECDA71B00CE730C /* 001.zip in Resources */,
 				04E038D82F20BFFB002CA5A0 /* websocket-api.md in Resources */,
 				0479200B2ED87CEE004E8522 /* permiss_video.mp4 in Resources */,
+				04E2277D2F516EBD001A8F14 /* PrivacyInfo.xcprivacy in Resources */,
 				04C6EABA2EAF86530089C901 /* Assets.xcassets in Resources */,
 				04A9FE212EB893F10020DB6D /* Localizable.strings in Resources */,
 				047920072ED86ABC004E8522 /* kb_guide_keyboard.gif in Resources */,
@@ -2344,6 +2361,13 @@
 				0498BD862EE1BEC9006CC1D5 /* KBSignUtils.m in Sources */,
 				04791FFC2ED71D17004E8522 /* UIColor+Extension.m in Sources */,
 				0450AC4A2EF2C3ED00B6AF06 /* KBKeyboardSubscriptionOptionCell.m in Sources */,
+				040B620F2F4BF2560099DEAC /* KeyboardViewController+Theme.m in Sources */,
+				040B62102F4BF2560099DEAC /* KeyboardViewController+Chat.m in Sources */,
+				040B62112F4BF2560099DEAC /* KeyboardViewController+Panels.m in Sources */,
+				040B62122F4BF2560099DEAC /* KeyboardViewController+Layout.m in Sources */,
+				040B62132F4BF2560099DEAC /* KeyboardViewController+UI.m in Sources */,
+				040B62142F4BF2560099DEAC /* KeyboardViewController+Subscription.m in Sources */,
+				040B62162F4BF2560099DEAC /* KeyboardViewController+Suggestions.m in Sources */,
 				04A9FE0F2EB481100020DB6D /* KBHUD.m in Sources */,
 				048FFD562F2B9C3D005D62AE /* KBChatAssistantCell.m in Sources */,
 				048FFD572F2B9C3D005D62AE /* KBChatUserCell.m in Sources */,
@@ -2533,7 +2557,6 @@
 				048908EC2EBF849300FABA60 /* KBSkinTagsContainerCell.m in Sources */,
 				049FB2172EC20A6600FAB05D /* BMLongPressDragCellCollectionView.m in Sources */,
 				04122F8E2EC6F83F00EF7AB3 /* PayVM.m in Sources */,
-				0477BDF02EBB76E30055D639 /* HomeSheetVC.m in Sources */,
 				048908E62EBF841B00FABA60 /* KBSkinDetailTagCell.m in Sources */,
 				04FC97002EB30A00007BD342 /* KBGuideTopCell.m in Sources */,
 				04791F982ED49CE7004E8522 /* KBFont.m in Sources */,
@@ -2592,6 +2615,7 @@
 				0498BDE42EEA885D006CC1D5 /* KBShopThemeModel.m in Sources */,
 				048908CD2EBE373500FABA60 /* KBSearchSectionHeader.m in Sources */,
 				049FB2202EC30D2700FAB05D /* HomeRankDetailPopView.m in Sources */,
+				045ED5212F52AF9200131114 /* KBCancelAccountVC.m in Sources */,
 				048908CE2EBE373500FABA60 /* KBSkinCardCell.m in Sources */,
 				048908CF2EBE373500FABA60 /* KBTagCell.m in Sources */,
 				0477BEA22EBCF0000055D639 /* KBTopImageButton.m in Sources */,

keyBoard.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict/>
+</plist>

keyBoard.xcworkspace/xcuserdata/mac.xcuserdatad/WorkspaceSettings.xcsettings

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>BuildLocationStyle</key>
+	<string>UseAppPreferences</string>
+	<key>CustomBuildLocationType</key>
+	<string>RelativeToDerivedData</string>
+	<key>DerivedDataLocationStyle</key>
+	<string>Default</string>
+	<key>ShowSharedSchemesAutomaticallyEnabled</key>
+	<true/>
+</dict>
+</plist>

keyBoard/Assets.xcassets/Ohter/ai_placehode_icon.imageset/Contents.json

@@ -0,0 +1,21 @@
+{
+  "images" : [
+    {
+      "filename" : "微信图片_20260226192149_128_935 (1).png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
+    {
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
+    {
+      "idiom" : "universal",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

keyBoard/Class/AiTalk/V/Chat/KBPersonaChatCell.h

@@ -69,6 +69,9 @@ NS_ASSUME_NONNULL_BEGIN
 /// 当前 Cell 不再是屏幕主显示页
 - (void)onResignedCurrentPersonaCell;
 
+/// 刷新聊天记录（重置分页状态，从第一页重新加载）
+- (void)refreshChatHistory;
+
 @end
 
 NS_ASSUME_NONNULL_END

keyBoard/Class/AiTalk/V/Chat/KBPersonaChatCell.m

@@ -213,7 +213,7 @@ static NSString * const KBChatSessionDidResetNotification = @"KBChatSessionDidRe
     
     // 设置 UI
     [self.backgroundImageView sd_setImageWithURL:[NSURL URLWithString:persona.coverImageUrl]
-                                placeholderImage:[UIImage imageNamed:@"placeholder_bg"]];
+                                placeholderImage:[UIImage imageNamed:@"ai_placehode_icon"]];
     [self.avatarImageView sd_setImageWithURL:[NSURL URLWithString:persona.avatarUrl]
                             placeholderImage:[UIImage imageNamed:@"placeholder_avatar"]];
     self.nameLabel.text = persona.name;    
@@ -256,7 +256,20 @@ static NSString * const KBChatSessionDidResetNotification = @"KBChatSessionDidRe
     if (self.hasLoadedData || self.isLoading) {
         return;
     }
-    
+
+    [self loadChatHistory];
+}
+
+- (void)refreshChatHistory {
+    // 重置分页状态
+    self.currentPage = 1;
+    self.hasMoreHistory = YES;
+    self.hasLoadedData = NO;
+    self.isLoading = NO;
+
+    // 清空当前消息并重新加载
+    [self.messages removeAllObjects];
+    [self.chatView clearMessages];
     [self loadChatHistory];
 }
 

keyBoard/Class/AiTalk/V/Comment/KBAICommentInputView.m

@@ -92,7 +92,9 @@
 }
 
 - (void)showKeyboard {
-  [self.textField becomeFirstResponder];
+  BOOL before = self.textField.isFirstResponder;
+  BOOL become = [self.textField becomeFirstResponder];
+  NSLog(@"[KBAICommentInputView] showKeyboard before=%d become=%d after=%d", before, become, self.textField.isFirstResponder);
 }
 
 #pragma mark - Actions
@@ -129,11 +131,17 @@
 }
 
 - (BOOL)textFieldShouldBeginEditing:(UITextField *)textField {
+  NSLog(@"[KBAICommentInputView] textFieldShouldBeginEditing");
   [self updatePlaceholderVisibility];
   return YES;
 }
 
+- (void)textFieldDidBeginEditing:(UITextField *)textField {
+  NSLog(@"[KBAICommentInputView] textFieldDidBeginEditing firstResponder=%d", textField.isFirstResponder);
+}
+
 - (void)textFieldDidEndEditing:(UITextField *)textField {
+  NSLog(@"[KBAICommentInputView] textFieldDidEndEditing");
   [self updatePlaceholderVisibility];
 }
 

keyBoard/Class/AiTalk/VC/KBAIHomeVC.m

@@ -108,6 +108,19 @@
 
 static NSString * const KBAISelectedPersonaIdKey = @"KBAISelectedPersonaId";
 
+#pragma mark - Darwin Notification Callback (键盘扩展聊天更新)
+
+static void KBChatUpdatedDarwinCallback(CFNotificationCenterRef center,
+                                         void *observer,
+                                         CFStringRef name,
+                                         const void *object,
+                                         CFDictionaryRef userInfo) {
+    KBAIHomeVC *self = (__bridge KBAIHomeVC *)observer;
+    dispatch_async(dispatch_get_main_queue(), ^{
+        [self kb_handleChatUpdatedFromExtension];
+    });
+}
+
 #pragma mark - Keyboard Gate
 
 /// 查找当前 view 树里的 firstResponder
@@ -163,10 +176,21 @@ static NSString * const KBAISelectedPersonaIdKey = @"KBAISelectedPersonaId";
     [self setupKeyboardNotifications];
     [self setupKeyboardDismissGesture];
     [self loadPersonas];
+
+    // 监听键盘扩展聊天更新的 Darwin 跨进程通知
+    CFNotificationCenterAddObserver(
+        CFNotificationCenterGetDarwinNotifyCenter(),
+        (__bridge const void *)(self),
+        KBChatUpdatedDarwinCallback,
+        (__bridge CFStringRef)kKBDarwinChatUpdated,
+        NULL,
+        CFNotificationSuspensionBehaviorDeliverImmediately);
 }
 
 - (void)viewDidAppear:(BOOL)animated {
     [super viewDidAppear:animated];
+    [self kb_syncTextInputStateIfNeeded];
+    [self kb_logInputLayoutWithTag:@"viewDidAppear"];
     KBPersonaChatCell *cell = [self currentPersonaCell];
     if (cell) {
         [cell onBecameCurrentPersonaCell];
@@ -175,6 +199,17 @@ static NSString * const KBAISelectedPersonaIdKey = @"KBAISelectedPersonaId";
 
 - (void)viewWillDisappear:(BOOL)animated {
     [super viewWillDisappear:animated];
+    // 离开页面时结束编辑并重置底部输入状态，避免返回时出现 hidden/firstResponder 错位
+    [self.view endEditing:YES];
+    self.voiceInputKeyboardActive = NO;
+    self.currentKeyboardHeight = 0.0;
+    self.isTextInputMode = NO;
+    self.commentInputView.hidden = YES;
+    [self.commentInputBottomConstraint setOffset:100];
+    self.voiceInputBar.hidden = NO;
+    [self.voiceInputBarBottomConstraint setOffset:-self.baseInputBarBottomSpacing];
+    [self.view layoutIfNeeded];
+    [self kb_logInputLayoutWithTag:@"viewWillDisappear"];
     for (NSIndexPath *indexPath in self.collectionView.indexPathsForVisibleItems) {
         KBPersonaChatCell *cell = (KBPersonaChatCell *)[self.collectionView cellForItemAtIndexPath:indexPath];
         if (cell) {
@@ -263,16 +298,26 @@ static NSString * const KBAISelectedPersonaIdKey = @"KBAISelectedPersonaId";
     self.isTextInputMode = YES;
     self.voiceInputBar.hidden = YES;
     self.commentInputView.hidden = NO;
+    [self kb_logInputLayoutWithTag:@"showTextInputView-beforeAdjust"];
+    // 键盘未弹起时先停在底部栏位置，随后由键盘通知动画抬起到键盘上方
+    // 键盘已弹起时（如返回页面）直接使用当前键盘高度对齐
+    CGFloat targetOffset = self.currentKeyboardHeight > 0.0 ? -self.currentKeyboardHeight : -self.baseInputBarBottomSpacing;
+    [self.commentInputBottomConstraint setOffset:targetOffset];
+    [self.view layoutIfNeeded];
+    [self kb_logInputLayoutWithTag:@"showTextInputView-afterAdjust"];
     [self.commentInputView showKeyboard];
 }
 
 /// 隐藏文本输入视图
 - (void)hideTextInputView {
+    [self kb_logInputLayoutWithTag:@"hideTextInputView-before"];
     self.isTextInputMode = NO;
     [self.view endEditing:YES];
     [self.commentInputView clearText];
     self.commentInputView.hidden = YES;
+    [self.commentInputBottomConstraint setOffset:100];
     self.voiceInputBar.hidden = NO;
+    [self kb_logInputLayoutWithTag:@"hideTextInputView-after"];
 }
 
 #pragma mark - 2：数据加载
@@ -570,12 +615,32 @@ static NSString * const KBAISelectedPersonaIdKey = @"KBAISelectedPersonaId";
 
 - (void)setupKeyboardNotifications {
     [[NSNotificationCenter defaultCenter] addObserver:self
-                                             selector:@selector(handleKeyboardWillChangeFrame:)
+                                             selector:@selector(handleKeyboardNotification:)
                                                  name:UIKeyboardWillChangeFrameNotification
                                                object:nil];
+    [[NSNotificationCenter defaultCenter] addObserver:self
+                                             selector:@selector(handleKeyboardNotification:)
+                                                 name:UIKeyboardDidChangeFrameNotification
+                                               object:nil];
+    [[NSNotificationCenter defaultCenter] addObserver:self
+                                             selector:@selector(handleKeyboardNotification:)
+                                                 name:UIKeyboardWillShowNotification
+                                               object:nil];
+    [[NSNotificationCenter defaultCenter] addObserver:self
+                                             selector:@selector(handleKeyboardNotification:)
+                                                 name:UIKeyboardDidShowNotification
+                                               object:nil];
+    [[NSNotificationCenter defaultCenter] addObserver:self
+                                             selector:@selector(handleKeyboardNotification:)
+                                                 name:UIKeyboardWillHideNotification
+                                               object:nil];
+    [[NSNotificationCenter defaultCenter] addObserver:self
+                                             selector:@selector(handleKeyboardNotification:)
+                                                 name:UIKeyboardDidHideNotification
+                                               object:nil];
 }
 
-- (void)handleKeyboardWillChangeFrame:(NSNotification *)notification {
+- (void)handleKeyboardNotification:(NSNotification *)notification {
     NSDictionary *userInfo = notification.userInfo;
     CGRect endFrame = [userInfo[UIKeyboardFrameEndUserInfoKey] CGRectValue];
     NSTimeInterval duration = [userInfo[UIKeyboardAnimationDurationUserInfoKey] doubleValue];
@@ -583,17 +648,42 @@ static NSString * const KBAISelectedPersonaIdKey = @"KBAISelectedPersonaId";
     
     CGRect convertedFrame = [self.view convertRect:endFrame fromView:nil];
     CGFloat keyboardHeight = MAX(0.0, CGRectGetMaxY(self.view.bounds) - CGRectGetMinY(convertedFrame));
+    BOOL shouldHandle = YES;
+    BOOL fromAllowedInput = [self kb_isKeyboardFromVoiceInputBar];
 
     if (keyboardHeight > 0.0) {
-        if (![self kb_isKeyboardFromVoiceInputBar]) {
-            return;
+        // 文本输入模式优先跟随键盘，避免返回页面后 firstResponder 瞬时不稳定导致被误过滤
+        if (!self.isTextInputMode && !fromAllowedInput) {
+            shouldHandle = NO;
         }
         self.voiceInputKeyboardActive = YES;
     } else {
-        if (!self.voiceInputKeyboardActive) {
-            return;
+        if (!self.voiceInputKeyboardActive && !self.isTextInputMode) {
+            shouldHandle = NO;
         }
         self.voiceInputKeyboardActive = NO;
+    }
+    
+    [self kb_logKeyboardNotification:notification
+                        keyboardHeight:keyboardHeight
+                        convertedFrame:convertedFrame
+                      fromAllowedInput:fromAllowedInput
+                          shouldHandle:shouldHandle];
+    if (!shouldHandle) {
+        return;
+    }
+    
+    UIView *firstResponder = [self kb_findFirstResponderInView:self.view];
+    BOOL firstInComment = firstResponder ? [firstResponder isDescendantOfView:self.commentInputView] : NO;
+    if (keyboardHeight > 0.0 && firstInComment && !self.isTextInputMode) {
+        // 防止出现「firstResponder 在 commentInput，但 textMode 仍为 NO」导致定位到底部
+        self.isTextInputMode = YES;
+        self.voiceInputBar.hidden = YES;
+        self.commentInputView.hidden = NO;
+        [self kb_logInputLayoutWithTag:@"keyboardSync-forceTextMode"];
+    }
+
+    if (keyboardHeight <= 0.0) {
         // 键盘隐藏时，如果是文本输入模式，隐藏文本输入框并显示 VoiceInputBar
         if (self.isTextInputMode) {
             [self hideTextInputView];
@@ -625,7 +715,9 @@ static NSString * const KBAISelectedPersonaIdKey = @"KBAISelectedPersonaId";
                      animations:^{
                          [self.view layoutIfNeeded];
                      }
-                     completion:nil];
+                     completion:^(BOOL finished) {
+                         [self kb_logInputLayoutWithTag:@"handleKeyboardNotification-animComplete"];
+                     }];
 }
 
 #pragma mark - 7：键盘收起
@@ -693,6 +785,36 @@ static NSString * const KBAISelectedPersonaIdKey = @"KBAISelectedPersonaId";
     return nil;
 }
 
+#pragma mark - 键盘扩展聊天更新处理
+
+/// 收到键盘扩展的聊天更新通知后，刷新对应 persona 的聊天记录
+- (void)kb_handleChatUpdatedFromExtension {
+    NSUserDefaults *ud = [[NSUserDefaults alloc] initWithSuiteName:AppGroup];
+    NSInteger companionId = [ud integerForKey:AppGroup_ChatUpdatedCompanionId];
+    if (companionId <= 0) {
+        return;
+    }
+
+    NSLog(@"[KBAIHomeVC] 收到键盘扩展聊天更新通知，companionId=%ld", (long)companionId);
+
+    // 查找对应 persona 的索引
+    NSInteger index = [self indexOfPersonaId:companionId];
+    if (index == NSNotFound) {
+        NSLog(@"[KBAIHomeVC] 未找到 companionId=%ld 对应的 persona", (long)companionId);
+        return;
+    }
+
+    // 获取对应的 cell 并刷新聊天记录
+    NSIndexPath *indexPath = [NSIndexPath indexPathForItem:index inSection:0];
+    KBPersonaChatCell *cell = (KBPersonaChatCell *)[self.collectionView cellForItemAtIndexPath:indexPath];
+    if (cell) {
+        [cell refreshChatHistory];
+        NSLog(@"[KBAIHomeVC] 已触发 companionId=%ld 的聊天记录刷新", (long)companionId);
+    } else {
+        NSLog(@"[KBAIHomeVC] companionId=%ld 的 cell 不可见，下次显示时会自动加载", (long)companionId);
+    }
+}
+
 - (NSInteger)indexOfPersonaId:(NSInteger)personaId {
     if (personaId <= 0) {
         return NSNotFound;
@@ -843,6 +965,7 @@ static NSString * const KBAISelectedPersonaIdKey = @"KBAISelectedPersonaId";
 }
 
 - (void)chatLimitPopViewDidTapRecharge:(KBChatLimitPopView *)view {
+    NSLog(@"[KBAIHomeVC][Pay] chatLimitPopViewDidTapRecharge");
     [self.chatLimitPopView dismiss];
     if (![KBUserSessionManager shared].isLoggedIn) {
         [[KBUserSessionManager shared] goLoginVC];
@@ -961,6 +1084,74 @@ static NSString * const KBAISelectedPersonaIdKey = @"KBAISelectedPersonaId";
     [self showPersonaSidebar];
 }
 
+#pragma mark - Debug Log
+
+- (void)kb_syncTextInputStateIfNeeded {
+    UIView *firstResponder = [self kb_findFirstResponderInView:self.view];
+    BOOL firstInComment = firstResponder ? [firstResponder isDescendantOfView:self.commentInputView] : NO;
+    if (!firstInComment) {
+        return;
+    }
+    self.isTextInputMode = YES;
+    self.voiceInputBar.hidden = YES;
+    self.commentInputView.hidden = NO;
+    if (self.currentKeyboardHeight > 0.0) {
+        [self.commentInputBottomConstraint setOffset:-self.currentKeyboardHeight];
+        [self.voiceInputBarBottomConstraint setOffset:-MAX(self.currentKeyboardHeight - 5.0, self.baseInputBarBottomSpacing)];
+    } else {
+        [self.commentInputBottomConstraint setOffset:-self.baseInputBarBottomSpacing];
+    }
+    [self.view layoutIfNeeded];
+    [self kb_logInputLayoutWithTag:@"kb_syncTextInputStateIfNeeded"];
+}
+
+- (void)kb_logInputLayoutWithTag:(NSString *)tag {
+    [self.view layoutIfNeeded];
+    UIView *firstResponder = [self kb_findFirstResponderInView:self.view];
+    NSString *firstResponderInfo = firstResponder ? NSStringFromClass(firstResponder.class) : @"nil";
+    NSLog(@"[KBAIHomeVC][Layout][%@] textMode=%d voiceHidden=%d commentHidden=%d currentKeyboardHeight=%.2f viewH=%.2f safeBottom=%.2f commentFrame=%@ voiceFrame=%@ firstResponder=%@",
+          tag ?: @"-",
+          self.isTextInputMode,
+          self.voiceInputBar.hidden,
+          self.commentInputView.hidden,
+          self.currentKeyboardHeight,
+          CGRectGetHeight(self.view.bounds),
+          self.view.safeAreaInsets.bottom,
+          NSStringFromCGRect(self.commentInputView.frame),
+          NSStringFromCGRect(self.voiceInputBar.frame),
+          firstResponderInfo);
+}
+
+- (void)kb_logKeyboardNotification:(NSNotification *)notification
+                      keyboardHeight:(CGFloat)keyboardHeight
+                      convertedFrame:(CGRect)convertedFrame
+                    fromAllowedInput:(BOOL)fromAllowedInput
+                        shouldHandle:(BOOL)shouldHandle {
+    NSDictionary *userInfo = notification.userInfo;
+    CGRect endFrame = [userInfo[UIKeyboardFrameEndUserInfoKey] CGRectValue];
+    NSTimeInterval duration = [userInfo[UIKeyboardAnimationDurationUserInfoKey] doubleValue];
+    NSInteger curve = [userInfo[UIKeyboardAnimationCurveUserInfoKey] integerValue];
+    UIView *firstResponder = [self kb_findFirstResponderInView:self.view];
+    NSString *firstResponderInfo = firstResponder ? NSStringFromClass(firstResponder.class) : @"nil";
+    BOOL firstInComment = firstResponder ? [firstResponder isDescendantOfView:self.commentInputView] : NO;
+    BOOL firstInVoice = firstResponder ? [firstResponder isDescendantOfView:self.voiceInputBar] : NO;
+    NSLog(@"[KBAIHomeVC][Keyboard][%@] shouldHandle=%d textMode=%d voiceActive=%d fromAllowed=%d firstInComment=%d firstInVoice=%d firstResponder=%@ endFrame=%@ converted=%@ keyboardHeight=%.2f duration=%.2f curve=%ld viewWindow=%@",
+          notification.name,
+          shouldHandle,
+          self.isTextInputMode,
+          self.voiceInputKeyboardActive,
+          fromAllowedInput,
+          firstInComment,
+          firstInVoice,
+          firstResponderInfo,
+          NSStringFromCGRect(endFrame),
+          NSStringFromCGRect(convertedFrame),
+          keyboardHeight,
+          duration,
+          (long)curve,
+          self.view.window ? @"YES" : @"NO");
+}
+
 - (void)showPersonaSidebar {
     if (!self.sidebarView) {
         CGFloat width = KB_SCREEN_WIDTH * 0.7;
@@ -1221,6 +1412,11 @@ static NSString * const KBAISelectedPersonaIdKey = @"KBAISelectedPersonaId";
 
 - (void)dealloc {
     [[NSNotificationCenter defaultCenter] removeObserver:self];
+    CFNotificationCenterRemoveObserver(
+        CFNotificationCenterGetDarwinNotifyCenter(),
+        (__bridge const void *)(self),
+        (__bridge CFStringRef)kKBDarwinChatUpdated,
+        NULL);
 }
 
 @end

keyBoard/Class/AiTalk/VC/KBAiMainVC.h

@@ -1,17 +0,0 @@
-//
-//  KBAiMainVC.h
-//  keyBoard
-//
-//  Created by Mac on 2026/1/15.
-//
-
-#import <UIKit/UIKit.h>
-
-NS_ASSUME_NONNULL_BEGIN
-
-/// AI 语音陪伴聊天主界面
-@interface KBAiMainVC : BaseViewController
-
-@end
-
-NS_ASSUME_NONNULL_END

keyBoard/Class/AiTalk/VC/KBAiMainVC.m

@@ -1,809 +0,0 @@
-//
-//  KBAiMainVC.m
-//  keyBoard
-//
-//  Created by Mac on 2026/1/15.
-//
-
-#import "KBAiMainVC.h"
-#import "ConversationOrchestrator.h"
-#import "AiVM.h"
-#import "AudioSessionManager.h"
-#import "DeepgramStreamingManager.h"
-#import "KBAICommentView.h"
-#import "KBChatTableView.h"
-#import "KBAiRecordButton.h"
-#import "KBHUD.h"
-#import "KBChatLimitPopView.h"
-#import "KBPayMainVC.h"
-#import "LSTPopView.h"
-#import "VoiceChatStreamingManager.h"
-#import "KBUserSessionManager.h"
-#import <AVFoundation/AVFoundation.h>
-
-@interface KBAiMainVC () <KBAiRecordButtonDelegate,
-                           VoiceChatStreamingManagerDelegate,
-                           DeepgramStreamingManagerDelegate,
-                           AVAudioPlayerDelegate,
-                           KBChatLimitPopViewDelegate>
-@property(nonatomic, weak) LSTPopView *popView;
-@property(nonatomic, weak) LSTPopView *limitPopView;
-
-// UI
-@property(nonatomic, strong) KBChatTableView *chatView;
-@property(nonatomic, strong) KBAiRecordButton *recordButton;
-@property(nonatomic, strong) UILabel *statusLabel;
-@property(nonatomic, strong) UILabel *transcriptLabel;
-@property(nonatomic, strong) UIButton *commentButton;
-@property(nonatomic, strong) KBAICommentView *commentView;
-@property(nonatomic, strong) UIView *tabbarBackgroundView;
-@property(nonatomic, strong) UIVisualEffectView *blurEffectView;
-@property(nonatomic, strong) CAGradientLayer *gradientLayer;
-@property(nonatomic, strong) UIImageView *personImageView;
-
-// 核心模块
-@property(nonatomic, strong) ConversationOrchestrator *orchestrator;
-@property(nonatomic, strong) VoiceChatStreamingManager *streamingManager;
-@property(nonatomic, strong) DeepgramStreamingManager *deepgramManager;
-@property(nonatomic, strong) AiVM *aiVM;
-@property(nonatomic, strong) AVAudioPlayer *aiAudioPlayer;
-@property(nonatomic, strong) NSMutableData *voiceChatAudioBuffer;
-
-// 文本跟踪
-@property(nonatomic, strong) NSMutableString *assistantVisibleText;
-@property(nonatomic, strong) NSMutableString *deepgramFullText;
-
-// 日志节流
-@property(nonatomic, assign) NSTimeInterval lastRMSLogTime;
-
-@end
-
-@implementation KBAiMainVC
-
-#pragma mark - Lifecycle
-
-- (void)viewDidLoad {
-  [super viewDidLoad];
-
-  // 让视图延伸到屏幕边缘（包括状态栏和导航栏下方）
-  self.edgesForExtendedLayout = UIRectEdgeAll;
-  self.extendedLayoutIncludesOpaqueBars = YES;
-
-  [self setupUI];
-  [self setupOrchestrator];
-  [self setupStreamingManager];
-  [self setupDeepgramManager];
-}
-
-- (void)viewWillAppear:(BOOL)animated {
-  [super viewWillAppear:animated];
-  // TabBar 背景色由 BaseTabBarController 统一管理，这里不需要设置
-}
-
-- (void)viewWillDisappear:(BOOL)animated {
-  [super viewWillDisappear:animated];
-
-  // 页面消失时停止对话
-  [self.orchestrator stop];
-  [self.streamingManager disconnect];
-  [self.deepgramManager disconnect];
-}
-
-- (void)viewDidLayoutSubviews {
-  [super viewDidLayoutSubviews];
-
-  // 只更新 mask 的 frame（mask 已在 setupUI 中创建）
-  if (self.blurEffectView.layer.mask) {
-    self.blurEffectView.layer.mask.frame = self.blurEffectView.bounds;
-  }
-}
-
-#pragma mark - UI Setup
-
-- (void)setupUI {
-  self.view.backgroundColor = [UIColor whiteColor];
-  self.title = @"AI 助手";
-
-  // 安全区域
-  UILayoutGuide *safeArea = self.view.safeAreaLayoutGuide;
-
-  // PersonImageView（背景图，最底层）
-  self.personImageView =
-      [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"person_icon"]];
-  [self.view addSubview:self.personImageView];
-  [self.personImageView mas_makeConstraints:^(MASConstraintMaker *make) {
-    make.left.right.top.bottom.equalTo(self.view);
-  }];
-
-  // TabBar 毛玻璃模糊背景（在 personImageView 之上）
-  self.tabbarBackgroundView = [[UIView alloc] init];
-  self.tabbarBackgroundView.translatesAutoresizingMaskIntoConstraints = NO;
-  self.tabbarBackgroundView.clipsToBounds = YES;
-  [self.view addSubview:self.tabbarBackgroundView];
-
-  // 模糊效果
-  UIBlurEffect *blurEffect =
-      [UIBlurEffect effectWithStyle:UIBlurEffectStyleLight];
-  self.blurEffectView = [[UIVisualEffectView alloc] initWithEffect:blurEffect];
-  self.blurEffectView.translatesAutoresizingMaskIntoConstraints = NO;
-  [self.tabbarBackgroundView addSubview:self.blurEffectView];
-
-  // 为 blurEffectView 创建透明度渐变
-  // mask（从底部到中间不透明，从中间到顶部透明）
-  CAGradientLayer *maskLayer = [CAGradientLayer layer];
-  maskLayer.startPoint = CGPointMake(0.5, 1); // 底部
-  maskLayer.endPoint = CGPointMake(0.5, 0);   // 顶部
-  // 底部到中间保持不透明，从中间到顶部过渡透明
-  maskLayer.colors = @[
-    (__bridge id)[UIColor whiteColor].CGColor, // 底部：完全不透明
-    (__bridge id)[UIColor whiteColor].CGColor, // 中间：完全不透明
-    (__bridge id)[UIColor clearColor].CGColor  // 顶部：完全透明
-  ];
-  maskLayer.locations = @[ @(0.0), @(0.5), @(1.0) ];
-  self.blurEffectView.layer.mask = maskLayer;
-
-  // 状态标签
-  self.statusLabel = [[UILabel alloc] init];
-  self.statusLabel.text = @"按住按钮开始对话";
-  self.statusLabel.font = [UIFont systemFontOfSize:14];
-  self.statusLabel.textColor = [UIColor secondaryLabelColor];
-  self.statusLabel.textAlignment = NSTextAlignmentCenter;
-  self.statusLabel.translatesAutoresizingMaskIntoConstraints = NO;
-  [self.view addSubview:self.statusLabel];
-
-  // 转写文本标签
-  self.transcriptLabel = [[UILabel alloc] init];
-  self.transcriptLabel.text = @"";
-  self.transcriptLabel.font = [UIFont systemFontOfSize:16];
-  self.transcriptLabel.textColor = [UIColor labelColor];
-  self.transcriptLabel.numberOfLines = 0;
-  self.transcriptLabel.textAlignment = NSTextAlignmentRight;
-  self.transcriptLabel.translatesAutoresizingMaskIntoConstraints = NO;
-  [self.view addSubview:self.transcriptLabel];
-
-  // 聊天视图
-  self.chatView = [[KBChatTableView alloc] init];
-  self.chatView.backgroundColor = [UIColor clearColor];
-  self.chatView.translatesAutoresizingMaskIntoConstraints = NO;
-  [self.view addSubview:self.chatView];
-
-  // 录音按钮
-  self.recordButton = [[KBAiRecordButton alloc] init];
-  self.recordButton.delegate = self;
-  self.recordButton.translatesAutoresizingMaskIntoConstraints = NO;
-  [self.view addSubview:self.recordButton];
-
-  // 评论按钮（聊天视图右侧居中）
-  self.commentButton = [UIButton buttonWithType:UIButtonTypeCustom];
-  [self.commentButton setImage:[UIImage systemImageNamed:@"bubble.right.fill"]
-                      forState:UIControlStateNormal];
-  self.commentButton.tintColor = [UIColor whiteColor];
-  self.commentButton.backgroundColor = [UIColor systemBlueColor];
-  self.commentButton.layer.cornerRadius = 25;
-  self.commentButton.layer.shadowColor = [UIColor blackColor].CGColor;
-  self.commentButton.layer.shadowOffset = CGSizeMake(0, 2);
-  self.commentButton.layer.shadowOpacity = 0.3;
-  self.commentButton.layer.shadowRadius = 4;
-  self.commentButton.translatesAutoresizingMaskIntoConstraints = NO;
-  [self.commentButton addTarget:self
-                         action:@selector(showComment)
-               forControlEvents:UIControlEventTouchUpInside];
-  [self.view addSubview:self.commentButton];
-
-  // 布局约束 - 使用 Masonry
-  [self.tabbarBackgroundView mas_makeConstraints:^(MASConstraintMaker *make) {
-    make.left.right.bottom.equalTo(self.view);
-    make.height.mas_equalTo(KBFit(238));
-  }];
-
-  [self.blurEffectView mas_makeConstraints:^(MASConstraintMaker *make) {
-    make.edges.equalTo(self.tabbarBackgroundView);
-  }];
-
-  [self.statusLabel mas_makeConstraints:^(MASConstraintMaker *make) {
-    make.top.equalTo(self.view.mas_safeAreaLayoutGuideTop).offset(8);
-    make.left.equalTo(self.view).offset(16);
-    make.right.equalTo(self.view).offset(-16);
-    // 设置固定高度，避免内容变化导致布局跳动
-    make.height.mas_equalTo(20); // 单行文本高度
-  }];
-
-  [self.transcriptLabel mas_makeConstraints:^(MASConstraintMaker *make) {
-    make.top.equalTo(self.statusLabel.mas_bottom).offset(8);
-    make.left.equalTo(self.view).offset(16);
-    make.right.equalTo(self.view).offset(-16);
-    // 设置固定高度，避免内容变化导致布局跳动
-    make.height.mas_equalTo(60); // 根据实际需要调整高度
-  }];
-  // 设置内容压缩阻力，避免被压缩
-  [self.transcriptLabel setContentCompressionResistancePriority:UILayoutPriorityDefaultLow
-                                                        forAxis:UILayoutConstraintAxisVertical];
-
-  [self.chatView mas_makeConstraints:^(MASConstraintMaker *make) {
-    make.left.right.equalTo(self.view);
-    make.bottom.equalTo(self.tabbarBackgroundView.mas_top).offset(-8);
-    make.top.equalTo(self.transcriptLabel.mas_bottom).offset(8);
-    // 设置最小高度，避免被压缩为 0
-    make.height.greaterThanOrEqualTo(@100).priority(MASLayoutPriorityDefaultHigh);
-  }];
-  // chatView 应该尽可能占据空间
-  [self.chatView setContentCompressionResistancePriority:UILayoutPriorityRequired
-                                                  forAxis:UILayoutConstraintAxisVertical];
-
-  [self.recordButton mas_makeConstraints:^(MASConstraintMaker *make) {
-    make.left.equalTo(self.view.mas_safeAreaLayoutGuideLeft).offset(20);
-    make.right.equalTo(self.view.mas_safeAreaLayoutGuideRight).offset(-20);
-    make.bottom.equalTo(self.view.mas_safeAreaLayoutGuideBottom).offset(-16);
-    make.height.mas_equalTo(50);
-  }];
-
-  [self.commentButton mas_makeConstraints:^(MASConstraintMaker *make) {
-    make.right.equalTo(self.view.mas_safeAreaLayoutGuideRight).offset(-16);
-    make.centerY.equalTo(self.view);
-    make.width.height.mas_equalTo(50);
-  }];
-}
-
-#pragma mark - Orchestrator Setup
-
-- (void)setupOrchestrator {
-  self.orchestrator = [[ConversationOrchestrator alloc] init];
-
-  // 配置服务器地址
-  // 1. ASR 语音识别服务（WebSocket）
-  self.orchestrator.asrServerURL = @"ws://192.168.2.21:7529/ws/asr";
-
-  // 2. LLM 大语言模型服务（HTTP Stream）
-  self.orchestrator.llmServerURL = @"http://192.168.2.21:7529/api/chat/stream";
-
-  // 3. TTS 语音合成服务（HTTP）
-  self.orchestrator.ttsServerURL = @"http://192.168.2.21:7529/api/tts/stream";
-
-  __weak typeof(self) weakSelf = self;
-
-  // 状态变化回调
-  self.orchestrator.onStateChange = ^(ConversationState state) {
-    __strong typeof(weakSelf) strongSelf = weakSelf;
-    if (!strongSelf)
-      return;
-
-    [strongSelf updateStatusForState:state];
-  };
-
-  // 实时识别文本回调
-  self.orchestrator.onPartialText = ^(NSString *text) {
-    __strong typeof(weakSelf) strongSelf = weakSelf;
-    if (!strongSelf)
-      return;
-
-    strongSelf.statusLabel.text = text.length > 0 ? text : @"正在识别...";
-  };
-
-  // 用户最终文本回调
-  self.orchestrator.onUserFinalText = ^(NSString *text) {
-    __strong typeof(weakSelf) strongSelf = weakSelf;
-    if (!strongSelf)
-      return;
-
-    if (text.length > 0) {
-      [strongSelf.chatView addUserMessage:text];
-    }
-  };
-
-  // AI 可见文本回调（打字机效果）
-  self.orchestrator.onAssistantVisibleText = ^(NSString *text) {
-    __strong typeof(weakSelf) strongSelf = weakSelf;
-    if (!strongSelf)
-      return;
-
-    [strongSelf.chatView updateLastAssistantMessage:text];
-  };
-
-  // AI 完整回复回调
-  self.orchestrator.onAssistantFullText = ^(NSString *text) {
-    __strong typeof(weakSelf) strongSelf = weakSelf;
-    if (!strongSelf)
-      return;
-
-    [strongSelf.chatView updateLastAssistantMessage:text];
-    [strongSelf.chatView markLastAssistantMessageComplete];
-  };
-
-  // 音量更新回调
-  self.orchestrator.onVolumeUpdate = ^(float rms) {
-    __strong typeof(weakSelf) strongSelf = weakSelf;
-    if (!strongSelf)
-      return;
-
-    [strongSelf.recordButton updateVolumeRMS:rms];
-  };
-
-  // AI 开始说话
-  self.orchestrator.onSpeakingStart = ^{
-    __strong typeof(weakSelf) strongSelf = weakSelf;
-    if (!strongSelf)
-      return;
-
-    // 添加空的 AI 消息占位
-    [strongSelf.chatView addAssistantMessage:@"" audioDuration:0 audioData:nil];
-  };
-
-  // AI 说话结束
-  self.orchestrator.onSpeakingEnd = ^{
-    __strong typeof(weakSelf) strongSelf = weakSelf;
-    if (!strongSelf)
-      return;
-
-    [strongSelf.chatView markLastAssistantMessageComplete];
-  };
-
-  // 错误回调
-  self.orchestrator.onError = ^(NSError *error) {
-    __strong typeof(weakSelf) strongSelf = weakSelf;
-    if (!strongSelf)
-      return;
-
-    [strongSelf showError:error];
-  };
-}
-
-#pragma mark - Streaming Manager
-
-- (void)setupStreamingManager {
-  self.streamingManager = [[VoiceChatStreamingManager alloc] init];
-  self.streamingManager.delegate = self;
-  self.streamingManager.serverURL = @"ws://192.168.2.21:7529/api/ws/chat";
-  self.assistantVisibleText = [[NSMutableString alloc] init];
-  self.voiceChatAudioBuffer = [[NSMutableData alloc] init];
-  self.lastRMSLogTime = 0;
-}
-
-#pragma mark - Deepgram Manager
-
-- (void)setupDeepgramManager {
-  self.deepgramManager = [[DeepgramStreamingManager alloc] init];
-  self.deepgramManager.delegate = self;
-  self.deepgramManager.serverURL = @"wss://api.deepgram.com/v1/listen";
-  self.deepgramManager.apiKey = @"9c792eb63a65d644cbc95785155754cd1e84f8cf";
-  self.deepgramManager.language = @"en";
-  self.deepgramManager.model = @"nova-3";
-  self.deepgramManager.punctuate = YES;
-  self.deepgramManager.smartFormat = YES;
-  self.deepgramManager.interimResults = YES;
-  self.deepgramManager.encoding = @"linear16";
-  self.deepgramManager.sampleRate = 16000.0;
-  self.deepgramManager.channels = 1;
-  [self.deepgramManager prepareConnection];
-
-  self.deepgramFullText = [[NSMutableString alloc] init];
-  self.aiVM = [[AiVM alloc] init];
-}
-
-#pragma mark - 事件
-- (void)showComment {
-  CGFloat customViewHeight = KB_SCREEN_HEIGHT * (0.8);
-  KBAICommentView *customView = [[KBAICommentView alloc]
-      initWithFrame:CGRectMake(0, 0, KB_SCREEN_WIDTH, customViewHeight)];
-  LSTPopView *popView =
-      [LSTPopView initWithCustomView:customView
-                          parentView:nil
-                            popStyle:LSTPopStyleSmoothFromBottom
-                        dismissStyle:LSTDismissStyleSmoothToBottom];
-  self.popView = popView;
-  popView.priority = 1000;
-  popView.isAvoidKeyboard = false;
-  popView.hemStyle = LSTHemStyleBottom;
-  popView.dragStyle = LSTDragStyleY_Positive;
-  popView.dragDistance = customViewHeight * 0.5;
-  popView.sweepStyle = LSTSweepStyleY_Positive;
-  popView.swipeVelocity = 1600;
-  popView.sweepDismissStyle = LSTSweepDismissStyleSmooth;
-
-  [popView pop];
-}
-
-- (void)showCommentDirectly {
-  if (self.commentView.superview) {
-    [self.view bringSubviewToFront:self.commentView];
-    return;
-  }
-
-  CGFloat customViewHeight = KB_SCREEN_HEIGHT * (0.8);
-  KBAICommentView *customView =
-      [[KBAICommentView alloc] initWithFrame:CGRectZero];
-  customView.translatesAutoresizingMaskIntoConstraints = NO;
-  [self.view addSubview:customView];
-  [NSLayoutConstraint activateConstraints:@[
-    [customView.leadingAnchor constraintEqualToAnchor:self.view.leadingAnchor],
-    [customView.trailingAnchor
-        constraintEqualToAnchor:self.view.trailingAnchor],
-    [customView.bottomAnchor constraintEqualToAnchor:self.view.bottomAnchor],
-    [customView.heightAnchor constraintEqualToConstant:customViewHeight],
-  ]];
-  self.commentView = customView;
-}
-
-#pragma mark - 次数用尽弹窗
-
-- (void)showChatLimitPopWithMessage:(NSString *)message {
-  if (self.limitPopView) {
-    [self.limitPopView dismiss];
-  }
-
-  CGFloat width = 252.0;
-  CGFloat height = 252.0 + 18.0 + 53.0 + 18.0 + 28.0;
-  KBChatLimitPopView *content =
-      [[KBChatLimitPopView alloc] initWithFrame:CGRectMake(0, 0, width, height)];
-  content.message = message;
-  content.delegate = self;
-
-  LSTPopView *popView =
-      [LSTPopView initWithCustomView:content
-                          parentView:nil
-                            popStyle:LSTPopStyleFade
-                        dismissStyle:LSTDismissStyleFade];
-  popView.bgColor = [[UIColor blackColor] colorWithAlphaComponent:0.4];
-  popView.hemStyle = LSTHemStyleCenter;
-  popView.isClickBgDismiss = YES;
-  popView.isAvoidKeyboard = NO;
-  self.limitPopView = popView;
-  [popView pop];
-}
-
-#pragma mark - KBChatLimitPopViewDelegate
-
-- (void)chatLimitPopViewDidTapCancel:(KBChatLimitPopView *)view {
-  [self.limitPopView dismiss];
-}
-
-- (void)chatLimitPopViewDidTapRecharge:(KBChatLimitPopView *)view {
-  [self.limitPopView dismiss];
-  if (![KBUserSessionManager shared].isLoggedIn) {
-    [[KBUserSessionManager shared] goLoginVC];
-    return;
-  }
-  KBPayMainVC *vc = [[KBPayMainVC alloc] init];
-  vc.initialSelectedIndex = 1; // SVIP
-  [KB_CURRENT_NAV pushViewController:vc animated:true];
-}
-
-#pragma mark - UI Updates
-
-- (void)updateStatusForState:(ConversationState)state {
-  switch (state) {
-  case ConversationStateIdle:
-    self.statusLabel.text = @"按住按钮开始对话";
-    self.recordButton.state = KBAiRecordButtonStateNormal;
-    break;
-
-  case ConversationStateListening:
-    self.statusLabel.text = @"正在聆听...";
-    self.recordButton.state = KBAiRecordButtonStateRecording;
-    break;
-
-  case ConversationStateRecognizing:
-    self.statusLabel.text = @"正在识别...";
-    self.recordButton.state = KBAiRecordButtonStateNormal;
-    break;
-
-  case ConversationStateThinking:
-    self.statusLabel.text = @"AI 正在思考...";
-    self.recordButton.state = KBAiRecordButtonStateNormal;
-    break;
-
-  case ConversationStateSpeaking:
-    self.statusLabel.text = @"AI 正在回复...";
-    self.recordButton.state = KBAiRecordButtonStateNormal;
-    break;
-  }
-}
-
-- (void)showError:(NSError *)error {
-  UIAlertController *alert =
-      [UIAlertController alertControllerWithTitle:@"错误"
-                                          message:error.localizedDescription
-                                   preferredStyle:UIAlertControllerStyleAlert];
-  [alert addAction:[UIAlertAction actionWithTitle:@"确定"
-                                            style:UIAlertActionStyleDefault
-                                          handler:nil]];
-  [self presentViewController:alert animated:YES completion:nil];
-}
-
-#pragma mark - KBAiRecordButtonDelegate
-
-- (void)recordButtonDidBeginPress:(KBAiRecordButton *)button {
-  NSLog(@"[KBAiMainVC] Record button began press");
-  
-  // 停止正在播放的音频
-  [self.chatView stopPlayingAudio];
-  
-  NSString *token = [[KBUserSessionManager shared] accessToken] ?: @"";
-  if (token.length == 0) {
-    [[KBUserSessionManager shared] goLoginVC];
-    return;
-  }
-
-  self.statusLabel.text = @"正在连接...";
-  self.recordButton.state = KBAiRecordButtonStateRecording;
-  [self.deepgramFullText setString:@""];
-  self.transcriptLabel.text = @"";
-  [self.deepgramManager start];
-}
-
-- (void)recordButtonDidEndPress:(KBAiRecordButton *)button {
-  NSLog(@"[KBAiMainVC] Record button end press");
-  [self.deepgramManager stopAndFinalize];
-}
-
-- (void)recordButtonDidCancelPress:(KBAiRecordButton *)button {
-  NSLog(@"[KBAiMainVC] Record button cancel press");
-  [self.deepgramManager cancel];
-}
-
-#pragma mark - VoiceChatStreamingManagerDelegate
-
-- (void)voiceChatStreamingManagerDidConnect {
-  self.statusLabel.text = @"已连接，准备中...";
-}
-
-- (void)voiceChatStreamingManagerDidDisconnect:(NSError *_Nullable)error {
-  self.recordButton.state = KBAiRecordButtonStateNormal;
-  if (error) {
-    [self showError:error];
-  }
-}
-
-- (void)voiceChatStreamingManagerDidStartSession:(NSString *)sessionId {
-  self.statusLabel.text = @"正在聆听...";
-  self.recordButton.state = KBAiRecordButtonStateRecording;
-}
-
-- (void)voiceChatStreamingManagerDidStartTurn:(NSInteger)turnIndex {
-  self.statusLabel.text = @"正在聆听...";
-  self.recordButton.state = KBAiRecordButtonStateRecording;
-}
-
-- (void)voiceChatStreamingManagerDidReceiveEagerEndOfTurnWithTranscript:(NSString *)text
-                                                             confidence:(double)confidence {
-  self.statusLabel.text = @"准备响应...";
-}
-
-- (void)voiceChatStreamingManagerDidResumeTurn {
-  self.statusLabel.text = @"正在聆听...";
-}
-
-- (void)voiceChatStreamingManagerDidUpdateRMS:(float)rms {
-  [self.recordButton updateVolumeRMS:rms];
-  NSTimeInterval now = [[NSDate date] timeIntervalSince1970];
-  if (now - self.lastRMSLogTime >= 1.0) {
-    self.lastRMSLogTime = now;
-    NSLog(@"[KBAiMainVC] RMS: %.3f", rms);
-  }
-}
-
-- (void)voiceChatStreamingManagerDidReceiveInterimTranscript:(NSString *)text {
-  self.statusLabel.text = @"正在识别...";
-  if (text.length > 0) {
-    self.transcriptLabel.text = text;
-  }
-}
-
-- (void)voiceChatStreamingManagerDidReceiveFinalTranscript:(NSString *)text {
-  if (text.length > 0) {
-    self.transcriptLabel.text = @"";
-    [self.chatView addUserMessage:text];
-  }
-}
-
-- (void)voiceChatStreamingManagerDidReceiveLLMStart {
-  self.statusLabel.text = @"AI 正在思考...";
-  [self.assistantVisibleText setString:@""];
-  [self.chatView addAssistantMessage:@"" audioDuration:0 audioData:nil];
-  [self.voiceChatAudioBuffer setLength:0];
-}
-
-- (void)voiceChatStreamingManagerDidReceiveLLMToken:(NSString *)token {
-  if (token.length == 0) {
-    return;
-  }
-
-  [self.assistantVisibleText appendString:token];
-  [self.chatView updateLastAssistantMessage:self.assistantVisibleText];
-}
-
-- (void)voiceChatStreamingManagerDidReceiveAudioChunk:(NSData *)audioData {
-  if (audioData.length == 0) {
-    return;
-  }
-  [self.voiceChatAudioBuffer appendData:audioData];
-}
-
-- (void)voiceChatStreamingManagerDidCompleteWithTranscript:(NSString *)transcript
-                                                aiResponse:(NSString *)aiResponse {
-  NSString *finalText = aiResponse.length > 0 ? aiResponse : self.assistantVisibleText;
-  if (aiResponse.length > 0) {
-    [self.assistantVisibleText setString:aiResponse];
-  }
-  
-  // 计算音频时长
-  NSTimeInterval duration = 0;
-  if (self.voiceChatAudioBuffer.length > 0) {
-    NSError *error = nil;
-    AVAudioPlayer *player = [[AVAudioPlayer alloc] initWithData:self.voiceChatAudioBuffer
-                                                           error:&error];
-    if (!error && player) {
-      duration = player.duration;
-    }
-  }
-  
-  if (finalText.length > 0) {
-    [self.chatView updateLastAssistantMessage:finalText];
-    [self.chatView markLastAssistantMessageComplete];
-  } else if (transcript.length > 0) {
-    [self.chatView addAssistantMessage:transcript
-                         audioDuration:duration
-                             audioData:self.voiceChatAudioBuffer.length > 0 ? self.voiceChatAudioBuffer : nil];
-  }
-  
-  if (self.voiceChatAudioBuffer.length > 0) {
-    [self playAiAudioData:self.voiceChatAudioBuffer];
-    [self.voiceChatAudioBuffer setLength:0];
-  }
-  
-  self.recordButton.state = KBAiRecordButtonStateNormal;
-  self.statusLabel.text = @"完成";
-}
-
-- (void)voiceChatStreamingManagerDidFail:(NSError *)error {
-  self.recordButton.state = KBAiRecordButtonStateNormal;
-  [self showError:error];
-}
-
-#pragma mark - DeepgramStreamingManagerDelegate
-
-- (void)deepgramStreamingManagerDidConnect {
-  self.statusLabel.text = @"已连接，准备中...";
-}
-
-- (void)deepgramStreamingManagerDidDisconnect:(NSError *_Nullable)error {
-  self.recordButton.state = KBAiRecordButtonStateNormal;
-  if (error) {
-    [self showError:error];
-  }
-}
-
-- (void)deepgramStreamingManagerDidUpdateRMS:(float)rms {
-  [self.recordButton updateVolumeRMS:rms];
-  NSTimeInterval now = [[NSDate date] timeIntervalSince1970];
-  if (now - self.lastRMSLogTime >= 1.0) {
-    self.lastRMSLogTime = now;
-    NSLog(@"[KBAiMainVC] RMS: %.3f", rms);
-  }
-}
-
-- (void)deepgramStreamingManagerDidReceiveInterimTranscript:(NSString *)text {
-  self.statusLabel.text = @"正在识别...";
-  NSString *displayText = text ?: @"";
-  if (self.deepgramFullText.length > 0 && displayText.length > 0) {
-    displayText =
-        [NSString stringWithFormat:@"%@ %@", self.deepgramFullText, displayText];
-  } else if (self.deepgramFullText.length > 0) {
-    displayText = [self.deepgramFullText copy];
-  }
-  self.transcriptLabel.text = displayText;
-}
-
-- (void)deepgramStreamingManagerDidReceiveFinalTranscript:(NSString *)text {
-  if (text.length > 0) {
-    if (self.deepgramFullText.length > 0) {
-      [self.deepgramFullText appendString:@" "];
-    }
-    [self.deepgramFullText appendString:text];
-  }
-  self.transcriptLabel.text = self.deepgramFullText;
-  self.statusLabel.text = @"识别完成";
-  self.recordButton.state = KBAiRecordButtonStateNormal;
-
-  NSString *finalText = [self.deepgramFullText copy];
-  if (finalText.length == 0) {
-    return;
-  }
-
-  // 添加用户消息
-  [self.chatView addUserMessage:finalText];
-
-  __weak typeof(self) weakSelf = self;
-  [KBHUD showWithStatus:@"AI 思考中..."];
-  
-  // 请求 chat/message 接口
-  [self.aiVM requestChatMessageWithContent:finalText
-                               companionId:0
-                                 completion:^(KBAiMessageResponse *_Nullable response,
-                                              NSError *_Nullable error) {
-    __strong typeof(weakSelf) strongSelf = weakSelf;
-    if (!strongSelf) {
-      return;
-    }
-    
-    dispatch_async(dispatch_get_main_queue(), ^{
-      [KBHUD dismiss];
-      
-      if (error) {
-        [KBHUD showError:error.localizedDescription ?: @"请求失败"];
-        return;
-      }
-
-      if (response.code == 50030) {
-        NSString *message = response.message ?: @"";
-        [strongSelf showChatLimitPopWithMessage:message];
-        return;
-      }
-
-      if (!response || !response.data) {
-        NSString *message = response.message ?: @"AI 回复为空";
-        [KBHUD showError:message];
-        return;
-      }
-
-      // 获取 AI 回复文本
-      NSString *aiResponse = response.data.aiResponse ?: response.data.content ?: response.data.text ?: response.data.message ?: @"";
-      
-      if (aiResponse.length == 0) {
-        [KBHUD showError:@"AI 回复为空"];
-        return;
-      }
-
-      // 获取 audioId
-      NSString *audioId = response.data.audioId;
-      
-      // 添加 AI 消息（带 audioId）
-      [strongSelf.chatView addAssistantMessage:aiResponse
-                                       audioId:audioId];
-    });
-  }];
-}
-
-- (void)deepgramStreamingManagerDidFail:(NSError *)error {
-  self.recordButton.state = KBAiRecordButtonStateNormal;
-  [self showError:error];
-}
-
-#pragma mark - Audio Playback
-
-- (void)playAiAudioData:(NSData *)audioData {
-  if (audioData.length == 0) {
-    return;
-  }
-
-  NSError *sessionError = nil;
-  AudioSessionManager *audioSession = [AudioSessionManager sharedManager];
-  if (![audioSession configureForPlayback:&sessionError]) {
-    NSLog(@"[KBAiMainVC] Configure playback failed: %@",
-          sessionError.localizedDescription ?: @"");
-  }
-  if (![audioSession activateSession:&sessionError]) {
-    NSLog(@"[KBAiMainVC] Activate playback session failed: %@",
-          sessionError.localizedDescription ?: @"");
-  }
-
-  NSError *error = nil;
-  self.aiAudioPlayer = [[AVAudioPlayer alloc] initWithData:audioData
-                                                     error:&error];
-  if (error || !self.aiAudioPlayer) {
-    NSLog(@"[KBAiMainVC] Audio player init failed: %@",
-          error.localizedDescription ?: @"");
-    return;
-  }
-  self.aiAudioPlayer.delegate = self;
-  [self.aiAudioPlayer prepareToPlay];
-  [self.aiAudioPlayer play];
-}
-
-#pragma mark - AVAudioPlayerDelegate
-
-- (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player
-                       successfully:(BOOL)flag {
-  [[AudioSessionManager sharedManager] deactivateSession];
-}
-
-@end

keyBoard/Class/Common/V/KBHUD.m

@@ -17,6 +17,7 @@ static __weak MBProgressHUD *sHUD = nil;
 static KBHUDMaskType sMaskType = KBHUDMaskTypeClear;   // 全局默认遮罩
 static BOOL sDefaultTapToDismiss = NO;                  // 全局默认：不允许点击关闭
 static NSTimeInterval sAutoDismiss = 1.2;
+static NSTimeInterval sLoadingMaxDuration = 20.0;       // loading 最长展示时长，避免异常分支一直转圈
 static __weak UIView *sContainerView = nil;             // 缺省承载视图（扩展里必须设置）
 
 #pragma mark - Private Helpers
@@ -129,8 +130,27 @@ static __weak UIView *sContainerView = nil;             // 缺省承载视图（
     [self dismiss];
 }
 
++ (void)_kb_loadingTimeoutDismiss {
+    [self dismiss];
+}
+
++ (void)cancelLoadingAutoDismiss {
+    [NSObject cancelPreviousPerformRequestsWithTarget:self
+                                             selector:@selector(_kb_loadingTimeoutDismiss)
+                                               object:nil];
+}
+
++ (void)scheduleLoadingAutoDismiss {
+    [self cancelLoadingAutoDismiss];
+    if (sLoadingMaxDuration <= 0) { return; }
+    [self performSelector:@selector(_kb_loadingTimeoutDismiss)
+               withObject:nil
+               afterDelay:sLoadingMaxDuration];
+}
+
 + (void)_showText:(NSString *)text icon:(nullable UIImage *)icon {
     [self onMain:^{
+        [self cancelLoadingAutoDismiss];
         MBProgressHUD *loadingHUD = sHUD;
         if (loadingHUD) {
             [loadingHUD hideAnimated:YES];
@@ -177,6 +197,7 @@ static __weak UIView *sContainerView = nil;             // 缺省承载视图（
         if (!hud) { return; }
         hud.mode = MBProgressHUDModeIndeterminate;
         hud.label.text = status ?: @"";
+        [self scheduleLoadingAutoDismiss];
     }];
 }
 
@@ -191,6 +212,7 @@ static __weak UIView *sContainerView = nil;             // 缺省承载视图（
         hud.mode = MBProgressHUDModeDeterminate;
         hud.progress = progress;
         hud.label.text = status ?: @"";
+        [self scheduleLoadingAutoDismiss];
     }];
 }
 
@@ -205,9 +227,9 @@ static __weak UIView *sContainerView = nil;             // 缺省承载视图（
 
 + (void)showError:(NSString *)status { [self _showText:status ?: KBLocalized(@"Failed") icon:nil]; }
 
-+ (void)dismiss { [self onMain:^{ [sHUD hideAnimated:YES]; }]; }
++ (void)dismiss { [self onMain:^{ [self cancelLoadingAutoDismiss]; [sHUD hideAnimated:YES]; }]; }
 
-+ (void)dismissWithDelay:(NSTimeInterval)delay { [self onMain:^{ [sHUD hideAnimated:YES afterDelay:delay]; }]; }
++ (void)dismissWithDelay:(NSTimeInterval)delay { [self onMain:^{ [self cancelLoadingAutoDismiss]; [sHUD hideAnimated:YES afterDelay:delay]; }]; }
 
 #pragma mark - Config
 

keyBoard/Class/Manager/KBSkinService.m

@@ -103,7 +103,7 @@
         }
         NSString *message = nil;
         if (success) {
-            message = KBLocalized(@"已应用，切到键盘查看");
+            message = KBLocalized(@"Applied. Switch to the keyboard to view.");
         } else if ([error.domain isEqualToString:KBSkinBridgeErrorDomain] &&
                    error.code == KBSkinBridgeErrorContainerUnavailable) {
             message = KBLocalized(@"无法访问共享容器，应用皮肤失败");

keyBoard/Class/Me/VC/KBCancelAccountVC.h

@@ -0,0 +1,19 @@
+//
+//  KBCancelAccountVC.h
+//  keyBoard
+//
+//  注销账户页面
+//
+
+#import "BaseViewController.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface KBCancelAccountVC : BaseViewController
+
+/// 注销协议 HTML 内容（由外部传入或内部请求）
+@property (nonatomic, copy, nullable) NSString *htmlContent;
+
+@end
+
+NS_ASSUME_NONNULL_END

keyBoard/Class/Me/VC/KBCancelAccountVC.m

@@ -0,0 +1,142 @@
+//
+//  KBCancelAccountVC.m
+//  keyBoard
+//
+//  注销账户页面：顶部标题 + 中间 HTML 协议展示 + 底部注销按钮
+//
+
+#import "KBCancelAccountVC.h"
+#import <WebKit/WebKit.h>
+#import <Masonry/Masonry.h>
+#import "KBMyVM.h"
+#import "KBAlert.h"
+
+@interface KBCancelAccountVC ()
+
+@property (nonatomic, strong) UILabel *titleLabel;
+@property (nonatomic, strong) WKWebView *webView;
+@property (nonatomic, strong) UIButton *cancelAccountBtn;
+@property (nonatomic, strong) KBMyVM *myVM;
+
+@end
+
+@implementation KBCancelAccountVC
+
+- (void)viewDidLoad {
+    [super viewDidLoad];
+    self.kb_titleLabel.text = KBLocalized(@"Cancel Account");
+    self.view.backgroundColor = [UIColor colorWithHex:0xFFFFFF];
+
+    [self.view addSubview:self.titleLabel];
+    [self.view addSubview:self.webView];
+    [self.view addSubview:self.cancelAccountBtn];
+
+    [self.titleLabel mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.top.equalTo(self.view).offset(KB_NAV_TOTAL_HEIGHT + 20);
+        make.left.equalTo(self.view).offset(16);
+        make.right.equalTo(self.view).offset(-16);
+    }];
+
+    [self.cancelAccountBtn mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.left.equalTo(self.view).offset(16);
+        make.right.equalTo(self.view).offset(-16);
+        make.bottom.equalTo(self.view.mas_safeAreaLayoutGuideBottom).offset(-12);
+        make.height.mas_equalTo(56);
+    }];
+
+    [self.webView mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.top.equalTo(self.titleLabel.mas_bottom).offset(16);
+        make.left.equalTo(self.view).offset(16);
+        make.right.equalTo(self.view).offset(-16);
+        make.bottom.equalTo(self.cancelAccountBtn.mas_top).offset(-16);
+    }];
+
+    [self fetchAgreement];
+}
+
+- (void)fetchAgreement {
+    __weak typeof(self) weakSelf = self;
+    [self.myVM fetchCancelAccountWarningWithCompletion:^(NSString * _Nullable html, NSError * _Nullable error) {
+        if (html.length > 0) {
+            weakSelf.htmlContent = html;
+        }
+        [weakSelf loadHTMLContent];
+    }];
+}
+
+- (void)loadHTMLContent {
+    NSString *html = self.htmlContent ?: @"";
+    // 包裹一层基本样式，适配移动端
+    NSString *wrappedHTML = [NSString stringWithFormat:
+        @"<html><head>"
+        "<meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no'>"
+        "<style>"
+        "body { font-family: -apple-system, sans-serif; font-size: 15px; color: #333; "
+        "line-height: 1.6; padding: 0; margin: 0; word-wrap: break-word; }"
+        "</style></head><body>%@</body></html>", html];
+    [self.webView loadHTMLString:wrappedHTML baseURL:nil];
+}
+
+#pragma mark - Actions
+
+- (void)onTapCancelAccount {
+    [[KBMaiPointReporter sharedReporter] reportClickWithEventName:@"click_cancel_account_confirm_btn"
+                                                          pageId:@"cancel_account"
+                                                       elementId:@"cancel_account_confirm_btn"
+                                                           extra:nil
+                                                      completion:nil];
+    KBWeakSelf;
+    
+    [KBAlert confirmTitle:KBLocalized(@"Cancel Account") message:KBLocalized(@"After cancellation, your account will be deactivated and local login data will be cleared. Continue?") ok:KBLocalized(@"Confirm") cancel:KBLocalized(@"Cancel") completion:^(BOOL ok) {
+        if (!ok) { return; }
+        [weakSelf.myVM cancelAccountWithCompletion:nil];
+    }];
+}
+
+#pragma mark - Lazy
+
+- (UILabel *)titleLabel {
+    if (!_titleLabel) {
+        _titleLabel = [UILabel new];
+        _titleLabel.text = KBLocalized(@"Cancel Account Notice");
+        _titleLabel.textColor = [UIColor colorWithHex:KBBlackValue];
+        _titleLabel.font = [KBFont bold:20];
+        _titleLabel.numberOfLines = 0;
+    }
+    return _titleLabel;
+}
+
+- (WKWebView *)webView {
+    if (!_webView) {
+        WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];
+        _webView = [[WKWebView alloc] initWithFrame:CGRectZero configuration:config];
+        _webView.backgroundColor = UIColor.whiteColor;
+        _webView.scrollView.showsVerticalScrollIndicator = YES;
+        _webView.layer.cornerRadius = 12;
+        _webView.layer.masksToBounds = YES;
+    }
+    return _webView;
+}
+
+- (UIButton *)cancelAccountBtn {
+    if (!_cancelAccountBtn) {
+        _cancelAccountBtn = [UIButton buttonWithType:UIButtonTypeSystem];
+        [_cancelAccountBtn setTitle:KBLocalized(@"Confirm Cancel Account") forState:UIControlStateNormal];
+        [_cancelAccountBtn setTitleColor:UIColor.whiteColor forState:UIControlStateNormal];
+        _cancelAccountBtn.titleLabel.font = [KBFont medium:16];
+        _cancelAccountBtn.backgroundColor = [UIColor colorWithHex:0xFF0000];
+        _cancelAccountBtn.layer.cornerRadius = 12;
+        _cancelAccountBtn.layer.masksToBounds = YES;
+        [_cancelAccountBtn addTarget:self action:@selector(onTapCancelAccount) forControlEvents:UIControlEventTouchUpInside];
+    }
+    return _cancelAccountBtn;
+}
+
+- (KBMyVM *)myVM {
+    if (!_myVM) {
+        _myVM = [[KBMyVM alloc] init];
+    }
+    return _myVM;
+}
+
+@end

keyBoard/Class/Me/VC/KBPersonInfoVC.m

@@ -14,6 +14,8 @@
 #import "KBChangeNicknamePopView.h"
 #import "KBGenderPickerPopView.h"
 #import "KBMyVM.h"
+#import "KBAlert.h"
+#import "KBCancelAccountVC.h"
 @interface KBPersonInfoVC () <UITableViewDelegate, UITableViewDataSource, PHPickerViewControllerDelegate, UINavigationControllerDelegate, UIImagePickerControllerDelegate>
 
 // 列表
@@ -25,7 +27,7 @@
 @property (nonatomic, strong) UIButton *editBadge;       // 头像右下角的小铅笔
 @property (nonatomic, strong) UILabel *modifyLabel;      // “Modify” 文案
 
-// 底部退出按钮（固定在屏幕底部）
+// 底部退出登录按钮
 @property (nonatomic, strong) UIButton *logoutBtn;
 
 // 数据
@@ -64,7 +66,7 @@
     // 表头
     self.tableView.tableHeaderView = self.headerView;
 
-    // 底部退出按钮固定在屏幕底部
+    // 底部退出登录按钮
     [self.view addSubview:self.logoutBtn];
     [self.logoutBtn mas_makeConstraints:^(MASConstraintMaker *make) {
         make.left.equalTo(self.view).offset(16);
@@ -116,14 +118,18 @@
 
 #pragma mark - UITableView
 
-- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView { return 1; }
-- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section { return self.items.count; }
+- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView { return 2; }
+- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
+    return section == 0 ? self.items.count : 1;
+}
 
 - (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
     return 56.0;
 }
 
-- (CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section { return 12.0; }
+- (CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section {
+    return section == 0 ? 12.0 : 15.0;
+}
 - (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)section { return [UIView new]; }
 - (CGFloat)tableView:(UITableView *)tableView heightForFooterInSection:(NSInteger)section { return 0.01; }
 
@@ -131,19 +137,34 @@
     static NSString *cid = @"KBPersonInfoItemCell";
     KBPersonInfoItemCell *cell = [tableView dequeueReusableCellWithIdentifier:cid];
     if (!cell) { cell = [[KBPersonInfoItemCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:cid]; }
-    NSDictionary *it = self.items[indexPath.row];
-    BOOL isTop = (indexPath.row == 0);
-    BOOL isBottom = (indexPath.row == self.items.count - 1);
-    [cell configWithTitle:it[@"title"]
-                    value:it[@"value"]
-                showArrow:[it[@"arrow"] boolValue]
-                 showCopy:[it[@"copy"] boolValue]
-                    isTop:isTop
-                 isBottom:isBottom];
+
+    if (indexPath.section == 0) {
+        NSDictionary *it = self.items[indexPath.row];
+        BOOL isTop = (indexPath.row == 0);
+        BOOL isBottom = (indexPath.row == self.items.count - 1);
+        [cell configWithTitle:it[@"title"]
+                        value:it[@"value"]
+                    showArrow:[it[@"arrow"] boolValue]
+                     showCopy:[it[@"copy"] boolValue]
+                        isTop:isTop
+                     isBottom:isBottom];
+    } else {
+        [cell configWithTitle:KBLocalized(@"Cancel Account")
+                        value:@""
+                    showArrow:YES
+                     showCopy:NO
+                        isTop:YES
+                     isBottom:YES];
+    }
     return cell;
 }
 
 - (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
+    if (indexPath.section == 1) {
+        KBCancelAccountVC *vc = [[KBCancelAccountVC alloc] init];
+        [self.navigationController pushViewController:vc animated:YES];
+        return;
+    }
     if (indexPath.row == 0) {
         // 昵称编辑 -> 弹窗
         CGFloat width = KB_SCREEN_WIDTH;

keyBoard/Class/Me/VC/MySkinVC.m

@@ -14,6 +14,7 @@
 #import "KBMyVM.h"
 #import "KBMyTheme.h"
 #import "KBHUD.h"
+#import "KBSkinManager.h"
 
 static NSString * const kMySkinCellId = @"kMySkinCellId";
 
@@ -254,6 +255,25 @@ static NSString * const kMySkinCellId = @"kMySkinCellId";
     return cell;
 }
 
+- (BOOL)collectionView:(UICollectionView *)collectionView shouldSelectItemAtIndexPath:(NSIndexPath *)indexPath {
+    if (self.isEditingMode) {
+        KBMyTheme *theme = self.data[indexPath.item];
+        NSString *currentSkinId = [KBSkinManager shared].current.skinId;
+        // themeId 可能是 NSString 或 NSNumber，统一转字符串比较
+        NSString *themeIdStr = nil;
+        if ([theme.themeId isKindOfClass:[NSString class]]) {
+            themeIdStr = theme.themeId;
+        } else if ([theme.themeId respondsToSelector:@selector(stringValue)]) {
+            themeIdStr = [(id)theme.themeId stringValue];
+        }
+        if (currentSkinId.length > 0 && themeIdStr.length > 0 && [themeIdStr isEqualToString:currentSkinId]) {
+            [KBHUD showInfo:KBLocalized(@"The skin in use cannot be deleted")];
+            return NO;
+        }
+    }
+    return YES;
+}
+
 - (void)collectionView:(UICollectionView *)collectionView didSelectItemAtIndexPath:(NSIndexPath *)indexPath {
     if (!self.isEditingMode) {
         // 非编辑态：可在此进入详情，当前示例不处理

keyBoard/Class/Me/VC/MyVC.m

@@ -24,6 +24,7 @@
 @property (nonatomic, strong) NSArray<NSArray<NSDictionary *> *> *data; // 分组数据
 @property (nonatomic, strong) UIImageView *bgImageView;  // 全屏背景图
 @property (nonatomic, strong) KBMyVM *viewModel;         // 我的页面 VM
+@property (nonatomic, copy) NSString *customerMail;      // 客服邮箱
 @end
 
 @implementation MyVC
@@ -43,7 +44,7 @@
     // 数据源（title + SF Symbols 名称 + 色值），分两组 my_record_icon
     self.data = @[
         @[@{ @"title": KBLocalized(@"Consumption Record"), @"icon": @"my_record_icon", @"color": @(0x60A3FF),@"id":@"8" }],
-        @[@{ @"title": KBLocalized(@"Notice"), @"icon": @"my_notice_icon", @"color": @(0x60A3FF),@"id":@"1" }],
+//        @[@{ @"title": KBLocalized(@"Notice"), @"icon": @"my_notice_icon", @"color": @(0x60A3FF),@"id":@"1" }],
         @[@{ @"title": KBLocalized(@"invite"), @"icon": @"my_share_icon", @"color": @(0xF5A623),@"id":@"2"  }],
         @[@{ @"title": KBLocalized(@"Feedback"), @"icon": @"my_feedback_icon", @"color": @(0xB06AFD),@"id":@"3"  },
           @{ @"title": KBLocalized(@"E-mail"), @"icon": @"my_email_icon", @"color": @(0xFF8A65),@"id":@"4"  },
@@ -63,6 +64,11 @@
     self.header = [[KBMyHeaderView alloc] initWithFrame:CGRectMake(0, 0, KB_SCREEN_WIDTH, 357)];
     self.header.backgroundColor = UIColor.clearColor; // 透明，显示背景图
     self.tableView.tableHeaderView = self.header;
+
+    if (!self.viewModel) {
+        self.viewModel = [[KBMyVM alloc] init];
+    }
+    [self loadCustomerMailOnce];
 }
 
 - (void)viewWillAppear:(BOOL)animated {
@@ -81,6 +87,30 @@
 
 // 系统导航栏的显隐由 BaseViewController 统一处理（始终隐藏），此处无需再设置。
 
+/// 1：viewDidLoad 触发一次，预加载客服邮箱
+- (void)loadCustomerMailOnce {
+    __weak typeof(self) weakSelf = self;
+    [self.viewModel fetchCustomerMailWithCompletion:^(NSString * _Nullable customerMail, NSError * _Nullable error) {
+        if (error) { return; }
+        dispatch_async(dispatch_get_main_queue(), ^{
+            __strong typeof(weakSelf) self = weakSelf;
+            if (!self) { return; }
+            self.customerMail = customerMail;
+        });
+    }];
+}
+
+/// 2：点击 E-mail 复制邮箱并提示
+- (void)handleEmailCopy {
+    NSString *mail = [self.customerMail stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
+    if (mail.length == 0) {
+        [KBHUD showInfo:KBLocalized(@"Failed")];
+        return;
+    }
+    UIPasteboard.generalPasteboard.string = mail;
+    [KBHUD showInfo:KBLocalized(@"Email  Copy Success")];
+}
+
 #pragma mark - UITableView
 
 - (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView { return self.data.count; }
@@ -185,7 +215,7 @@
         [self.navigationController pushViewController:[KBFeedBackVC new] animated:true];
 
     }else if ([itemID isEqualToString:@"4"]){
-        
+        [self handleEmailCopy];
     }else if ([itemID isEqualToString:@"5"]){
         
     }else if ([itemID isEqualToString:@"6"]){

keyBoard/Class/Me/VM/KBMyVM.h

@@ -30,6 +30,9 @@ typedef void(^KBDeleteThemesCompletion)(BOOL success, NSError *_Nullable error);
 typedef void(^KBSubmitFeedbackCompletion)(BOOL success, NSError *_Nullable error);
 typedef void(^KBMyPurchaseRecordCompletion)(NSArray<KBConsumptionRecord *> *_Nullable records, NSError *_Nullable error);
 typedef void(^KBMyInviteCodeCompletion)(KBInviteCodeModel *_Nullable inviteCode, NSError *_Nullable error);
+typedef void(^KBMyCustomerMailCompletion)(NSString *_Nullable customerMail, NSError *_Nullable error);
+typedef void(^KBCancelAccountCompletion)(BOOL success, NSError *_Nullable error);
+typedef void(^KBCancelAccountAgreementCompletion)(NSString *_Nullable html, NSError *_Nullable error);
 
 @interface KBMyVM : NSObject
 
@@ -37,6 +40,8 @@ typedef void(^KBMyInviteCodeCompletion)(KBInviteCodeModel *_Nullable inviteCode,
 - (void)fetchUserDetailWithCompletion:(KBMyUserDetailCompletion)completion;
 /// 查询邀请码（/user/inviteCode）
 - (void)fetchInviteCodeWithCompletion:(KBMyInviteCodeCompletion)completion;
+/// 获取客服邮箱（/user/customerMail）
+- (void)fetchCustomerMailWithCompletion:(KBMyCustomerMailCompletion)completion;
 
 /// 用户人设列表（/character/listByUser）
 - (void)fetchCharacterListByUserWithCompletion:(KBCharacterListCompletion)completion;
@@ -74,6 +79,12 @@ typedef void(^KBMyInviteCodeCompletion)(KBInviteCodeModel *_Nullable inviteCode,
 
 /// 退出登录
 - (void)logout;
+
+/// 注销账号（/user/cancelAccount）
+- (void)cancelAccountWithCompletion:(KBCancelAccountCompletion)completion;
+
+/// 获取注销提示信息 HTML（GET /keyboardWarningMessage/byLocale）
+- (void)fetchCancelAccountWarningWithCompletion:(KBCancelAccountAgreementCompletion)completion;
 @end
 
 NS_ASSUME_NONNULL_END

keyBoard/Class/Me/VM/KBMyVM.m

@@ -83,6 +83,35 @@ NSString * const KBUserCharacterDeletedNotification = @"KBUserCharacterDeletedNo
     }];
 }
 
+- (void)fetchCustomerMailWithCompletion:(KBMyCustomerMailCompletion)completion {
+    [[KBNetworkManager shared] GET:API_USER_CUSTOMER_MAIL
+                        parameters:nil
+                           headers:nil
+              autoShowBusinessError:NO
+                        completion:^(NSDictionary *jsonOrData, NSURLResponse * _Nullable response, NSError * _Nullable error) {
+        if (error) {
+            if (completion) completion(nil, error);
+            return;
+        }
+
+        // 返回结构：{ "message":"ok", "data":"123@mail.com", "code":0 }
+        id dataObj = jsonOrData[@"data"];
+        NSString *customerMail = [dataObj isKindOfClass:[NSString class]]
+        ? [(NSString *)dataObj stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]]
+        : @"";
+
+        if (customerMail.length == 0) {
+            NSError *e = [NSError errorWithDomain:KBNetworkErrorDomain
+                                             code:KBNetworkErrorInvalidResponse
+                                         userInfo:@{NSLocalizedDescriptionKey: KBLocalized(@"Invalid response")}];
+            if (completion) completion(nil, e);
+            return;
+        }
+
+        if (completion) completion(customerMail, nil);
+    }];
+}
+
 - (void)fetchCharacterListByUserWithCompletion:(KBCharacterListCompletion)completion{
     [[KBNetworkManager shared] GET:KB_API_CHARACTER_LISTBYUSER
                         parameters:nil
@@ -428,18 +457,98 @@ NSString * const KBUserCharacterDeletedNotification = @"KBUserCharacterDeletedNo
 
         NSString *message = jsonOrData[KBMessage] ?: KBLocalized(@"Success");
         [KBHUD showSuccess:message];
-
-        // 本地会话退出
-        [[KBUserSessionManager shared] logout];
-
-        // 回到登录 / 主界面
-        dispatch_async(dispatch_get_main_queue(), ^{
-            id<UIApplicationDelegate> appDelegate = UIApplication.sharedApplication.delegate;
-            if ([appDelegate respondsToSelector:@selector(toMainTabbarVC)]) {
-                AppDelegate *delegate = (AppDelegate *)appDelegate;
-                [delegate toMainTabbarVC];
-            }
-        });
+        [self kb_clearLoginInfoAndRouteHome];
     }];
 }
+
+- (void)cancelAccountWithCompletion:(KBCancelAccountCompletion)completion {
+    [KBHUD show];
+    [[KBNetworkManager shared] POST:API_USER_CANCEL_ACCOUNT
+                           jsonBody:nil
+                            headers:nil
+               autoShowBusinessError:NO
+                          completion:^(NSDictionary *jsonOrData, NSURLResponse * _Nullable response, NSError * _Nullable error) {
+        [KBHUD dismiss];
+
+        if (error) {
+            NSString *msg = KBBizMessageFromJSONObject(jsonOrData) ?: error.localizedDescription ?: KBLocalized(@"Network error");
+            [KBHUD showInfo:msg];
+            if (completion) {
+                completion(NO, error);
+            }
+            return;
+        }
+
+        NSString *message = jsonOrData[KBMessage] ?: KBLocalized(@"Success");
+        [KBHUD showSuccess:message];
+
+        [self kb_clearLoginInfoAndRouteHome];
+        if (completion) {
+            completion(YES, nil);
+        }
+    }];
+}
+
+- (void)fetchCancelAccountWarningWithCompletion:(KBCancelAccountAgreementCompletion)completion {
+    KBLanguageCode langCode = [KBLocalizationManager shared].currentLanguageCode;
+    NSString *locale;
+    if ([langCode isEqualToString:KBLanguageCodeSimplifiedChinese]) {
+        locale = @"zh-CN";
+    } else {
+        locale = @"en-US";
+    }
+
+    [[KBNetworkManager shared] GET:API_CANCEL_ACCOUNT_WARNING
+                        parameters:@{@"locale": locale}
+                           headers:nil
+              autoShowBusinessError:NO
+                        completion:^(NSDictionary *jsonOrData, NSURLResponse * _Nullable response, NSError * _Nullable error) {
+        if (error) {
+            if (completion) completion(nil, error);
+            return;
+        }
+
+        id dataObj = jsonOrData[KBData];
+        NSString *html = @"";
+        if ([dataObj isKindOfClass:[NSDictionary class]]) {
+            id content = dataObj[@"content"];
+            if ([content isKindOfClass:[NSString class]]) {
+                html = (NSString *)content;
+            }
+        }
+        if (completion) completion(html, nil);
+    }];
+}
+
+#pragma mark - Private
+
+/// 清理本地登录态及关联缓存，并回到首页。
+- (void)kb_clearLoginInfoAndRouteHome {
+    [[KBUserSessionManager shared] logout];
+
+    NSUserDefaults *sharedDefaults = [[NSUserDefaults alloc] initWithSuiteName:AppGroup];
+    NSArray<NSString *> *sharedKeys = @[
+        AppGroup_MyKbJson,
+        AppGroup_UserAvatarURL,
+        AppGroup_SubscriptionPrefillPayload,
+        AppGroup_ChatUpdatedCompanionId,
+        @"AppGroup_SelectedPersona"
+    ];
+    for (NSString *key in sharedKeys) {
+        [sharedDefaults removeObjectForKey:key];
+    }
+    [sharedDefaults synchronize];
+
+    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
+    [defaults removeObjectForKey:@"KBAISelectedPersonaId"];
+    [defaults synchronize];
+
+    dispatch_async(dispatch_get_main_queue(), ^{
+        id<UIApplicationDelegate> appDelegate = UIApplication.sharedApplication.delegate;
+        if ([appDelegate respondsToSelector:@selector(toMainTabbarVC)]) {
+            AppDelegate *delegate = (AppDelegate *)appDelegate;
+            [delegate toMainTabbarVC];
+        }
+    });
+}
 @end

keyBoard/Class/Network/KBNetworkManager.m

@@ -33,29 +33,6 @@ NSErrorDomain const KBNetworkErrorDomain = @"com.company.keyboard.network";
 
 @implementation KBNetworkManager
 
-static NSString *KBSignStringFromObject(id obj) {
-    if (!obj || obj == (id)kCFNull) {
-        return nil;
-    }
-    if ([obj isKindOfClass:[NSString class]]) {
-        return (NSString *)obj;
-    }
-    if ([obj isKindOfClass:[NSNumber class]]) {
-        return [(NSNumber *)obj stringValue];
-    }
-    if ([obj isKindOfClass:[NSArray class]] || [obj isKindOfClass:[NSDictionary class]]) {
-        NSJSONWritingOptions options = 0;
-        if (@available(iOS 11.0, *)) {
-            options = NSJSONWritingSortedKeys;
-        }
-        NSData *data = [NSJSONSerialization dataWithJSONObject:obj options:options error:nil];
-        if (data.length > 0) {
-            return [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
-        }
-    }
-    return [obj description];
-}
-
 + (instancetype)shared {
     static KBNetworkManager *m; static dispatch_once_t onceToken; dispatch_once(&onceToken, ^{ m = [KBNetworkManager new]; });
     return m;
@@ -84,48 +61,12 @@ static NSString *KBSignStringFromObject(id obj) {
 }
 
 - (void)getSignWithParare:(NSDictionary *)bodyParams{
-   
-    NSString *appId    = @"loveKeyboard";
-    NSString *secret   = @"kZJM39HYvhxwbJkG1fmquQRVkQiLAh2H"; // 和服务端保持一致
-    NSString *timestamp = [KBSignUtils currentTimestamp];
-    NSString *nonce     = [KBSignUtils generateNonceWithLength:16];
-    // 1. 组装参与签名的所有参数
-    NSMutableDictionary<NSString *, NSString *> *signParams = [NSMutableDictionary dictionary];
-    signParams[@"appId"]     = appId;
-    signParams[@"timestamp"] = timestamp;
-    signParams[@"nonce"]     = nonce;
-    // 把 body 里的字段也加入签名参数
-    [bodyParams enumerateKeysAndObjectsUsingBlock:^(id key, id obj, BOOL *stop) {
-        NSString *value = KBSignStringFromObject(obj);
-        if (value.length == 0) {
-            return;
-        }
-        signParams[key] = value;
-    }];
-    NSString *signSource = [KBSignUtils signSourceStringWithParams:signParams secret:secret];
-    NSString *sign = [KBSignUtils signWithParams:signParams secret:secret];
-
-#if DEBUG
-    if (signSource.length > 0) {
-        NSString *secretPart = [NSString stringWithFormat:@"secret=%@", [KBSignUtils urlEncode:secret ?: @""]];
-        NSString *masked = [signSource stringByReplacingOccurrencesOfString:secretPart withString:@"secret=***"];
-        KBLOG(@"[KBNetwork] sign source: %@", masked);
-        KBLOG(@"[KBNetwork] sign value: %@", sign ?: @"");
-    }
-#endif
-
-    // 将签名相关字段合并进默认请求头
+    NSDictionary<NSString *, NSString *> *signHeaders = [KBSignUtils signHeadersWithBodyParams:bodyParams];
     NSMutableDictionary<NSString *, NSString *> *headers =
     [self.defaultHeaders mutableCopy] ?: [NSMutableDictionary dictionary];
-
-    if (sign.length > 0) {
-        headers[@"X-Sign"] = sign;
-    }
-    headers[@"X-App-Id"]    = appId;
-    headers[@"X-Timestamp"] = timestamp;
-    headers[@"X-Nonce"]     = nonce;
-
-    // 触发 copy 语义，确保对外仍是不可变字典
+    // 每次请求动态更新 Accept-Language，确保语言切换后生效
+    headers[@"Accept-Language"] = [KBLocalizationManager shared].currentLanguageCode ?: KBLanguageCodeEnglish;
+    [headers addEntriesFromDictionary:signHeaders ?: @{}];
     self.defaultHeaders = headers;
 }
 
@@ -448,6 +389,10 @@ autoShowBusinessError:YES
     self.manager.responseSerializer = [AFHTTPResponseSerializer serializer];
     NSURLSessionDataTask *task = [self.manager dataTaskWithRequest:req uploadProgress:nil downloadProgress:nil completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {
         NSLog(@"[KBNetworkManager] task finished, error = %@", error);
+        // 无论成功/失败，网络回包后统一兜底关闭 loading HUD，避免异常分支遗漏导致一直转圈。
+        dispatch_async(dispatch_get_main_queue(), ^{
+            [KBHUD dismiss];
+        });
         // AFN 默认对非 2xx 的状态码返回 error；这里先日志，再直接回调上层
         if (error) {
 #if DEBUG
@@ -555,6 +500,9 @@ autoShowBusinessError:YES
     self.manager.responseSerializer = [AFHTTPResponseSerializer serializer];
     NSURLSessionDataTask *task = [self.manager dataTaskWithRequest:req uploadProgress:nil downloadProgress:nil completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {
         NSLog(@"[KBNetworkManager] data task finished, error = %@", error);
+        dispatch_async(dispatch_get_main_queue(), ^{
+            [KBHUD dismiss];
+        });
         if (error) {
             if (completion) completion(nil, response, error);
             return;

keyBoard/Class/Pay/V/KBVipReviewListCell.m

@@ -27,12 +27,12 @@ static NSString * const kKBVipReviewItemCellId = @"kKBVipReviewItemCellId";
         
         // 模拟数据
         _data = @[
-            @{@"name":@"Sdsd666", @"text":@"I Highly Recommend This App. It Taught Me How To Chat"},
-            @{@"name":@"Joyce",   @"text":@"Great keyboard and AI features!"},
-            @{@"name":@"Luna",    @"text":@"Amazing app, love it."},
-            @{@"name":@"Mark",    @"text":@"Helps with chat and emotion."},
-            @{@"name":@"Alan",    @"text":@"Useful personalized keyboard."},
-            @{@"name":@"Coco",    @"text":@"Recommend to friends."},
+//            @{@"name":@"Sdsd666", @"text":@"I Highly Recommend This App. It Taught Me How To Chat"},
+//            @{@"name":@"Joyce",   @"text":@"Great keyboard and AI features!"},
+//            @{@"name":@"Luna",    @"text":@"Amazing app, love it."},
+//            @{@"name":@"Mark",    @"text":@"Helps with chat and emotion."},
+//            @{@"name":@"Alan",    @"text":@"Useful personalized keyboard."},
+//            @{@"name":@"Coco",    @"text":@"Recommend to friends."},
         ];
     }
     return self;

keyBoard/Class/Pay/VC/KBVipPay.m

@@ -396,7 +396,7 @@ static NSString * const kKBVipReviewListCellId = @"kKBVipReviewListCellId";
     if (indexPath.section == 1) {
         return CGSizeMake(w, KBFit(75 + 6));
     } else {
-        return CGSizeMake(w, 140);
+        return CGSizeMake(w, 0);
     }
 }
 

keyBoard/Class/Shop/VC/KBSkinDetailVC.m

@@ -313,7 +313,7 @@ typedef NS_ENUM(NSInteger, KBSkinDetailSection) {
     skin[@"force_download"] = @(YES);
     NSLog(@"⬇️[SkinDetail] download request id=%@ zip=%@ force=YES",
           skin[@"id"], skin[@"zip_url"]);
-    [KBHUD showWithStatus:@"正在下载..."];
+    [KBHUD showWithStatus:KBLocalized(@"Downloading...")];
     [[KBSkinService shared] applySkinWithJSON:skin
                            fromViewController:self
                                          mode:KBSkinSourceModeRemoteZip

keyBoard/Class/Shop/VM/KBShopVM.m

@@ -213,9 +213,11 @@
         return;
     }
     NSString *themeIdValue = [[self kb_themeIdParamFromString:themeId] description];
-    NSString *path = [NSString stringWithFormat:@"%@?themeId=%@", API_THEME_RESTORE, themeIdValue ?: @""];
-    [[KBNetworkManager shared] POST:path
-                           jsonBody:nil
+//    NSString *path = [NSString stringWithFormat:@"%@?themeId=%@", API_THEME_RESTORE, themeIdValue ?: @""];
+    NSDictionary *body = @{@"themeId": [self kb_themeIdParamFromString:themeId]};
+
+    [[KBNetworkManager shared] POST:API_THEME_RESTORE
+                           jsonBody:body
                             headers:nil
                autoShowBusinessError:NO
                           completion:^(NSDictionary * _Nullable json,

keyBoard/Info.plist

@@ -15,18 +15,12 @@
 			</array>
 		</dict>
 	</array>
-	<key>UIBackgroundModes</key>
-	<array>
-		<string>audio</string>
-	</array>
 	<key>NSAppTransportSecurity</key>
 	<dict>
 		<key>NSAllowsArbitraryLoads</key>
 		<true/>
 	</dict>
-	<key>UIBackgroundModes</key>
-	<array>
-		<string>audio</string>
-	</array>
+	<key>UIDesignRequiresCompatibility</key>
+	<true/>
 </dict>
 </plist>

keyBoard/PrivacyInfo.xcprivacy

@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>NSPrivacyTracking</key>
+	<false/>
+	<key>NSPrivacyTrackingDomains</key>
+	<array/>
+	<key>NSPrivacyCollectedDataTypes</key>
+	<array>
+		<dict>
+			<key>NSPrivacyCollectedDataType</key>
+			<string>NSPrivacyCollectedDataTypeEmailAddress</string>
+			<key>NSPrivacyCollectedDataTypeLinked</key>
+			<true/>
+			<key>NSPrivacyCollectedDataTypeTracking</key>
+			<false/>
+			<key>NSPrivacyCollectedDataTypePurposes</key>
+			<array>
+				<string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+			</array>
+		</dict>
+		<dict>
+			<key>NSPrivacyCollectedDataType</key>
+			<string>NSPrivacyCollectedDataTypeUserID</string>
+			<key>NSPrivacyCollectedDataTypeLinked</key>
+			<true/>
+			<key>NSPrivacyCollectedDataTypeTracking</key>
+			<false/>
+			<key>NSPrivacyCollectedDataTypePurposes</key>
+			<array>
+				<string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+			</array>
+		</dict>
+		<dict>
+			<key>NSPrivacyCollectedDataType</key>
+			<string>NSPrivacyCollectedDataTypeOtherUserContent</string>
+			<key>NSPrivacyCollectedDataTypeLinked</key>
+			<true/>
+			<key>NSPrivacyCollectedDataTypeTracking</key>
+			<false/>
+			<key>NSPrivacyCollectedDataTypePurposes</key>
+			<array>
+				<string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+			</array>
+		</dict>
+	</array>
+	<key>NSPrivacyAccessedAPITypes</key>
+	<array>
+		<dict>
+			<key>NSPrivacyAccessedAPIType</key>
+			<string>NSPrivacyAccessedAPICategoryUserDefaults</string>
+			<key>NSPrivacyAccessedAPITypeReasons</key>
+			<array>
+				<string>CA92.1</string>
+			</array>
+		</dict>
+		<dict>
+			<key>NSPrivacyAccessedAPIType</key>
+			<string>NSPrivacyAccessedAPICategoryActiveKeyboards</string>
+			<key>NSPrivacyAccessedAPITypeReasons</key>
+			<array>
+				<string>3EC4.1</string>
+			</array>
+		</dict>
+		<dict>
+			<key>NSPrivacyAccessedAPIType</key>
+			<string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
+			<key>NSPrivacyAccessedAPITypeReasons</key>
+			<array>
+				<string>C617.1</string>
+			</array>
+		</dict>
+	</array>
+</dict>
+</plist>