# 문제 해결

> DockSpark에서 흔한 문제를 해결하세요. 포인터 패널이 나타나지 않거나 프로필이 열리지 않는 경우, macOS에서 Chromium이나 Firefox 새로 고침 오류가 나는 경우를 다룹니다.

Source: https://dockspark.app/ko/docs/reference/troubleshooting

## 패널이 나타나지 않습니다

1. DockSpark가 백그라운드에서 계속 실행 중인지 확인하세요.
2. 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용을 엽니다.
3. DockSpark 접근이 켜져 있는지 확인하고, 필요하면 앱을 다시 여세요. 손쉬운 사용 권한이 복구되면 DockSpark는 Dock 포인터 감지를 자동으로 다시 구성할 수 있습니다.
4. 그 아이콘이 지원되는 브라우저의 것인지 확인하세요.

포인터가 Dock 아이콘과 패널을 모두 벗어나면 포인터 패널이 닫혀야 합니다. 아이콘에서 패널로 대각선으로 이동할 수 있으며, 이웃 아이콘을 잠깐 지나가도 프로필이 전환되거나 패널이 닫히지 않아야 합니다.

## 프로필이 열리지 않습니다

Chrome 계열 브라우저의 경우 설정한 프로필 디렉터리가 `Default`나 `Profile 1`처럼 브라우저의 실제 값과 일치하는지 확인하세요. 최신 릴리스의 Chrome은 디렉터리를 자동으로 감지할 수 있으며, 이름을 바꾼 프로필이 잘못 보인다면 DockSpark에서 새로 고치거나 다시 추가하세요. macOS의 자동화 권한 요청에도 응답하세요.

## Chromium 또는 Firefox 프로필 목록이 새로 고쳐지지 않습니다

DockSpark가 Chromium 또는 Firefox 프로필을 읽으려면 전체 디스크 접근 권한이 필요하다고 안내하면, 시스템 설정에서 해당 권한을 허용한 뒤 다시 새로 고쳐 보세요. 이제 목록을 업데이트할 수 없을 때 새로 고침 오류에 더 분명한 이유가 표시됩니다.

## 권한을 취소한 뒤 기능이 중단됩니다

정상 동작입니다. 손쉬운 사용을 끄면 포인터 패널이 표시되지 않습니다. 자동화를 끄면 선택한 프로필이나 시크릿 창 열기가 중단될 수 있습니다. 전체 디스크 접근을 끄면 Chromium과 Firefox 프로필 목록 새로 고침이 중단될 수 있습니다. 시스템 설정에서 스위치를 다시 켜거나 DockSpark에서 접근을 다시 허용하세요. 기록된 권한을 삭제하고 로컬 설정을 지우는 터미널 명령은 [권한](/docs/getting-started/permissions)에 있습니다.

> **계속 해결되지 않나요?**
>
> [문제를 신고](https://github.com/DockSpark/DockSpark/issues)할 때 macOS 버전, 브라우저 버전, Dock 위치, 자동 숨김 사용 여부를 함께 알려 주세요. 앱에서 **도움말 → 피드백 보내기…**를 선택할 수도 있습니다.

## 앱이 계속 실행됩니다

정상 동작입니다. DockSpark는 메인 창을 닫은 뒤에도 Dock 포인터 이벤트를 감지하기 위해 계속 활성 상태로 남습니다. 메뉴 막대나 Dock 아이콘에서 다시 열거나, DockSpark 종료를 선택해 완전히 종료하세요. 두 아이콘을 모두 숨겼다면 Launchpad나 응용 프로그램에서 앱을 다시 여세요.
