桌面客户端使用指南

PerfKitty 桌面客户端用于连接 Android 或 iOS 设备、选择待测应用、实时采集性能指标，并将结果保存到本地或上传到云端。本文面向第一次使用 PerfKitty 的测试、研发和性能分析人员，按一次完整测试的顺序介绍客户端操作。

一次标准测试通常包含以下步骤：

1. 安装并登录客户端。
2. 连接测试设备。
3. 选择待测应用。
4. 开始采样并执行测试场景。
5. 标记场景、截图并观察实时曲线。
6. 停止采样，保存或上传结果。
7. 在“我的数据”中查看、对比和分享报告。

1. 下载与安装

访问 PerfKitty 官网，下载 Windows 客户端并完成安装。建议使用 Windows 10 或 Windows 11 的 64 位系统。

首次使用前，请准备好：

• 一台可正常联网的 Windows 电脑。
• 已安装待测应用的 Android 或 iOS 设备。
• 可用于数据传输的 USB 线。
• 一个可正常登录的 PerfKitty 账号。

如果使用 Android 设备，请提前打开开发者选项和 USB 调试；如果使用 iOS 设备，请按设备提示信任当前电脑，并完成客户端提示的必要设置。

2. 登录 PerfKitty

启动客户端后，使用 PerfKitty 账号登录。登录状态用于采样权限校验、云端上传、历史数据查看和 MCP 配置。

在“我的数据”网页未登录时，点击登录按钮会进入邮箱验证码登录流程。根据页面提示完成验证后，浏览器会保存登录状态。

如果客户端能够采样，但“查看数据”页面提示重新登录，请确认浏览器登录的是与客户端相同的 PerfKitty 账号。

3. 连接并选择测试设备

使用 USB 连接设备后，客户端会在左侧设备下拉列表中显示已经识别的设备。一个设备可能同时存在 USB 和无线连接项，列表右侧的图标用于区分连接方式。

操作步骤：

1. 解锁设备并保持屏幕点亮。
2. Android 设备需要先打开“开发者模式”，并在开发者选项中启用“USB 调试”。
3. 使用 USB 数据线连接电脑。请确认使用的是支持数据传输的线缆，而不是只能充电的线缆。
4. 在设备端确认“允许 USB 调试”“信任此电脑”等授权提示；Android 设备出现调试授权提示时，建议允许当前电脑进行调试。
5. 打开设备下拉列表，选择本次测试使用的设备。
6. 如果列表没有更新，点击设备列表右侧的刷新按钮重新发现设备。

选择设备后，左侧会显示设备名称、系统版本、CPU、GPU、内存、分辨率、序列号等信息。开始测试前建议核对这些信息，避免误选同型号的其他设备。

3.1 使用无线方式连接 Android 设备

Android 设备支持在局域网内通过无线方式连接。第一次建立无线连接时，需要先使用 USB 数据线连接设备和电脑，完成 USB 调试授权及无线连接初始化；无线连接成功后即可断开数据线。

1. 确认 Android 设备已经打开“开发者模式”和“USB 调试”。
2. 使用 USB 数据线连接设备和电脑，并在设备端允许当前电脑进行 USB 调试。
3. 确认电脑和 Android 设备连接在同一局域网或同一 Wi-Fi 网络中。
4. 打开客户端的设备下拉列表，选择带有无线连接图标的选项。
5. 按提示输入 Android 设备在当前局域网中的 IP 地址，然后发起连接。设备 IP 地址通常可在系统的 Wi-Fi 网络详情中查看。
6. 等待客户端提示连接成功，并确认设备已经出现在列表中且可以正常读取设备信息。
7. 连接成功后，可以断开 USB 数据线，继续通过无线连接进行测试。

如果断开数据线后设备立即离线，请确认电脑与设备仍在同一网段、IP 地址没有变化，并重新点击刷新或再次执行无线连接。无线网络不稳定时，建议改用 USB 连接进行正式性能测试。

3.2 设备没有出现在列表中

按以下顺序检查：

1. 更换支持数据传输的 USB 线或 USB 接口。
2. 确认设备已解锁，且没有停留在授权弹窗后面。
3. Android 设备确认 USB 调试已开启，并重新确认调试授权。
4. iOS 设备确认已经信任当前电脑，并按客户端提示完成必要配置。
5. 点击刷新按钮；仍未出现时，重新插拔设备后再刷新。
6. 如果同时存在 USB 和无线连接，优先使用稳定的 USB 连接排查问题。

