· 全部指南
User-Agent 解析基础
User-Agent 字符串包含浏览器类型、版本和操作系统等信息。使用我们的 user-agent-parser 工具可本地解析这些数据，避免将敏感信息发送到服务器。例如 'Mozilla/5.0 (iPhone)' 表明 iOS 设备，而 'Windows NT 10.0' 则代表 Windows 10 系统。
现代浏览器逐渐精简 User-Agent 信息，应考虑使用 Navigator API 作为补充。通过 device-information 工具可检测屏幕尺寸、内存等硬件参数，这对响应式设计和性能优化至关重要。所有解析均在浏览器内完成，确保用户数据零外泄。
设备特征检测实战
移动端适配需要精准识别设备类型。通过分析触摸支持、屏幕方向等特征，可区分手机、平板或桌面设备。例如检测 maxTouchPoints > 0 表示触摸屏设备，而 orientationchange 事件则暴露屏幕旋转能力。
注意某些浏览器会伪装 User-Agent，建议结合多个特征验证。使用 prefers-color-scheme 检测深色模式，通过 battery API 判断移动设备（需用户授权）。这些技术可实现更智能的界面自适应。
键盘事件调试技巧
不同浏览器键盘事件存在兼容性问题。keycode-info 工具可实时显示按键代码，比如 Enter 键在 Chrome 中返回 13 而 Firefox 可能不同。注意 keyCode 已被废弃，应优先使用 key 和 code 属性。
处理国际键盘需特别注意。德语键盘的 Y/Z 位置与美式布局相反，而日语键盘存在特殊输入模式。建议在工具中测试各区域键盘布局，或使用 Keyboard.getLayoutMap() API 检测当前映射。
日志分析与问题排查
收集客户端日志时应包含标准化设备信息。建议格式：[Android 10][Chrome 89][1920x1080] 这样可快速定位特定环境的问题。注意 GDPR 合规性，避免记录个人身份信息。
遇到兼容性问题时，先通过我们的工具复现用户环境。检查触控事件是否被错误识别为鼠标事件，或某些 CSS 属性在特定浏览器版本中被忽略。本地解析工具能安全模拟各种测试场景。
UA 会撒谎——这没关系
浏览器会伪装，爬虫会模仿，隐私模式会减少细节。解析 UA 只适合粗粒度分析与渐进增强，绝不能当安全依据。功能开关应优先能力检测，而不是 UA 嗅探。
支持工单排障
用户反馈「布局坏了」时，收集 UA、视口与截图。用解析器判断浏览器家族，再用最接近的本地配置复现。不要因为某个过时爬虫匹配到子串就封锁整类操作系统。
日志卫生
必要时只存派生的浏览器家族；在最小化政策下避免无限期保留完整原始 UA。
渐进增强优于嗅探
对所需 API 做特性检测。UA 解析只用于分析看板与粗略支持统计。安全控制不能只依赖 UA 字符串。
User-Agent 实战解析
动生产前先写操作程序：输入、期望输出、负责人与回滚。Towalles 上的工具便于本地检查样例，不能替代变更控制。
前置条件
- 有代表失败案例的脱敏 fixture。
- 清楚谁是真相来源（应用、网关、CMS 或网络设备）。
- 能在非生产环境或用合成数据复现问题。
步骤
- 用 fixture 复现，记录精确命令或 UI 路径。
- 按需用格式化、哈希或解析工具与已知正确样例对照。
- 做最小修复；同一变更里避免顺手重构。
- 补充回归测试或清单项，避免下一任 on-call 重复踩坑。
- 更新 runbook：症状 → 检查 → 修复。
善后
观察 24–72 小时错误率与支持工单。若做过一次性数据修复，安排后续防止复发。工单里保留截图与哈希，不要留真实密钥。
反模式
- 把生产密钥贴到公开页面「只是看一下」。
- 上线却不写回滚说明。
- 把本地绿色演示当成多区域生产的证明。