CORTEX v1.0.0 - 설치 및 빠른 시작

Cortex v1.0.0은 단일 휴대용 Windows 애플리케이션인 cortex.exe로 제공됩니다. x64 및 x86 계측 런타임은 runtime 폴더에 있으며 각 대상에 맞게 자동으로 선택됩니다. 그 외에는 아무것도 설치할 필요가 없습니다 (Qt도, Visual C++ 런타임도 필요 없습니다).

설치

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. Memory 워크스페이스의 "Value scan" 패널을 사용하여 값을 스캔합니다 (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

stdio를 통한 영구 MCP 서버 (대상 없음; AI 클라이언트에서 연결):

   .\cortex.exe mcp

시작 시 PID 또는 프로세스에 MCP 연결:

   .\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 애플리케이션 (데스크톱 UI 및 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는 소유하거나 검사 권한이 있는 소프트웨어와 시스템에서만 사용하십시오. 안티치트 우회, 무단 접근 및 온라인 서비스 방해는 이 프로젝트의 범위를 벗어납니다.