PerfKitty快速开始
PerfKitty 将设备连接、实时采样和云端数据复盘放在同一个工作流中。完成下面四步，就可以开始第一次性能测试。
先看哪篇文档
- 客户端使用：请先阅读桌面客户端使用指南，了解登录、连接设备、选择应用、开始采样和查看报告的完整流程。
- AI 使用：请阅读Skills 使用指南，了解如何让 AI Agent 执行采集、分析和版本对比；需要访问云端报告时，再参考MCP 使用指南。
- 自动化采集：如果需要在脚本、CI 或批处理中运行 PerfKitty，请参考CLI 使用指南。
安装客户端
从 PerfKitty 官网下载客户端 下载 Windows 客户端并完成安装。建议使用 Windows 10 或 Windows 11 的 64 位系统。
客户端只需要安装一次。后续如果要更新版本，可以在客户端设置中检查更新，或重新从官网下载最新版本。
安装设备连接依赖
根据要测试的平台安装对应的前置工具即可，不需要同时安装 Android 和 iOS 的依赖。
Android：安装 adb
Android 设备需要使用 Android SDK Platform-Tools 中的 adb。建议从 Android 官方 Platform-Tools 下载页 下载 Windows 版本。
下载并解压
platform-tools，例如解压到C:\Android\platform-tools。将包含
adb.exe的目录加入 Windows 的Path环境变量。只设置ANDROID_HOME而不把platform-tools加入Path，通常不能让客户端找到adb。重新打开终端和 PerfKitty 客户端，使环境变量生效。
在 PowerShell 或命令提示符中执行下面的命令进行验证：
adb version adb devices如果已经连接设备，
adb devices会列出设备序列号。首次连接时，还需要在 Android 设备上打开开发者选项和 USB 调试，并允许当前电脑进行调试。
如果电脑已经安装 Android Studio，也可以直接使用其 SDK Manager 安装或更新 Platform-Tools；请确认实际使用的 adb.exe 所在目录已经加入 Path。
iOS：安装 Apple Mobile Device Support
iOS 设备需要 Windows 上的 Apple Mobile Device Support。由于 PerfKitty 当前会直接使用 Apple 的 MobileDevice.dll 和 CoreFoundation.dll，建议优先安装 Apple 官方 iTunes for Windows（64 位）安装包。也可以先查看 Apple 官方 Windows 软件页面；如果使用 Apple Devices 后 PerfKitty 仍无法识别设备，请改装或修复桌面版 iTunes。
连接设备后：
使用支持数据传输的 USB 线连接 iPhone 或 iPad。
在设备上解锁，并在“信任此电脑？”提示中点击“信任”，然后输入设备密码。
打开 Apple Devices 或 iTunes，确认电脑能够识别设备。
确认下面两个文件存在；如果不存在，请重新安装或修复 Apple Devices / iTunes：
C:\Program Files\Common Files\Apple\Mobile Device Support\MobileDevice.dll C:\Program Files\Common Files\Apple\Mobile Device Support\CoreFoundation.dll
完成后重新打开 PerfKitty 客户端。iOS 设备的配对和开发者相关设置仍需根据客户端提示完成。
连接测试设备
使用 USB 连接 Android 或 iOS 设备。首次连接时，请根据客户端提示完成设备授权与必要的开发者设置。
- Android：确认已开启开发者选项和 USB 调试，并在设备端允许当前电脑调试。
- iOS：确认已在设备端信任当前电脑，并且 Apple Devices 或 iTunes 可以正常识别设备。
- 两个平台都建议使用支持数据传输的 USB 线，而不是只能充电的线缆。
开始性能采样
在客户端选择目标应用和需要关注的性能指标，然后开始采样。测试过程中可以实时查看帧率、CPU、GPU、内存和网络等数据。
查看历史数据
采样完成后，进入我的数据登录账号，即可按项目检索历史会话、查看详细曲线并进行多次测试对比。
建议为同一产品和测试场景使用统一的项目名称，后续检索与对比会更方便。