Guide · Mount

내 폴더를 wiiiv에 연결하세요

wiiiv는 안전을 위해 격리된 공간(sandbox)에서 동작합니다. 작업할 폴더를 마운트하면, wiiiv가 해당 폴더의 파일을 읽고 수정할 수 있습니다.

Why

왜 폴더를 등록해야 하나요?

wiiiv의 AI 에이전트는 샌드박스 안에서 동작합니다. 샌드박스는 격리된 작업 공간으로, 에이전트가 내 컴퓨터의 아무 파일이나 마음대로 건드리지 못하도록 보호하는 울타리입니다.

일반적인 AI 도구는 "바탕화면의 파일을 읽어줘"라고 하면 컴퓨터 전체에 접근할 수 있습니다. 편리하지만 위험합니다. wiiiv는 반대로, 사용자가 명시적으로 허용한 폴더만 에이전트가 접근할 수 있습니다. 이 "허용"이 마운트입니다.

Sandbox 구조
내 컴퓨터 전체
/home/user/개인문서/  ← 접근 불가
/home/user/.ssh/  ← 접근 불가
/etc/passwd  ← 접근 불가
🛡 wiiiv 샌드박스 (격리 공간)
sessions/abc123/  ← 대화별 임시 파일
mounts/보고서/ → /home/user/reports/  ✓ 허용됨
mounts/서버로그/ → /var/log/myapp/  ✓ 허용됨
마운트 = 샌드박스 밖 폴더를 안으로 연결하는 통로

정리하면: 샌드박스가 보호하고, 마운트가 필요한 만큼만 열어줍니다. 파일을 일일이 업로드하지 않아도 되고, 동시에 허용하지 않은 파일에는 접근이 차단됩니다.

What

마운트로 할 수 있는 것

폴더를 마운트하면, 대화 중에 "보고서 폴더에서 이번 달 파일 요약해줘"처럼 자연스럽게 파일 작업을 요청할 수 있습니다.

📂
폴더 단위 연결
디렉토리를 통째로 등록. 하위 파일/폴더까지 모두 접근 가능합니다.
🏷
라벨로 간편 접근
"보고서", "서버로그" 같은 이름을 붙이면 대화에서 라벨로 찾습니다.
🛡
필요할 때만 노출
대화 맥락과 관련 있는 마운트만 에이전트에게 보입니다.
⚡
실시간 반영
폴더 안에서 파일을 추가/수정하면 즉시 반영됩니다. 재등록 불필요.
Where

어디에서 찾나요?

좌측 사이드바 하단의 ⚙️ 설정 아이콘을 누르고, 상단 탭에서 "마운트"를 선택합니다.

wiiiv — Settings
💬
📁
📚
⚡
⚙️
프로필
연결
기억
API 키
AI
마운트
환경 설정
정보
마운트
wiiiv가 접근할 수 있는 로컬 폴더를 등록합니다.
/home/user/documents/reports
📁
보고서
+
보고서
/home/user/documents/reports reports_2fe
×
서버 로그
/var/log/myapp myapp_a3b
×
프로젝트 소스
C:\Users\me\dev\project project_8cd
×
각 마운트에는 시스템이 자동 생성하는 mountId(예: reports_2fe)가 붙습니다. 라벨과 함께 파일 접근에 사용됩니다.
Register

마운트 등록하기

1. 경로 입력 또는 폴더 선택
경로를 직접 입력하거나, 📁 버튼을 눌러 폴더 브라우저에서 선택합니다.
2. 라벨 지정 (선택)
폴더에 알아보기 쉬운 이름을 붙입니다. 비워두면 폴더 이름이 라벨이 됩니다.
3. + 버튼으로 등록
등록하면 즉시 활성화됩니다. 다음 대화부터 사용할 수 있습니다.
4. 완료
목록에 라벨, 경로, mountId가 표시됩니다.

폴더 브라우저

📁 버튼을 누르면 서버의 파일 시스템을 탐색할 수 있는 모달이 열립니다. 홈 폴더, 드라이브 루트 바로가기와 경로 이동 기능을 제공합니다.

폴더 선택

폴더 선택

