一款开源的 Windows 原生 Android 14 模拟器，集成了 AI 代理自动化和指纹强化的 Android 角色，用于应用测试、APK 分析和可重复的设备自动化工作流。
## 简介
REPlayer 是一个原生的 Windows Android 模拟器和自动化平台。它是 BlueStacks、LDPlayer 和 Nox 等闭源模拟器的开源替代方案，重点关注透明的 Android 模拟和代理自动化。
其 Android 14 角色**经过指纹强化**：REPlayer 应用了大量的 framework、属性、图形、Settings 和身份补丁，因此客户机不会呈现通常默认的出厂模拟器配置。逆向工程是其应用场景之一；可重复的 Android 自动化、应用测试以及由 agent 控制的设备工作流同样也是其核心用途。
## 预览
Native REPlayer chrome with the embedded Android 14 guest.
Provider-backed agents, queued tasks, controlled device access, and evidence.
## 核心特性
| | |
|---|---|
| **Android emulator** | 官方 Android Emulator，支持 WHPX 加速和原生嵌入式显示。 |
| **Agentic automation** | 并发的 provider 支持的 agent；支持并行观察和串行的同设备控制。 |
| **Hardened persona** | 中立的 REPlayer 身份，带有经过补丁处理的 framework、属性、图形、Settings 和隐秘的默认配置。 |
| **App tooling** | APK 工作流、ADB、Frida 集成、网络捕获、屏幕旋转、GPS 和设备控制。 |
| **Evidence** | 基于案例范围的日志、命令结果、捕获内容以及 JSONL agent 历史记录。 |
## 快速开始
完整的 Windows 发行版需要 64 位 Windows 11、硬件虚拟化以及 **Windows Hypervisor Platform**。解压并运行：
```
setup.bat
```
安装程序会按用户安装到 `%LOCALAPPDATA%\REPlayer` 下，验证应用/运行时清单，修复可重定位的 AVD 描述符，并创建“开始”菜单快捷方式。
## 从源码构建
```
dotnet restore REPlayer.sln
dotnet build REPlayer.sln -c Release --no-restore
```
输出路径：`ReVM/bin/Release/net9.0-windows/REPlayer.exe`
## 运行时与角色
运行时已固定并经过哈希验证。REPlayer 倾向于隐蔽的角色，移除或替换了 Android 属性、framework 资源、图形字符串、Settings 和产品品牌中许多高显著性的出厂模拟器标识符。发布和分析通道会保持其明确的 root/debug 策略。
运行时基线被刻意排除在 Git 之外。完整的发行版是在受信任的发布工作站上通过 `scripts/setup/New-REPlayerDistribution.ps1` 组装的。
## 自动化
Agent Center 支持跨 OpenRouter、OpenAI、Anthropic 和 Z.AI 配置排队的自然语言 Android 任务。只读工作可以并发执行；REPlayer 会对修改性操作进行分类，并按设备进行串行化处理。每个任务都有受限的轮次、取消机制、超时限制和 JSONL 证据。
外部自动化可以通过在 [docs/agent-harness.md](docs/agent-harness.md) 中描述的经过验证的 inbox/outbox 协议使用同一个协调器。
## 构建与发布
GitHub Actions 会在每次推送时构建、验证并打包一个独立的 `win-x64` 应用程序归档。`v*` 标签会创建带有 SHA-256 校验文件的草稿发布；预览标签仍保留为预发布版本。完整的发布版本会额外添加经过独立验证的 Android 运行时 payload。
## 文档
- [运行时架构](docs/runtime-architecture.md)
- [Agent 自动化](docs/agent-harness.md)
- [生产环境验证](docs/production-validation.md)
- [README 媒体指南](docs/media/README.md)
- [贡献指南](docs/CONTRIBUTING.md)
- [安全策略](docs/SECURITY.md)
- [第三方声明](docs/THIRD_PARTY_NOTICES.md)
## 许可证
REPlayer 源代码基于 [MIT License](LICENSE) 提供。第三方运行时、依赖项、服务和商标保留其各自的条款；请参阅 [第三方声明](docs/THIRD_PARTY_NOTICES.md)。
## 范围
指纹强化的设计旨在默认避免呈现为出厂模拟器；它并不宣称能够对抗硬件证明或所有的内核、Hypervisor、QEMU 设备或 ABI 级别的检测技术。