4. 选择待测应用

选中设备后，打开应用下拉列表。客户端会列出设备上可识别的应用，并显示应用名称、图标和包名。

建议优先通过应用名称或包名搜索目标应用。确认包名非常重要：同一产品的正式版、测试版和渠道包可能名称相似，但包名不同。

如果目标应用没有出现：

• 确认应用已经安装在当前选中的设备上。
• 确认没有选错设备。
• 将目标应用启动并切换到前台后，再刷新设备或重新打开应用列表。
• 使用完整或部分包名搜索，例如 com.example.game。

列表中可能同时包含用户应用和系统进程。除非明确需要分析系统进程，否则请选择产品自身的应用包。

5. 开始性能采样

设备和应用选择完成后，点击主界面右上角的圆形采样按钮开始采样。采样启动成功后，左侧“当前状态”会显示为运行中，左下角按钮变为“停止采样”。

主界面分为三个区域：

区域	主要内容
左侧设备区	当前账号、设备和应用选择、运行状态、场景名称、设备详情、停止采样按钮
顶部工具栏	反馈、场景、截图、截图循环、图表选项、保存、打开、MCP、查看数据
中央图表区	FPS、CPU、内存、网络、GPU、温度等实时性能曲线和截图时间线

开始采样后，在设备上执行计划好的测试步骤。为了获得可复现的数据，建议在不同测试轮次中保持以下条件尽量一致：

• 使用相同设备和系统版本。
• 使用相同应用版本和账号状态。
• 使用相同画质、帧率和其他应用设置。
• 按相同顺序执行测试场景。
• 保持相近的采样时长和设备温度。
• 测试期间避免无关应用、系统更新或通知干扰。

6. 使用场景标记

点击顶部工具栏中的“场景”，输入当前测试阶段的名称并确认。

场景名称会写入保存的 JSON 和 Excel 会话文件，并可在云端报告中用于定位测试阶段。建议在场景切换时及时修改，例如：

• 启动与登录
• 主城跑图
• 多人战斗
• 商城滑动
• 高画质团战

推荐使用简短、稳定且团队统一的命名。不要把临时备注、个人姓名或敏感信息写入场景名称。

7. 截图与截图循环

顶部工具栏提供两种截图方式：

• 截图：立即采集一张当前设备画面，适合记录卡顿、加载、切场景等关键时刻。
• 截图循环：按固定间隔持续采集画面，适合需要把性能曲线与操作过程对应起来的测试。

截图会按采样时间对齐到当前会话。使用截图循环时，应注意：

• 长时间连续截图会增加会话文件体积和资源占用。
• 测试结束前确认截图循环已经停止，避免采集无关画面。
• 截图可能包含账号、聊天、订单、定位等敏感信息，上传或分享前应先检查内容。

8. 选择需要显示的图表

点击“图表选项”，可以控制实时界面显示哪些指标分组。

常用组合如下：

测试目标	建议关注的指标
流畅度	FPS、Frame Time、Jank、BigJank、卡顿率
CPU 压力	App CPU、Total CPU、CPU 频率、CPU 核心利用率
内存问题	Virtual Memory、PSS、Memory Detail
网络问题	上行速率、下行速率、累计流量
GPU 压力	GPU Overview，以及设备支持的 GPU 执行、利用率、计算或带宽指标
温控问题	Temperature、CPU/GPU 频率和性能曲线

不同平台、设备型号和 GPU 架构支持的指标可能不同。某个选项未显示数据时，不一定表示客户端故障，也可能是当前设备或采集后端不提供该指标。

9. 阅读实时曲线

将鼠标移动到曲线上，可以查看当前时间点的各项指标值。图表底部的时间轴用于浏览会话，也可通过左右边界选择一个时间范围。

分析时建议先看整体趋势，再定位局部区间：

1. 观察 FPS 是否持续下降或频繁波动。
2. 对照 Frame Time、Jank 和 BigJank 判断卡顿程度。
3. 检查同一时间段 CPU、GPU、内存、温度或网络是否同步变化。
4. 结合场景标记和截图确认当时正在执行的操作。
5. 对异常区间使用“保存选中范围”，导出更聚焦的数据供进一步分析。