×
🏠 Home 📁 Drives | / / home / user / documents
📁 reports
📁 invoices
📁 photos
📁 templates
최근: /home/user/dev
Desktop 앱에서는 Windows/Mac 폴더를 그대로 선택할 수 있고, 서버(Web) 모드에서는 서버의 파일 시스템을 탐색합니다.
Usage

대화에서 사용하기

마운트를 등록해두면, 대화 중에 해당 폴더의 파일을 언급하거나 작업을 요청할 수 있습니다. wiiiv가 대화 맥락을 분석해서 관련 마운트를 자동으로 인식합니다.

wiiiv — Chat
You
보고서 폴더에서 이번 달 파일 목록을 보여줘
wiiiv
보고서 폴더의 파일 목록입니다:
ls mounts/reports_2fe/
───────────────
2026-07-01_주간보고.docx
2026-07-08_월간실적.xlsx
2026-07-10_회의록.md
project-summary.pdf
wiiiv — Chat
You
서버 로그에서 오늘 에러만 뽑아서 정리해줘
wiiiv
서버 로그(myapp) 폴더에서 오늘 날짜의 ERROR 로그를 추출했습니다.

총 3건의 에러가 발견되었습니다:
1. 09:12 — NullPointerException at UserService:142
2. 11:45 — TimeoutException: DB connection pool exhausted
3. 15:33 — FileNotFoundException: /tmp/cache/session_abc

라벨 또는 mountId 어떤 것으로든 접근할 수 있습니다. "보고서 폴더"라고 말하면 라벨 "보고서"를 가진 마운트를 자동으로 찾습니다.

마운트된 폴더가 여러 개일 때, 대화와 무관한 마운트는 에이전트에게 노출되지 않습니다. wiiiv가 맥락을 분석해서 관련된 것만 선택합니다.
Mechanism

동작 원리

마운트가 등록되면 내부적으로 다음과 같이 동작합니다.

경로 등록
sourcePath와 라벨을 저장하고, 폴더명+해시 조합으로 고유한 mountId를 생성합니다.
심볼릭 링크 생성
샌드박스 내부에 mounts/{mountId}/ → 실제 폴더로 연결됩니다.
대화 시 관련성 판단
사용자 메시지와 마운트 라벨을 비교해서, 관련 있는 마운트만 에이전트에게 알려줍니다.
파일 접근 실행
에이전트가 mounts/보고서/파일.txt 경로로 파일을 읽거나 분석합니다.
Security

보안

마운트는 파일 시스템 접근을 허용하므로, 여러 보호 장치가 적용됩니다.

🚫
시스템 경로 차단
/etc, /usr, Windows 시스템 폴더 등은 등록할 수 없습니다.
👁
최소 노출
대화와 관련 없는 마운트는 에이전트에게 보이지 않습니다.
🔒
API 세션 격리
외부 API 작업 중에는 마운트 접근이 자동 차단됩니다.
마운트된 폴더의 파일은 읽기뿐 아니라 쓰기도 가능합니다. 중요한 원본 파일이 있다면 백업 후 등록하거나, 사본 폴더를 만들어 등록하세요.
Tips

활용 팁

📋
라벨을 명확하게
"서버 로그", "매출 데이터"처럼 구체적인 이름을 붙이면 wiiiv가 맥락을 더 정확히 파악합니다.
📦
용도별로 분리
하나의 큰 폴더보다 용도별로 나눠서 등록하면 관련성 판단이 정확해집니다.
🗑
불필요하면 삭제
더 이상 필요 없는 마운트는 × 버튼으로 바로 삭제할 수 있습니다. 원본 파일은 그대로 유지됩니다.
🔄
자동 동기화
마운트는 심볼릭 링크이므로, 원본 폴더에 파일을 추가/수정하면 즉시 반영됩니다.
마운트를 처음 사용할 때: 대화에서 "마운트 목록 보여줘"라고 말하면 등록된 폴더 목록과 접근 방법을 안내받을 수 있습니다.
비록 wiiiv의 DACS와 HazardGuard가 파괴적인 동작을 사전에 방지하기 위해 최선을 다하지만, 100%를 보장하지는 않습니다. 마운트된 폴더의 파일은 실제 파일시스템에 반영됩니다. 파일의 수정, 삭제, 이동 등을 수행하기 전 대단히 주의를 기울이시고 반드시 직접 확인 후 실행하십시오.