中文 | English

ZAFrida UI - PyCharm Frida Plugin

Versión actual: 0.3.7

Principales novedades de 0.3.7

• Cada ZAFrida Project puede seleccionar o compartir de forma independiente el entorno Python/Frida; por defecto se usa el intérprete del proyecto PyCharm actual, con soporte para entornos locales como venv, Conda, uv, Poetry, Pipenv, Hatch, etc.
• Se rediseñaron la Session UI y los Project Settings, mostrando por completo la información de versiones del plugin, Python y Frida, y se optimizó el panel de logs adaptable y arrastrable junto con el estado de la sesión.
• Soporte completo para .js / .ts, Frida 16/17, cambio entre múltiples entornos de proyecto, y los tres flujos de conexión: USB, Remote y Gadget.
• Se reforzaron las capacidades de recuperación de dispositivos, espera de sesión y logs incrementales de la API HTTP local, la CLI y las Skills en chino; se eliminó la capa de adaptación MCP duplicada e inestable.

Introducción al proyecto

Herramienta gráfica de Frida diseñada para PyCharm/IntelliJ

ZAFrida UI es un plugin de operación gráfica de Frida integrado en PyCharm y en los IDE de la familia JetBrains. Su objetivo es resolver los problemas de la tediosa operación por línea de comandos de Frida y la gestión caótica de scripts, proporcionando un conjunto completo de interfaces de interacción UI para gestionar dispositivos, procesos, scripts y logs.

El punto culminante principal reside en su sistema de gestión de plantillas "tipo casilla de verificación": el usuario puede insertar dinámicamente fragmentos de código en el script principal o comentarlos marcando/desmarcando casillas, logrando así un ensamblaje de scripts Hook "tipo bloques". Además, el plugin incorpora una gestión completa por proyectos (zafrida-project.xml) que admite el cambio rápido entre múltiples configuraciones de dispositivos y entornos.

ZAFrida no sustituye a Frida, sino que actúa como una potente interfaz UI para frida-tools, conectándose sin fisuras con su entorno Python y Frida existente.

Wiki simplificada: ZAFrida UI Wiki simplificada (BBS) (esta es la Wiki más sencilla) Tutorial detallado de uso: Wiki del tutorial detallado de ZAFrida UI

Demostración de resultados

Inicio rápido

1. Instalar el plugin: Busque "ZAFrida" en el mercado de plugins del IDE o instálelo desde disco.
2. Configurar el entorno predeterminado: Por defecto se usa el Python Interpreter del proyecto PyCharm actual; en Settings globales -> Tools -> ZAFrida solo se conservan los valores predeterminados de nombre/ruta de las herramientas.
3. Crear un proyecto: Haga clic derecho en la vista de proyecto -> New Frida Project.
   • Si ese proyecto requiere una versión diferente de Frida, abra los Project Settings de ZAFrida, seleccione el intérprete de Python o el directorio del entorno y haga clic en Test.
4. Escribir/seleccionar script: En el panel Run seleccione su agent.js o agent.ts.
5. Depuración de Hooks:

• Conecte el dispositivo (USB, Remote o Gadget).
• Seleccione el proceso objetivo o el nombre del paquete.
• Haga clic en Run.

6. Usar plantillas: Cambie a la pestaña Templates, marque las funciones Hook que necesite (por ejemplo, "SSL Pinning Bypass") y el código se inyectará automáticamente en su script.
7. Automatización con Skills (opcional): Desactivada por defecto. Vaya a Settings/Preferences -> ZAFrida -> Skills HTTP API, marque Enable Skills para iniciar automáticamente la API local (también puede iniciarla/detenerla manualmente con Start/Stop). Ubicación de la CLI y las plantillas:
   • Skill y CLI principal: skills-template/zafrida-http-control/
   • Lanzador compatible con rutas antiguas: skills-cli/zafrida_skill_cli.py

