| name | stability-auto-test |
| description | 对 Android APK 做稳定性测试、监控 Java/Native 崩溃、ANR、进程异常退出时使用。给定包名，连接安卓设备/模拟器后自动监听 logcat 与 dropbox，捕获稳定性事件并落盘现场快照，测试结束后输出稳定性总结并弹出网页报告。 |
| when_to_use | 用户说"帮我跑稳定性测试"、"测一下这个 APK 的稳定性"、"监控 crash 和 ANR"、"看下 APK 有没有崩溃"、"跑 stability-auto-test"时触发。 |
| argument-hint | <package> [duration] [--device serial] [--config path] [--output dir] |
stability-auto-test
参数解析
从 args 或对话上下文中提取。只有 --package 是必填的，其余均有代码默认值。
| 参数 | 说明 | 默认值 |
|---|
--package | 目标 APK 包名（必填） | — |
--duration | 采集时长，如 30s、5m、1h | 5m |
--output | 报告输出目录（不填时自动生成） | ./reports/<包名末段>_<YYYYMMDD_HHMMSS> |
--device | ADB serial（多设备时必填） | 自动取唯一在线设备 |
--config | YAML 配置路径 | — |
--dedup-window | 同事件去重窗口秒数 | 5 |
--max-incidents-per-type | 每类事件最大记录数 | 200 |
检测开关（--no-java-crash / --no-native-crash / --no-anr / --no-process-death）、采集开关（--no-dropbox）、dump 拉取开关（--no-tombstone-pull / --no-anr-trace-pull）等进阶参数均在代码中有默认值，需要时可通过 --config YAML 覆盖，见 ${CLAUDE_SKILL_DIR}/scripts/config.example.yaml。
简写识别：/stability-auto-test com.example.app 30m → --package com.example.app --duration 30m
步骤 1：环境检查
python -m sat --help
若报 ModuleNotFoundError，安装依赖后重试：
pip install -e ${CLAUDE_SKILL_DIR}/scripts
若 adb devices 为空，提示用户连接设备或启动模拟器后再试。
步骤 2：确认参数
若 --package 缺失，询问用户目标包名。
若 --output 未指定，自动生成：./reports/<包名末段>_<YYYYMMDD_HHMMSS>
确认后告知用户：
开始对 <package> 进行 <duration> 稳定性监控，输出至 <output_dir>…
注意：本工具不会启动 APK，请确保目标 App 已运行（或将在采集期间被启动）。
步骤 3：执行采集
在 stability_auto_test/scripts/ 目录下执行：
python -m sat \
--package <package> \
--output <output_dir> \
--duration <duration> \
[--device <serial>] \
[--config <config_path>] \
[其他可选参数]
在前台执行，实时显示日志。采集期间 <output_dir>/status.json 每 10 秒刷新一次心跳（含当前进程列表 + 各类事件累计计数）。
步骤 4：弹出报告 + 输出总结
采集命令结束后，先弹出网页报告，再输出文字总结。
4.1 弹出网页报告
open <output_dir>/report.html
4.2 读取数据
读取 <output_dir>/report.json，提取以下字段：
run：时长、退出原因、设备信息processes[*]：events（4 类计数）、restart_count、uptime_ratioincidents[]：触发时间、进程、类型、severity、summary、evidencelifecycle_events[]：new / restart / gone 事件
4.3 输出稳定性总结
总结要简短、有逻辑、有结论，格式如下：
稳定性测试总结 — <package>（<duration>）
整体状态：✅ 稳定 / ⚠️ 有问题 / 🔴 严重异常（一句话说明）
进程概览
| 进程 | uptime% | 重启 | Java crash | Native crash | ANR | 异常退出 |
|---|
关键事件（无则省略此节）
结论
一到两句话：是否存在稳定性问题、最严重的问题是什么。
详细堆栈、tombstone、ANR trace、原始 logcat 见已弹出的 report.html 与 incidents/ 目录
总结不要罗列所有字段，不需要重复网页报告里的完整数据——只给出判断和关键事件。
命令行直接调用参考
以下命令在 stability_auto_test/scripts/ 目录下执行。
python -m sat --package com.example.app --duration 30m --output ./reports/run01
python -m sat --config config.example.yaml --package com.example.app --output ./reports/r1
python -m sat --package com.android.settings --duration 30s --output ./reports/smoke
完整参数：python -m sat --help
