1

keyBoard/Class/Home/VM/KBHomeVM.h

@@ -10,16 +10,24 @@
 NS_ASSUME_NONNULL_BEGIN
 
 @class KBCharacter;
+@class KBTag;
 
 /// 首页排行榜回调
 typedef void(^KBHomeRankCompletion)(NSArray<KBCharacter *> * _Nullable list,
                                     NSError * _Nullable error);
 
+/// 首页标签回调
+typedef void(^KBHomeTagCompletion)(NSArray<KBTag *> * _Nullable list,
+                                   NSError * _Nullable error);
+
 @interface KBHomeVM : NSObject
 
 /// 最近一次成功请求到的排行榜数据
 @property (nonatomic, copy, readonly, nullable) NSArray<KBCharacter *> *rankList;
 
+/// 最近一次成功请求到的标签数据
+@property (nonatomic, copy, readonly, nullable) NSArray<KBTag *> *tagList;
+
 /// 请求排行榜列表（GET /character/list）
 /// - Parameters:
 ///   - params: 额外查询参数（可为空），例如分页、筛选 tag 等；
@@ -29,6 +37,15 @@ typedef void(^KBHomeRankCompletion)(NSArray<KBCharacter *> * _Nullable list,
                        needShow:(BOOL)needShow
                      completion:(KBHomeRankCompletion)completion;
 
+/// 请求排行榜标签列表（GET /tag/list）
+/// - Parameters:
+///   - params: 额外查询参数（可为空）；
+///   - needShow: 是否在请求期间显示加载 HUD；
+///   - completion: 回调，list 为解析后的标签数组，error 非空表示失败。
+- (void)fetchTagListWithParams:(nullable NSDictionary *)params
+                      needShow:(BOOL)needShow
+                    completion:(KBHomeTagCompletion)completion;
+
 @end
 
 NS_ASSUME_NONNULL_END

keyBoard/Class/Home/VM/KBHomeVM.m

@@ -7,12 +7,14 @@
 
 #import "KBHomeVM.h"
 #import "KBCharacter.h"
+#import "KBTag.h"
 #import "KBNetworkManager.h"
 #import "KBHUD.h"
 #import "KBBizCode.h"
 
 @interface KBHomeVM ()
 @property (nonatomic, copy, readwrite, nullable) NSArray<KBCharacter *> *rankList;
+@property (nonatomic, copy, readwrite, nullable) NSArray<KBTag *> *tagList;
 @end
 
 @implementation KBHomeVM
@@ -65,4 +67,50 @@
     }];
 }
 
+- (void)fetchTagListWithParams:(nullable NSDictionary *)params
+                      needShow:(BOOL)needShow
+                    completion:(KBHomeTagCompletion)completion {
+    if (needShow) {
+        [KBHUD show];
+    }
+
+    [[KBNetworkManager shared] GET:KB_API_TAG_LIST
+                        parameters:params
+                           headers:nil
+              autoShowBusinessError:NO
+                        completion:^(NSDictionary * _Nullable json, NSURLResponse * _Nullable response, NSError * _Nullable error) {
+        if (needShow) {
+            [KBHUD dismiss];
+        }
+
+        if (error) {
+            NSString *msg = KBBizMessageFromJSONObject(json) ?: error.localizedDescription ?: KBLocalized(@"Network error");
+            [KBHUD showInfo:msg];
+            if (completion) {
+                completion(nil, error);
+            }
+            return;
+        }
+
+        id dataObj = json[KBData] ?: json[@"data"];
+        if (![dataObj isKindOfClass:[NSArray class]]) {
+            NSError *e = [NSError errorWithDomain:KBNetworkErrorDomain
+                                             code:KBNetworkErrorInvalidResponse
+                                         userInfo:@{NSLocalizedDescriptionKey: KBLocalized(@"Invalid response")}];
+            [KBHUD showInfo:e.localizedDescription];
+            if (completion) {
+                completion(nil, e);
+            }
+            return;
+        }
+
+        NSArray<KBTag *> *list = [KBTag mj_objectArrayWithKeyValuesArray:(NSArray *)dataObj];
+        self.tagList = list;
+
+        if (completion) {
+            completion(list, nil);
+        }
+    }];
+}
+
 @end