Código QR del grupo de intercambio

Características

• Gestión de dispositivos y procesos
  Integra frida-ls-devices y frida-ps, con soporte para actualizar la lista de dispositivos con un clic, ver procesos en ejecución, apps en ejecución o aplicaciones instaladas.

• Conexión multimodo
  Soporte completo de los modos USB / Remote / Gadget, con Host y Port remotos personalizables, sin necesidad de ensamblar manualmente parámetros complejos de línea de comandos.

• Ejecución interactiva de scripts (Run / Attach)

  • Soporta las dos acciones de ejecución Run (Spawn por defecto) y Attach, en lugar de un simple "cambio de modo".
  • Soporta Force Stop para detener forzosamente la aplicación objetivo.
  • Salida de logs de consola integrada, con guardado automático de logs en el directorio del proyecto zafrida-logs/.

• Menú contextual del editor JS / TypeScript (importante)

  • En el área de edición de archivos Frida .js o .ts, haga clic derecho y podrá seleccionar directamente:
    • Run Frida Script: ejecuta el archivo actual como script principal (Spawn por defecto).
    • Attach Frida Script: inyecta el archivo actual como script adjunto en el proceso objetivo ya en ejecución.
  • Antes de ejecutar, el archivo actual se guarda automáticamente y se cambia automáticamente al ZAFrida Project al que pertenece el script.
  • Ideal para PoC rápidos, validación de demos, modo Gadget o inyección inmediata en procesos ya en ejecución.
  • Atajos de teclado:
    • Windows / Linux: Ctrl + Alt + S

Escenarios de uso

ZAFrida UI es adecuado para todos los escenarios de ingeniería inversa con Frida, en particular:

• Pruebas de penetración y análisis de ingeniería inversa de apps Android / iOS.
• Procesos de depuración que requieren cambiar con frecuencia entre diferentes scripts Hook.
• Ingenieros acostumbrados a usar IDE (PyCharm/IDEA) para desarrollo mixto de Python, JavaScript y TypeScript.

Documentación técnica

• Requisitos del entorno:

  • IntelliJ IDEA o PyCharm (se recomienda 2024.3+)
  • Python3 y frida-tools instalados localmente (pip install frida-tools)
  • Asegúrese de que frida, frida-ps, frida-ls-devices estén en el PATH del sistema o especifique sus rutas en la configuración del plugin.

• Reporte de problemas: Github Issues

Iniciar el proyecto

1. Clone el código fuente: git clone https://github.com/yilongmd/zafrida-ui.git
2. Abra el proyecto con IntelliJ IDEA.
3. Ejecute la tarea de Gradle runIde para iniciar el entorno de depuración.

Capturas del sistema

Interfaz principal y panel de ejecución (Run Panel)

Ofrece selección de dispositivo, selección de script, configuración del modo de ejecución y salida de consola.

Gestión de plantillas dinámicas (Template Panel)

A la izquierda se selecciona la categoría, en el centro se marcan las plantillas y a la derecha se previsualiza el código en tiempo real. Las casillas controlan directamente si el contenido del script está activo o no.

Interfaz de configuración (Settings)

Admite personalizar las rutas de las herramientas Frida, la dirección de conexión remota y la configuración de logs.

Asistente de creación de proyectos

Crea rápidamente una estructura de proyecto Frida estandarizada.

Arquitectura técnica

Entorno de desarrollo

• Lenguaje: Java 21, Java, scripts de compilación con Gradle Kotlin DSL
• Framework: IntelliJ Platform SDK
• Herramienta de compilación: Gradle
• Dependencias: frida frida-tools (entorno Python)

Agradecimientos

Agradecimiento especial a las siguientes personas por proporcionar soporte de plantillas de scripts Frida JS para este proyecto:

• 小佳
• Lane
• 迷人

Para más colaboradores e información de agradecimientos, consulte: CONTRIBUTORS.md