Agent Skills
返回列表
🔒

原生应用性能剖析(CLI)

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-native-app-performance

技能介绍

要解决什么问题

在 macOS / iOS 上做 原生应用性能 分析时,Time Profiler 往往意味着打开 Instruments、手工导出再对照符号表。对习惯在终端里排障的工程师来说,这条路径既慢又难自动化:CI 里没法点 UI,远程机器上也不方便挂图形界面。

本技能围绕 纯 CLI 工作流:用 xcrun xctrace 录制 Time Profiler(attach 或 launch 目标二进制)、从 trace 里抽出 time-sample 数据、结合运行时 __TEXT 加载地址(vmmap)做符号化,并汇总应用侧热点栈,全程不必打开 Instruments。

技能如何工作

核心能力对应 SKILL 里列出的脚本与步骤:

  • scripts/record_time_profiler.sh:按 attach 或 --launch 直接指向二进制路径录制 trace
  • scripts/extract_time_samples.py:从 trace 导出 time-sample XML
  • scripts/top_hotspots.py:符号化并按应用帧排序热点

典型顺序是:确认剖析的是 本机构建 还是 /Applications 里的包 → 录制时在 UI 上触发慢路径(菜单开合、刷新等)→ 若栈为空则延长采集、避开空闲段 → 用 xcrun xctrace help record / export 核对参数 → 取 load address → 符号化并看排名。

适用边界与注意点

  • ASLR:必须用运行时的 __TEXT 加载地址,不能死记编译期地址。
  • 换新 build 后要更新 --binary 路径,符号必须与 trace 一致。
  • CLI 流在栈已通过 atos 等方式正确符号化时,可不依赖 Instruments 图形界面;若符号不匹配,热点排名会失真。

适合已熟悉 Xcode 工具链、需要在终端或脚本里完成「录制 → 导出 → 符号化 → 看热点」闭环的 macOS 原生开发场景。

使用场景

  • 本地 Debug 包菜单卡顿,需在终端 attach 录制 Time Profiler 并列出应用帧热点
  • CI 或 SSH 环境无法开 Instruments,要对指定二进制做 launch 录制并导出 time-sample
  • 改版后怀疑某次交互变慢,要在录 trace 时手动触发慢路径再符号化比对栈
  • 拿到同事导出的 trace,要用脚本抽样本并结合 vmmap 加载地址做 atos 符号化排名

适合人员

  • 维护 macOS 客户端、需在终端复现卡顿并给团队提交热点栈摘要的客户端工程师
  • 负责 iOS/macOS 构建流水线、希望在无图形界面节点上跑性能采样脚本的发布工程师
  • 性能专项同学,习惯用 vmmap/atos 校对 ASLR 后再解读 Time Profiler 样本
  • 接手他人 Instruments 习惯改 CLI 的同学,需要按仓库脚本走完录制到排名的固定步骤