单一指标通常不能直接证明根因。例如 FPS 下降同时伴随 GPU 利用率升高，只能说明 GPU 压力可能相关，仍应结合场景、资源加载、日志和代码变更验证。

10. 停止采样

完成测试步骤后，点击左下角“停止采样”。停止后不要立即关闭客户端，先检查曲线、场景和截图是否完整，再保存结果。

如果本次采样出现误操作或无效等待，可以在时间轴上选择有效区间，只保存需要分析的部分。

11. 保存本地会话

“保存”按钮提供两个范围：

• 全部保存：保存本次会话的完整时间范围，适合正式留档和上传。
• 保存选中范围：只保存时间轴中当前选中的区间，适合截取卡顿、加载或战斗等关键片段。

在保存窗口中设置保存路径、文件格式和是否上传。

客户端支持以下格式：

格式	适用场景
Excel	便于测试人员查看表格、筛选指标和进行常规统计
JSON	保留结构化会话数据，适合程序处理、自动化工具和后续重新加载

勾选“保存后上传”后，客户端会先保存本地文件，再把会话上传到当前账号的云端数据中。上传需要有效登录状态和可用网络。

建议正式测试同时保留本地文件并上传云端。本地文件用于归档和离线处理，云端报告用于检索、对比、分享和 AI 分析。

11.1 推荐命名方式

建议让文件名能直接体现测试对象，例如：

产品名_版本_平台_设备_场景_日期

示例：

ExampleGame_1.6.0_Android_Xiaomi14_主城跑图_20260824.xlsx

同一项目应保持统一命名规则，避免只使用“测试1”“新建文件”等无法检索的名称。

12. 打开已有会话

点击顶部工具栏中的“打开”，可以加载客户端保存的会话文件，在不连接设备的情况下重新查看曲线和数据。

适合以下场景：

• 复盘之前保存的测试结果。
• 打开他人提供的本地会话文件。
• 从完整会话中重新选择关键区间并导出。
• 在网络不可用时进行离线查看。

打开文件前，如果当前仍在采样，应先停止并保存当前会话，避免丢失尚未保存的数据。

13. 查看云端数据

点击客户端顶部的“查看数据”，或在浏览器进入我的数据。上传完成后，报告会按项目和应用归类。

在会话列表中可以：

• 从左侧选择项目或应用。
• 按平台、系统版本、应用版本和设备筛选。
• 查看平均 FPS、卡顿率、峰值内存、平均 App CPU 和上传时间等摘要。
• 点击会话名称进入单次报告。
• 通过操作菜单执行分享等后续操作。

如果刚上传的报告没有出现，可以刷新页面，并确认网页与桌面客户端登录的是同一个账号。

14. 查看单次报告

单次报告顶部显示应用、包名、版本、系统、设备、会话名称、时长、创建者和上传时间。页面按 System、CPU、Memory、Network、GPU 等类别展示数据。

报告中的“性能概要”用于快速浏览关键统计结果；下方图表提供平均值、最小值、最大值、P90 等统计，并保留完整时间序列。

阅读报告时可以：

1. 先查看性能概要，确认是否存在明显异常。
2. 在分类标签间切换，检查 CPU、内存、网络和 GPU 数据。
3. 将鼠标移动到曲线上读取指定时间点的数据。
4. 拖动底部时间范围，放大异常区间。
5. 对照场景标签和截图判断异常发生时的用户操作。

15. 对比多次测试

需要比较不同版本、设备或测试轮次时，点击网页顶部的“对比”，再选择“添加用例”。

添加窗口支持按 Android、iOS、项目、应用版本、系统版本和设备筛选。每次对比至少选择 2 个用例，最多选择 5 个用例。

选中的用例会进入右侧对比列表。确认无误后点击“开始对比”。

为了让对比结果有意义，建议选择：

• 相同测试场景和操作路径。
• 相近的采样时长。
• 相同设备，或硬件规格明确可比的设备。
• 相同画质、分辨率和帧率设置。
• 仅改变一个主要变量，例如应用版本或系统版本。

如果设备、场景和时长差异过大，指标变化可能来自测试条件，而不是应用版本本身。

16. 分享报告

