用途：在 Swift 项目中生成生产级分页基础设施，支持偏移量（页码+页大小）与游标（不透明游标令牌）两种 API 模式，并可搭配无限滚动视图、状态机管理与可选搜索。激活场景：用户要求“加分页”“让列表分页”“无限滚动”“加载更多”“游标分页”“偏移分页”“分页 API”“带分页的搜索”时启用。
主要能力：生成通用响应模型 PaginatedResponse.swift、状态机 PaginationState.swift（idle、loading、loaded、error、exhausted）、数据源协议 PaginatedDataSource.swift、@Observable 管理器 PaginationManager.swift；可选生成 SearchablePaginationManager.swift、Views/PaginatedList.swift（无限滚动包装）、Views/LoadMoreButton.swift（手动加载更多）、Views/PaginationStateView.swift（空/加载/错误状态视图）。
使用方式：生成前会检测项目上下文（要求 Swift 5.9+，@Observable 需 iOS 17+/macOS 14+）、现有网络层与已有分页实现，冲突时询问替换或扩展；随后通过配置问题确定分页风格、加载触发方式（无限滚动、手动按钮或两者兼有）、附加功能（搜索、下拉刷新、状态视图）与数据源模式（通用 Codable 或按端点定义协议）。文件按项目结构放入 Sources/Pagination/、App/Pagination/ 或 Pagination/。之后需自行定义符合 PaginatedDataSource 的数据源、在视图模型中持有 PaginationManager，并用 PaginatedList 构建列表视图。
限制：具体依赖与平台版本以资料中的检测要求为准；搜索、刷新、状态视图为可选项，需在配置时选择；未提供模板文件的完整内容与更多集成细节。