앱이 호스트에 닿지 않을 때
데스크톱 앱은 자기 호스트를 띄웁니다. 준비된 뒤에 호스트가 멈추면 앱이 5분에 세 번까지 다시 띄웁니다. 시작하다가 멈추면 이유와 함께 다시 시도와 로그 보기가 나옵니다.- 직접 다시 띄우려면 파일 → Archetype 다시 시작을 누릅니다.
- **호스트가 다시 시작됐어요. Archetype을 다시 열면 연결돼요.**가 보이면 앱을 닫았다가 다시 엽니다.
- 서버의 호스트: 앱은 시스템의
ssh로 연결하므로, 터미널에서 비밀번호를 묻지 않고ssh가 되어야 합니다. 다시 연결(파일, 또는 관리 → 설정 → 서버)을 누릅니다. 서버가 더 오래된 버전이면 업데이트 후 다시 연결이 나옵니다. 그래도 안 되면 이 컴퓨터 쓰기로 이 컴퓨터의 호스트를 엽니다. - 휴대폰: 컴퓨터에 연결할 수 없어요라고 나오면 컴퓨터가 켜져 있고 앱이나 호스트가 도는지 확인합니다. 포트가 이미 쓰이고 있다고 나오면 설정 파일의
phones.port를 다른 값으로 바꿉니다. 기기 참고.
채팅, 예약, 트리거에 답이 없을 때
이것들은 앱을 닫아도 백그라운드 서비스가 돌립니다.~/.config/archetype/env에 한 줄에 하나씩 NAME=value로 두고, 나만 읽게 합니다(chmod 600). 다른 사람이 읽을 수 있으면 서비스가 시작을 거부합니다.
로그인이 만료됐을 때
MCP 서버가 실패할 때
"disabled": true인 서버는 돌지 않습니다. MCP 서버 참고.
플러그인이 꺼져 있거나 보이지 않을 때
- 관리 → 플러그인을 확인합니다. 보낼 것과 식사는 직접 켜기 전에는 꺼져 있습니다.
~/.config/archetype/config.json에서 끈 플러그인("plugins": { "이름": false })은 꺼진 채로 있습니다.- 회사 호스트에서는 관리자가 어느 역할이 플러그인을 보고 도구를 쓸지 정합니다. 내 역할에 없으면 관리자에게 묻습니다. 회사 호스팅 참고.
- 음악은 Mac에서만 동작하고, macOS가 Archetype의 앱 조작을 허용해야 합니다. 음악 참고.
알림이 오지 않을 때
- 관리 → 내 설정 → 알림 설정을 엽니다. 기기마다 알림을 받는지 보이고, 시스템 설정에서 꺼짐, 이 브라우저에서 꺼짐, 브라우저가 막음, 닿지 않음이 이유를 알려 줍니다.
- 시스템 설정에서 Archetype의 알림을 켠 뒤 다시 확인합니다.
- 방해 금지 시간에는 알림을 미루고, 알림 끈 세션은 알리지 않습니다.
- 그 대화가 앞에 있는 창에 열려 있으면 알림을 띄우지 않습니다.
- 팀의 멘션, 답글, 결정 알림은 그 팀의 설정을 따릅니다.
로그 위치
로그에는 접속 토큰이 빠져 있습니다. 보내기 전에 개인적인 내용이 없는지 한 번 봅니다.
문제 알리기
help@archetype.ing로 다음을 보냅니다.- 무엇을 했고, 무엇을 기대했고, 무슨 일이 있었는지
- 컴퓨터와 시스템,
archetype --version archetype --doctor출력, 그리고 문제 앞뒤의 로그 줄- 연결한 앱이나 플러그인이라면 그 이름