5f795b9a91
- extension.ts 3,446→1,289줄 (-63%) - step-probe.ts (1,435줄): setupMonitor, processResponseFile, tryApprovalStrategies - observer-script.ts (687줄): DOM observer script - ws-client.ts (390줄): WSBridgeClient - step-utils.ts (114줄): step 파싱 유틸 - auth.py (115줄): JWT + registration code - hub.py (581줄): WSHub + per-client queue - Hub WS 연동 테스트 통과 (auth, chat, register) - VSIX v0.4.0 빌드
50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
# Tech Stack
|
|
|
|
> AI 에이전트는 구현 전 이 문서를 확인하여 올바른 기술/버전을 사용합니다.
|
|
|
|
## 언어 & 런타임
|
|
|
|
| 항목 | 버전 | 경로/비고 |
|
|
|------|------|-----------|
|
|
| Python | 3.x (miniforge3) | `C:\ProgramData\miniforge3\envs\gravity_control\python.exe` |
|
|
| Node.js | 시스템 설치 | `node`, `npm` (PowerShell에서 `cmd /c npm` 권장) |
|
|
| TypeScript | (Extension) | `extension/src/extension.ts` → `tsc` 빌드 |
|
|
|
|
> [!IMPORTANT]
|
|
> Python은 **반드시** 위 miniforge3 경로를 사용. WindowsApps의 python stub은 동작하지 않음.
|
|
|
|
## 프레임워크
|
|
|
|
| 항목 | 버전 | 용도 |
|
|
|------|------|------|
|
|
| discord.py | 2.x | Discord 봇 |
|
|
| watchdog | - | 파일시스템 감시 |
|
|
| antigravity-sdk | 로컬 | VS Code Extension SDK 연동 |
|
|
|
|
## 패키지 관리
|
|
|
|
- **Python**: pip (`requirements.txt`)
|
|
- **Extension**: npm (`extension/package.json`)
|
|
|
|
## 개발 도구
|
|
|
|
| 도구 | 명령어 |
|
|
|------|--------|
|
|
| **봇 실행** | `start_bot.bat` 또는 `C:\ProgramData\miniforge3\envs\gravity_control\python.exe main.py` |
|
|
| **Extension 빌드** | `cd extension && cmd /c npm run compile` |
|
|
| **Extension VSIX** | `cd extension && cmd /c npx vsce package` |
|
|
| **봇 구문 검사** | `C:\ProgramData\miniforge3\envs\gravity_control\python.exe -c "import bot, bridge, config, main"` |
|
|
|
|
## 환경 변수
|
|
|
|
| 변수명 | 용도 | 기본값 |
|
|
|--------|------|--------|
|
|
| DISCORD_TOKEN | Discord 봇 토큰 | (필수) |
|
|
| DISCORD_GUILD_ID | Discord 서버 ID | (필수) |
|
|
| BRAIN_PATH | AG 브레인 경로 | `~/.gemini/antigravity/brain` |
|
|
| BOT_MODE | 봇 모드 (local/remote/gateway) | `local` |
|
|
| REMOTE_BRIDGE_URL | 원격 브릿지 URL | (remote 모드 전용) |
|
|
| GATEWAY_API_KEY | Gateway REST API 인증 키 | (gateway 모드) |
|
|
| GRAVITY_HUB_SECRET | WS Hub JWT 서명 시크릿 | (자동생성 가능) |
|
|
| GRAVITY_REGISTRATION_CODE | Extension 등록 코드 | (미설정 시 인증 생략) |
|