문제 해결

버전 및 세션 상태부터 시작합니다.

herdr -V
herdr status

또한 운영 체제, 외부 터미널 이름 및 버전, 세션이 로컬인지 원격인지, tmux가 관련되어 있는지 여부도 기록하세요.

ConPTY 기반 멀티플렉서가 화면을 다시 그리는 동안 기본 커서가 깜박이거나, 점프하거나 오래된 위치를 표시할 수 있기 때문에 Herdr는 기본 Windows 및 WSL에서 셀로 그린 커서를 기본으로 사용합니다. 셀로 그린 커서는 한국어, 일본어 및 중국어 IME 구성 UI에서 사용되는 기본 커서 앵커를 제공할 수 없습니다.

IME 구성 또는 후보 창이 잘못된 위치에 나타나면 기본 커서를 활성화합니다.

[ui]
host_cursor = "native"

기본 모드는 IME 앵커를 복원하지만 활성 출력 중에 가끔 커서 이동 아티팩트가 다시 발생할 수 있습니다. host_cursor = "drawn"을 사용하여 시각적으로 안정적인 커서로 돌아가거나 설정을 제거하여 Windows 기본값을 사용하세요. 현재 제한 사항은 Windows 지원을 참조하세요.

일부 터미널의 이전 버전에서는 애플리케이션이 키티 키보드 이벤트 보고를 활성화할 때 Enter, Tab 및 Backspace의 릴리스를 누름과 동일한 바이트로 내보낼 수 있습니다. Herdr는 터미널이 보낸 후에 중복된 바이트를 구별할 수 없습니다.

외부 터미널을 업스트림 수정 사항이 포함된 버전으로 업데이트합니다.

이는 장기 지원 Linux 배포판의 이전 터미널 패키지에서 특히 일반적입니다. 확인된 경계 캡처 및 업스트림 참조는 Herdr 문제 #1116을 참조하세요. 문제가 현재 터미널 버전에 남아 있으면 정확한 터미널 버전과 Herdr 외부에서도 문제가 발생하는지 보고하십시오.

