ldplayer-control

name	ldplayer-control
description	LDPlayer 9 雷电模拟器 RE 实例管理。用于为逆向项目创建独立模拟器实例、启动/停止实例、管理 HTTPS 抓包代理、查看状态和安全清理实例。项目实例按 workspace 项目名隔离，index 0 预留给 MAA，所有写操作拒绝触碰 index 0。

雷电模拟器 RE 实例管理

ldplayer-control 负责管理逆向工程项目使用的 LDPlayer 9 实例。当前采用“模板实例 + 项目实例”的模型：re-base、re-xposed、re-stealth 是长期保留的已验证模板，真实目标 App 使用新的项目实例，从合适模板复制或从备份恢复，不直接污染模板。

硬约束

• Project 只允许 ASCII 字母、数字、点、下划线、短横线：^[A-Za-z0-9._-]+$。
• index 0 是 MAA 保留实例，re-init.ps1、re-proxy.ps1、re-destroy.ps1 和 ldplayer.ps1 的写操作都必须拒绝触碰。
• re-base、re-xposed、re-stealth 是模板实例，除升级模块和重新打 verified 备份外，不安装目标 App、不抓目标业务流量。
• 项目实例名必须与 workspace\<Project>\ 项目名一致；项目实例可以用 re-init.ps1 -Template <template> 从模板复制。
• re-proxy.ps1 默认端口是 8080 + instance index，避免多项目抓包互相抢端口。
• proxy-off 只停止当前项目 PID 文件记录的 mitmdump，不得全局杀所有 mitmdump。
• workspace 产物不随实例删除；re-destroy.ps1 -Remove 只删除 LDPlayer VM。
• 备份文件统一放在 D:\reverse_ENV\storage\ldplayer-backups\，不纳入 Git。

调用链路

新 App 逆向项目的模拟器链路固定如下：

article/INDEX.md 知识库检索
  -> choose template: re-base / re-xposed / re-stealth
  -> re-init.ps1 -Project <Project> -Template <Template>
  -> optional: apk-reverse/scripts/init-ldplayer-re.ps1 -DeviceSerial <ADB>
  -> re-proxy.ps1 -Project <Project> -Action on/off
  -> APK static/dynamic work via apk-reverse / native-reverse
  -> re-backup.ps1 only when the project/template state is worth preserving
  -> re-destroy.ps1 -Project <Project> [-Remove] for disposable project instances

职责边界：

需求	入口
创建/复制/启动/停止/删除 LDPlayer 实例	ldplayer-control
模板 verified 备份和 .ldbk 恢复	ldplayer-control
项目 HTTPS 代理和 flow 文件	ldplayer-control
指定 ADB 设备内 Root / Frida server 重新初始化	apk-reverse/scripts/init-ldplayer-re.ps1
APK 解包、静态分析、Frida Hook、重打包	apk-reverse

快速开始

# 1. 从已验证模板创建项目实例。默认推荐 re-xposed，强对抗场景用 re-stealth。
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-init.ps1" -Project myapp -Template re-xposed

# 2. 开启 HTTPS 抓包，flow 写入 workspace\myapp\mitmproxy_traffic.flow
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-proxy.ps1" -Project myapp -Action on

# 3. 查看实例
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-list.ps1"

# 4. 关闭代理
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-proxy.ps1" -Project myapp -Action off

# 5. 停止实例
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-destroy.ps1" -Project myapp

# 6. 项目实例坏了就删掉重建，模板坏了才从 verified 备份恢复
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-restore.ps1" -Project re-xposed -SourceProject re-xposed -Force

脚本清单

脚本	用途	关键参数
scripts/re-init.ps1	创建、复制模板、配置、启动项目实例	-Project, -Template, -Resolution, -Cpu, -Memory, -NoLaunch
scripts/re-list.ps1	查看 LDPlayer 实例并标注 MAA/RE/NONASCII/ORPHAN	-Project
scripts/re-proxy.ps1	开启或关闭单项目 HTTPS 抓包	-Project, -Action, -ProxyPort
scripts/re-backup.ps1	将模板或项目实例备份为 .ldbk	-Project, -Tag, -BackupRoot, -NoStop
scripts/re-restore.ps1	从 .ldbk 恢复到已有实例，按 index 恢复并重命名回目标实例名	-Project, -SourceProject, -BackupFile, -BackupRoot, -Force
scripts/re-destroy.ps1	停止实例，可选删除 VM	-Project, -Remove, -Force
tools\ldplayer\ldplayer.ps1	底层原子操作封装	-Action, -Index / -Name

