docs(agent): record Git Credential Manager UI popup issue in known-issues.md

This commit is contained in:
Variet Worker
2026-04-08 05:54:54 +09:00
parent e5d45b589c
commit d3150bd5d8

View File

@@ -29,6 +29,12 @@
## 🔴 Active/Recent Issues ## 🔴 Active/Recent Issues
### [2026-04-08] [Git/Windows] Git Credential Manager UI 팝업 (포커스 스틸)
- **증상**: 에이전트가 백그라운드에서 `git push origin main` 명령을 실행하자 Windows Git Credential Manager 로그인 창(UI 팝업)이 화면에 나타나 사용자의 작업 포커스를 빼앗고 방해함.
- **원인**: HTTPS 원격 저장소 주소에 인증 토큰이 없거나 캐시가 만료된 상태에서, Windows 환경의 기본 설정이 대화형 UI 자격 증명 프롬프트를 띄우도록 되어있기 때문.
- **해결**: `.agents/workflows/services.md` 파일에 정의되어 있는 인증 토큰이 포함된 명시적 URL (`https://<토큰>@git.variet.net/...`)을 사용하여 직접 푸시를 수행하도록 수정 (`git push https://... main`).
- **주의**: AI 엔진이나 백그라운드 환경에서 Git 원격 서버와 통신할 때는, 반드시 사전에 `.agents` 지침 및 서비스 토큰을 확인하여 UI 팝업으로 인한 인터랙션 블로킹이 일어나지 않도록 각별히 유의.
### [2026-04-08] [VS Code Extension] 동기 프로세스(execSync)로 인한 UI 프리징 ### [2026-04-08] [VS Code Extension] 동기 프로세스(execSync)로 인한 UI 프리징
- **증상**: 익스텐션 활성화 시 `activate()` 내부에서 `detectProjectName()`가 호출되며 VS Code UI 전체가 최대 2초간 완전 멈춤(Freeze). - **증상**: 익스텐션 활성화 시 `activate()` 내부에서 `detectProjectName()`가 호출되며 VS Code UI 전체가 최대 2초간 완전 멈춤(Freeze).
- **원인**: 확장 프로그램 구동 이벤트 루프에서 `cp.execSync('git remote get-url origin', { timeout: 2000 })`라는 무거운 동기 블로킹 연산을 수행. - **원인**: 확장 프로그램 구동 이벤트 루프에서 `cp.execSync('git remote get-url origin', { timeout: 2000 })`라는 무거운 동기 블로킹 연산을 수행.