apk-reverse-skill
Manifest valid★ 3Mobile-first Android APK reverse-engineering skill for DSH and DSH Go — decode with jadx/apktool, locate ad SDKs and entitlement logic, patch smali or values, repack/align/sign, then verify on a real
apk-reverse · 手机版逆向skill
Android APK Reverse Engineering Skill
Unpack it, understand it, patch it, prove it works.
About · Capabilities · Quick start · Usage · Layout · Docs · Verify · Contributing · License
🌐 English · 中文
Install in DSH Go / DeepSeek Harness
| Way | Action |
|---|---|
| DSH Go App marketplace (recommended; index data from awesome-dsh-plugin) | App → Plugins → search apk-reverse → install; restart the core |
| Plugin command | dsh plugin --profile web add github:xiaotianya14/apk-reverse-skill |
| Manual | Download the release zip, unzip, dsh plugin --profile web add <dir> |
- Skill name:
apk-reverse. Trigger it by asking to reverse/decode an APK, analyze third-party ad components, or inspect entitlement logic. - On a phone you do not need adb: DSH Go ships phone-control tools (
screen,tap,type,open,key,handoff) for on-device verification. - Desktop (Linux/WSL) works with the same commands and toolchain.
- Manual package needs unzipping:
dsh plugin addaccepts a local directory, an npm package, orgithub:owner/repo— not a zip. Unzip the release package first, then rundsh plugin --profile web add <unzipped-dir>. Marketplace and plugin-command installs need no unzip.
中文说明(安装到 DSH Go)
| 方式 | 操作 |
|---|---|
| DSH Go App 插件市场(推荐;目录数据来自 awesome-dsh-plugin) | App → 插件市场 → 搜 apk-reverse → 安装;重启内核生效 |
| 插件命令 | dsh plugin --profile web add github:xiaotianya14/apk-reverse-skill |
| 手动包 | 下载 Release 的 zip → 解压 → dsh plugin --profile web add <目录> |
- 技能名:
apk-reverse;装好后在对话里说「逆向这个 APK / 分析广告组件 / 看付费逻辑」即可触发。 - 手机端不需要 adb:DSH Go 自带手机操控工具(
screen/tap/type/open/key/handoff)可做真机验证。 - 电脑端(Linux/WSL)同样可装,命令与工具链一致。
- 手动包要解压:
dsh plugin add只接受「本地目录 / npm 包名 / github:owner/repo」,不收 zip;所以离线包要先解压成文件夹,再dsh plugin --profile web add <那个文件夹>。商城安装与插件命令都不用解压。 - 收录情况:App 插件市场的目录数据来自 awesome-dsh-plugin。
About
If you are an AI agent, open
SKILL.mdand follow its routing, consent and patch rules before touching any target.
A practical Android APK reverse-engineering skill for phone-based work. It turns “I have an APK” into a repeatable loop instead of guessed commands:
APK
→ toolcheck / install_tools (is the toolchain ready?)
→ decode + manifest_summary (unpack, decompile, map components)
→ scan_premium / find_api_calls (find the logic and the ads)
→ patch smali / manifest / .so (make the smallest change)
→ build_sign (repack, align, sign)
→ device verify (install, launch, check behaviour)
→ field-journal (write down cause → fix)
Why this exists
- APK tasks need a different playbook from generic coding tasks
- jadx / apktool / Frida / IDA are easy to install but easy to misuse
- Phone-only workflows (proot Ubuntu on ARM64) have their own pitfalls
- The same “why did it crash after repacking?” problems get solved twice
At a glance
| Version | Scripts | Reference docs | CI | License |
|---|---|---|---|---|
| v0.6.9 | 32 + 12 Frida | 24 | GitHub Actions | MIT |
⭐ Star this repo · 🍴 Fork · 🐛 Report an issue
Capabilities
| Area | What it does |
|---|---|
| Decompilation | jadx sources, apktool resources/smali, smali3, CFR |
| Components & ads | SDK signatures, manifest / layout / resource inspection |
| Logic analysis | paid & entitlement checks, numeric logic, storage (SharedPreferences / SQLite) |
| Patching | smali patches, static fields, native .so instruction patches |
| Protection | packers, signature checks, integrity checks |
| Dynamic & network | Frida, objection, mitmproxy, certificate-pinning adaptation |
| Delivery | repack, align, sign, install and verify on device |
Quick start
SK=/path/to/apk-reverse
bash $SK/scripts/toolcheck.sh # tool check
bash $SK/scripts/install_tools.sh # install missing tools
bash $SK/scripts/decode.sh app.apk --out ./work # decode
python3 $SK/scripts/manifest_summary.py ./work # manifest summary
python3 $SK/scripts/scan_premium.py ./work # paid/entitlement candidates
python3 $SK/scripts/find_api_calls.py ./work # API and credential hints
bash $SK/scripts/build_sign.sh ./work out.apk # repack + sign
Tool downloads are verified against scripts/download-sha256.txt (SHA256); a mismatch aborts
the install, and an unpinned version prints its hash with a warning.
Usage
- The workflow rules and patch patterns live in
SKILL.md; reference docs underreferences/explain each step in depth. - Everything runs in proot Ubuntu on ARM64; a regular Linux machine works too.
- Build a release:
bash scripts/make_release.sh --name apk-reverse --public→ zip(+ 本地.sha256,发布附件只传SHA256SUMS), then the extracted copy is re-checked. - Verify a release:
bash scripts/verify_release.sh <zip>(reads.sha256orSHA256SUMS). - Publish to GitHub:
bash scripts/publish_github.sh --tag v<version> --release; the token comes from$GITHUB_TOKENor~/.config/dsh-go/github-tokenand never enters the repo.
Repository layout
apk-reverse/
├── SKILL.md # routing / workflow / patch patterns / rules
├── references/ # topic docs
├── scripts/ # executable tools
├── field-journal/ # reusable problem → cause → fix notes
├── assets/ # banner, icon and social preview images
├── AGENTS.md # agent activation and consent boundaries
├── SECURITY.md # trust model and reporting
├── CONTRIBUTING.md
├── CHANGELOG.md
├── VERSION
└── LICENSE # MIT
Documentation
references/identity-check.md— local identity card, no online lookupsreferences/mobile-toolchain.md— toolchain and installationreferences/patch-patterns.md— smali / manifest / layout patchingreferences/protection-map.md— packers, integrity checks, traffic capturereferences/device-verify.md,references/device-control.md— on-device verificationreferences/security-audit.md— exported components, WebView, secretsdocs/STAGES.md— six-stage workflow: entry, artifacts, gate for each stagedocs/REPORT-TEMPLATE.md— analysis report template (conclusion first, evidence chain)docs/MCP-INTEGRATION.md— JADX / Ghidra / IDA / Burp MCP integration notesscripts/frida/README.md— Frida script library (SSL unpinning, anti-debug, exit blocker, root bypass, Frida hider, return-value patcher)tests/routing_cases.json— routing regression cases (CI checks withscripts/check_routing.py)docs/ENVIRONMENTS.md— phone proot vs Termux vs desktop agent, and where this skill fitsreferences/kotlin-r8-recovery.md— R8/ProGuard obfuscation and Kotlin name recoveryreferences/api-extraction.md— API / auth headers / third-party host extractionreferences/on-device-tooling.md— on-device GUI toolchain: MT Manager / NP Manager / LSPosed / Termux vs scriptsreferences/lsposed-modules.md— LSPosed module fallback when repacking is refusedreferences/decompilers.md— decompiler choice: jadx / Fernflower / ddc (with on-phone install)references/triage-playbook.md— 15-minute triage checklistdocs/EVIDENCE.md— evidence levels and ledger discipline (scripts/ledger.py)docs/APP-INTEGRATION.md— using this skill inside the phone appreferences/native-fuzzing.md— native fuzzing (AFL++/ASan) feasibility- See the index at the end of
SKILL.md
Release integrity
Every release ships a SHA256SUMS file; recipients verify with:
sha256sum -c SHA256SUMS
# or
bash scripts/verify_release.sh apk-reverse.zip SHA256SUMS
Contact
- Email: xiaotianya14@gmail.com
- QQ Group: 258605008
- Feedback: GitHub Issues
Contributing
Contributions are welcome — issues, better patch patterns, new reference docs, field-journal notes.
- Fork the repository
git checkout -b feature/your-idea- Commit your change (
git commit -m 'Add your idea') git push origin feature/your-idea- Open a pull request
Please keep changes inside the consent and authorization boundaries described in
AGENTS.md and SECURITY.md.
Contributors
Contributors — PRs welcome.
Built with
jadx · apktool · Frida · IDA Pro · Ghidra
Acknowledgments
Thanks to the open-source tool authors behind jadx, apktool, Frida, radare2, Ghidra and every tool this skill relies on. This project is a workflow layer on top of their work.
License & usage scope
Code & docs: original content in scripts/, docs/, SKILL.md and references/ is MIT-licensed (see LICENSE). Copies and redistributions must retain the copyright and license notice.
Visual assets are NOT licensed: avatars, banners, icon, social image and badge styles in assets/ remain © xiaotianya14, all rights reserved — no commercial use, no redistribution, no relicensing. Do not extract them separately when referencing this repository.
Private materials: game-mod notes, working records and internal materials are not published and not licensed.
Third-party tools: jadx, apktool, Frida and other tools, SDKs and trademarks remain under their own terms. This project does not license them on behalf of their owners and does not bundle them. Method inspiration from upstream projects is credited in NOTICE.
Usage & disclaimer: for learning/research on applications you own or are authorized to test only. You are responsible for data loss, device damage and legal risk. Do not use it against other people's devices, unauthorized apps, or in violation of platform terms. No warranty; the authors accept no liability.
Rights contact: if you believe this project infringes your rights, please open a GitHub Issue or email xiaotianya14@gmail.com; we will remove or adjust the relevant content after verification.
Comments
Loading…
Similar plugins
by Gladess1102
Agent Skill + DSH plugin: field-tested black-box legacy firmware RE methodology (SigmaTel STMP35xx case study). 零变砖刷写·全量汉化·DSP JIT 仿真·证伪矩阵
★ 1
MIT
JavaScript
Nov 4, 2026
dsh plugin --profile web add dsh-fw-reconby zhz8888
Android development toolchain inside DeepSeek Harness: 23 android_* tools that find the SDK, create and manage AVDs, start and stop emulators, scaffold a Kotlin/Compose project, build and run it with
★ 3
↓ 625/wk
JavaScript
Nov 9, 2026
dsh plugin --profile web add @zhz8888/dsh-android-emulator-helperby Hyna-hla
DSH Remote 手机遥控端:把电脑上的 DeepSeek Harness 装进口袋。手机连上就能给 AI 派活、看实时回复、批审批;支持局域网/内网穿透、扫码连接、审批通知、会话管理、多主题换装,还能解锁加密保险库。第三方社区作品,开源免费。
★ 23
↓ 32/wk
MIT
Kotlin
Aug 31, 2026
dsh plugin --profile web add dsh-remote-accessby MatriQ
Portable Agent Skill for Android game Google Play dependencies, resources, Firebase, and ads.
★ 15
Python
Nov 10, 2026
dsh plugin --profile web add dsh-rea-gpCoding agent preset plus an embedded coding-discipline skill for DeepSeek Harness: verify-first edits, minimal diffs, real test runs and evidence-based reports.
★ 0
dsh plugin --profile web add dsh-coding-disciplineDeepSeek App-style mobile shell for the DSH Web UI with drawer navigation, app-like composer and settings; best paired with the dsh-android app, which supplies the native Android back key (standalone
★ 0
dsh plugin --profile web add dsh-mobile-shell