설정 및 보안

ProjectHub의 모든 설정을 관리하는 방법과 보안 시스템에 대해 안내합니다.

설정 접근 방법

설정은 다음 방법으로 접근할 수 있습니다:

방법설명
프로젝트 설정 버튼프로젝트 상세 헤더의 기어 아이콘
네트워크 상태 클릭툴바 좌측의 네트워크 인디케이터
설정 시트 전체 (탭 구분)public/images/manual/settings/set-01-settings-full.png스크린샷 교체 예정

Intelligence 설정 (AI 구성)

AI 프로바이더를 설정하고 관리하는 핵심 설정입니다.

BYOK (Bring Your Own Key)

ProjectHub는 BYOK 모델로 동작합니다. 사용자의 API 키를 직접 사용하며, ProjectHub는 API 자격 증명이나 응답을 저장, 프록시, 캐싱하지 않습니다. 모든 API 사용량은 각 AI 제공자의 계정으로 직접 청구됩니다.

설정 화면 상단에 BYOK 안내 배지가 표시됩니다.

Intelligence 설정 탭 전체public/images/manual/settings/set-02-intelligence-tab.png스크린샷 교체 예정

AI 프로바이더 관리

프로바이더설명설치 확인설정 항목
Claude CLIAnthropic Claudeclaude --version모델 선택, 활성화
Gemini CLIGoogle Geminigemini --version모델 선택, 활성화
Ollama로컬 AIollama --version호스트, 모델, 활성화
OpenCode오픈소스opencode --version활성화
프로바이더 목록 - 설치 상태 및 토글public/images/manual/settings/set-03-provider-list.png스크린샷 교체 예정

각 프로바이더에 대해:

  • 활성화/비활성화 토글
  • 사용 가능 여부 자동 감지 (설치 상태 확인)
  • 모델 선택 (해당 시)

자율 모드

자율 모드 토글과 설명public/images/manual/settings/set-04-autonomous-toggle.png스크린샷 교체 예정
설정설명
자율 모드AI 파일 작업을 자동 승인
자율 모드를 활성화하면:
  • AI Agent (Vibe Coding): 파일 생성/수정 자동 승인
  • Alliance: Human Checkpoint 자동 선택
  • Alliance: Fix Checkpoint 자동 재시도

⚠️ 주의: 자율 모드에서는 AI가 승인 없이 파일을 수정합니다. 중요한 프로젝트에서는 반드시 스냅샷을 먼저 생성하세요.

Ollama 원격 설정

Ollama를 다른 컴퓨터에서 실행하고 네트워크로 연결할 수 있습니다:

Ollama 원격 설정 필드public/images/manual/settings/set-05-ollama-remote.png스크린샷 교체 예정
형식: host:port|model
예시: 192.168.1.100:11434|llama3
필드설명예시
호스트Ollama 서버 IP192.168.1.100
포트Ollama 서버 포트11434 (기본)
모델사용할 모델 이름llama3, codellama

Ollama 모델 라이선스 안내

Ollama 자체는 MIT 라이선스이지만, 개별 모델은 각기 다른 라이선스를 가지고 있습니다. 모델을 선택하면 ProjectHub가 자동으로 라이선스를 분류하여 안내합니다.

분류모델 예시표시
상업 이용 가능Llama 3, Qwen 2.5, Phi, DeepSeek, Gemma, Mistral경고 없음
상업 이용 제한Codestral빨간색 경고
확인 필요목록에 없는 모델주황색 안내

상업적으로 배포할 경우, 사용하려는 모델의 라이선스 조건을 반드시 확인하세요.

네트워크 설정 (P2P)

ProjectHub 인스턴스 간 P2P 연결을 설정합니다.

네트워크 설정 패널public/images/manual/settings/set-06-network-panel.png스크린샷 교체 예정

네트워크 상태 인디케이터

툴바의 네트워크 상태 인디케이터 (연결됨/끊김)public/images/manual/settings/set-07-network-indicator.png스크린샷 교체 예정
상태색상설명
연결됨초록다른 ProjectHub 인스턴스와 연결 중
연결 없음회색독립 실행 모드
오류빨강연결 실패

P2P 기능

기능설명
프로젝트 채팅같은 프로젝트 작업자 간 실시간 채팅
연락처 동기화네트워크 상의 사용자 목록
인증연결 요청 시 승인/거부

인증 다이얼로그

P2P 인증 다이얼로그 (승인/거부)public/images/manual/settings/set-08-p2p-auth-dialog.png스크린샷 교체 예정

다른 ProjectHub 인스턴스에서 연결 요청이 오면 인증 다이얼로그가 나타납니다:

  • 승인 — 연결 허용
  • 거부 — 연결 거부

보안 시스템

ProjectHub는 HMAC-SHA256 기반 인증 시스템으로 AI Agent의 보안을 관리합니다.

AI Agent 인증

항목설명
알고리즘HMAC-SHA256
키 저장~/.projecthub/agent_secret.key
토큰 만료60초
리플레이 방지Nonce 기반

인증 흐름

1. ProjectHub가 비밀 키로 토큰 생성

  1. AI Agent에게 토큰 전달
  2. AI Agent가 토큰으로 인증
  3. 60초 내 사용되지 않으면 만료
  4. 동일 토큰 재사용 불가 (Nonce)

비밀 키 관리

비밀 키는 앱 첫 실행 시 자동으로 생성됩니다:

  • 위치: ~/.projecthub/agent_secret.key
  • 형식: 랜덤 바이트 문자열
  • 권한: 소유자만 읽기/쓰기 (600)

⚠️ 비밀 키를 삭제하면 새 키가 자동 생성되지만, 기존 세션은 모두 무효화됩니다.

앱 데이터 관리

데이터 위치

데이터위치
프로젝트 목록~/Library/Application Support/ProjectHub/projects.json
논문 북마크~/Library/Application Support/ProjectHub/paper_bookmarks.json
일정 알림 설정~/Library/Application Support/ProjectHub/ScheduleNotificationSettings
보안 키~/.projecthub/agent_secret.key

데이터 백업

ProjectHub의 전역 데이터를 백업하려면:

# 전역 설정 백업
cp -r ~/Library/Application\ Support/ProjectHub/ ~/ProjectHub_Backup/

보안 키 백업

cp ~/.projecthub/agent_secret.key ~/ProjectHub_Backup/

데이터 초기화

⚠️ 아래 작업은 모든 프로젝트 목록과 설정을 삭제합니다.

# 전역 설정 초기화
rm -rf ~/Library/Application\ Support/ProjectHub/

보안 키 초기화

rm -rf ~/.projecthub/

다음 단계