터미널은 일반적으로 Alt+Left 및 Alt+Right를 표준 수정 화살표 시퀀스 ESC[1;3D 및 ESC[1;3C로 보냅니다. macOS에서는 먼저 Option을 Alt로 처리하도록 외부 터미널을 구성해야 합니다. 쉘이 이러한 시퀀스를 바인딩하지 않으면 zsh는 나머지 문자를 ;3D 또는 ;3C로 표시할 수 있습니다. 이는 kitty, Alacritty 및 기타 터미널에서 발생할 수 있습니다. Herdr과 tmux는 모두 원래 수정된 화살표 입력을 유지합니다.

수정된 화살표가 모든 터미널 및 중첩 셸에서 단어 탐색을 수행하도록 하려면 명시적인 zsh 바인딩을 추가하세요.

bindkey $'\e[1;3D' backward-word
bindkey $'\e[1;3C' forward-word

Kitty는 Herdr 외부에서 다르게 작동하는 것처럼 보일 수 있습니다. 왜냐하면 자동 zsh 통합은 이러한 바인딩을 터미널 멀티플렉서에 의해 생성된 쉘이 아니라 kitty가 직접 시작한 쉘에만 추가하기 때문입니다. 키티의 수동 쉘 통합 지침을 따르거나 키가 쉘에 도달하기 전에 kitty.conf의 키를 매핑하세요.

map alt+left send_text all \x1bb
map alt+right send_text all \x1bf

Herdr는 터미널 응용 프로그램이 Alt+Left 및 Alt+Right를 직접 사용할 수 있으므로 수정된 화살표를 의도적으로 다시 작성하지 않습니다. 조사 내용은 Herdr 문제 #1370을 참조하세요.

바이너리 업데이트는 이미 실행 중인 호환 서버를 대체하지 않습니다. 업데이트된 클라이언트를 사용하려면 Herdr를 다시 시작하세요. 릴리스에서 서버 측 변경 사항도 필요한 경우 herdr status을 확인한 다음 세션을 중지하고 Herdr를 다시 시작하십시오.

herdr server stop
herdr

서버를 중지하면 해당 패널 프로세스가 종료됩니다. 명명된 세션은 herdr session stop <name>를 사용합니다. 업데이트 프로그램, 패키지 관리자 및 실시간 핸드오프 동작은 Install Herdr을 참조하세요.

Herdr 패널에서 서버 실행 컨텍스트를 확인합니다.

launchctl managername

Background은 자동으로 시작된 macOS 서버에서 일반적이며 그 자체로는 키체인 문제를 나타내지 않습니다. 키체인 액세스가 실패하고 서버가 SSH 또는 백그라운드 작업을 통해 시작된 경우 이를 중지하고 일반 GUI 터미널에서 Herdr를 다시 시작하십시오.

herdr server stop
herdr

서버를 중지하면 해당 패널 프로세스가 종료됩니다. Herdr 패널은 수명이 긴 서버의 macOS 실행 컨텍스트를 상속하므로 SSH 또는 백그라운드 작업을 통해 시작된 서버는 대화형 키체인 서비스에 액세스하지 못할 수 있습니다. 자세한 내용은 Herdr 문제 #966을 참조하세요.

자동으로 시작된 macOS 서버는 사용자별 서비스 컨텍스트를 사용하므로 로그아웃해도 해당 패널에서 macOS 서비스에 대한 연결이 끊어지지 않습니다. 명시적 herdr server 실행은 호출자의 컨텍스트를 유지합니다.

오래된 서버는 사용자 조회 및 DNS를 잃어도 로그아웃 상태를 유지할 수 있습니다. 증상에는 No user exists for uid 501, Could not get manager name. 및 curl: (6) Could not resolve host이 포함됩니다. 다시 로그인해도 해당 서버는 복구되지 않습니다. 영향을 받은 세션을 중지하고 새 로그인의 GUI 터미널에서 Herdr를 시작하십시오. 이렇게 하면 라이브 패널 프로세스가 종료되지만 저장된 세션 레이아웃이 복원됩니다. 실시간 핸드오프는 원본 서버의 서비스 컨텍스트와 기존 패널 프로세스를 유지합니다. 따라서 이 수정 사항을 적용하려면 이전 서버에서 전체 세션을 다시 시작해야 합니다. 핸드오프는 상속된 컨텍스트를 복구할 수 없습니다.

새로 시작한 서버에 여전히 이 문제가 있는 경우 could not select persistent user service context에 대해 herdr-server.log을 확인하세요. Herdr는 필요한 macOS API를 사용할 수 없는 경우 상속된 컨텍스트를 유지합니다. Herdr 문제 #4100을 참조하세요.

환경을 다시 로드하도록 터미널을 다시 시작한 다음 Herdr 설치 디렉터리가 PATH에 있는지 확인합니다. 패키지 관리자 설치의 경우 해당 패키지 관리자를 사용하여 Herdr를 업데이트하고 PATH에 노출하세요. Herdr 설치를 참조하세요.

운영 체제나 외부 터미널은 Herdr가 코드를 수신하기 전에 코드를 사용할 수 있습니다. 해당 레이어의 코드를 해제하거나 다른 바인딩을 선택하세요. 알려진 충돌 및 안전한 기본값은 키보드와 마우스을 참조하세요.

먼저 일반 OpenSSH가 ssh <host>에서 작동하는지 확인하세요. 비대화형 셸, CI 작업 또는 모바일 터미널의 암호로 보호된 키의 경우 원격 연결을 시작하기 전에 키를 ssh-agent에 로드합니다. 지속성 및 원격 액세스을 참조하세요.

Herdr 로그는 기본적으로 ~/.config/herdr/에 있습니다.

herdr.log
herdr-client.log
herdr-server.log

자세한 내용을 보려면 HERDR_LOG=herdr=debug을 설정하세요. 문제를 보고할 때 현재 로그와 순환된 형제 항목을 포함합니다. 구성을 참조하세요.