CORTEX v1.0.0 - INSTALACIÓN Y GUÍA DE INICIO RÁPIDO

Cortex v1.0.0 se distribuye como una única aplicación portátil para Windows: cortex.exe. Los runtimes de instrumentación x64 y x86 se encuentran en la carpeta runtime y se seleccionan automáticamente para cada objetivo. No es necesario instalar nada más (ni Qt, ni el runtime de Visual C++).

INSTALACIÓN

1. Descargue el archivo:

   cortex-v1.0.0-windows-portable.zip
   

2. Extraiga todo el archivo en una carpeta normal con permisos de escritura, por ejemplo:

   C:\Cortex\
   

3. No mueva cortex.exe por sí solo. Mantenga la carpeta runtime junto al ejecutable.

4. Ejecute:

   .\cortex.exe
   

PRIMERA SESIÓN

1. Haga clic en "Select process" en el encabezado (o File > Select process...).
2. Seleccione el objetivo y haga clic en Attach (o haga doble clic en la fila).
3. Utilice el panel "Value scan" del espacio de trabajo Memory para escanear un valor (First scan, luego Next scan).
4. Haga doble clic en un resultado útil para preparar una entrada en Addresses.
5. Utilice el menú contextual de una dirección para saltar al visor de Memory, el Disassembler, RE, Pointer Maps, Structures o acciones del depurador.
6. Los botones Memory, Debug, RE, Trace, Automation y Runtime del encabezado reorganizan los espacios de trabajo para cada tarea.
7. Cambie el conmutador del encabezado de "Read-only" a "Writes allowed" solo cuando pretenda realizar una operación que modifique el objetivo o el estado persistente.

MODOS DE LÍNEA DE COMANDOS

Ayuda:

   .\cortex.exe --help

Versión:

   .\cortex.exe --version

Servidor MCP persistente sobre stdio (sin objetivo; conéctese desde el cliente de IA):

   .\cortex.exe mcp

Conectar MCP a un PID o a un proceso al iniciar:

   .\cortex.exe mcp --pid 1234
   .\cortex.exe mcp --process game.exe

También expone las herramientas primitivas de bajo nivel:

   .\cortex.exe mcp --tools all

Otros comandos integrados:

   .\cortex.exe probe --pid 1234
   .\cortex.exe diagnose --pid 1234
   .\cortex.exe analyze <directory>
   .\cortex.exe symbolize [options]
   .\cortex.exe inject <target> [dll]

QUÉ CONTIENE EL ARCHIVO

cortex.exe La aplicación Cortex (interfaz de escritorio y modos CLI/MCP).

runtime\x64\cortex_core.dll Runtime de instrumentación para objetivos de 64 bits.

runtime\x86\cortex_core.dll Runtime de instrumentación para objetivos de 32 bits.

runtime\x86\cortex_runtime_helper.exe Asistente privado utilizado automáticamente para objetivos de 32 bits.

Nunca elige entre x64 y x86: Cortex lee la arquitectura del objetivo y
utiliza el runtime correspondiente, incluso para
"cortex.exe inject <pid>".

README.md, CHANGELOG.md, LICENSE, docs Documentación, historial, licencia y guías técnicas.

SOLUCIÓN DE PROBLEMAS

• Si cortex.exe no se inicia, compruebe que se extrajo todo el archivo y que la carpeta runtime está presente.
• Si no se puede abrir un objetivo, compruebe su arquitectura y los permisos de Windows del proceso. Utilice privilegios elevados solo cuando el objetivo los requiera.
• Si se rechaza una operación de escritura, punto de interrupción o control, cambie el encabezado a "Writes allowed" primero.
• La configuración y el diseño de la ventana se guardan en %LOCALAPPDATA%\Cortex. Para mantenerlos junto a cortex.exe en su lugar (memoria USB, sandbox), cree un archivo vacío llamado cortex.portable junto al ejecutable.
• En modo MCP, stdout está reservado para JSON-RPC durante toda la sesión; los diagnósticos van a stderr.
• Consulte docs/getting-started.md, docs/ui-guide.md y docs/ui-walkthrough.md para el flujo de trabajo completo.

AUTORIZACIÓN

Utilice Cortex solo en software y sistemas que posea o esté autorizado a inspeccionar. La elusión de anti-cheat, el acceso no autorizado y la interferencia con servicios en línea están fuera del alcance de este proyecto.