用途:为 iOS/SwiftUI 应用添加仅调试用的深链接,使开发者、Claude Code 或自动化测试工具能通过 xcrun simctl openurl 直接跳转到指定界面,并可同时配置应用状态,用于截图、视觉验证与自动化测试。不适用于生产环境深链接、Universal Links、App Clips 或复杂路由架构。
主要能力:支持基础 URL scheme 路由(如 debug://settings、debug://profile?id=123、debug://reset);与 NavigationStack 的 NavigationPath 集成,可追加多个目标实现多级跳转;支持状态配置链接(如登录错误、空列表、网络错误);支持参数化测试场景(用户类型、列表状态、网络状态);可配合 /axiom:screenshot 命令与 simulator-tester 智能体使用。
使用方式:在 SwiftUI App 中用 #if DEBUG 包裹 .onOpenURL 处理函数,按 url.host 路由到现有导航系统;在 Info.plist 注册 debug URL scheme,并通过 Run Script 在 Release 构建中删除该 scheme,或使用独立的 Info.plist。测试命令示例:xcrun simctl openurl booted "debug://settings"、xcrun simctl openurl booted "debug://recipe-edit?id=42"。
限制与注意:所有调试代码必须用 #if DEBUG 包裹并从发布构建中剥离;参数需校验,避免强制解包;应复用现有导航系统而非重复实现路由逻辑;需在 README 或注释中记录。资料未提供具体收费、价格或平台支持范围。