在单次报告中点击“分享”，可以生成外部访问链接。

分享时可以设置：

• 是否开启公开分享。
• 是否要求访问者输入密码。
• 链接的失效日期或有效期限。
• 是否更新已经存在的分享链接。

分享前请检查报告名称、场景标签和截图是否包含敏感信息。对于外部客户或公开渠道，建议设置密码和明确的失效时间；不再需要分享时，应及时关闭分享。

17. 账户、额度与套餐

点击网页右上角的账号菜单，可以进入账户信息页面，查看或修改昵称，并确认当前登录邮箱。

“余额”页面显示剩余额度、当前权益、服务时间和套餐信息。页面中的数值和日期仅代表当前账号状态，以实际显示为准。

如果客户端提示额度不足或权益不可用，请先检查：

1. 当前登录账号是否正确。
2. 余额页面是否仍有可用额度或有效权益。
3. 电脑时间和网络连接是否正常。
4. 是否需要购买或续订对应套餐。

18. MCP Key 管理

“令牌”页面用于创建和管理 MCP Key。MCP Key 可让支持 MCP 的 AI 客户端访问当前账号有权限查看的 PerfKitty 项目和报告。

每个 AI 客户端或电脑建议使用独立的 Key，便于单独禁用和删除。完整配置方法请参阅 MCP 使用指南。

安全要求：

• 不要把 MCP Key 发到群聊、工单或公开文档中。
• 不要把 MCP Key 提交到代码仓库或写入公开日志。
• 截图前先遮挡完整 Key。
• 怀疑 Key 泄露时，立即禁用或删除旧 Key，并重新配置。

19. 客户端设置与更新

点击客户端账号区域旁的齿轮按钮进入设置。

设置页面可以：

• 切换客户端界面语言。
• 查看当前客户端版本。
• 检查是否存在新版本。
• 在检测到更新时执行升级。

排查设备兼容、上传或指标显示问题时，建议先确认正在使用最新版本。升级前请结束当前采样并保存数据。

20. 常见问题

20.1 点击开始采样后没有数据

检查设备和应用是否仍处于连接状态，目标应用是否已经启动并位于前台。刚开始采样时部分指标可能需要短暂预热，可等待数秒后再判断。

20.2 FPS 或 GPU 指标为空

不同设备、系统版本和 GPU 架构可提供的指标不同。先确认目标应用正在产生有效画面，再检查“图表选项”中对应指标是否已勾选。必要时换用客户端最新版本重新测试。

20.3 应用列表找不到目标应用

确认应用安装在当前设备上，核对设备选择，启动应用后刷新列表，并尝试使用包名搜索。

20.4 保存后没有在网页中看到报告

确认保存时勾选了“保存后上传”，且上传过程没有报错；随后检查浏览器与客户端是否使用同一个账号。未勾选上传时，本地保存不会自动出现在“我的数据”中。

20.5 上传失败怎么办

先保留已经生成的本地 JSON 或 Excel 文件，检查网络、登录状态和账户权益后重试。不要因为上传失败删除本地原始数据。

20.6 对比结果差异很大

先检查测试条件是否一致，包括设备、应用版本、系统版本、画质、帧率、测试场景、采样时长和设备温度。测试条件不同会显著影响对比结论。

20.7 打开分享链接后无法访问

分享可能已关闭、过期或设置了密码。联系分享者确认链接状态，并检查输入的密码是否正确。

21. 推荐测试流程

正式测试时可以使用下面的检查清单：

测试前

• 客户端已更新到计划使用的版本。
• 设备电量、温度和网络状态满足测试要求。
• 已确认设备、应用和包名。
• 应用画质、帧率及账号状态已按测试方案设置。
• 已关闭可能干扰测试的通知和后台任务。

测试中

• 采样状态显示为运行中。
• 按统一步骤执行测试场景。
• 场景切换时及时修改场景名称。
• 关键问题发生时进行截图或启用截图循环。
• 观察曲线是否持续产生数据。

测试后

• 已停止采样。
• 已检查有效时间范围。
• 已使用清晰的文件名保存本地数据。
• 正式结果已上传到云端。
• 已确认报告可在“我的数据”中打开。
• 分享前已检查敏感信息并设置访问策略。

保持设备、场景和命名规则一致，是获得可比较、可复现性能数据的关键。