实例模型

LDPlayer instances
  [0] MAA reserved instance    -> DO NOT TOUCH
  [1] reverse                  -> seed / legacy RE instance
  [2] re-base                  -> template: root + Frida + CA/proxy readiness
  [3] re-xposed                -> template: re-base + LSPosed + JustTrustMe
  [4] re-stealth               -> template: re-xposed + Hide My Applist + Shamiko
  [5+] myapp                   -> project instance cloned from a template

模板分层：

模板	用途	已验证能力
re-base	低干扰快速动态调试	Android 9 / Root / Kitsune Mask v27.0 / Frida 17.15.3 / mitmproxy CA
re-xposed	日常 App 逆向默认环境	re-base + LSPosed v1.9.2 + JustTrustMe v2
re-stealth	需要 Root/模块隐藏的强检测目标	re-xposed + Hide My Applist V3.6.1 + Shamiko v0.7.5

模板不要直接用于目标项目。新任务按风险选择模板后复制：

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-init.ps1" -Project target-demo -Template re-base
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-init.ps1" -Project target-demo -Template re-xposed
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-init.ps1" -Project target-demo -Template re-stealth

re-list.ps1 分类规则：

Type	含义	处理策略
MAA	index 0，MAA 保留实例	只读查看，不做写操作
RE	名称符合项目命名规则	可由本 skill 管理
NONASCII	名称存在但不符合 ASCII 项目名规则	不作为托管 RE 项目
ORPHAN	空名或异常实例	人工确认后再清理

re-init.ps1

创建或复用项目实例，并配置 root、分辨率、CPU 和内存。传 -Template 时会复制模板实例；未显式传 -Resolution、-Cpu、-Memory 时保留模板配置。

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-init.ps1" -Project myapp

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-init.ps1" `
  -Project myapp -Resolution "1280,720,240" -Cpu 2 -Memory 2048

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-init.ps1" `
  -Project myapp -Template re-xposed

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-init.ps1" -Project myapp -NoLaunch

执行链路：

validate project name
  -> ldconsole list2
  -> if project exists: reject index 0, launch if stopped
  -> if missing and -Template: ldconsole copy --name <project> --from <template>
  -> if missing without -Template: ldconsole add
  -> ldconsole modify --root 1 --resolution --cpu --memory when creating from scratch or explicit overrides exist
  -> launch unless -NoLaunch
  -> wait for ADB ready

模块与 LSPosed Scope

模块资产统一放在 D:\reverse_ENV\tools\android-modules\，该目录只跟踪 README.md，APK/ZIP 本体不进 Git。

模块	当前用途
Kitsune Mask v27.0	模拟器 Root 管理，当前模板基座
LSPosed v1.9.2	Zygisk Xposed 框架
JustTrustMe v2	SSL Pinning 快速绕过模块，re-xposed / re-stealth 已安装并启用模块本体
Hide My Applist V3.6.1	App 列表隐藏，re-stealth 已安装并启用模块本体
Shamiko v0.7.5	当前 Kitsune/Magisk 27001 上已验证可用的 Root 隐藏模块
Shamiko v1.2.5	已归档但未用于模板；要求 Magisk Canary > 27005，当前环境安装会失败

模板内 LSPosed 模块只启用模块本体，不预设目标 App scope。每个项目复制实例后再按目标包名设置 scope，避免模板全局污染导致定位问题。

备份与恢复

verified 模板备份位于 D:\reverse_ENV\storage\ldplayer-backups\：

re-base.verified.20260707_104718.ldbk
re-xposed.verified.20260707_104718.ldbk
re-stealth.verified.20260707_104718.ldbk

备份模板：

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-backup.ps1" -Project re-xposed -Tag verified

恢复到同名模板：

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-restore.ps1" -Project re-xposed -SourceProject re-xposed -Force

恢复到临时测试实例时，先创建目标实例，再指定来源：

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-init.ps1" -Project restore-test -Template re-base -NoLaunch
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-restore.ps1" -Project restore-test -SourceProject re-xposed -Force

