크라우니트윈 v1.0 — os.crowny.org/twin

개요

이 맥(mac-studio)의 전체 작업 상태를 외부 기기에서 동기화할 수 있는 디지털 트윈 시스템. 윈도우/맥 어디서든 클로드 실행 시 이 컴퓨터의 작업 결과를 동기화.

무엇을 했는가

1. Twin API (12개 엔드포인트)

• GET /twin/api/snapshot — 전체 상태 스냅샷
• GET /twin/api/sessions — 활성 클로드 세션 목록
• GET /twin/api/knowledge — PLAN.md + LIVE_STATUS.md
• GET /twin/api/patterns — 크라우니코드 학습DB 통계
• GET /twin/api/services — 14개 서비스 헬스체크
• GET /twin/api/system — 시스템 정보 (CPU/RAM/디스크)
• GET /twin/api/packages — @crowny 패키지 버전
• GET /twin/api/files — 최근 변경 .한선 파일
• GET /twin/api/diff — 특정 시점 이후 변경사항
• GET /twin/api/file — 특정 파일 내용 읽기
• POST /twin/api/sync — 원격 기기에서 상태 전송
• POST /twin/api/exec — 허용된 명령 원격 실행
• GET /twin/api/pull — 전체 동기화 패키지 풀

2. Twin 대시보드 UI

• os.crowny.org/twin — 토큰 기반 인증
• 실시간 시스템 정보, 세션, 서비스, 패턴, 파일 변경 표시

3. 동기화 클라이언트 스크립트

• crowny-twin-sync.sh — 원격 기기에서 pull/push/status
• os.crowny.org/twin/download/sync.sh 에서 다운로드

4. 한선씨 동반

• 크라우니트윈.한선 — 트윈 로직 (컴파일 성공)

관련 파일

• /Users/ef/CrownyOS/os-site/server.js — API 서버 (twin 라우트 추가)
• /Users/ef/CrownyOS/os-site/twin.html — 대시보드 UI
• /Users/ef/CrownyOS/os-site/크라우니트윈.한선 — 한선씨 동반
• /Users/ef/CrownyOS/os-site/downloads/crowny-twin-sync.sh — 동기화 클라이언트
• /Users/ef/crowny-gateway/gateway.yaml — os.crowny.org 캐시 설정 수정
• /Users/ef/.crowny-twin/ — 트윈 데이터 디렉토리

인증

• 토큰: X-Twin-Token 헤더 또는 ?token= 쿼리
• 환경변수: CROWNY_TWIN_TOKEN (기본: crowny-twin-2026)

원격 사용법

bashexport CROWNY_TWIN_HOST=https://os.crowny.org
export CROWNY_TWIN_TOKEN=crowny-twin-2026
curl -sf $CROWNY_TWIN_HOST/twin/download/sync.sh -o ~/crowny-twin-sync.sh
chmod +x ~/crowny-twin-sync.sh
./crowny-twin-sync.sh pull

잔여 이슈

• 토큰을 환경변수나 설정파일로 관리하는 방식 강화 필요
• 윈도우용 PowerShell sync 스크립트 추가 필요
• 학습DB 파일 자체의 동기화 (현재는 통계만 — 실제 .dat 파일 전송 미구현)