빌더
채팅 빌더가 조립 계획을 세우기 전에 필요한 cob 실행 파일 · 빌더 기계 API · bricks 체크아웃 · 레시피 카탈로그가 갖춰졌는지 읽기 전용으로 점검하고, 모자란 것을 채우는 방법을 보여 주는 화면을 설명합니다.
목차
「설정」의 「빌더」는 채팅 빌더가 계획을 세우는 데 필요한 준비물이 갖춰졌는지 미리 보여 주는 화면입니다. 채팅에서 요구를 보냈다가 「cob 실행 파일을 찾지 못했습니다」 같은 안내를 만나기 전에, 여기서 먼저 알 수 있습니다. 이 화면은 아무것도 설치하거나 바꾸지 않습니다. 모자란 것을 알려 주고 터미널에서 실행할 명령을 복사하게 해 줄 뿐입니다.
참고
화면 위의 설명은 「아래 세 가지가 갖춰져야 계획을 만들 수 있습니다」라고 적혀 있지만 점검하는 줄은 네 개입니다. 이 문서는 네 항목으로 설명합니다.
네 항목
항목을 열 때 한 번, 그리고 「다시 확인」을 누를 때마다 다시 확인합니다. 처음 확인하는 동안 네 줄은 모두 「확인 중…」으로 보입니다. 「다시 확인」을 누르면 이전 결과가 그대로 있다가 새 결과로 바뀌고, 단추 글자만 「확인 중…」이 됩니다.
| 항목 | 정상일 때 | 문제가 있을 때 | 확인하는 방법 |
|---|---|---|---|
| cob 실행 파일 | cob <버전> 꼴. 버전을 읽지 못하면 「찾았습니다」 |
「PATH 에서 찾지 못했습니다」 | cob --version 과 cob plan --help 를 실행해 봅니다. 둘 중 하나라도 실행되면 설치된 것으로 봅니다 |
| 빌더 기계 API | 「plan --spec 지원」 | 「plan --spec 이전 버전입니다 — 갱신이 필요합니다」 | cob plan --help 의 출력에 --spec 이 있는지 봅니다. cob 가 없으면 「cob 를 설치하면 확인합니다」 |
| bricks 체크아웃 | 폴더 위치(macOS · Linux 는 ~/.cob/bricks 로 줄여 보임) |
「<위치> 이 없습니다」 |
홈 폴더 아래 .cob/bricks 안에 bricks 폴더가 있는지 봅니다 |
| 레시피 카탈로그 | 「레시피 목록을 찾았습니다」 | 「레시피 목록을 찾지 못했습니다 — cob 갱신이 필요합니다」 | 앞의 둘이 정상일 때만 cob catalog --json 을 실행해 레시피가 한 건이라도 있는지 봅니다. 아니면 「cob 와 bricks 를 준비하면 확인합니다」 |
각 줄의 왼쪽 아이콘이 상태를 알려 줍니다. 체크 표시는 정상, 느낌표는 문제, 빈 원은 아직 판단할 수 없음입니다.
- cob 를 찾는
PATH는 터미널의 것과 다를 수 있습니다. macOS · Linux 에서는 앱을 시작할 때 로그인 셸의PATH를 한 번 읽어 쓰고(5초 안에 끝나지 않으면 앱이 받은PATH를 그대로 씁니다), Windows 에서는 앱이 시작된 환경의PATH를 씁니다(준비물). - 이 점검은 사람이 터미널에서 같은 명령을 치는 것과 같은 방식의 읽기 전용 실행입니다. 채팅이 cob 로 프로젝트를 조립할 때는 정책 프록시를 거치는 별도 실행이라, 여기서 모두 정상이어도 조립 중에는 샌드박스 때문에 막힐 수 있습니다.
- 점검 자체가 실패하면 「cob 상태를 확인하지 못했습니다 — 다시 확인해 보세요.」가 나옵니다. 처음 확인이 실패했다면 네 줄은 「확인하지 못했습니다」(빈 원)로 보입니다. 「다시 확인」을 누르세요.
모자란 것을 채우기
네 항목 가운데 문제가 있으면 카드 아래에 가장 먼저 해결할 하나만 안내가 나옵니다. 설치 → 갱신 → bricks → 레시피 순서로, 앞의 것이 해결되기 전에는 뒤의 것을 보여 주지 않습니다.
| 안내 | 언제 | 할 일 |
|---|---|---|
| cob 를 설치하세요 | cob 를 찾지 못했을 때 | 안내 아래의 명령을 「복사」로 복사해 터미널에서 실행하고 「다시 확인」 |
| cob 를 갱신하세요 | cob 가 plan --spec 이전 버전일 때 |
같은 명령으로 갱신하고 「다시 확인」 |
| bricks 체크아웃이 없습니다 | ~/.cob/bricks 가 없을 때 |
cob doctor --fix 를 터미널에서 실행하거나, 채팅에서 계획을 만들 때 나오는 「bricks 받기」를 누릅니다 |
| 레시피 카탈로그를 찾지 못했습니다 | cob 가 레시피를 한 건도 돌려주지 않을 때 | cob 를 갱신하고 「다시 확인」 |
설치 · 갱신 명령에는 이 앱이 기대하는 cob 버전이 지정되어 있습니다. 직접 치지 말고 앱이 보여 주는 명령을 복사해 쓰세요. 이 화면에는 설치 단추가 없습니다 — 명령은 터미널에서 직접 실행합니다.
참고
자주 겪는 문제
터미널에서는 cob 가 되는데 「PATH 에서 찾지 못했습니다」가 나옵니다
터미널에서는 cob --version 이 되는데도 앱이 cob 를 찾지 못하는 경우입니다. 앱이 읽은 PATH 에 cob 가 있는 폴더가 없습니다. dart pub global 로 설치한 실행 파일의 폴더는 셸 프로필(.zshrc 등)에서 PATH 에 더해 두는 경우가 많은데, 앱은 시작할 때 로그인 셸에서 그 PATH 를 읽어 오고 셸이 5초 안에 끝나지 않으면 읽은 값을 쓰지 못합니다. 셸 프로필이 느리다면 가볍게 하세요. 로그인 셸 조회가 실패하거나 5초를 넘기면 앱은 자기가 받은 PATH 를 그대로 쓰는데, 터미널에서 띄운 앱이 받는 PATH 는 그 터미널의 것입니다(예: Linux 에서 ./cocode). 소스를 읽어 확인한 내용이고 앱 화면에서 직접 돌려 보지는 않았습니다. 준비 방법은 준비물에 있습니다.
「다시 확인」을 눌러도 상태가 그대로입니다
설치나 갱신 명령이 아직 끝나지 않았거나 실패한 경우입니다. 터미널에서 cob --version 과 cob plan --help 가 직접 동작하는지 먼저 확인하세요. plan --help 의 출력에 --spec 이 보이지 않으면 갱신이 필요한 버전입니다.
다음 단계
내장 터미널이 보관하는 출력의 양을 정하는 화면은 터미널로 이어서 보세요.