Initial commit: suixinkan_ios UIKit rewrite project.

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

suixinkan_ios/Core/UIKit/ModuleViewControllerSupport.swift

@@ -0,0 +1,156 @@
+//
+//  ModuleViewControllerSupport.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/26.
+//
+
+import SnapKit
+import UIKit
+
+/// 通用双行列表 Cell，用于模块列表页展示标题、副标题和详情。
+final class TitleSubtitleTableViewCell: UITableViewCell {
+    static let reuseIdentifier = "TitleSubtitleTableViewCell"
+
+    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
+        super.init(style: .subtitle, reuseIdentifier: reuseIdentifier)
+        selectionStyle = .default
+        textLabel?.font = .systemFont(ofSize: 16, weight: .medium)
+        textLabel?.textColor = AppDesign.textPrimary
+        textLabel?.numberOfLines = 2
+        detailTextLabel?.font = .systemFont(ofSize: 13)
+        detailTextLabel?.textColor = AppDesign.textSecondary
+        detailTextLabel?.numberOfLines = 3
+    }
+
+    @available(*, unavailable)
+    required init?(coder: NSCoder) {
+        fatalError("init(coder:) has not been implemented")
+    }
+
+    func configure(title: String, subtitle: String? = nil, detail: String? = nil) {
+        textLabel?.text = title
+        if let subtitle, !subtitle.isEmpty {
+            detailTextLabel?.text = subtitle
+        } else {
+            detailTextLabel?.text = detail
+        }
+    }
+}
+
+/// 模块列表页基类，封装 UITableView、下拉刷新和 ViewModel onChange 绑定。
+@MainActor
+class ModuleTableViewController: UIViewController, UITableViewDataSource, UITableViewDelegate {
+    let services = AppServices.shared
+    let tableView = UITableView(frame: .zero, style: .insetGrouped)
+    private let refreshControl = UIRefreshControl()
+    private let activityIndicator = UIActivityIndicatorView(style: .medium)
+    private var viewModelReloadHandler: (() -> Void)?
+
+    var isLoading = false {
+        didSet {
+            if isLoading, tableView.numberOfSections > 0, tableView.numberOfRows(inSection: 0) == 0 {
+                activityIndicator.startAnimating()
+            } else {
+                activityIndicator.stopAnimating()
+            }
+        }
+    }
+
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        view.backgroundColor = UIColor(hex: 0xF5F7FA)
+        navigationItem.largeTitleDisplayMode = .never
+
+        tableView.dataSource = self
+        tableView.delegate = self
+        tableView.backgroundColor = .clear
+        tableView.register(
+            TitleSubtitleTableViewCell.self,
+            forCellReuseIdentifier: TitleSubtitleTableViewCell.reuseIdentifier
+        )
+        tableView.refreshControl = refreshControl
+        refreshControl.addTarget(self, action: #selector(handleRefresh), for: .valueChanged)
+
+        activityIndicator.hidesWhenStopped = true
+        view.addSubview(tableView)
+        view.addSubview(activityIndicator)
+        tableView.snp.makeConstraints { make in
+            make.edges.equalToSuperview()
+        }
+        activityIndicator.snp.makeConstraints { make in
+            make.center.equalToSuperview()
+        }
+
+        Task { await reloadContent() }
+    }
+
+    func bindViewModel(onChange: (() -> Void)?) {
+        viewModelReloadHandler = onChange
+    }
+
+    func reloadTable() {
+        tableView.reloadData()
+    }
+
+    func tableRowCount() -> Int { 0 }
+
+    func configureCell(_ cell: TitleSubtitleTableViewCell, at indexPath: IndexPath) {}
+
+    func didSelectTableRow(at indexPath: IndexPath) {}
+
+    func reloadContent() async {}
+
+    @objc private func handleRefresh() {
+        Task {
+            await reloadContent()
+            refreshControl.endRefreshing()
+        }
+    }
+
+    func numberOfSections(in tableView: UITableView) -> Int { 1 }
+
+    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
+        tableRowCount()
+    }
+
+    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
+        guard let cell = tableView.dequeueReusableCell(
+            withIdentifier: TitleSubtitleTableViewCell.reuseIdentifier,
+            for: indexPath
+        ) as? TitleSubtitleTableViewCell else {
+            return UITableViewCell()
+        }
+        configureCell(cell, at: indexPath)
+        return cell
+    }
+
+    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
+        tableView.deselectRow(at: indexPath, animated: true)
+        didSelectTableRow(at: indexPath)
+    }
+
+    func tableView(_ tableView: UITableView, willDisplay cell: UITableViewCell, forRowAt indexPath: IndexPath) {
+        willDisplayTableRow(at: indexPath)
+    }
+
+    func willDisplayTableRow(at indexPath: IndexPath) {}
+}
+
+extension ModuleTableViewController {
+    func wireViewModel(_ viewModel: AnyObject, reload: @escaping () -> Void) {
+        if let bindable = viewModel as? ViewModelBindable {
+            bindable.onChange = { [weak self] in
+                reload()
+                self?.reloadTable()
+            }
+        }
+        reload()
+    }
+}
+
+/// ViewModel 通用绑定协议。
+@MainActor
+protocol ViewModelBindable: AnyObject {
+    var onChange: (() -> Void)? { get set }
+}