가이드

설계 철학

ModelBuff가 끝까지 지키는 것과 단호히 거부하는 것 — 모두 아래 5가지 엔지니어링 원칙에 뿌리를 둡니다.

01

공식 원본을 네이티브 그대로 구동

리버스 프록시와 위장을 거부하고 격리 환경 안에서 공식 CLI를 그대로 실행합니다.

지키는 원칙

  • 공식 직구동 — 정식 CLI로 로그인·통신해 신기능을 지체 없이 활용
  • 표준 프로토콜 — ACP로 에이전트를 구동하고 MCP로 미디어 도구 제공
  • 개방형 API 호환 — 로컬 게이트웨이가 OpenAI / Anthropic / Gemini 형식 지원

하지 않는 것

  • 토큰 추출 금지 — 구독 인증 토큰을 빼내 프록시가 대리 전송하지 않음
  • 프롬프트 위장 금지 — 시스템 프롬프트를 변조하거나 지우지 않음

02

독립 샌드박스 + 전용 브라우저, 이상 시 즉시 차단

계정마다 격리 경계·고정 출구·전용 브라우저를 묶고, 경계가 깨지면 직접 연결 없이 즉시 중단합니다.

지키는 원칙

  • 전용 브라우저 원클릭 — 정품 Chrome / Edge를 독립 프로필과 색상 배지로 재사용
  • 무오염 샌드박스 — 호스트 자격 증명 차단, 출구 기준 시간대·언어 정렬, DNS/WebRTC 누출 봉쇄
  • 폴더 × 그룹 격리 — 업무·개인 환경과 다중 계정의 경계를 물리적으로 분리

하지 않는 것

  • 비격리 실행 금지 — 샌드박스나 출구 오류 시 즉시 에러로 중단
  • 묵시적 폴백 금지 — 호스트 $HOME이나 직접 연결로 슬쩍 되돌리지 않음

03

100% 로컬 실행, 오직 개인을 위한 도구

내 컴퓨터 안에서만 완결되는 개인 생산성 워크스테이션. 자격 증명도 대화도 기기 밖으로 나가지 않습니다.

지키는 원칙

  • 모든 데이터 로컬 보관 — 로그인 세션, API 키, 이중 소스 사용량 장부를 로컬 디스크에만 저장
  • 제공사 직접 연결 — 모든 모델 요청을 기기에서 대상 제공사로 직접 전송
  • 양방향 민감 정보 보호 — 127.0.0.1:28330 전용으로 키 마스킹과 경로 치환 수행

하지 않는 것

  • 클라우드 계정 없음 — 로그인 강제나 대화·사용량 업로드 없음
  • 다인 공유·재판매 불가 — 멀티 테넌트 계정 풀이나 구독 상업 재판매 미제공

04

밀리초 초경량 코어, 컴퓨터 한 대로 충분

VM·Docker보다 훨씬 가볍게 격리해 작업 리듬을 전혀 늦추지 않는 아키텍처.

지키는 원칙

  • 상주 메모리 5 MB 미만 — 자체 경량 엔진으로 세션당 실측 약 3 MB
  • 약 45 ms 즉시 시작 — 샌드박스+고정 출구 전체 활성 시 ~45 ms, 전환만 ~3 ms
  • 독립 CLI 바이너리 — GUI 의존성 제로, macOS / Linux / WSL2 고속 동작

하지 않는 것

  • 무거운 VM 지양 — 계정마다 가상 머신이나 대형 이미지를 띄우지 않음
  • 다중 클라우드 불필요 — 컴퓨터 한 대로 여러 격리 환경을 가볍게 병렬 운용

05

MIT 오픈소스로 기존 생태계 확장

자격 증명·설정·프로토콜을 다루는 모든 핵심 구성요소는 MIT 오픈소스로 투명하게 감사 가능합니다.

지키는 원칙

  • 핵심 클라이언트·프로토콜 전면 공개 — 데스크톱 앱, CLI, 보호 게이트웨이, 멀티모달 MCP, 프로토콜 계약 공개
  • 투명한 로컬 파일 — 설정과 키 모두 명확한 로컬 파일로 벤더 종속 없음
  • 무손실 마이그레이션 — CC Switch / Magpie / OpenCode 및 ccswitch:// 읽기 전용 가져오기

하지 않는 것

  • 원본 설정 덮어쓰기 금지 — 기존 도구의 설정 파일을 손상시키지 않음
  • 폐쇄적 생태계 지양 — 오픈 플러그인과 표준 프로토콜로 기존 도구를 증폭

아키텍처 경계 — 샌드박스 격리, 멀티홉 체인, 듀얼 윈도우 스케줄링은 동봉된 mb-engine이 수행하며 공개 계약을 통해 오픈소스 클라이언트와 통신합니다.