native-app-performance

核心用法

Native App Performance 是一套专为 macOS/iOS 开发者设计的命令行性能分析工具链。该技能通过 xctrace 录制 Time Profiler 数据，结合自定义 Python 脚本实现完整的"录制-提取-符号化-分析"闭环。用户可通过 --attach 模式附加到运行中的进程，或使用 --launch 模式直接启动应用进行录制。录制完成后，，extract_time_samples.py 将 .trace 文件转换为可解析的 XML 格式，，top_hotspots.py 则利用 atos 完成地址符号化并输出热点函数排名。

显著优点

纯 CLI 工作流：彻底摆脱 Instruments 图形界面的性能开销与操作繁琐，特别适合 CI/CD 集成和远程服务器场景。精准符号化：通过运行时 vmmap 获取 ASLR 偏移量，结合 atos 实现准确的符号还原，避免地址混淆导致的误判。灵活触发机制：支持手动触发慢路径（如菜单操作、刷新动作），确保捕获到真实的性能瓶颈。可信工具链：完全基于苹果官方开发者工具（xctrace、atos、otool），无第三方依赖风险。

潜在缺点与局限性

平台锁定：仅支持 macOS 环境，Windows/Linux 开发者无法直接使用。ASLR 复杂性：每次新启动都需要重新获取 __TEXT 段加载地址，自动化脚本需额外处理。符号匹配敏感：若录制后重新编译应用，必须确保二进制文件与 trace 完全匹配，否则符号化失败。学习曲线：需要熟悉 vmmap、、otool` 等底层工具的使用，对新手不够友好。

适合的目标群体

• 需要频繁进行性能回归测试的 iOS/macOS 开发团队
• 追求 CI/CD 自动化的 DevOps 工程师
• 习惯命令行工作流的高级开发者
• 需要分析用户现场性能问题的技术支持人员

使用风险

调试权限依赖：--attach 模式需要进程调试权限，可能触发系统安全提示。文件路径注入：虽脚本有参数验证，但用户仍需确保传入的二进制路径可信，避免误操作覆盖系统文件。长时间录制开销：90 秒以上的持续采样可能对目标应用性能产生可观测影响，生产环境需谨慎。

核心用法

该 Skill 提供了一套完整的命令行原生应用性能分析方案，核心围绕 xcrun xctrace 展开，支持两种录制模式（attach 现有进程或 launch 启动新进程），并通过配套 Python 脚本完成样本提取、地址符号化和热点排序。

典型工作流：
1. 使用 record_time_profiler.sh 录制 90 秒 Time Profiler 追踪（.trace 文件）
2. 使用 extract_time_samples.py 从 .trace 导出 XML 格式时间样本
3. 使用 vmmap 获取运行时 __TEXT 段加载地址（应对 ASLR）
4. 使用 top_hotspots.py 调用 atos 符号化并输出 Top 30 热点函数

显著优点

• 纯 CLI 无 GUI 依赖：服务器/CI 环境友好，无需 Instruments 图形界面
• 零第三方依赖：Python 仅用标准库，Bash 脚本无外部依赖，供应链攻击面为零
• 精准符号化：通过运行时 load address + atos 实现准确的符号解析
• 来源可信：维护者 steipete 为 PSPDFKit 创始人，iOS/macOS 社区知名开发者

潜在缺点与局限性

• macOS/iOS only：完全依赖 Apple 生态工具链，不支持其他平台
• Xcode 版本敏感：xctrace CLI 接口在不同 Xcode 版本间存在差异
• ASLR 手动处理：必须每次获取 load address，无法自动化
• 模板单一：当前仅支持 Time Profiler，不支持 Allocations、Energy Log 等其他 Instruments 模板
• 无可视化：缺失 Instruments 的火焰图交互体验，纯文本输出

适合人群

• 需要 CI/CD 集成性能测试的 iOS/macOS 开发者
• 习惯终端工作流、追求效率的资深工程师
• 远程服务器或无 GUI 环境（如 GitHub Actions macOS runner）的使用者
• 对供应链安全敏感、拒绝第三方依赖的安全团队

常规风险

• 输入验证待增强：duration 参数未严格校验格式，依赖 xctrace 报错
• 二进制/符号匹配：若录制后重新编译，需确保符号文件与追踪版本一致
• 权限要求：xctrace 录制可能需要开发者模式或特定 entitlements
• 长时录制磁盘占用：.trace 文件体积随时长增长，需注意 /tmp 空间