FakePers

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #llm #golang #machine-learning #macos #nodejs #vue #security #pytorch #mcp #ios

(★ 15)

一款写给测试者与隐私偏好者的 LSPosed 权限伪装模块

FakePers Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FakePers

**权限可以假装给了 · 隐私不必真的交出**

一款写给测试者与隐私偏好者的 LSPosed 权限伪装模块

[![Platform](https://img.shields.io/badge/Platform-Android%208%2B-3DDC84?style=flat-square)](https://raw.githubusercontent.com/pwh-pwh/FakePers/main/)
[![LSPosed](https://img.shields.io/badge/LSPosed-Module-8B5CF6?style=flat-square)](https://raw.githubusercontent.com/pwh-pwh/FakePers/main/)
[![Kotlin](https://img.shields.io/badge/Kotlin-2.x-7F52FF?style=flat-square)](https://raw.githubusercontent.com/pwh-pwh/FakePers/main/)
[![YukiHookAPI](https://img.shields.io/badge/YukiHookAPI-1.3-0EA5E9?style=flat-square)](https://raw.githubusercontent.com/pwh-pwh/FakePers/main/)
[![Compose](https://img.shields.io/badge/UI-Jetpack%20Compose-4285F4?style=flat-square)](https://raw.githubusercontent.com/pwh-pwh/FakePers/main/)
[![Release](https://img.shields.io/github/v/release/pwh-pwh/FakePers?style=flat-square&label=Release)](https://github.com/pwh-pwh/FakePers/releases)

</div>

---

## 故事从那句「请允许访问」说起

打开一个 App，屏幕中央弹出熟悉的对话框：

> 需要访问通讯录 / 文件 / 位置……

点「允许」，生活得以继续；点「拒绝」，功能大门常常立刻合上。  
很多时候你并不想把真实通讯录、相册与轨迹交给对方——你只想**顺利走过那道门**。

系统里的权限检查，本质上是在回答一个问题：

> **「你有没有被允许？」**

**FakePers** 想做的，不是在系统设置里真的打开那把锁，  
而是在目标 App 耳边轻轻说一声：

> **「可以。但房间里什么也没有。」**

检查层返回「已授权」，敏感数据侧可选返回空结果——  
App 以为自己通过了门禁，却读不到你的真名、真号、真照片。  
像给好奇心穿上一层雾：路可以走，隐私仍留在雾后。

名字 **FakePers**，来自 *Fake Permissions* 的缩写——  
假的是「许可的姿态」，真的是「对边界的尊重」。

---

## 它能做什么

| 能力 | 说明 |
|------|------|
| **权限检查伪装** | `checkSelfPermission` / `PackageManager.checkPermission` 等返回已授予 |
| **请求流程跟进** | 运行时 `requestPermissions` 与常见 Activity Result 合约结果可伪装为同意 |
| **按应用细控** | 每个包独立开关；权限组分项勾选，不搞「一刀切」 |
| **空数据桩** | 通讯录 / 短信 / 通话记录 / 日历 / 媒体库查询可返回空 Cursor |
| **电话标识弱化** | 启用电话组时，号码 / 设备标识类 getter 可返回空串 |
| **共享配置** | 管理端写入，目标进程通过 YukiHookPrefs 读取，日常不必为改配置去 Root |

### 权限组一览

| 组 | 覆盖的常见意图 |
|----|----------------|
| 存储 / 媒体 | 读写存储、分区媒体权限 |
| 通讯录 | 读写信录、账号 |
| 电话 | 电话状态、号码、拨打相关 |
| 短信 | 收发读短信 |
| 通话记录 | 通话历史 |
| 日历 | 读写日程 |
| 位置 | 精粗定位与后台定位 |
| 相机 / 麦克风 | 成像与录音权限声明 |
| 传感器 | 体感、活动识别 |
| 附近设备 | 蓝牙扫描连接、附近 Wi‑Fi 等 |

> **作用域仍由你在 LSPosed 里亲手勾选。**  
> FakePers 不替框架做决定——诚实，比「一键全开」更重要。

---

## 它不做什么

写清楚边界，比夸大功能更重要。

- **不会**在系统层真实授权（设置里权限页可能仍显示未授予）
- **不会** Hook AppOps / `system_server` 做深层系统改造
- **不会**伪造相机画面、麦克风音频或真实轨迹数据  
  （位置类若需深度模拟，可搭配 [Locus](https://github.com/pwh-pwh/Locus) 等模块）
- **绕不过**服务端二次校验「是否真授权」的 App——那是另一层信任模型

FakePers 的哲学是：**骗过门卫的点头，不必交出房间的钥匙。**

---

## 开始使用

### 1. 安装模块

从 [Releases](https://github.com/pwh-pwh/FakePers/releases) 下载 `FakePers-*.apk`，或自行编译：

```bash
./gradlew :app:assembleDebug
# 产物：app/build/outputs/apk/debug/app-debug.apk
```

### 2. 在 LSPosed 中启用

1. 打开 LSPosed → 模块 → 启用 **FakePers**  
2. 勾选需要伪装的目标应用（作用域）  
3. 按提示重启相关作用域（或重启目标 App）

### 3. 在 FakePers 里写好「剧本」

| 步骤 | 操作 |
|------|------|
| ① | 打开 **状态** 页，确认模块已激活，打开 **总开关** |
| ② | 进入 **应用**，搜索并点开目标包名 |
| ③ | 启用伪装 → 勾选权限组 → 按需打开 **空数据桩** → 保存 |
| ④ | **强制停止**并重新打开目标 App，让配置生效 |

管理端底部三页：**状态 · 应用 · 关于**——从总览到细控，再到边界说明。

---

## 技术栈

```
Kotlin 2.x · Jetpack Compose · Material 3
YukiHookAPI + KavaRef · LSPosed / Xposed API 82
minSdk 26 · compile / targetSdk 35
```

工程骨架与配置同步思路对齐同作者的 Locus 模块：  
管理端与 Hook 侧共享一份 prefs，职责分离、便于维护。

---

## 发布（GitHub Actions）

推送版本标签即可自动构建 APK 并挂到 Release：

```bash
git tag v0.1.0
git push origin v0.1.0
```

| 项 | 说明 |
|----|------|
| 工作流 | `.github/workflows/release.yml` |
| 产物名 | `FakePers-<version>.apk`（`assembleRelease`，便于侧载的 debug 签名） |
| 可选 Secret | `DEBUG_KEYSTORE_BASE64`：固定签名，方便覆盖安装 |

`main` 与 PR 会跑轻量 CI（单测 + debug 构建），避免坏掉的代码悄悄上岛。

---

## 写在最后

权限对话框从来不只是 UI 组件——它是 App 与人之间的一份临时契约。  
有些契约你愿意签；有些你只想礼貌地点头，却把真正的故事留在本地。

**FakePers** 是给后者的一把小工具：  
在合法、自有设备与授权测试场景里，让「功能可走通」与「数据可少交」多一点点共存空间。

> 请仅在你有权操作的设备与环境中使用。  
> 尊重他人隐私，也保护好自己的边界。

---

**Fake Permissions · 假的是许可 · 真的是边界**

</div>

---

## 真机测试台（testapp）

仓库内附带模块 **`:testapp`**（包名 `com.pwh.fakepers.testapp`），用于在真机上验证 FakePers：

| 页 | 作用 |
|----|------|
| 说明 | 自测步骤与判定标准 |
| 检查 | 多 API 权限检查对比 |
| 请求 | 全量 / 按组请求权限 |
| 读数据 | Contacts / SMS / CallLog / Media / Telephony 探测 |

```bash
./gradlew :testapp:assembleDebug
# APK: testapp/build/outputs/apk/debug/testapp-debug.apk
adb install -r testapp/build/outputs/apk/debug/testapp-debug.apk
```

LSPosed 作用域勾选 **FakePers 测试台**，在 FakePers 管理端为本包启用对应权限组即可。

FakePers

FakePers Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

FakePers

FakePers Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README