中文 | English

ZAFrida UI - Complemento de Frida para PyCharm

Versión actual: 0.3.8

Actualizaciones principales de 0.3.8

• El panel Session divide «Dispositivo» y «Modo de conexión» en dos filas de selección independientes: la fila Device solo lista dispositivos reales, la fila Mode selecciona USB / Remote / Gadget y el endpoint. El reenvío de puertos adb, Force Stop y Open App del bucle Remote/Gadget siempre actúan sobre el teléfono actualmente seleccionado, sin reutilizar por error dispositivos anteriores.
• Al abrir y actualizar dispositivos por primera vez, se inicia automáticamente el servidor adb que no esté en ejecución, sin necesidad de ejecutar manualmente adb devices.
• Cuando un dispositivo guardado no está en línea, se muestra el marcador «No conectado» y se bloquean las operaciones relacionadas; si solo hay un dispositivo USB conectado, se cambia automáticamente a él y se notifica en la Console.
• Debajo de la fila Mode se muestra la ruta adb/frida realmente ejecutada; en modo Gadget el nombre del paquete Target es de solo lectura pero se puede seleccionar y copiar.
• El /state de la HTTP API añade el resultado de resolución connection; device-select --host sigue disponible pero está obsoleto, para endpoints use mode-set --host/--port.

Actualizaciones principales de 0.3.7

• Cada ZAFrida Project puede seleccionar o compartir de forma independiente el entorno Python/Frida; por defecto usa el intérprete del proyecto PyCharm actual, y admite entornos locales como venv, Conda, uv, Poetry, Pipenv, Hatch, etc.
• Rediseño de la Session UI y Project Settings, mostrando completa la información de versión del plugin, Python y Frida, y optimizando el panel de logs adaptativo y arrastrable y el estado de sesión.
• Soporte completo para .js / .ts, Frida 16/17, cambio de entorno entre múltiples proyectos, y los tres flujos de conexión USB, Remote y Gadget.
• Refuerzo de la HTTP API local, CLI y Skill en chino para la recuperación de dispositivos, espera de sesión y logs incrementales; se elimina 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 complemento de operación gráfica de Frida integrado en PyCharm y la serie de IDE de JetBrains. Está diseñado para resolver los problemas de la engorrosa operación por línea de comandos de Frida y la gestión desordenada de scripts, ofreciendo un conjunto completo de interfaz de interacción UI para gestionar dispositivos, procesos, scripts y logs.

El punto clave es su sistema de gestión de plantillas «estilo casilla de verificación»: el usuario puede, marcando/desmarcando casillas, insertar dinámicamente fragmentos de código en el script principal o comentarlos, logrando así un ensamblaje de scripts Hook «tipo bloques de construcción». Además, el complemento incorpora una completa gestión por proyectos (zafrida-project.xml), que permite cambiar rápidamente entre configuraciones de múltiples dispositivos y entornos.

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

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

Demostración

Inicio rápido

1. Instalar el complemento: busque "ZAFrida" en el marketplace de complementos 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 global -> Tools -> ZAFrida solo se conservan los valores predeterminados de nombre/ruta de herramientas.
3. Crear un proyecto: clic derecho en la vista de proyecto -> New Frida Project.
   • Si el proyecto necesita una versión diferente de Frida, abra ZAFrida Project Settings, seleccione el intérprete de Python o el directorio de entorno y haga clic en Test.
4. Escribir/seleccionar el script: en el panel Run seleccione su agent.js o agent.ts.
5. Depuración de Hook:

• Conectar el dispositivo (USB o Remote o Gadget).
• Seleccionar el proceso o nombre de paquete objetivo.
• Hacer clic en Run.

6. Usar plantillas: cambie a la pestaña Templates, marque las funciones Hook que necesite (como "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 Start/Stop manualmente); ubicaciones del CLI y las plantillas:
   • Skill y CLI principal: skills-template/zafrida-http-control/
   • Lanzador compatible con la ruta antigua: 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, permite actualizar la lista de dispositivos con un clic y 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 componer manualmente parámetros de línea de comandos complejos.

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

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

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

  • Con clic derecho en el área de edición de archivos Frida .js o .ts, puede 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, guarda automáticamente el archivo actual y cambia automáticamente al ZAFrida Project al que pertenece el script.
  • Adecuado para PoC rápidos, validación de Demo, modo Gadget o inyección inmediata en procesos ya en ejecución.
  • Atajos:
    • Windows / Linux: Ctrl + Alt + S
    • macOS: ⌘ + ⌥ + S