xxf-router

name	xxf-router
description	使用 XXFRouter 管理页面跳转。当用户要注册路由、配置页面导航、添加跳转拦截器、实现降级策略、处理 URL Scheme 或 Universal Link、解耦模块间跳转时使用。若属于普通编码任务中的实现环节，应先经过 `xxf-aaa-delivery-loop` 再落到本 skill。
allowed-tools	Read, Glob, Grep, Edit, Write

XXFRouter 路由框架

触发场景

• 项目要做模块化解耦，页面互相跳转不直接依赖
• URL Scheme / Universal Link 外部唤起
• 跳转前鉴权、埋点、风控
• 降级兜底（H5 回退、版本不匹配）

工作流

1. 读源码定 API（必做）

Glob Sources/XXFRouter/**/*.swift
Grep "register|navigate|intercept" in Sources/XXFRouter/

识别以下关键点（不要凭记忆写）：

• 注册入口（协议 / 宏 / 字符串 key）
• 跳转入口（方法签名、参数传递方式）
• 拦截器接口
• 降级策略的配置点

2. 路由表设计（强制约定）

• 路由 key 用常量集中管理，禁止魔法字符串散落各处
  推荐位置：App/Routes.swift 或每个模块自带 XxxModule+Routes.swift
• 参数命名用 camelCase，与 Swift 变量一致
• 跨模块跳转只依赖路由 key，不 import 目标模块

3. 注册时机

在 AppDelegate / SceneDelegate 启动时注册所有路由，或用每个模块的 @_cdecl / 自注册机制（先读源码确认框架支持哪种）。

禁止在 ViewController 里临时注册。

4. 拦截器典型用法

• 登录拦截：未登录 → 跳登录页 → 登录后恢复原跳转
• 埋点：所有跳转打点
• 限流：短时间重复点击去抖
• 版本降级：新页面在低版本客户端回退到 H5

拦截器按职责单一，不要写一个"万能拦截器"。

5. 跳转参数传递

优先级：编译期类型安全 > 字典 > URL query
先读源码看框架支持哪种，避免自作主张。

反模式（禁止）

• 业务代码里直接 navigationController?.pushViewController(...)（除非是页面内部子页面）
• 路由 key 用中文或包含特殊字符
• 把整个 ViewModel 通过路由参数传递（只传 ID / DTO）

深入阅读

跳转降级、模块自注册详见 references/patterns.md。