# SoloPi Android Testing

Runs Android device tests and writes acceptance reports with full screenshots.

- Repository: https://github.com/alipay/SoloPi (6352 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-10-23
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add alipay/SoloPi --skill solopi-ai -g -a claude-code -y`
Codex: `npx skills add alipay/SoloPi --skill solopi-ai -g -a codex -y`
Cursor: `npx skills add alipay/SoloPi --skill solopi-ai -g -a cursor -y`
Gemini CLI: `npx skills add alipay/SoloPi --skill solopi-ai -g -a gemini-cli -y`

## Description

通过 SoloPi Harness 运行 Android 真机测试、选择支付宝内置模板并生成带完整截图的验收报告。默认使用规则，Laya 为可选的电脑本地实验模式。也支持从需求/AC 编译验证计划、交互录制、回放、动态 Agent、性能监控、签名端侧模型和多设备 CI。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# SoloPi AI 控制框架

将本文件所在目录作为 Skill 根目录。只使用 Skill 的薄入口：

```bash
scripts/solopi-ai --pretty <命令>
```

执行时把 `scripts/solopi-ai` 解析为绝对路径，并保持调用者当前工作目录不变。Harness 实现与内置模板随本 Skill 放在 `scripts/harness/`，入口默认只调用这一份实现，不依赖仓库外的同级目录或已安装的 Python 包。调用方显式配置 `SOLOPI_HARNESS_CLI` 时可指定另一准确 CLI；普通使用无需配置。不得自行拼接 HTTP、Scheme 或 Shell 命令代替类型化 CLI。

安装时完整复制本 Skill 目录，保留脚本执行权限；运行需要 Python 3.9+ 和设备操作所需的 ADB。Laya 权重、虚拟环境、APK 和真机证据不随 Skill 打包。独立安装与本地验证见[内置工作流](references/workflows.md#安装与目录)。

全局参数必须放在子命令前。多台设备在线时，每次调用都必须添加 `--serial <adb-serial>`。

## 快速使用

用户要“连接手机跑几个案例”“运行支付宝模板”“查看带截图的结果”时，优先读取
[内置工作流](references/workflows.md)，使用以下入口：

```bash
scripts/solopi-ai --pretty workflow-list
scripts/solopi-ai --serial <adb-serial> --pretty workflow-run --template alipay-more-services
scripts/solopi-ai --pretty workflow-report --artifacts <上一步返回的artifacts>
```

默认规则模式不加载模型。只有用户明确选择 Laya 实验时，才传 `--mode laya --model <本地MLX权重目录>`；
模型运行在电脑上。不要为这些模板安装 companion APK，也不要把模型输出当成验收结论。
`workflow-run` 自动完成预检、计划编译与校验、执行及截图报告；前置页面不满足时保留 `not_tested`，
不自动重跑。完成后返回 Markdown 报告路径，并说明三态结果、清理结果和截图是否齐全。

## 能力路由

需要判断某项 App 能力是直接 CLI、用例间接、用户交互还是暂不可安全自动化时，先读取 [能力矩阵](references/capability-matrix.md)。需要证明页面、设置和动作是否已纳入覆盖时，再读取 [App 功能覆盖清单](references/app-feature-inventory.md)。

The rest: https://github.com/alipay/SoloPi/blob/HEAD/solopi-skill/SKILL.md