# 크라우니 스킬·한선씨 설치 안내 (Claude 터미널용 실행 절차서)

당신은 다른 컴퓨터의 Claude 터미널입니다. 이 문서를 읽고 **그대로 실행**하면
이 작업 환경과 동일한 크라우니 도구(/크라우니코드·/한선씨·/KPS·/분별 + 한선씨 컴파일러)를 갖춥니다.

## 0. 전제 (중요)
- 모든 다운로드는 **아이디/비밀번호 인증 필수** (공개 다운로드 없음).
- 사용자에게 cowork 아이디/비번을 받으세요. (예: 사용자가 `id=kps` 를 알려줌)
- 서버 주소는 반드시 **`https://cowork.crowny.org`** — **포트 번호(:9720)를 붙이지 마세요.**
  외부망에서 `:9720` 직접 접속은 **방화벽 차단(연결 안 됨)**, `https://cowork.crowny.org`(443/게이트웨이)로만 접속됩니다.
- 503 이 뜨면 게이트웨이 콜드스타트/일시 재기동입니다 → **2~5초 후 재시도**하면 됩니다.

## ※ 윈도우(PowerShell) 빠른 경로 — 한선씨 컴파일러 확보
```powershell
$H="https://cowork.crowny.org"
# 1) CLI 받기
irm "$H/cli.ps1" -OutFile cowork-cli.ps1
# 2) 로그인 (비번 입력창)
.\cowork-cli.ps1 login kps
# 3) 한선씨 컴파일러 한방 설치 (=> %USERPROFILE%\한선씨\한선씨-win)
.\cowork-cli.ps1 han
# 실행
cd $env:USERPROFILE\한선씨\한선씨-win ; .\han.cmd 예제.한선
# (스킬도) .\cowork-cli.ps1 pkg 크라우니스킬-v1.0.zip  → 압축해제 후 설치.cmd
```
아래 1~8 은 macOS/Linux(bash) 절차입니다.

## 1. 로그인 → 세션 토큰 획득
```bash
COWORK=https://cowork.crowny.org
read -p "cowork 아이디: " ID; read -s -p "비밀번호: " PW; echo
TOK=$(curl -s "$COWORK/api/login" -H 'Content-Type: application/json' -d "{\"id\":\"$ID\",\"password\":\"$PW\"}" | grep -o '"token": *"[^"]*"' | cut -d'"' -f4)
[ -z "$TOK" ] && { echo "로그인 실패 — 아이디/비번 확인"; exit 1; }
echo "로그인 성공"
```

## 2. 사용 가능 패키지 확인 (인증)
```bash
curl -s "$COWORK/api/packages" -H "Authorization: Bearer $TOK"
```

## 3. 크라우니 스킬 설치 (슬래시 스킬 + 규칙엔진 + 패턴DB)
```bash
curl -s "$COWORK/api/download/크라우니스킬-v1.0.tar.gz" -H "Authorization: Bearer $TOK" -o /tmp/cs.tgz
tar -xzf /tmp/cs.tgz -C /tmp && /tmp/크라우니스킬/설치.sh && rm -f /tmp/cs.tgz
```
설치 후 `~/.claude/{commands,skills,templates,scripts}` 와 `~/Downloads/CrownyTVM/crownycode-agent` 가 채워집니다.

## 4. (선택) 한선씨 컴파일러/VM 설치
```bash
# macOS(arm64). 윈도우는 한선씨-win-v1.0.zip
curl -s "$COWORK/api/download/한선씨-mac-v1.0.tar.gz" -H "Authorization: Bearer $TOK" -o /tmp/han.tgz
mkdir -p ~/한선씨 && tar -xzf /tmp/han.tgz -C ~/한선씨 --strip-components=1 && rm -f /tmp/han.tgz
echo '출력값("한선씨 OK " + 문자열변환(6*7))' > /tmp/t.한선 && ~/한선씨/han /tmp/t.한선   # → 한선씨 OK 42
```

## 5. 검증 (이것까지 통과하면 학습·실행 준비 완료)
```bash
ls ~/.claude/commands     # KPS.md 크라우니코드.md 한선씨.md 보이면 OK
ls ~/.claude/skills       # 분별 AYS집사
# 규칙엔진 매칭 테스트 (HIT 나오면 학습 브레인 동작)
( cd ~/Downloads/CrownyTVM/crownycode-agent && bash agent.sh search "16진2" 2>/dev/null | grep HIT )
```

