{"repo":"yeyu-lab/PerfettoKit","free":true,"listed":false,"github":"https://github.com/yeyu-lab/PerfettoKit","clone":"git clone https://github.com/yeyu-lab/PerfettoKit.git","description":"🧠 AI-Powered Android performance detection & root-cause analysis SDK — pinpoint jank with multi-dimensional data, then let LLM generate fix suggestions with code examples. Supports GPT / Ollama / DeepSeek.","language":"Kotlin","stars":12,"topics":["android","android-sdk","apm","kotlin","perfetto","performance","profiler","tracing","frame-metrics","jank-detection"],"license":"Apache-2.0","category":"analytics","readme_excerpt":"PerfettoKit English 简体中文 🧠 AI 加持的 Android 性能检测与根因分析 SDK 多维数据采集 + 规则引擎 + LLM 智能归因 ，从检测到修复建议一步到位。 输出\"哪里慢、为什么慢、如何修\"的结构化诊断报告，并由 AI 生成 可执行的代码级修复方案 。 --- ✨ 特性 - 零侵入接入 ：通过 ContentProvider 自动初始化，导入即用。 - 手动 + 自动双模式 ：精准标记关键路径，自动兜底覆盖未标记场景（Activity 启动、列表滑动等）。 - 多维数据采集 ：帧率、CPU、内存、线程、网络、IO、Bitmap、对象分配、Looper 慢消息。 - 方法级根因定位 ：5ms 周期栈采样 + Choreographer 慢消息抓栈 + FrameMetrics 渲染阶段统计。 - 规则引擎 + Skill 库 ：内置 5 套规则 + 10 条 YAML 卡顿模式（GC 抖动、主线程 IO、Binder 阻塞、图片解码等）。 - 历史回归检测 ：本地 SessionStore 记录历史指标，自动检测劣化。 - 🧠 AI 智能诊断 ：接入任意 OpenAI 兼容 LLM（GPT / Claude / 本地 Ollama），自动输出 根因一句话 + 优化步骤 + 代码示例 。 - Logcat 友好输出 ：总览 → 卡顿元凶 Top → 耗时归因 → 详细数据分层展示。 --- 📦 模块结构 SDK 关键包 包 作用 --- --- PerfettoKit / PerfettoKitInitializer 入口对象 + 自动初始化 Provider session.TraceSession 一次检测会话的生命周期管理 collector/ 多维数据采集：Frame / Cpu / Memory / Thread / Network / IO / Bitmap / Allocation / Looper / MethodTracer rule/ 规则引擎：SlowFrame / ScrollJank / CpuUsage / Memory / Thread analyzer/ 栈采样聚合 + 根因分析 + 热点方法识别 skill/ + assets/perfettokit/skills/ .yaml 可扩展的卡顿模式知识库 auto/ AutoSceneDetector （自动场景识别）+ AnomalyDetector （回归检测） history/SessionStore 历史会话本地存储 ai/ 可选的 LLM 增强（OpenAI 兼容协议） report/ DiagnosisReport 数据结构 + LogcatReporter 输出 --- 🚀 快速接入 1. 引入 SDK 方式一：JitPack（推荐） 在项目根 settings.gradle.kts 中添加 JitPack 仓库： App 模块添加依赖： 方式二：源码引入 最低支持版本： minSdk = 24 ， compileSdk = 34 。 2. 自动初始化（默认） SDK 通过 PerfettoKitInitializer ContentProvider 在 Application.onCreate 之前自动调用 PerfettoKit.init() ， 无需任何代码 即可工作。 3. 自定义初始化（可选） 如需自定义规则 / Reporter / AI Provider，在 Application.onCreate ","default_branch":null,"files":null,"tree":[],"storefront":"/r/yeyu-lab","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/yeyu-lab/PerfettoKit/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}