메인 콘텐츠로 건너뛰기
먼저 이것부터 봅니다.

앱이 호스트에 닿지 않을 때

데스크톱 앱은 자기 호스트를 띄웁니다. 준비된 뒤에 호스트가 멈추면 앱이 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 출력, 그리고 문제 앞뒤의 로그 줄
  • 연결한 앱이나 플러그인이라면 그 이름