1

CustomKeyboard/View/KBChatMessageCell.h

@@ -0,0 +1,17 @@
+//
+//  KBChatMessageCell.h
+//  CustomKeyboard
+//
+
+#import <UIKit/UIKit.h>
+@class KBChatMessage;
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface KBChatMessageCell : UITableViewCell
+
+- (void)kb_configureWithMessage:(KBChatMessage *)message;
+
+@end
+
+NS_ASSUME_NONNULL_END

CustomKeyboard/View/KBChatMessageCell.m

@@ -0,0 +1,194 @@
+//
+//  KBChatMessageCell.m
+//  CustomKeyboard
+//
+
+#import "KBChatMessageCell.h"
+#import "KBChatMessage.h"
+#import "Masonry.h"
+
+@interface KBChatMessageCell ()
+@property (nonatomic, strong) UIImageView *avatarView;
+@property (nonatomic, strong) UILabel *nameLabel;
+@property (nonatomic, strong) UIView *bubbleView;
+@property (nonatomic, strong) UILabel *messageLabel;
+@property (nonatomic, strong) UIImageView *audioIconView;
+@property (nonatomic, strong) UILabel *audioLabel;
+@end
+
+@implementation KBChatMessageCell
+
+- (instancetype)initWithStyle:(UITableViewCellStyle)style reuseIdentifier:(NSString *)reuseIdentifier {
+    if (self = [super initWithStyle:style reuseIdentifier:reuseIdentifier]) {
+        self.backgroundColor = [UIColor clearColor];
+        self.selectionStyle = UITableViewCellSelectionStyleNone;
+
+        [self.contentView addSubview:self.avatarView];
+        [self.contentView addSubview:self.nameLabel];
+        [self.contentView addSubview:self.bubbleView];
+        [self.bubbleView addSubview:self.messageLabel];
+        [self.bubbleView addSubview:self.audioIconView];
+        [self.bubbleView addSubview:self.audioLabel];
+    }
+    return self;
+}
+
+- (void)kb_configureWithMessage:(KBChatMessage *)message {
+    BOOL outgoing = message.outgoing;
+    BOOL audioMessage = (!outgoing && message.audioFilePath.length > 0);
+    UIColor *bubbleColor = outgoing ? [UIColor colorWithHex:0x02BEAC] : [UIColor colorWithWhite:1 alpha:0.95];
+    UIColor *textColor = outgoing ? [UIColor whiteColor] : [UIColor colorWithHex:0x1B1F1A];
+
+    self.bubbleView.backgroundColor = bubbleColor;
+    self.messageLabel.textColor = textColor;
+    self.audioLabel.textColor = textColor;
+    self.audioIconView.tintColor = textColor;
+    self.messageLabel.text = message.text ?: @"";
+    self.audioLabel.text =
+        (message.text.length > 0) ? message.text : KBLocalized(@"语音回复");
+    self.messageLabel.hidden = audioMessage;
+    self.audioIconView.hidden = !audioMessage;
+    self.audioLabel.hidden = !audioMessage;
+
+    UIImage *avatarImage = message.avatarImage;
+    if (!avatarImage) {
+        avatarImage = [self kb_defaultAvatarImage];
+    }
+    self.avatarView.image = avatarImage;
+    self.avatarView.backgroundColor =
+        avatarImage ? [UIColor clearColor] : [UIColor colorWithWhite:0.9 alpha:1.0];
+    self.nameLabel.hidden = outgoing;
+    self.nameLabel.text =
+        (message.displayName.length > 0) ? message.displayName : KBLocalized(@"AI助手");
+
+    CGFloat avatarSize = 28.0;
+    [self.avatarView mas_remakeConstraints:^(MASConstraintMaker *make) {
+        make.width.height.mas_equalTo(avatarSize);
+        make.top.equalTo(self.contentView.mas_top).offset(6);
+        if (outgoing) {
+            make.right.equalTo(self.contentView.mas_right).offset(-8);
+        } else {
+            make.left.equalTo(self.contentView.mas_left).offset(8);
+        }
+    }];
+
+    if (outgoing) {
+        [self.nameLabel mas_remakeConstraints:^(MASConstraintMaker *make) {
+            make.top.equalTo(self.contentView.mas_top).offset(0);
+            make.left.equalTo(self.contentView.mas_left);
+        }];
+    } else {
+        [self.nameLabel mas_remakeConstraints:^(MASConstraintMaker *make) {
+            make.left.equalTo(self.avatarView.mas_right).offset(6);
+            make.top.equalTo(self.contentView.mas_top).offset(2);
+            make.right.lessThanOrEqualTo(self.contentView.mas_right).offset(-12);
+        }];
+    }
+
+    [self.bubbleView mas_remakeConstraints:^(MASConstraintMaker *make) {
+        make.width.lessThanOrEqualTo(self.contentView.mas_width).multipliedBy(0.65);
+        if (outgoing) {
+            make.top.equalTo(self.contentView.mas_top).offset(6);
+            make.bottom.equalTo(self.contentView.mas_bottom).offset(-6);
+            make.right.equalTo(self.avatarView.mas_left).offset(-6);
+        } else {
+            make.top.equalTo(self.nameLabel.mas_bottom).offset(2);
+            make.bottom.equalTo(self.contentView.mas_bottom).offset(-6);
+            make.left.equalTo(self.avatarView.mas_right).offset(6);
+            make.right.lessThanOrEqualTo(self.contentView.mas_right).offset(-12);
+        }
+    }];
+
+    if (audioMessage) {
+        [self.audioIconView mas_remakeConstraints:^(MASConstraintMaker *make) {
+            make.left.equalTo(self.bubbleView.mas_left).offset(10);
+            make.centerY.equalTo(self.bubbleView);
+            make.width.height.mas_equalTo(16);
+        }];
+        [self.audioLabel mas_remakeConstraints:^(MASConstraintMaker *make) {
+            make.left.equalTo(self.audioIconView.mas_right).offset(6);
+            make.centerY.equalTo(self.bubbleView);
+            make.right.equalTo(self.bubbleView.mas_right).offset(-10);
+            make.top.greaterThanOrEqualTo(self.bubbleView.mas_top).offset(8);
+            make.bottom.lessThanOrEqualTo(self.bubbleView.mas_bottom).offset(-8);
+        }];
+    } else {
+        [self.messageLabel mas_remakeConstraints:^(MASConstraintMaker *make) {
+            make.edges.equalTo(self.bubbleView).insets(UIEdgeInsetsMake(8, 10, 8, 10));
+        }];
+    }
+}
+
+#pragma mark - Lazy
+
+- (UIImageView *)avatarView {
+    if (!_avatarView) {
+        _avatarView = [[UIImageView alloc] init];
+        _avatarView.contentMode = UIViewContentModeScaleAspectFill;
+        _avatarView.layer.cornerRadius = 14;
+        _avatarView.layer.masksToBounds = YES;
+        _avatarView.backgroundColor = [UIColor colorWithWhite:0.9 alpha:1.0];
+        _avatarView.tintColor = [UIColor colorWithHex:0xB9BDC8];
+    }
+    return _avatarView;
+}
+
+- (UILabel *)nameLabel {
+    if (!_nameLabel) {
+        _nameLabel = [[UILabel alloc] init];
+        _nameLabel.font = [UIFont systemFontOfSize:11];
+        _nameLabel.textColor = [UIColor colorWithHex:0x6B6F7A];
+        _nameLabel.numberOfLines = 1;
+    }
+    return _nameLabel;
+}
+
+- (UIView *)bubbleView {
+    if (!_bubbleView) {
+        _bubbleView = [[UIView alloc] init];
+        _bubbleView.layer.cornerRadius = 12;
+        _bubbleView.layer.masksToBounds = YES;
+    }
+    return _bubbleView;
+}
+
+- (UILabel *)messageLabel {
+    if (!_messageLabel) {
+        _messageLabel = [[UILabel alloc] init];
+        _messageLabel.font = [UIFont systemFontOfSize:14];
+        _messageLabel.numberOfLines = 0;
+    }
+    return _messageLabel;
+}
+
+- (UIImageView *)audioIconView {
+    if (!_audioIconView) {
+        _audioIconView = [[UIImageView alloc] init];
+        _audioIconView.contentMode = UIViewContentModeScaleAspectFit;
+        _audioIconView.tintColor = [UIColor colorWithHex:0x1B1F1A];
+        UIImage *icon = nil;
+        if (@available(iOS 13.0, *)) {
+            icon = [UIImage systemImageNamed:@"waveform"];
+        }
+        _audioIconView.image = icon;
+    }
+    return _audioIconView;
+}
+
+- (UILabel *)audioLabel {
+    if (!_audioLabel) {
+        _audioLabel = [[UILabel alloc] init];
+        _audioLabel.font = [UIFont systemFontOfSize:14 weight:UIFontWeightMedium];
+        _audioLabel.numberOfLines = 1;
+    }
+    return _audioLabel;
+}
+
+- (UIImage *)kb_defaultAvatarImage {
+    if (@available(iOS 13.0, *)) {
+        return [UIImage systemImageNamed:@"person.circle.fill"];
+    }
+    return nil;
+}
+
+@end

