用途：该技能属于 revyl-cli-auth-bypass 的下级叶子技能，当上级技能判断目标为原生 iOS 应用时使用，提供 Swift/iOS 侧的认证绕过实现指导。它是应用代码层面的指引，并非 Revyl 自身的认证捷径。
主要能力：约定单一深链形式 myapp://revyl-auth?token=<token>&role=<role>&redirect=<allowlisted-route>；Revyl 启动变量在 iOS 模拟器应用中通过启动参数传入，例如 -REVYL_AUTH_BYPASS_ENABLED true -REVYL_AUTH_BYPASS_TOKEN <token>。需要新增或更新的位置包括 Info.plist 注册 URL scheme、SwiftUI 应用根或 app/scene delegate 处理深链、认证会话模块创建允许角色的正常会话、路由协调器仅跳转白名单目标，以及在账户、调试或设置页展示接受/拒绝状态。
使用方式：作者给出 Swift 处理函数示例，读取启动参数与查询参数，校验开关、令牌、角色与重定向白名单，然后调用 TestSession.signIn 与 AppRouter 跳转；并要求将示例中的占位类型替换为应用真实实现。验证时先设置启动变量并启动全新 Revyl 会话，相关命令为 export REVYL_AUTH_BYPASS_TOKEN="<test-only-token>"、revyl global launch-var update REVYL_AUTH_BYPASS_TOKEN --value "$REVYL_AUTH_BYPASS_TOKEN"，以及 revyl dev --platform ios --no-build --launch-var REVYL_AUTH_BYPASS_ENABLED --launch-var REVYL_AUTH_BYPASS_TOKEN；随后可用 revyl device navigate 分别验证有效令牌、错误令牌、非法角色和非法重定向，并用 revyl device screenshot 截图留存。
适用场景：原生 iOS 应用在模拟器、调试、预发或测试构建中进行端到端测试所需的临时登录态建立。
限制：绝不能发布无条件生产绕过；必须由模拟器/调试/预发/测试构建加 REVYL_AUTH_BYPASS_ENABLED=true 双重限定；不得将原始令牌写入源码、YAML、截图或 PR 文案；角色与重定向白名单应保持小而具体；应用需清晰展示被拒绝状态以便诊断。仅当目标应用、平台、会话、URL scheme、令牌来源或敏感操作无法从仓库或 Revyl CLI 推断时，才提出 1 到 3 个简短澄清问题。