chore(agents): 添加 Android 逆向工程 skill

包含 APK 反编译、API 调用提取、调用链分析、Kotlin 名称恢复等参考文档,
以及 jadx/fernflower 相关脚本与第三方域名过滤列表。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
voidandClaude Sonnet 4.6 committed 2026-11-08 21:15:24 +08:00
1 parent 252b7088cf
commit c29e425996
19 files changed
+4392

No files matched your search

@@ -0,0 +1,165 @@
# check-deps.ps1 — Verify dependencies and report what's missing
# Output includes machine-readable INSTALL_REQUIRED/INSTALL_OPTIONAL lines.
$ErrorActionPreference = 'Stop'
# Refresh PATH from user environment so we pick up tools installed in the same session
$userPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
if ($userPath) {
foreach ($dir in $userPath -split ';') {
if ($dir -and $env:PATH -notlike "*$dir*") {
$env:PATH = "$dir;$env:PATH"
}
}
}
$REQUIRED_JAVA_MAJOR = 17
$errors = 0
$missingRequired = @()
$missingOptional = @()
Write-Host "=== Android Reverse Engineering: Dependency Check ==="
Write-Host ""
# --- Java ---
$javaOk = $false
$javaBin = Get-Command java -ErrorAction SilentlyContinue
if ($javaBin) {
$javaVersionOutput = & java -version 2>&1 | Select-Object -First 1
$javaVersionStr = "$javaVersionOutput"
if ($javaVersionStr -match '"(\d+)') {
$javaVersion = [int]$Matches[1]
if ($javaVersion -eq 1 -and $javaVersionStr -match '"1\.(\d+)') {
$javaVersion = [int]$Matches[1]
}
if ($javaVersion -ge $REQUIRED_JAVA_MAJOR) {
Write-Host "[OK] Java $javaVersion detected"
$javaOk = $true
} else {
Write-Host "[WARN] Java detected but version $javaVersion is below $REQUIRED_JAVA_MAJOR"
$errors++
$missingRequired += "java"
}
} else {
Write-Host "[WARN] Java detected but could not parse version from: $javaVersionStr"
$errors++
$missingRequired += "java"
}
} else {
Write-Host "[MISSING] Java is not installed or not in PATH"
$errors++
$missingRequired += "java"
}
# --- jadx ---
$jadxBin = Get-Command jadx -ErrorAction SilentlyContinue
if (-not $jadxBin) {
# Check common Windows install locations
$jadxCandidates = @(
"$env:USERPROFILE\.local\share\jadx\bin\jadx.bat",
"$env:USERPROFILE\jadx\bin\jadx.bat",
"$env:LOCALAPPDATA\jadx\bin\jadx.bat"
)
foreach ($c in $jadxCandidates) {
if (Test-Path $c) {
$jadxBin = $c
break
}
}
}
if ($jadxBin) {
try {
$jadxCmd = if ($jadxBin -is [string]) { $jadxBin } else { 'jadx' }
$jadxVersion = & $jadxCmd --version 2>$null
Write-Host "[OK] jadx $jadxVersion detected"
} catch {
Write-Host "[OK] jadx detected"
}
} else {
Write-Host "[MISSING] jadx is not installed or not in PATH"
$errors++
$missingRequired += "jadx"
}
# --- Fernflower / Vineflower ---
$ffFound = $false
$vineflowerBin = Get-Command vineflower -ErrorAction SilentlyContinue
$fernflowerBin = Get-Command fernflower -ErrorAction SilentlyContinue
if ($vineflowerBin) {
Write-Host "[OK] vineflower CLI detected"
$ffFound = $true
} elseif ($fernflowerBin) {
Write-Host "[OK] fernflower CLI detected"
$ffFound = $true
} else {
$ffCandidates = @(
$env:FERNFLOWER_JAR_PATH,
"$env:USERPROFILE\.local\share\vineflower\vineflower.jar",
"$env:USERPROFILE\fernflower\build\libs\fernflower.jar",
"$env:USERPROFILE\vineflower\build\libs\vineflower.jar",
"$env:USERPROFILE\fernflower\fernflower.jar",
"$env:USERPROFILE\vineflower\vineflower.jar"
)
foreach ($candidate in $ffCandidates) {
if ($candidate -and (Test-Path $candidate -ErrorAction SilentlyContinue)) {
Write-Host "[OK] Fernflower/Vineflower JAR found: $candidate"
$ffFound = $true
break
}
}
}
if (-not $ffFound) {
Write-Host "[MISSING] Fernflower/Vineflower not found (optional - better output on complex Java code)"
$missingOptional += "vineflower"
}
# --- dex2jar ---
$d2jBin = Get-Command d2j-dex2jar -ErrorAction SilentlyContinue
if (-not $d2jBin) {
$d2jBin = Get-Command d2j-dex2jar.bat -ErrorAction SilentlyContinue
}
if ($d2jBin) {
Write-Host "[OK] dex2jar detected"
} else {
Write-Host "[MISSING] dex2jar not found (optional - needed to use Fernflower on APK/DEX files)"
$missingOptional += "dex2jar"
}
# --- Optional: apktool ---
if (Get-Command apktool -ErrorAction SilentlyContinue) {
Write-Host "[OK] apktool detected (optional)"
} else {
Write-Host "[MISSING] apktool not found (optional - useful for resource decoding)"
$missingOptional += "apktool"
}
# --- Optional: adb ---
if (Get-Command adb -ErrorAction SilentlyContinue) {
Write-Host "[OK] adb detected (optional)"
} else {
Write-Host "[MISSING] adb not found (optional - useful for pulling APKs from devices)"
$missingOptional += "adb"
}
# --- Machine-readable summary ---
Write-Host ""
foreach ($dep in $missingRequired) {
Write-Host "INSTALL_REQUIRED:$dep"
}
foreach ($dep in $missingOptional) {
Write-Host "INSTALL_OPTIONAL:$dep"
}
Write-Host ""
if ($errors -gt 0) {
Write-Host "*** $($missingRequired.Count) required dependency/ies missing. ***"
Write-Host "Run install-dep.ps1 <name> to install, or see references/setup-guide.md."
exit 1
} else {
if ($missingOptional.Count -gt 0) {
Write-Host "Required dependencies OK. $($missingOptional.Count) optional dependency/ies missing."
Write-Host "Run install-dep.ps1 <name> to install optional tools."
} else {
Write-Host "All dependencies are installed. Ready to decompile."
}
exit 0
}