NanumOS

브라우저

상태: 시험 중데스크톱 전용

이 컴퓨터에 있는 엔진으로 웹 사이트를 여는 앱: NanumOS.app 의 맥 웹 뷰, 아니면 Z브라우저.

브라우저

이 앱은

독의 「브라우저」는 앱 하나에 엔진이 둘이고, 나눔OS 가 어디서 도느냐에 따라 달라집니다. 비서에게 app_state(browser) 를 물으면 첫 줄이 engine: mac-web 또는 engine: zbrowser 이고, 다음 줄에 까닭이 나옵니다.

한눈에

한 줄: 웹 사이트를 여는 브라우저입니다. 이 컴퓨터에 있는 엔진으로 보여 줍니다.

화면

할 일 1. 주소 열기

  1. 창에 주소 쓰기
  2. Enter 누르기

말로: 「크로미움 열어 줘」

할 일 2. 즐겨찾기에 넣기

  1. 별 누르기
  2. 즐겨찾기 막대에서 확인하기

말로: 「브라우저 열어 줘」

할 일 3. 어느 엔진인지 보기

  1. 비서에게 말이나 글로 묻기
  2. 답 읽기

말로: 「브라우저가 어느 엔진인지 알려 줘」

기초

웹 뷰는 맥 자신의 브라우저 부품으로, 앱이 자기 창 안에 놓을 수 있습니다. NanumOS.app 은 쪽을 직접 그리지 않고, 웹 뷰를 브라우저 창 몸통 위에 정확히 덮어 놓고, 숨길 때(창이 접히거나 다른 창에 가려지거나 앞이 아닐 때)를 알려 받습니다. 나눔OS 가 맥 앱에 보내는 것은 자리(사각형)와 열 주소뿐입니다. Z브라우저는 다른 경우입니다: 나눔OS 가 자기 엔진으로 쪽을 나무(DOM)로 읽어 직접 그립니다.

쓰는 법

  1. 독의 브라우저를 누릅니다. 맥 앱에서는 창 위쪽에 맥 웹 뷰의 주소창이, 다른 곳에서는 Z브라우저의 주소창이 있습니다.
  2. 주소나 찾을 말을 쓰고 Enter 를 누릅니다. 주소가 아닌 말은 파일 › 검색 엔진에서 고른 엔진으로 검색합니다(기본 Google).
  3. 별(또는 Cmd+D)을 누르면 이 쪽이 즐겨찾기에 들어가고, 도구 줄 아래 막대와 즐겨찾기 메뉴에 보입니다. 메뉴에서 이름을 바꾸거나 지울 수 있습니다.
  4. Cmd+T 는 새 탭, Cmd+W 는 탭 닫기(마지막 탭이면 창도 닫힘). 새 창을 열려는 링크는 새 탭으로 열립니다.
  5. 방문 기록 메뉴에 최근 쪽이 보이고, Cmd+Y 는 전부 보여 주며, 「기록 지우기」는 목록을 비웁니다.
  6. 창을 닫으면 쪽도 닫힙니다.
  7. 저장된 로그인 (맥 웹 뷰). 비밀번호 칸이 있는 페이지에서 금고에 정확히 그 사이트의 로그인이 있으면 도구 막대 밑에 「이 사이트의 저장된 로그인 「이름」을 채울까요?」 줄이 뜹니다. 채우기를 누르기 전에는 아무것도 입력되지 않습니다. 비밀번호를 직접 쳐서 보낸 뒤에는 「이 비밀번호를 금고에 저장할까요?」가 뜨고, 저장 또는 안 함을 누릅니다.
  8. 다운로드 (Shift+Cmd+J): 받는 동안 진행 막대, 다 받으면 열기(나눔OS 에서 맞는 앱으로), 받은 것에서 보기(받은 것 폴더), 지우기. 실패한 것은 실패라고 적히고 다시 받기가 있습니다. 목록 지우기는 목록만 비웁니다(파일은 받은 것에 남음).
  9. 방문 기록 (Cmd+Y): 맨 위 검색 칸, 줄마다 지우기, 그리고 지우기: 지난 1시간 / 오늘 / 지난 7일 / 전체.

직접 해 보기

해 보기: 비서에게 「브라우저가 어느 엔진이야?」라고 물어 보세요.

작동 원리

즐겨찾기·방문 기록·탭 (mac-web)

맥 앱의 데이터 폴더 browser/bookmarks.json, browser/history.json 두 작은 파일이 전부이고, 맥 앱만 씁니다. 나눔OS 로 보내지 않고 비서도 읽지 못합니다: 비서는 여전히 주소 하나 열기, 그리고 승인 카드 아래의 읽기·찾기·누르기·쓰기만 할 수 있습니다. 공용 방이 아니라 내 책상 서랍에 둔 수첩과 같습니다.

