CORTEX v1.0.0 — УСТАНОВКА И БЫСТРЫЙ СТАРТ

Cortex v1.0.0 поставляется как одно портативное приложение для Windows: cortex.exe. Инструментальные среды выполнения x64 и x86 находятся в папке runtime и выбираются автоматически для каждой цели. Больше ничего устанавливать не нужно (ни Qt, ни Visual C++ runtime).

УСТАНОВКА

1. Скачайте архив:

   cortex-v1.0.0-windows-portable.zip
   

2. Распакуйте весь архив в обычную папку с правами записи, например:

   C:\Cortex\
   

3. Не перемещайте cortex.exe отдельно. Держите папку runtime рядом с исполняемым файлом.

4. Запустите:

   .\cortex.exe
   

ПЕРВАЯ СЕССИЯ

1. Нажмите "Select process" в заголовке (или File > Select process...).
2. Выберите цель и нажмите Attach (или дважды щёлкните по строке).
3. Используйте панель "Value scan" рабочей области Memory для сканирования значения (First scan, затем Next scan).
4. Дважды щёлкните по полезному результату, чтобы подготовить запись в Addresses.
5. Используйте контекстное меню адреса для перехода к Memory viewer, Disassembler, RE, Pointer Maps, Structures или действиям отладчика.
6. Кнопки Memory, Debug, RE, Trace, Automation и Runtime в заголовке перестраивают рабочие области для каждой задачи.
7. Переключайте тумблер в заголовке с "Read-only" на "Writes allowed" только когда вы намерены выполнить операцию, изменяющую цель или постоянное состояние.

РЕЖИМЫ КОМАНДНОЙ СТРОКИ

Справка:

   .\cortex.exe --help

Версия:

   .\cortex.exe --version

Постоянный сервер MCP через stdio (без цели; подключение из AI-клиента):

   .\cortex.exe mcp

Подключение MCP к PID или процессу при запуске:

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

Также предоставить низкоуровневые примитивные инструменты:

   .\cortex.exe mcp --tools all

Другие встроенные команды:

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

ЧТО НАХОДИТСЯ В АРХИВЕ

cortex.exe Приложение Cortex (настольный интерфейс и режимы CLI/MCP).

runtime\x64\cortex_core.dll Инструментальная среда выполнения для 64-битных целей.

runtime\x86\cortex_core.dll Инструментальная среда выполнения для 32-битных целей.

runtime\x86\cortex_runtime_helper.exe Приватный вспомогательный компонент, автоматически используемый для 32-битных целей.

Вам никогда не нужно выбирать между x64 и x86: Cortex определяет
архитектуру цели и использует соответствующую среду выполнения, в том числе для
"cortex.exe inject <pid>".

README.md, CHANGELOG.md, LICENSE, docs Документация, история изменений, лицензия и технические руководства.

УСТРАНЕНИЕ НЕПОЛАДОК

• Если cortex.exe не запускается, проверьте, что весь архив был распакован и что папка runtime присутствует.
• Если цель не удаётся открыть, проверьте её архитектуру и права процесса в Windows. Используйте повышенные привилегии только когда цель их требует.
• Если операция записи, точка останова или управляющая операция отклонена, сначала переключите заголовок на "Writes allowed".
• Настройки и расположение окна сохраняются в %LOCALAPPDATA%\Cortex. Чтобы хранить их рядом с cortex.exe вместо этого (USB-накопитель, песочница), создайте пустой файл с именем cortex.portable рядом с исполняемым файлом.
• В режиме MCP stdout зарезервирован для JSON-RPC на всю сессию; диагностика выводится в stderr.
• См. docs/getting-started.md, docs/ui-guide.md и docs/ui-walkthrough.md для полного рабочего процесса.

АВТОРИЗАЦИЯ

Используйте Cortex только на программном обеспечении и системах, которыми вы владеете или которые уполномочены проверять. Обход античита, несанкционированный доступ и вмешательство в работу онлайн-сервисов находятся за рамками этого проекта.