# Venom

**Repository Path**: svpn/venom

## Basic Information

- **Project Name**: Venom
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-14
- **Last Updated**: 2026-11-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Venom — 安卓多开引擎

> **终极目标**：以原生系统为标杆，一切功能以安卓系统兼容为首要，提供安卓环境下最稳定、最极致的用户体验多开 APP。

| 项目 | 说明 |
|---|---|
| APP 名称 | Venom |
| APP 包名 | `org.os.venom`（**由 gradle 注入**，见 [docs/06_包名注入方案.md](docs/06_包名注入方案.md)） |
| 开发语言 | Java（引擎 + UI）、C++（native 层） |
| 适配范围 | Android 5.1 (API 22) ~ Android 17 (API 37) |
| 构建环境 | Gradle 8.14.5 / AGP 8.13.2 / NDK 27.0.12077973 / JDK 17+ |
| 引擎状态 | P0~P8 已真机验证（A11/A13 双端） |
| 功能基准 | `D:\Projects\AndroidStudioProjects\BlackBoxReborn-2.1.0`（功能清单对照基准，非正确性标准） |
| 隐藏 API 豁免 | [LSPosed/AndroidHiddenApiBypass](https://github.com/LSPosed/AndroidHiddenApiBypass)（见 [docs/07_HiddenAPI方案.md](docs/07_HiddenAPI方案.md)） |

## 设计原则

1. **原生为标杆**：一切伪装/改写决策以"同一 APK 原生安装 vs 沙箱运行"参数逐项对齐（ParityProbe）为准，参考项目只是线索源。
2. **兼容优先**：低版本（5.1/6.0/7.x）不支持的函数必须做版本分派；无法两全的硬性问题一律 **A/B 开关**取舍（见 [docs/05_兼容性方案.md](docs/05_兼容性方案.md)）。
3. **功能完整**：参考项目（BlackBoxReborn-2.1.0）的全部功能必须在新项目中落地，逐项对照（见 [docs/02_功能清单.md](docs/02_功能清单.md)）。
4. **可维护**：模块边界清晰、代码注解详细、每个任务/踩坑/验收都有文档记录。
5. **包名可换**：程序包名在 `build.gradle` 配置，经构建期注入 Java 与 C++，后续换包名只改一处。

## 文档索引

| 文档 | 内容 | 维护者 |
|---|---|---|
| [docs/01_架构设计.md](docs/01_架构设计.md) | 框架分层、模块职责、进程模型、启动流程、Hook 体系 | 架构负责人 |
| [docs/02_功能清单.md](docs/02_功能清单.md) | 参考项目全功能 → Venom 实现与状态对照表 | 全体 |
| [docs/03_任务看板.md](docs/03_任务看板.md) | 全栈任务工作内容、进度、未完成项（**活文档**） | 全体 |
| [docs/04_实现步骤.md](docs/04_实现步骤.md) | 各阶段详细实现步骤、开发流程、验收流程、代码注解规范 | 全体 |
| [docs/05_兼容性方案.md](docs/05_兼容性方案.md) | Android 5.1~17 适配矩阵、A/B 开关注册表 | 兼容负责人 |
| [docs/06_包名注入方案.md](docs/06_包名注入方案.md) | gradle → Java/C++/Manifest 的包名注入机制 | 工程负责人 |
| [docs/07_HiddenAPI方案.md](docs/07_HiddenAPI方案.md) | AndroidHiddenApiBypass 接入设计与降级链 | 工程负责人 |
| [docs/08_Git与版本规范.md](docs/08_Git与版本规范.md) | 提交纪律、版本更新内容格式 | 全体 |
| [docs/09_踩坑记录.md](docs/09_踩坑记录.md) | 详细踩坑点日志（含历史硬教训 B-01~B-58） | 全体 |
| [docs/10_路径与存储目录.md](docs/10_路径与存储目录.md) | 真实目录/可见路径映射、IO 重定向、/proc 视图、生命周期与已知边界 | 全体 |
| [docs/11_业界方案调研.md](docs/11_业界方案调研.md) | 多开技术路线全景（VA/BlackBox/LSPatch/厂商分身/风控生态）与吸收点 | 调研 |
| [docs/12_前车之鉴与经验汇编.md](docs/12_前车之鉴与经验汇编.md) | 检测面总清单 D1~D19、前人教训对照、盲目实现红线 | 全体 |
| [docs/13_基础测试文档.md](docs/13_基础测试文档.md) | 基础测试基线（demo/四大组件/功能/交互/压测/未覆盖清单，活文档） | 全体 |
| [docs/14_参考项目结构解剖.md](docs/14_参考项目结构解剖.md) | 参考项目模块/包地图、启动握手、进程与 50 槽位模型、组件虚拟化总览、Venom 对照 | 架构 |
| [docs/15_组件虚拟化细节.md](docs/15_组件虚拟化细节.md) | 安装链、任务栈算法、Service 生命周期/划卡/VPN、广播、Provider、Job、通知、WebView、IO、崩溃退避 | 引擎 |
| [docs/16_原生层与反检测细节.md](docs/16_原生层与反检测细节.md) | Hook 顺序、ArtMethod 校准、隐藏 API、Binder 身份、路径翻译、/proc 视图、加固壳边界 | 引擎 |
| [docs/17_Android版本适配矩阵.md](docs/17_Android版本适配矩阵.md) | API 22~37 逐版本变化/影响/处理、targetSdk 28 取舍、子系统适配与测试矩阵 | 兼容 |
| [docs/18_多厂家ROM适配.md](docs/18_多厂家ROM适配.md) | ROM 识别、MIUI/HyperOS 深项、EMUI/ColorOS/vivo/三星/Flyme、GMS/Integrity、红线与真机矩阵 | 兼容 |
| [docs/19_设计取舍与移植清单.md](docs/19_设计取舍与移植清单.md) | 底座决策、值得学/不可照搬、失败模式与不变量、分阶段移植路线 | 架构 |
| [docs/20_Venom启动与进程模型.md](docs/20_Venom启动与进程模型.md) | 进程类型、初始化顺序、IPC、20×16 槽位、三条启动路径、ensureBound 七步、死亡与划卡清理 | 引擎 |
| [docs/21_Venom服务端实现.md](docs/21_Venom服务端实现.md) | ServiceHub 11 服务、锁模型、安装/fixPaths、进程槽位与闸门、崩溃退避、通知与广播、持久化 | 引擎 |
| [docs/22_Venom运行时与Hook体系.md](docs/22_Venom运行时与Hook体系.md) | GuestRuntime 安装与消息拦截、Instrumentation/Startup/Task/Crash、InterfaceHook 与 20 个系统 Hook | 引擎 |
| [docs/23_Venom代理组件与组件分发.md](docs/23_Venom代理组件与组件分发.md) | StubGenerator、Activity/Dialog/Pending、Service/VPN/Job 容器、Provider 本地/远端、广播、失败语义 | 引擎 |
| [docs/24_Venom原生实现.md](docs/24_Venom原生实现.md) | JNI 表面、安装时序、PLT/GOT、IO 规则与 /proc 伪造、身份伪装、反检测、晚加载、诊断工具 | 引擎 |
| [docs/25_Venom兼容适配与开关.md](docs/25_Venom兼容适配与开关.md) | 版本基线、hiddenapi 三级链、API 分派、按包兼容、A/B 三层配置、per-app 选项、诊断与操作手册 | 兼容 |
| [docs/VERIFICATION.md](docs/VERIFICATION.md) | 真机验证日志（日期 + 根因 + 方案 + 验收） | 全体 |

## 设备要求（真机验证前必读）

- 验证设备：Android 11（MIUI 14，A11 基线）+ Android 13（A13 基线）双端；后续扩展 5.1/7.x/10/12/14/15/16/17 设备矩阵。
- **MIUI 后台弹窗管控会无日志静默丢弃占坑拉起**：设备装好后必须执行 `appops set <宿主包名> 10021 allow`。
- **Android 13+ 通知**：新装应用默认 `POST_NOTIFICATION: ignore`，需 `cmd appops set --uid <宿主uid> POST_NOTIFICATION allow` 或用户手动允许，否则沙箱 FGS 通知不显示。
- 宿主重装会重置运行时权限（定位/电话等），重装后需在宿主内重新弹窗授权。

## 快速开始

```bash
# 构建（默认双 ABI；-Pvenom.abi=32|64|all 选择性打包）
./gradlew :app:assembleDebug

# 构建 perf 变体（非 debuggable，性能基准用，约快 2 倍冷启动）
./gradlew :app:assemblePerf

# 安装
adb install -r app/build/outputs/apk/perf/app-perf.apk
```

## 项目状态

见 [docs/03_任务看板.md](docs/03_任务看板.md)。当前阶段：**P0~P8 已完成，进入兼容性修复与工程净化**。