CustomKeyboard/View/KBChatPanelView.h

@@ -0,0 +1,27 @@
+//
+//  KBChatPanelView.h
+//  CustomKeyboard
+//
+
+#import <UIKit/UIKit.h>
+@class KBChatPanelView, KBChatMessage;
+
+NS_ASSUME_NONNULL_BEGIN
+
+@protocol KBChatPanelViewDelegate <NSObject>
+@optional
+- (void)chatPanelView:(KBChatPanelView *)view didSendText:(NSString *)text;
+- (void)chatPanelView:(KBChatPanelView *)view didTapMessage:(KBChatMessage *)message;
+@end
+
+@interface KBChatPanelView : UIView
+
+@property (nonatomic, weak) id<KBChatPanelViewDelegate> delegate;
+
+@property (nonatomic, strong, readonly) UITableView *tableView;
+
+- (void)kb_reloadWithMessages:(NSArray<KBChatMessage *> *)messages;
+
+@end
+
+NS_ASSUME_NONNULL_END

CustomKeyboard/View/KBChatPanelView.m

@@ -0,0 +1,97 @@
+//
+//  KBChatPanelView.m
+//  CustomKeyboard
+//
+
+#import "KBChatPanelView.h"
+#import "KBChatMessage.h"
+#import "KBChatMessageCell.h"
+#import "Masonry.h"
+
+@interface KBChatPanelView () <UITableViewDataSource, UITableViewDelegate>
+@property (nonatomic, strong) UITableView *tableViewInternal;
+@property (nonatomic, copy) NSArray<KBChatMessage *> *messages;
+@end
+
+@implementation KBChatPanelView
+
+- (instancetype)initWithFrame:(CGRect)frame {
+    if (self = [super initWithFrame:frame]) {
+        self.backgroundColor = [UIColor colorWithHex:0xD1D3DB];
+
+        [self addSubview:self.tableViewInternal];
+
+        [self.tableViewInternal mas_makeConstraints:^(MASConstraintMaker *make) {
+            make.left.right.equalTo(self);
+            make.top.equalTo(self.mas_top).offset(8);
+            make.bottom.equalTo(self.mas_bottom).offset(-8);
+        }];
+    }
+    return self;
+}
+
+#pragma mark - Public
+
+- (void)kb_reloadWithMessages:(NSArray<KBChatMessage *> *)messages {
+    self.messages = messages ?: @[];
+    [self.tableViewInternal reloadData];
+    if (self.messages.count > 0) {
+        NSIndexPath *indexPath = [NSIndexPath indexPathForRow:self.messages.count - 1 inSection:0];
+        [self.tableViewInternal scrollToRowAtIndexPath:indexPath
+                                      atScrollPosition:UITableViewScrollPositionBottom
+                                              animated:YES];
+    }
+}
+
+#pragma mark - UITableViewDataSource
+
+- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
+    return self.messages.count;
+}
+
+- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
+    KBChatMessageCell *cell = [tableView dequeueReusableCellWithIdentifier:NSStringFromClass(KBChatMessageCell.class)];
+    KBChatMessage *msg = self.messages[indexPath.row];
+    [cell kb_configureWithMessage:msg];
+    return cell;
+}
+
+#pragma mark - UITableViewDelegate
+
+- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
+    return UITableViewAutomaticDimension;
+}
+
+- (CGFloat)tableView:(UITableView *)tableView estimatedHeightForRowAtIndexPath:(NSIndexPath *)indexPath {
+    return 44.0;
+}
+
+- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
+    if (indexPath.row >= self.messages.count) { return; }
+    KBChatMessage *msg = self.messages[indexPath.row];
+    if ([self.delegate respondsToSelector:@selector(chatPanelView:didTapMessage:)]) {
+        [self.delegate chatPanelView:self didTapMessage:msg];
+    }
+}
+
+#pragma mark - Lazy
+
+- (UITableView *)tableViewInternal {
+    if (!_tableViewInternal) {
+        _tableViewInternal = [[UITableView alloc] initWithFrame:CGRectZero style:UITableViewStylePlain];
+        _tableViewInternal.backgroundColor = [UIColor clearColor];
+        _tableViewInternal.separatorStyle = UITableViewCellSeparatorStyleNone;
+        _tableViewInternal.dataSource = self;
+        _tableViewInternal.delegate = self;
+        _tableViewInternal.estimatedRowHeight = 44.0;
+        _tableViewInternal.rowHeight = UITableViewAutomaticDimension;
+        [_tableViewInternal registerClass:KBChatMessageCell.class forCellReuseIdentifier:NSStringFromClass(KBChatMessageCell.class)];
+    }
+    return _tableViewInternal;
+}
+
+#pragma mark - Expose
+
+- (UITableView *)tableView { return self.tableViewInternal; }
+
+@end

