2

keyBoard/Class/Home/VM/KBHomeVM.h

@@ -0,0 +1,34 @@
+//
+//  KBHomeVM.h
+//  keyBoard
+//
+//  Created by Mac on 2025/12/3.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class KBCharacter;
+
+/// 首页排行榜回调
+typedef void(^KBHomeRankCompletion)(NSArray<KBCharacter *> * _Nullable list,
+                                    NSError * _Nullable error);
+
+@interface KBHomeVM : NSObject
+
+/// 最近一次成功请求到的排行榜数据
+@property (nonatomic, copy, readonly, nullable) NSArray<KBCharacter *> *rankList;
+
+/// 请求排行榜列表（GET /character/list）
+/// - Parameters:
+///   - params: 额外查询参数（可为空），例如分页、筛选 tag 等；
+///   - needShow: 是否在请求期间显示加载 HUD；
+///   - completion: 回调，list 为解析后的模型数组，error 非空表示失败。
+- (void)fetchRankListWithParams:(nullable NSDictionary *)params
+                       needShow:(BOOL)needShow
+                     completion:(KBHomeRankCompletion)completion;
+
+@end
+
+NS_ASSUME_NONNULL_END