## 6. 사용
이제 이 디렉토리에서 `claude` 를 실행하면 `/크라우니코드` `/한선씨` `/KPS` `/분별` 이 활성화됩니다.
- 한선씨 코드 작성·실행: `~/한선씨/han 파일.한선`
- 패턴 검색(라이브): `curl -s "$COWORK/api/crownycode-search?q=키워드" -H "Authorization: Bearer $TOK"`

## 7. 개선분 커밋 (이 디바이스에서 고친 버전을 블록체인으로 되돌리기)
이 맥(제네시스 node-0)이 첫 서버, 당신의 디바이스가 첫 노드입니다. 문제를 고쳤으면 커밋하세요.
```bash
# cowork-cli 받기(최초 1회)
curl -s "$COWORK/cli" -o ~/cowork-cli.sh
# 로그인(세션 저장)
bash ~/cowork-cli.sh login $ID
# 노드 이름 지정(선택, 기본=hostname). 인텔맥/윈도우 구분용
export COWORK_NODE=intel-mac    # 또는 win-pc
# 고친 파일/디렉토리를 커밋 → 해시체인 블록 + chain.crowny.org 앵커
bash ~/cowork-cli.sh commit "인텔맥에서 빌드 경고 수정" CrownyOS/crownyc/crownyc.c
# 전체 노드 기여 보기 / 다른 노드 개선분 받기
bash ~/cowork-cli.sh commits
bash ~/cowork-cli.sh commit-get <commitId>
bash ~/cowork-cli.sh nodes
```
커밋은 누가(노드)·무엇을·언제를 변조불가 해시체인에 기록하고 chain.crowny.org 에 앵커링합니다.

## 8. 한선씨로 웹서버·에코서버 만들기 (kpswin 등)
한선씨 패키지(컴파일러+VM+stdlib) + 예제로 바로 서버를 띄운다. 예제 패키지 받기:
```bash
# 로그인 후
curl -s "$COWORK/api/download/한선씨예제-v1.0.tar.gz" -H "Authorization: Bearer $TOK" -o ex.tgz
tar -xzf ex.tgz   # 한선씨예제/{웹서버예제.한선, 에코서버예제.한선, README}
# 한선씨 패키지의 han 런너로 실행 (윈도우는 han.cmd)
~/한선씨/한선씨-win/han.cmd 한선씨예제/웹서버예제.한선   # http://localhost:8090
~/한선씨/한선씨-win/han.cmd 한선씨예제/에코서버예제.한선  # TCP :8091
```
**핵심 규칙(꼭 지킬 것)**:
- TCP 빌트인: `TCP대기(host,port)` · `TCP수락(서버)` · **`TCP읽기(클라, 4096)` ← 2인자(fd,최대바이트)** · `TCP쓰기(클라,문자열)` · `TCP닫기`.
- TCP읽기를 1인자로 쓰면 -1(실패). 수락 소켓은 5초 블로킹 읽기(`CROWNY_TCP_RCVTIMEO_MS`로 조절).
- HTTP 응답: `"HTTP/1.1 200 OK\r\nContent-Type: text/html; charset=utf-8\r\nConnection: close\r\n\r\n" + 본문`.
- 라우터형은 stdlib `가져오기 "HTTP서버.한선"` 활용. 외부공개는 crowny-ports.sh + 게이트웨이 결선(임의포트는 방화벽 차단).

## 9. 정기 업데이트 확인 (kpswin 등 — 권장)
cowork가 갱신되면 `/api/updates`의 rev가 올라갑니다. 클라이언트는 정기적으로 확인해 변경분을 적용하세요.
```bash
# 한 번 확인
curl -s "$COWORK/update-check" | bash
# 변경분 적용(인증): 재다운로드+스킬 갱신
curl -s "$COWORK/update-check" | bash -s -- --apply $ID
# 정기화(cron, 6시간마다)
( crontab -l 2>/dev/null; echo "0 */6 * * * curl -s $COWORK/update-check | bash >> ~/.cowork-update.log 2>&1" ) | crontab -
```
윈도우(PowerShell): `irm "$COWORK/update-check.ps1" | iex` (작업 스케줄러로 정기 실행). 로컬 rev는 `~/.cowork-rev`에 기록되어 새 항목만 표시됩니다.

## 10. (전체 환경 이관까지 필요하면) 부트스트랩
```bash
curl -s "$COWORK/setup" | bash -s -- $ID    # 권한 등급에 맞는 티어드 세팅 전체 + 한선씨 빌드
```

— 한글 키워드를 영어로 번역하지 마세요(한선씨 규칙). cowork.crowny.org 제공.