CustomKeyboard/View/KBToolBar.h

@@ -26,7 +26,7 @@ NS_ASSUME_NONNULL_BEGIN
 
 @property (nonatomic, weak, nullable) id<KBToolBarDelegate> delegate;
 
-/// 左侧按钮的标题（数量由数组决定）。默认值：@[@"AI"]。
+/// 左侧按钮的标题（数量由数组决定）。默认值：@[@"AI", @"语音"]。
 @property (nonatomic, copy) NSArray<NSString *> *leftButtonTitles;
 
 /// 暴露按钮以便外部定制（只读；首次访问时懒加载创建）

CustomKeyboard/View/KBToolBar.m

@@ -26,11 +26,12 @@ static NSString * const kKBAIKeyIdentifier = @"ai";
 static NSString * const kKBUndoKeyIdentifier = @"key_revoke";
 static const CGFloat kKBAIButtonWidth = 40;
 static const CGFloat kKBAIButtonHeight = 40;
+static const NSInteger kKBVoiceButtonIndex = 1;
 
 - (instancetype)initWithFrame:(CGRect)frame{
     if (self = [super initWithFrame:frame]) {
         self.backgroundColor = [UIColor clearColor];
-        _leftButtonTitles = @[@"AI"]; // 默认标题
+        _leftButtonTitles = @[@"AI", KBLocalized(@"语音")]; // 默认标题
         [self setupUI];
         [[NSNotificationCenter defaultCenter] addObserver:self
                                                  selector:@selector(kb_undoStateChanged)
@@ -68,6 +69,7 @@ static const CGFloat kKBAIButtonHeight = 40;
         }
     }];
     [self kb_updateAIButtonAppearance];
