문제 해결
대시보드가 머신과 동기화되지 않거나, 세션이 사라지거나, 호스팅 CLI 런타임을 복구해야 할 때 이 페이지를 사용하세요.
대시보드에 아무것도 표시되지 않음
대시보드에 머신이나 세션이 없다고 표시되면 먼저 로컬 데몬을 확인하세요:
adhdev daemon:status다음을 확인하세요:
- 실행 중인 데몬 프로세스
- 도달 가능한 로컬 IPC
- CLI 에이전트를 사용하는 경우 세션-호스트 상태
데몬이 실행되지 않는다면 다시 시작하거나, 보통 그 방식으로 ADHDev를 실행한다면 백그라운드 서비스를 다시 설치하세요.
IDE 또는 에이전트가 없음
무엇이든 다시 실행하기 전에, 이제 덜 긴급한 작업을 숨기는 대시보드 표면을 확인하세요:
- 숨김 탭
- 활동 인박스
- 히스토리
머신이 연결되어 있지만 특정 IDE 세션이 없는 경우 ADHDev를 통해 해당 IDE를 다시 실행하여 예상 제어 표면으로 시작되도록 하세요:
adhdev launch cursorIDE에 맞는 대상을 사용하세요.
채팅이 비어 있거나 로딩 중에 멈춤
세션은 존재하지만 채팅이 비어 있거나 여전히 로딩 중인 경우:
- 세션 스트림이 안정화될 때까지 몇 초 기다리세요.
- 탭 스트립, 인박스, 또는 히스토리에서 세션을 다시 여세요.
- 원래 IDE 또는 CLI 도구가 여전히 실행 중인지 확인하세요.
- CLI 런타임인 경우 즉시 중복 세션을 실행하는 대신 세션 호스트를 검사하세요.
CLI 집약적인 설정에서 누락된 채팅은 종종 런타임이 살아남았지만 대시보드가 다시 연결해야 한다는 것을 의미합니다.
CLI 프로바이더를 실행할 수 없음
런처에 사용 가능한 CLI/ACP 프로바이더가 없다고 나오거나 내장 프로바이더가 실행에서 없는 경우:
- 머신의 Providers 탭을 엽니다.
- 해당 머신에서 프로바이더를 활성화합니다.
- Detect를 실행하고 프로바이더 카드의 감지/검증 상세 정보를 읽으세요.
- 업스트림 바이너리가 기본 PATH 외부에 설치된 경우 사용자 정의 실행 파일 경로/인수를 설정하세요.
- 프로바이더 소스 모드나 providerDir를 변경한 경우 새 실행을 시도하기 전에 Apply + Reload를 클릭하세요.
내장 프로바이더 인벤토리는 의도적으로 머신 실행 가능성과 분리되어 있습니다. 프로바이더는 로컬 활성화와 감지가 성공한 후에만 실행 가능해집니다.
재시작 후 CLI 세션이 멈춤
호스팅 CLI 런타임에는 이제 전용 복구 경로가 있습니다.
먼저 세션-호스트 상태를 검사하세요:
adhdev daemon:session-host일반적인 복구 액션:
adhdev daemon:session-host --session <sessionId> --resume
adhdev daemon:session-host --session <sessionId> --restart
adhdev daemon:session-host --prune-duplicates대시보드의 머신 Hosted Runtimes 탭에서 동일하게 할 수 있습니다.
다음과 같은 경우에 사용하세요:
- CLI 세션이 데몬 재시작 후 살아남은 경우
- 런타임이 interrupted 상태에서 멈춘 경우
- 동일 세션에 대해 중복 호스팅 런타임이 생성된 경우
- 런타임은 존재하지만 대시보드가 잘못된 복사본에 연결된 경우
Remote View를 사용할 수 없음
Remote View가 비어 있거나 CDP 경고를 표시하는 경우:
adhdev launch <ide>를 통해 IDE를 다시 실행하세요.- IDE가 ADHDev가 잘 제어할 수 있는 Electron 기반 흐름 중 하나인지 확인하세요.
- 네트워크 또는 브라우저가 라이브 연결을 방해하고 있는지 확인하세요.
나머지 세션은 작동하지만 Remote View가 작동하지 않는다면, 일반적인 대시보드 실패가 아닌 IDE 제어 표면 문제로 먼저 취급하세요.
알림이 오지 않음
대시보드에서 Notifications를 열고 다음을 확인하세요:
- 글로벌 알림이 활성화됨
- 브라우저 알림이 활성화됨
- 호스팅 클라우드 경로를 사용한다면 푸시 알림이 활성화됨
- 프로바이더 수준 알림 설정이 예상하는 이벤트를 억제하지 않음
푸시 알림은 클라우드 전용이며 모바일에서 ADHDev가 PWA로 설치된 경우 가장 잘 작동합니다.
모바일 대시보드가 멈춘 것 같음
모바일 브라우저는 백그라운드 탭을 더 공격적으로 중단합니다.
시도해 보세요:
- 당겨서 새로고침
- 인박스에서 활성 세션 다시 열기
- 연결이 복구되지 않으면 탭 완전히 다시 열기
승인만 확인하면 된다면 이전 채팅 뷰가 자체 복원되기를 기다리는 것보다 인박스가 보통 더 신뢰할 수 있습니다.
여전히 문제가 있음
로컬 상태가 일관성 없어 보인다면 먼저 현재 상태를 수집하세요:
adhdev doctor
adhdev daemon:status
adhdev daemon:session-host --jsonadhdev doctor는 이제 PATH adhdev / adhmux 바이너리가 오래됐거나, 손상됐거나, 더 새로운 런타임 표면이 없는지도 확인합니다. runtime 명령이 문서와 일치하지 않는 것 같다면 세션-호스트/런타임 레이어가 잘못됐다고 가정하기 전에 doctor 출력을 확인하세요.
그런 다음 확인하세요:
~/.adhdev/logs/의 데몬 로그- 대시보드의 머신 Logs 탭
- 중단된 런타임을 위한 머신 Hosted Runtimes 탭
최후 수단
설치 자체가 손상된 경우 깨끗한 재설치가 여전히 폴백입니다:
adhdev uninstall -f
npm uninstall -g adhdev
npm install -g adhdev
adhdev setup
adhdev service installWARNING
이렇게 하면 인증 상태, 로그, 캐시된 설정을 포함한 로컬 ADHDev 데이터가 제거됩니다.