User guide
문제 해결과 자주 묻는 질문
This chapter is available in Korean only for now.
| 증상 | 확인과 복구 |
|---|---|
| Access Required | 실제 프로젝트 폴더를 연결하고 브라우저 접근을 허용합니다. |
| Folder selection was cancelled 또는 AbortError | 선택/허용이 완료되지 않은 상태입니다. 폴더 선택을 다시 수행합니다. |
| Protocol Not Configured | .tastedev/project.yml이 존재하는지 확인합니다. |
| Protocol Invalid | 저장된 YAML의 오류 위치·타입·경로·명령 인수를 확인합니다. |
| Dirty로 실행/Apply 차단 | 현재 내용을 저장하거나 취소합니다. 자동 overwrite하지 않습니다. |
| Queue 대기 | Core 연결·Agent idle 상태·요구 OS/runtime/browser를 비교합니다. |
| desktop runtime required | Web 제한입니다. 데스크톱 또는 승인된 원격 Protocol 실행을 사용합니다. |
| Agent/Core 연결 끊김 | 주소·인증·Origin·TLS·프로세스 상태를 관리자와 확인합니다. |
| AI authentication 오류 | 선택 Provider의 계정 연결을 확인합니다. 인증 실패와 Test FAIL을 구분합니다. |
| AI rate/context limit 또는 timeout | 최소 Context와 전송 크기·Provider 상태를 확인합니다. |
| PATCH_CONFLICT | Proposal 이후 파일이 변경됐습니다. 최신 Source로 새 분석·Proposal을 검토합니다. |
| Snapshot 실패 | 크기·필수 파일 제외·Secret·checksum·경로 validation을 확인합니다. |
| GitHub 생성 결과 불명확 | 새 POST 전에 reconciliation으로 기존 Issue를 확인합니다. |
| 예약이 실행되지 않음 | Core 생존·Enable·timezone·next trigger·Protocol sync·overlap을 확인합니다. |
Core는 자동 서비스인가요
현재 Core는 독립 Node 프로세스입니다. 서비스 설치와 전체 상태 영속화는 고도화 계획입니다. 서비스 등록만으로 Run/Queue 복구가 완성되지는 않습니다.
Source를 모두 AI에 보내나요
분석에 필요한 최소 Context와 읽기 결과를 대상으로 합니다. 전송 승인·마스킹·크기 제한을 확인하세요. 이미지의 시각적 민감정보까지 자동 제거한다고 보장하지 않습니다.
AI가 고쳤으면 성공인가요
아닙니다. 승인된 변경을 적용한 뒤 Validation과 실제 Retest 결과를 확인합니다. 모델의 판단과 실제 테스트 결과는 별개입니다.
장애 신고에 무엇을 포함하나요
앱 버전·OS·발생 시각과 timezone·Run/Step ID·상태·재현 순서·마스킹한 관련 로그를 포함합니다. credential 원문·전체 .env·불필요한 Source는 첨부하지 않습니다. 과거 Historical Error와 현재 오류를 구분합니다.
