Advance UIKit rewrite with AMap integration and core UI modules.

Integrate高德 SDK with simulator-safe build flags, add map views for operating area and punch points, refactor main tabs and key feature screens to UIKit with Diffable lists, and document Swift concurrency defaults in AGENTS.md.

Co-authored-by: Cursor <cursoragent@cursor.com>

suixinkan_ios/Features/MessageCenter/Models/MessageCenterModels.swift

@@ -14,6 +14,7 @@ struct MessageListResponse: Decodable, Equatable {
     let lastId: Int
     let items: [MessageEntity]
 
+    /// 枚举，定义相关常量或状态。
     enum CodingKeys: String, CodingKey {
         case hasMore = "has_more"
         case lastId = "last_id"
@@ -47,6 +48,7 @@ struct MessageEntity: Decodable, Equatable, Identifiable {
     let createdAt: String
     let isRead: Bool
 
+    /// 枚举，定义相关常量或状态。
     enum CodingKeys: String, CodingKey {
         case id
         case type

suixinkan_ios/Features/MessageCenter/ViewControllers/MessageCenterViewController.swift

@@ -11,6 +11,7 @@ import UIKit
 final class MessageCenterViewController: ModuleTableViewController {
     private let viewModel = MessageCenterViewModel()
 
+    /// 视图加载完成后的 UI 初始化与数据绑定。
     override func viewDidLoad() {
         title = "消息中心"
         navigationItem.rightBarButtonItem = UIBarButtonItem(
@@ -23,10 +24,12 @@ final class MessageCenterViewController: ModuleTableViewController {
         wireViewModel(viewModel) { [weak self] in self?.updateBarButtons() }
     }
 
+    /// table行Count相关逻辑。
     override func tableRowCount() -> Int {
         viewModel.messages.count
     }
 
+    /// 配置Cell展示内容。
     override func configureCell(_ cell: TitleSubtitleTableViewCell, at indexPath: IndexPath) {
         let item = viewModel.messages[indexPath.row]
         cell.configure(
@@ -37,6 +40,7 @@ final class MessageCenterViewController: ModuleTableViewController {
         cell.accessoryType = item.isRead ? .none : .disclosureIndicator
     }
 
+    /// didSelectTableRow 回调处理。
     override func didSelectTableRow(at indexPath: IndexPath) {
         let item = viewModel.messages[indexPath.row]
         Task {
@@ -45,20 +49,24 @@ final class MessageCenterViewController: ModuleTableViewController {
         }
     }
 
+    /// 刷新Content。
     override func reloadContent() async {
         isLoading = viewModel.messages.isEmpty
         await viewModel.reloadFirstPage(api: services.messageCenterAPI)
         isLoading = false
     }
 
+    /// mark全部Read相关逻辑。
     @objc private func markAllRead() {
         Task { try? await viewModel.markAllAsRead(api: services.messageCenterAPI) }
     }
 
+    /// 更新BarButtons状态。
     private func updateBarButtons() {
         navigationItem.rightBarButtonItem?.isEnabled = viewModel.unreadCount > 0 && !viewModel.messages.isEmpty
     }
 
+    /// 展示Alert。
     private func showAlert(title: String, message: String) {
         let alert = UIAlertController(title: title, message: message, preferredStyle: .alert)
         alert.addAction(UIAlertAction(title: "知道了", style: .default))

suixinkan_ios/Features/MessageCenter/ViewModels/MessageCenterViewModel.swift

@@ -146,6 +146,7 @@ final class MessageCenterViewModel {
         }
     }
 
+    /// deduplicated并排序相关逻辑。
     private func deduplicatedAndSorted(_ source: [MessageItem]) -> [MessageItem] {
         var unique: [String: MessageItem] = [:]
         for item in source {
@@ -154,6 +155,7 @@ final class MessageCenterViewModel {
         return unique.values.sorted { $0.time > $1.time }
     }
 
+    /// 清空Messages。
     private func clearMessages() {
         messages = []
         hasMoreMessages = false