디버깅 (Unity · Node · Python)
AgentManager 는 DAP(Debug Adapter Protocol) 디버거를 내장합니다. 따로 IDE 를 열지 않고 Unity · Node · Python 프로그램을 멈추고 변수를 볼 수 있습니다. 멈춘 상태는 그대로 AI 에게 넘겨 원인을 묻습니다.
디버그 패널 열기
섹션 제목: “디버그 패널 열기”프로젝트 화면 상단 툴바의 🐞 Debug 를 누릅니다. 패널은 도킹되며 별도 창으로 떼어 낼 수도 있습니다.
패널 구성:
- 툴바: 언어 선택 · 포트 · 실행 제어 · 🤖 분석 · 🔴 BP
- 호출 스택 · 변수 2열
어댑터 3종
섹션 제목: “어댑터 3종”| 언어 | 준비물 | 연결 방법 |
|---|---|---|
| 🎮 Unity | .NET 런타임 + VS Code Unity 확장(visualstudiotoolsforunity.vstuc) |
열려 있는 Unity Editor 에 자동 attach |
| 🟢 Node | Node.js + ~/.vscode/extensions 에 설치한 ms-vscode.js-debug(또는 nightly) 확장. VS Code 에 내장된 사본은 인식하지 않습니다 |
node --inspect-brk=9229 app.js 로 실행 후 attach |
| 🐍 Python | Python + debugpy |
python -m debugpy --listen 5678 --wait-for-client app.py 로 실행 후 attach |
Node 와 Python 은 툴바의 port 칸에 포트를 넣습니다(기본 9229 · 5678). Unity 는 포트가 필요 없습니다.
어댑터를 못 찾으면 무엇이 빠졌는지 알림이 뜹니다.
.NET 런타임을 찾지 못했습니다. dotnet 을 설치하세요.VSCode 의 Unity 디버그 확장(visualstudiotoolsforunity.vstuc)이 필요합니다→ 마켓플레이스 열기debugpy 가 설치되지 않았습니다. 터미널에서: pip install debugpy
자동 탐색이 계속 실패하면 Settings > 편집 > Unity 디버그 어댑터 (옵션) 에 어댑터 절대 경로를 지정합니다.
실행 제어
섹션 제목: “실행 제어”| 키 | 동작 |
|---|---|
| F5 | 계속 실행 (멈춘 상태에서만. 처음 시작은 툴바 Start) |
| F10 | Step Over |
| F11 | Step Into |
| Shift+F11 | Step Out |
| Shift+F5 | Stop |
디버그 세션은 프로젝트마다 따로 돕니다. 한 프로젝트의 이벤트가 다른 프로젝트로 섞이지 않습니다. 떼어 낸 창에서는 보기만 되고 조작은 메인 창에서 합니다.
브레이크포인트
섹션 제목: “브레이크포인트”- 코드 편집기의 줄 번호 영역을 클릭하거나 F9 로 토글
- 조건부 브레이크포인트와 logpoint 지원
- 🔴 BP 로 브레이크포인트 목록 패널을 엽니다. 확인된(verified) 것과 미확인(pending) 것을 색으로 구분합니다. 클릭하면 그 줄로, ✕ 로 제거
브레이크포인트는 프로젝트별로 저장돼 앱을 다시 켜도 남습니다.
멈췄을 때
섹션 제목: “멈췄을 때”브레이크포인트에 걸리면:
- 해당 파일이 자동으로 열리고 멈춘 줄이 노란색으로 표시됩니다.
- 호출 스택에서 프레임을 고르면 그 프레임의 변수를 봅니다.
- 편집기에서 변수 위에 마우스를 올리면 값이 툴팁으로 나옵니다.
- 채팅 위에
파일:줄 에서 멈춤줄이 뜹니다.
AI 에게 묻기
섹션 제목: “AI 에게 묻기”두 가지 방법이 있습니다.
🤖 분석 버튼은 멈춘 상태(스택 + 변수 + 소스 ±15줄)를 claude -p 로 보내 진단을 받습니다. 질문은 선택입니다. 90초 안에 답이 없으면 실패합니다.
채팅 위 멈춤 줄의 Claude 에게 물어보기 는 멈춘 위치를 입력창에 미리 채워 줍니다. 지금 대화에서 이어서 묻고 싶을 때 씁니다. 버튼의 Claude 는 프로젝트 provider 이름으로 바뀝니다.
C# 코드 탐색 (실험적)
섹션 제목: “C# 코드 탐색 (실험적)”Unity · C# 프로젝트에서는 C# Language Server 로 코드 탐색을 씁니다.
- 자동완성 · hover · 정의로 이동
- F12 정의로 이동, Shift+F12 참조 찾기
- 프로젝트를 열면 심볼 인덱스를 백그라운드에서 만듭니다. 우측 하단에
C# 심볼 인덱싱…진행률이 보이고, 끝나면심볼 인덱스 준비됨 - 파일이 바뀌면 인덱스를 다시 맞춥니다.
VS Code C# 확장(v2.0 이상)이 있으면 자동으로 찾습니다. 없으면 csharp-ls 를 쓰거나 Settings > 편집 > C# Language Server 에 경로를 지정합니다. 못 찾으면 ✗ C# LSP 미감지 로 표시됩니다.
서버 로그 보기
섹션 제목: “서버 로그 보기”앱 자체 문제를 볼 때는 Settings > 디버그 탭의 디버그 로그 를 봅니다. 서버 프로세스 출력이 매일 새 파일로 저장되고 14일 보관됩니다. 필터 · 새로고침 · 자동 · 복사 · 폴더 열기 를 지원합니다.