저장된 로그인·다운로드·방문 기록 (mac-web)

저장된 로그인 — 흐름.

  1. 비밀번호 칸이 있는 페이지를 다 불러옵니다. 맥 앱은 나눔OS 에 하나만 묻습니다: 「이 사이트의 저장된 로그인이 있나요?」 보내는 것은 맥 앱의 웹 뷰가 직접 아는 사이트 주소(https://example.com 꼴)뿐이고, 페이지에 적힌 글은 보내지 않습니다.
  2. 나눔OS 가 그 주소를 금고 항목마다의 주소와 견줍니다. 정확히 같은 사이트여야 합니다: https/http, 이름, 포트가 모두 같아야 합니다. login.example.com 은 example.com 이 아니고, exarnple.com(r+n)도 아니며, https 로 저장한 로그인은 http 페이지에 절대 안 뜹니다.
  3. 맞는 것이 있으면 줄에 사용자 이름(비밀번호는 아님)이 보입니다. 채우기를 누르면 나눔OS 에 그 로그인을 달라고 하고, 나눔OS 는 사이트를 한 번 더 확인한 뒤 금고 사용 기록(vault log)에 「browser → 항목 @ 사이트 (autofill) filled」 한 줄을 적고, 비밀번호를 맥 앱에 넘깁니다. 맥 앱은 페이지 칸에 넣고 바로 잊습니다.
  4. 비밀번호를 쳐서 보낸 뒤 저장을 누르면 사이트 이름으로 새 항목이 생기거나, 사용자가 같은 항목의 비밀번호가 바뀝니다. 이것도 기록 한 줄입니다.

비유: 브라우저는 손일 뿐이고 열쇠는 나눔OS 가 쥡니다. 호텔 프런트가 방 번호를 직접 대는 사람에게만 열쇠를 내주고 장부에 적는 것과 같습니다.

하지 않는 것: 비서는 이 중 어떤 것도 보거나 치거나 전해 듣지 않습니다 — 줄은 앱의 것이지 페이지의 것이 아니고, 비서의 페이지 조작(읽기·누르기·쓰기)은 여전히 비밀번호 칸을 거절합니다. 페이지의 스크립트도 이 줄을 읽지 못합니다. 보통의 「보내기」를 거치지 않는 일부 한 페이지 사이트는 저장 제안이 안 뜹니다. Z브라우저는 입력 칸이 없어 저장된 로그인이 없습니다 — 로그인은 맥 웹 뷰에서 하세요.

직접 해 보기: 금고 앱에 시험용 로컬 페이지 주소로 로그인 하나를 넣고 그 페이지를 열어 보세요. 채우기를 누르기 전에는 칸이 비어 있습니다. 그다음 터미널에서 vault log 를 쳐서 기록 한 줄을 찾아 보세요.

기술 자세히

앱 → 나눔OS 줄(드롭 포트): vfind <origin>, vfill <번호> <origin>, vsave <origin> TAB 사용자 TAB 비밀번호; 답은 vfound·vfilled·vsaved 또는 거절 낱말. 견주기는 src/fillmatch.h(스킴+호스트+포트, 소문자, 기본 포트·끝 점 제거, user@ 는 브라우저처럼 읽음, 이상하면 불일치) — 제안과 채우기가 같은 견주기를 씁니다. 페이지 안의 스크립트와 그 메시지는 앱 전용 콘텐츠 월드(zeus-fill)에 있어 페이지의 스크립트가 부를 수 없습니다. 비밀번호는 답이 온 뒤 채우는 순간까지만 맥 앱 메모리에 있고, 어떤 로그에도 비밀번호·사용자 이름·주소가 없습니다(tests/mac_brbasic.py 가 시리얼 로그와 데이터 폴더의 모든 로그를 훑음).

다운로드·방문 기록 — 흐름. 페이지가 보여 줄 수 없는 파일(또는 첨부로 보낸 파일)은 맥 앱이 비공개 폴더에 받아, 「파일 보내기」와 같은 길로 나눔OS 에 넘기고 1분 뒤 맥 사본을 지웁니다. 목록 페이지는 앱이 직접 쓴 페이지이고, 그 단추는 그 페이지만 쓸 수 있는 링크입니다(웹 사이트는 누를 수 없음). 「열기」·「받은 것에서 보기」는 나눔OS 에 낱말 둘(cmd fileopen 이름, cmd filesdl)을 보내는 것입니다. 방문 기록은 맥의 browser/history.json 이고, 하나나 한 구간을 지우면 그 파일을 다시 씁니다.

맥 웹 뷰 (mac-web)

맥 앱은 「맥 브라우저 쓰기」가 켜져 있으면 나눔OS 에 알립니다(cmd hostbrowser 1). 그러면 브라우저 창 몸통은 자리일 뿐입니다: 자리가 바뀌면 hrect x y w h, 가려지면 hhide, 창을 닫으면 hclose 를 나눔OS 가 말하고, 맥 앱이 그 자리 위에 테두리 없는 웹 창 하나를 둡니다. 벽에 건 액자와 같습니다 — 틀은 나눔OS 것, 그림은 맥 것입니다.

Z브라우저 (zbrowser)

맥 웹 뷰가 없으면 브라우저는 Z브라우저입니다: 우리 엔진이 쪽을 읽고, 배치하고, 창에 그리고, 스크립트도 엔진 안에서 돕니다.

크로미움 VM (실험실)

세 번째 방식(기본은 꺼짐)은 작은 가상 컴퓨터 안에서 진짜 크로미움을 돌립니다. 설정 › 앱 › 브라우저의 실험실 스위치를 켰을 때만 나타나고, 그때 app_state(browser) 에 chromium-vm 이 보입니다. 브라우저 (크로미움 VM, 실험실) 참고.

자주 묻는 것

로그인과 기록은 어디에 남나요?

맥 웹 뷰에서는 맥(앱의 웹 저장소)에 남고 나눔OS 안에는 안 남습니다. Z브라우저에서는 나눔OS 안에 남습니다.

컴퓨터마다 브라우저가 왜 다르게 보이나요?

그 컴퓨터가 가진 엔진이기 때문입니다. NanumOS.app 을 쓰는 맥은 맥 웹 뷰를, 맥 웹 뷰가 없는 컴퓨터는 Z브라우저를 씁니다.

비서가 내 즐겨찾기나 방문 기록을 볼 수 있나요?

아니요. 맥에만 남습니다. 비서는 지금 열린 쪽에서 허락받은 일만 할 수 있습니다.

브라우저가 비밀번호를 알아서 채우나요?

아니요. 제안만 하고 결정은 내가 합니다. 금고에 정확히 이 사이트의 로그인이 있을 때만 줄이 뜨고, 채우기를 누르기 전엔 아무것도 입력되지 않습니다. 비슷한 주소나 다른 사이트에는 제안이 아예 없습니다.

브라우저에서 저장한 비밀번호는 어디에 있나요?

맥이 아니라 나눔OS 금고(금고 앱과 같은 파일)에 있습니다. 채우기와 저장은 모두 금고 사용 기록(vault log)에 한 줄씩 남습니다.

받은 파일을 볼 수 있나요?

네: Shift+Cmd+J. 파일은 나눔OS 의 받은 것(Downloads) 폴더에 있고, 실패한 것도 목록에 남아 다시 받기를 할 수 있습니다.

비서가 쪽을 읽을 수 있나요?

맥 웹 뷰에서 열기·읽기는 승인 없이, 대신 누르거나 쓰는 일은 그때마다 묻습니다. 비밀번호·카드 번호는 비서가 치지 않습니다.

이렇게 해 보세요

1. 주소 열기

  1. 창에 주소를 쓰고 Enter 를 누릅니다.

주소 열기 1

2. 어느 엔진인지 보기

  1. 비서에게 브라우저의 엔진을 물으면 app_state(browser) 로 답합니다.

어느 엔진인지 보기 1

3. 읽기 앱으로 보기

  1. 긴 글은 브라우저 대신 읽기 앱에서 엽니다.

읽기 앱으로 보기 1

단축키

맥 앱의 웹 뷰: Cmd+T 새 탭, Cmd+W 탭 닫기, Cmd+L 주소창, Cmd+R 새로고침, Cmd+. 멈추기, Cmd+[ 뒤로, Cmd+] 앞으로, Shift+Cmd+H 홈(처음엔 나눔OS 소개 쪽 zeus.kim), Cmd+D 즐겨찾기, Shift+Cmd+B 즐겨찾기 막대, Cmd+Y 방문 기록, Cmd+F 찾기(Cmd+G 다음), Cmd++ / Cmd+- / Cmd+0 확대·축소, Option+Cmd+O 맥 기본 브라우저로 열기. 그 밖의 곳에서는 키가 쪽으로 갑니다.

설정

설정 › 앱 › 브라우저에 실험실 스위치(「실험실: 브라우저를 크로미움 VM 으로 돌리기」)가 있고 기본은 꺼짐입니다. 맥 앱에서는 앱 메뉴의 「맥 브라우저 쓰기」가 맥 웹 뷰를 켜고 끕니다. 파일 › 검색 엔진에서 검색 엔진(Google·DuckDuckGo·Bing·Naver, 앱 설정의 hostsearch)을 고르고, 즐겨찾기 막대는 보기 메뉴에서 보이거나 숨깁니다.

안 되는 것

NanumOS 0.1.8349 · 2026-11-16