+    [self kb_updateVoiceButtonAppearance];
 }
 
 #pragma mark - 视图搭建
@@ -171,6 +173,7 @@ static const CGFloat kKBAIButtonHeight = 40;
 
 - (void)kb_applyTheme {
     [self kb_updateAIButtonAppearance];
+    [self kb_updateVoiceButtonAppearance];
     [self kb_updateUndoButtonAppearance];
 }
 
@@ -208,6 +211,16 @@ static const CGFloat kKBAIButtonHeight = 40;
     }
 }
 
+- (void)kb_updateVoiceButtonAppearance {
+    UIButton *voiceButton = [self kb_voiceButton];
+    if (!voiceButton) { return; }
+
+    voiceButton.backgroundColor = [UIColor colorWithHex:0xE53935];
+    [voiceButton setTitleColor:[UIColor whiteColor] forState:UIControlStateNormal];
+    voiceButton.layer.cornerRadius = 16;
+    voiceButton.layer.masksToBounds = YES;
+}
+
 - (void)kb_updateUndoButtonAppearance {
     if (!self.undoButtonInternal) { return; }
 
@@ -306,6 +319,11 @@ static const CGFloat kKBAIButtonHeight = 40;
     return self.leftButtonsInternal[0];
 }
 
+- (UIButton *)kb_voiceButton {
+    if (self.leftButtonsInternal.count <= kKBVoiceButtonIndex) { return nil; }
+    return self.leftButtonsInternal[kKBVoiceButtonIndex];
+}
+
 #pragma mark - Globe (Input Mode Switch)
 
 // 根据宿主是否已提供系统切换键，决定是否显示地球按钮；并绑定系统事件。