实测 ldconsole restore 会恢复备份内部实例名。re-restore.ps1 必须按目标 index 恢复，并在恢复后执行 rename --index <index> --title <Project>，否则把 re-xposed 备份恢复到临时实例时会产生第二个同名 re-xposed。

re-proxy.ps1

对指定项目实例开启或关闭 HTTPS 抓包。

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-proxy.ps1" -Project myapp -Action on

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-proxy.ps1" -Project myapp -Action off

# 如需手动指定端口
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-proxy.ps1" -Project myapp -Action on -ProxyPort 8091

执行链路：

validate project name
  -> resolve project name to instance index
  -> reject index 0
  -> require instance running
  -> delegate to tools\ldplayer\ldplayer.ps1 proxy-on/proxy-off

proxy-on 行为：

• 推送 D:\reverse_ENV\tools\c8750f0d.0 到模拟器。
• root 后 bind mount CA 到 /system/etc/security/cacerts。
• 建立 adb reverse tcp:<port> tcp:<port>。
• 设置 Android 全局代理 127.0.0.1:<port>。
• 启动项目专属 mitmdump，PID 写入 workspace\<Project>\mitmdump.pid。
• flow 写入 workspace\<Project>\mitmproxy_traffic.flow。

proxy-off 行为：

• 清理 Android 全局代理。
• 移除当前端口的 adb reverse。
• 只停止 workspace\<Project>\mitmdump.pid 指向的进程。

re-destroy.ps1

停止项目实例，可选删除 LDPlayer VM。

# 只停止
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-destroy.ps1" -Project myapp

# 停止并删除，需要输入项目名确认
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-destroy.ps1" -Project myapp -Remove

# 非交互删除
powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\skill\ldplayer-control\scripts\re-destroy.ps1" -Project myapp -Remove -Force

安全边界：

• 拒绝 index 0。
• -Remove 删除的是 LDPlayer 实例，不删除 workspace\<Project>\。
• 非 -Force 模式必须输入项目名确认。

底层工具

底层封装路径：

powershell -NoProfile -ExecutionPolicy Bypass -File "D:\reverse_ENV\tools\ldplayer\ldplayer.ps1" -Action list

常用 action：

Action	用途	关键参数
list	列出实例	无
status	查看实例状态	-Index 或 -Name
launch / quit / reboot	启停和重启	-Index 或 -Name
copy	从模板或源实例复制	-Name, -From
install / uninstall / runapp	APK 和 App 管理	-ApkPath, -PackageName
adb	执行 ldconsole adb command	-Command
proxy-on / proxy-off	抓包代理	-Index, -Project, -ProxyPort

除 list/status/add/copy 外，底层写操作会解析目标实例并拒绝 index 0。

本机环境

项目	值
LDPlayer CLI	D:\leidian\LDPlayer9\ldconsole.exe
LDPlayer ADB	D:\leidian\LDPlayer9\adb.exe
控制脚本	D:\reverse_ENV\tools\ldplayer\ldplayer.ps1
mitmdump	D:\reverse_ENV\.venv\Scripts\mitmdump.exe
mitmproxy CA	D:\reverse_ENV\tools\c8750f0d.0
Android 模块资产	D:\reverse_ENV\tools\android-modules\
LDPlayer 备份	D:\reverse_ENV\storage\ldplayer-backups\
workspace	D:\reverse_ENV\workspace\

故障排查

症状	排查
ERR:invalid_project_name	项目名只能用 ASCII 字母、数字、点、下划线、短横线
ERR:project_resolves_to_index_0_MAA	项目名匹配到了 index 0，必须换项目名
ERR:instance_not_running	先执行 re-init.ps1 -Project <name>
ERR:template_instance_not_found	先确认 re-base / re-xposed / re-stealth 是否存在
ERR:mitmproxy_ca_not_found	确认 D:\reverse_ENV\tools\c8750f0d.0 存在
端口冲突	显式传 -ProxyPort，或检查旧项目的 mitmdump.pid
没有抓到 HTTPS	检查 CA bind mount、App 是否证书固定、代理是否被 App 绕过
Shamiko 1.2.5 安装失败	当前 Kitsune/Magisk 27001 不满足 Magisk Canary > 27005 要求；使用已验证的 Shamiko v0.7.5