# 여백 (Yeobaek)

책을 읽는 종이 모양의 여백 마스코트

> 광고가 아니라 여백을 남기는, 나만의 읽기용 브라우저 **여백**은 자주 읽는 블로그·기술 사이트를 방해 없이 읽기 위한 개인용 Windows 데스크톱 앱입니다. WebView2(Chromium)를 호스트하되, 네트워크 계층과 문서 초기화 시점을 앱이 직접 장악해 브라우저 확장이 구조적으로 할 수 없는 수준의 정리를 수행합니다. - **플랫폼**: Windows 10 1809+ / Windows 11 - **런타임**: .NET 10 (LTS), WPF - **엔진**: Microsoft Edge WebView2 Runtime (시스템 공유) - **화면 언어**: 한국어(기본) · 영어 · 일본어 · 중국어 간체 > 처음 쓰시나요? **[처음 사용하는 분을 위한 안내](#처음-사용하는-분을-위한-안내)** 부터 보세요. > 설치부터 광고 숨기기, 리더 모드, 보관·검색까지 차례로 설명합니다. --- ## 왜 만드는가 범용 브라우저를 대체하려는 시도가 아닙니다. **읽기라는 단일 목적**으로 범위를 좁혔을 때만 얻을 수 있는 이점을 노립니다. 티스토리나 미디엄류의 자동 광고는 페이지 로딩이 끝난 뒤 스크립트가 본문 구조를 읽고 스스로 삽입합니다. 그래서 요소를 하나씩 찍어 숨기는 방식이 잘 듣지 않습니다. 호스트 앱은 페이지의 첫 스크립트보다 먼저 실행할 수 있으므로 삽입 시도 자체를 무산시킬 수 있습니다. 또한 MV3 확장에 걸려 있는 정적 규칙 3만 개·동적 규칙 5천 개 상한, 요청을 읽고 판단해 취소하는 방식의 금지, 스토어 심사로 인한 갱신 지연이 전부 사라집니다. 규칙은 내 SQLite 파일에 있고, 고치면 즉시 반영됩니다. 무엇보다 **관리 대상이 내가 실제로 읽는 도메인 수십 개로 한정**됩니다. 범용 차단기는 수만 개 사이트를 상대로 끝없는 군비 경쟁을 하지만, 여백은 전선이 좁아서 혼자서도 유지할 수 있습니다. --- ## 주요 기능 ### 3중 방어 구조 | 층 | 수단 | 효과 | |---|---|---| | 1층 | `WebResourceRequested` 네트워크 차단 | 광고 요청을 아예 받지 않음. 원인 제거 | | 2층 | `AddScriptToExecuteOnDocumentCreated` | 광고 SDK보다 먼저 개입. 삽입 자체를 무산 | | 3층 | 리더 모드 (본문 추출) | 광고가 존재할 공간을 없앰. 최종 방어선 | ### 요소 선택기와 영구 기억 광고가 남아 있으면 `Alt+Shift+Z`로 선택 모드에 들어가 클릭합니다. 선택자가 도메인별로 SQLite에 저장되고, 다음 방문 시 페이지가 그려지기 전에 자동 적용됩니다. 개수 제한이 없습니다. ### 탭 브라우징과 링크 컨텍스트 메뉴 읽다가 참고 링크를 만났을 때 흐름이 끊기지 않도록 탭을 지원합니다. - 링크 **우클릭** → `새 탭에서 열기`, `새 탭에서 열고 이동`, `새 창에서 열기`, `링크 주소 복사`, `나중에 읽기에 추가` - `Ctrl+클릭` 또는 **가운데 버튼 클릭** → 백그라운드 새 탭 (`Ctrl+Shift+클릭` → 바로 이동) - `Shift+클릭` → 새 창 - 페이지가 `window.open()`이나 `target="_blank"`로 창을 띄우려 하면 새 창이 아니라 **새 탭으로 유도**해 팝업 광고가 별도 창으로 뜨는 것을 막습니다 - 사용자 조작 없이 뜨는 팝업은 막고, 알림 줄의 `열기`로 직접 열 수 있게 합니다 ### 읽기 경험 렌더링된 페이지에서 본문만 추출하는 리더 모드(`Ctrl+R`), 본문 폭·서체·행간·테마 조절(`settings.json`), 시스템 설정을 따르는 다크 모드, 한글 줄바꿈 품질 (`word-break: keep-all`), 나중에 읽기 목록. ### 오프라인 보관과 전문 검색 읽던 글에서 `Ctrl+S`를 누르면 본문과 이미지를 PC에 저장합니다. 보관본은 인터넷 없이도 열리고, 원문이 지워지거나 바뀌어도 남습니다. 보관함(`Ctrl+Shift+F`)에서 제목·본문으로 찾을 수 있습니다(SQLite FTS5). 한국어는 조사가 붙거나 붙여 쓴 말이 많아 낱말 중간도 찾으며, "검색"처럼 두 글자로도 찾습니다. 띄어 쓴 낱말은 모두 들어간 글만 보여 줍니다. --- ## 처음 사용하는 분을 위한 안내 처음에는 **실행 → 주소 입력 → 글 읽기 → 필요하면 리더 모드 → 나중에 읽기 또는 보관** 순서로 사용하면 된다. 아래 화면은 실제 Windows 앱에서 캡처했다. 예시 글은 [위키백과의 Web browser 문서](https://en.wikipedia.org/wiki/Web_browser)다. 1. [설치하고 실행하기](#1-설치하고-실행하기) 2. [화면 둘러보기](#2-화면-둘러보기) 3. [웹 페이지 보기 기본](#3-웹-페이지-보기-기본) 4. [광고 줄이기](#4-광고-줄이기) 5. [편하게 읽기 — 리더 모드](#5-편하게-읽기--리더-모드) 6. [나중에 읽기](#6-나중에-읽기) 7. [보관하고 다시 찾기](#7-보관하고-다시-찾기) 8. [설정 바꾸기](#8-설정-바꾸기) 9. [문제가 생겼을 때](#9-문제가-생겼을-때) ### 1. 설치하고 실행하기 [Microsoft Store에서 여백을 설치](https://apps.microsoft.com/detail/9P9727RR5675)하거나 PowerShell 또는 Windows 터미널에서 다음 명령을 실행한다. ```powershell winget install --id jacking75.Yeobaek -e --source winget ``` 직접 실행 파일을 내려받을 수도 있다. 1. **여백 받기**: [v0.1.0 릴리스](https://github.com/jacking75/Yeobaek/releases/tag/v0.1.0)의 **Assets**에서 `Yeobaek.exe`를 받는다. Windows x64용 파일이다. 2. **런타임 설치**: .NET 10 Desktop Runtime이 없다면 [dotnet.microsoft.com/download](https://dotnet.microsoft.com/download)에서 **Windows x64** 버전을 설치한다. 다운로드한 앱을 실행하는 데 SDK는 필요 없다. 3. **실행**: `Yeobaek.exe`를 두 번 누른다. 자주 쓴다면 실행 중인 작업 표시줄 아이콘을 우클릭해 **작업 표시줄에 고정**한다. 소스를 직접 빌드하려면 다음 순서를 따른다. 1. [dotnet.microsoft.com/download](https://dotnet.microsoft.com/download)에서 **.NET 10 SDK (Windows x64)**를 설치한다. 2. [github.com/jacking75/Yeobaek](https://github.com/jacking75/Yeobaek)에서 **Code → Download ZIP**을 눌러 압축을 푼다. Git을 쓴다면 `git clone https://github.com/jacking75/Yeobaek.git`을 실행한다. 3. 압축을 푼 폴더(`README.md`가 있는 곳)의 빈 곳을 **Shift+우클릭 → 터미널에서 열기**로 연 뒤 다음 명령을 실행한다. `경고 0개, 오류 0개` 또는 `Build succeeded`가 나오면 끝이다. ```powershell dotnet build ``` 4. `bin\Debug\Yeobaek.exe`를 두 번 누른다. > **WebView2 런타임**은 Windows 11 과 대부분의 Windows 10 에 이미 들어 있습니다. 없으면 여백이 시작할 때 > 설치 주소와 함께 알려 주니, 설치한 뒤 다시 실행하면 됩니다. > > 실행 파일을 직접 게시하려면 [빌드와 실행](#빌드와-실행)의 `dotnet publish` 명령을 쓴다. ### 2. 화면 둘러보기 ![여백의 새 탭 화면. 위쪽에 탭과 주소창, 가운데에 나중에 읽기와 보관함 버튼 및 단축키 안내가 있다.](assets/screenshots/home.png) 처음 열면 **새 탭** 화면이 나온다. 맨 위 긴 입력칸에 주소나 검색어를 적고 `Enter`를 누르면 된다. 가운데의 **나중에 읽기 목록**과 **보관함** 버튼은 저장한 글로 바로 이동할 때 쓴다. 화면 가운데 아래에는 자주 쓰는 단축키도 적혀 있다. | 자리 | 하는 일 | |---|---| | **탭 줄** | 연 페이지들. `×` 로 닫고, 오른쪽 `+` 로 새 탭을 엽니다. 탭을 **가운데 버튼으로 눌러도** 닫힙니다. | | **← → ⟳** | 뒤로 · 앞으로 · 새로 고침 | | **주소창** | 주소나 검색어를 넣고 `Enter` | | **방패 `차단 12`** | 이 페이지에서 막은 광고 요청 수. 누르면 이 사이트를 **예외 사이트**(광고 허용)로 바꿉니다 → [4번](#4-광고-줄이기) | | **리더** (펼친 책 모양) | 본문만 보여 주는 리더 모드 켜기/끄기 → [5번](#5-편하게-읽기--리더-모드) | | **목록** (줄 모양) | 나중에 읽기 목록 → [6번](#6-나중에-읽기) | | **보관함** (책장 모양) | 보관한 글 찾기 → [7번](#7-보관하고-다시-찾기) | | **⋯** (메뉴) | 모든 기능과 단축키, 설정 파일·데이터 폴더 열기 | | **알림 줄** | 창 아래에 잠깐 나타났다 사라집니다. 마우스를 올려 두면 사라지지 않고, `되돌리기`·`열기` 같은 버튼이 붙기도 합니다. | 버튼 위에 마우스를 올리면 설명과 단축키가 보인다. ### 3. 웹 페이지 보기 기본 - **주소로 가기·검색**: 주소창을 누르거나 `Ctrl+L` → `example.com` 같은 주소나 검색어를 넣고 `Enter`. 검색은 기본으로 Google 을 씁니다([8번](#8-설정-바꾸기)에서 바꿀 수 있습니다). ![위키백과 글을 여백에서 연 화면. 주소창 오른쪽에 광고 차단 상태, 리더 모드, 나중에 읽기, 보관함 버튼이 있다.](assets/screenshots/browser.png) 위 예시처럼 글이 열리면 주소창 오른쪽의 **방패**에서 차단 상태를 확인할 수 있다. 그 옆 아이콘은 순서대로 **리더 모드**, **나중에 읽기 목록**, **보관함**, **더 보기 메뉴**다. - **탭**: 새 탭 `Ctrl+T` · 닫기 `Ctrl+W` · 다음/이전 탭 `Ctrl+Tab` / `Ctrl+Shift+Tab` · 방금 닫은 탭 다시 열기 `Ctrl+Shift+T` - **새 창**: `Ctrl+N` - **링크 여는 방법** | 이렇게 누르면 | 이렇게 열립니다 | |---|---| | 그냥 클릭 | 지금 탭에서 | | `Ctrl+클릭` 또는 **가운데 버튼** | 뒤쪽 새 탭에서 (읽던 글을 계속 읽을 수 있어요) | | `Ctrl+Shift+클릭` | 새 탭을 열고 바로 이동 | | `Shift+클릭` | 새 창 | | **우클릭** | 메뉴: 새 탭에서 열기 · 새 창에서 열기 · 링크 주소 복사 · 나중에 읽기에 추가 | - **글자 크게/작게**: `Ctrl+마우스 휠`, 또는 `Ctrl` + `+` / `-`, 원래대로 `Ctrl+0` - **페이지에서 찾기**: `Ctrl+F` · **새로 고침**: `F5` (`Ctrl+R` 은 리더 모드입니다) - 사이트가 몰래 띄우는 **팝업은 자동으로 막습니다**. 필요한 팝업이었다면 알림 줄의 `열기` 를 누르세요. ### 4. 광고 줄이기 **그냥 읽으면 됩니다.** 여백은 알려진 광고를 페이지가 그려지기 전에 막습니다. 도구 모음의 방패 `차단 12` 가 지금 페이지에서 막은 광고 요청 수입니다. **남은 광고를 직접 숨기기** 1. `Alt+Shift+Z` 를 누릅니다. 광고 위에서 **우클릭 → 이 영역 광고 숨기기** 를 골라도 됩니다. 2. 마우스를 움직이면 **주황색 테두리**가 따라다닙니다. 숨길 광고에 맞추세요. 화면 아래에 선택자(어떤 요소인지)가 표시됩니다. 3. 테두리가 광고 일부만 감싸면 `↑` 로 바깥 영역까지 넓히고, 너무 크면 `↓` 로 좁힙니다. 4. **클릭**(또는 `Enter`)하면 바로 사라지고, 다음부터 이 사이트에서는 페이지가 뜨기 전에 자동으로 숨깁니다. 그만두려면 `Esc` 나 우클릭. 5. 잘못 숨겼다면 알림 줄의 **되돌리기**. 시간이 지났다면 **⋯ → 이 사이트 규칙 관리** 에서 골라 지웁니다. > 본문까지 사라지지 않도록, 테두리가 광고만 감쌀 때 클릭하세요. 규칙 관리 창에서는 선택자를 직접 넣어 > 추가하거나 **모든 사이트에 적용** 할 수도 있습니다. **좋아하는 사이트는 광고를 허용하기 (후원)** 방패 버튼을 누르거나 `Alt+Shift+A` 를 누르면 방패가 주황색 **예외 사이트** 로 바뀌고, 이 사이트에서는 광고를 막지 않습니다. 다시 누르면 원래대로 막습니다. 광고 차단 때문에 사이트가 제대로 동작하지 않을 때도 이렇게 하세요. **차단 목록 직접 고치기 (선택)** **⋯ → 차단 목록 편집 (blocklist.txt)** 을 누르면 메모장이 열립니다. 기본 목록은 여백에 들어 있고, 이 파일에는 **더하거나 뺄 항목만** 한 줄에 하나씩 적습니다. 저장하고 여백 창으로 돌아오면 바로 적용됩니다. ``` # 이 호스트와 그 하위 도메인을 막기 ads.example.com # 주소 경로에 /banner/ 가 들어가면 막기 /banner/ # 기본 목록에 있는 항목을 막지 않기 (앞에 !) !static.criteo.net ``` ### 5. 편하게 읽기 — 리더 모드 - `Ctrl+R` 또는 도구 모음의 **리더** 버튼을 누르면 광고·메뉴·댓글 없이 **본문만** 넉넉한 여백으로 보여 줍니다. 다시 누르면 원래 페이지로 돌아갑니다. ![같은 위키백과 글을 리더 모드로 연 화면. 본문이 한 열로 정리되고 리더 모드 버튼이 켜져 있다.](assets/screenshots/reader.png) 위 화면처럼 본문이 한 열로 정리되고 **리더 버튼에 색이 들어오면** 리더 모드가 켜진 상태다. 새로 고침은 `Ctrl+R` 대신 `F5`를 누른다. - 리더 모드에서도 주소창에는 원래 글 주소가 보이고, 제목 아래 **원문 보기** 로 원래 페이지를 열 수 있습니다. - 쇼핑·SNS·검색 결과처럼 "글"이 아닌 페이지는 본문을 찾지 못합니다. 그럴 때는 원래 화면을 그대로 두고 알림으로 알려 줍니다. - 글자 크기·줄 간격·본문 폭·어두운 화면은 [8번](#8-설정-바꾸기)에서 바꿉니다. ### 6. 나중에 읽기 - **지금 보는 글**: `Ctrl+D` · **링크**: 우클릭 → **나중에 읽기에 추가** - 도구 모음의 **목록** 버튼으로 목록을 엽니다. 글을 두 번 누르면 새 탭에서 열리고 **읽음** 으로 표시됩니다. ![나중에 읽기 창. 저장한 글의 제목, 사이트, 담은 날짜가 보이고 오른쪽 아래에 열기, 읽음 표시, 삭제 버튼이 있다.](assets/screenshots/reading-list.png) 목록에서 글을 한 번 눌러 선택한 뒤 아래의 **열기**를 눌러도 된다. 이미 읽은 글을 다시 찾으려면 오른쪽 위 **읽지 않은 글만** 체크를 해제한다. - 선택한 글은 **읽음 / 안 읽음**으로 상태를 바꾸거나 **삭제**로 목록에서 뺄 수 있다. ### 7. 보관하고 다시 찾기 - **보관하기**: 읽던 글에서 `Ctrl+S` (또는 **⋯ → 이 글 보관하기**). 본문과 **이미지까지 PC 에 저장**하므로 인터넷이 없어도, 원래 글이 지워지거나 바뀌어도 그대로 읽을 수 있습니다. 이미지가 많으면 몇 초 걸립니다. - **찾기**: `Ctrl+Shift+F` 또는 도구 모음의 **보관함** 버튼 → 검색 칸에 낱말을 넣으면 제목과 본문에서 찾습니다. - 여러 낱말을 띄어 쓰면 **모두 들어간 글만** 보여 줍니다. - "검색"처럼 **두 글자**도 되고, "커서"로 "커서를", "검색"으로 "전문검색" 처럼 **낱말 중간**도 찾습니다. - 검색 칸을 비우면 보관한 글이 모두 최근 순으로 보입니다. - **보관본 열기**(인터넷 없이 열림) · **원문 열기**(지금의 최신 글) · **삭제**(저장한 이미지까지 지움) 중에 고릅니다. - 같은 글을 다시 `Ctrl+S` 하면 최신 내용으로 바꿔 저장합니다. ### 8. 설정 바꾸기 **⋯ → 설정 파일 편집 (settings.json)** 을 누르면 메모장이 열립니다. 고쳐서 저장한 뒤 여백 창으로 돌아오면 적용됩니다(리더 모드 모양은 다음에 리더 모드를 켤 때부터). `//` 뒤는 설명이며 파일에 넣어도 됩니다. 화면 언어는 `"language"`에서 고른다. 기본값은 한국어 `"ko"`이며, 영어 `"en"`, 일본어 `"ja"`, 중국어 간체 `"zh-CN"`도 지원한다. 언어를 바꾼 뒤에는 여백을 다시 시작해야 창과 WebView2 메뉴에 적용된다. ```jsonc { "startPage": "about:blank", // 새 창·새 탭의 첫 페이지. 예: "https://news.hada.io" "searchUrl": "https://www.google.com/search?q={0}", // 검색 주소. {0} 자리에 검색어가 들어갑니다 "language": "ko", // ko · en · ja · zh-CN "reader": { "fontSizePx": 17, // 글자 크기 (12 ~ 32) "lineHeight": 1.85, // 줄 간격 (1.2 ~ 2.6) "maxWidthRem": 42, // 본문 폭 (28 ~ 80) "fontFamily": "\"Pretendard\", \"Malgun Gothic\", system-ui, sans-serif", "theme": "system" // system(Windows 설정 따름) · light(밝게) · dark(어둡게) } } ``` - 네이버로 검색하려면: `"searchUrl": "https://search.naver.com/search.naver?query={0}"` - 파일 내용이 잘못되면 알림으로 알려 주고 기본 설정으로 동작합니다. 파일을 지우면 다음 실행 때 기본값으로 다시 만들어집니다. ### 9. 문제가 생겼을 때 | 이런 경우 | 이렇게 해 보세요 | |---|---| | 시작하자마자 **WebView2 런타임을 찾을 수 없다**고 나온다 | 안내 창의 주소에서 **Evergreen 부트스트래퍼**를 받아 설치한 뒤 다시 실행 | | 터미널에서 **`dotnet` 을 찾을 수 없다**고 나온다 | .NET 10 SDK 를 설치한 뒤 터미널을 **새로 열어** 다시 입력 | | 사이트가 깨지거나 버튼이 눌리지 않는다 | ① 방금 숨긴 요소 때문이면 **⋯ → 이 사이트 규칙 관리** 에서 지우기 ② 아니면 방패 버튼으로 **예외 사이트** 지정 | | "광고 차단 소프트웨어가 방해하고 있다"는 안내가 뜬다 | 사이트가 광고 차단을 알아챈 것입니다. 계속 보려면 그 사이트를 **예외 사이트**로 | | 리더 모드가 켜지지 않는다 | 본문으로 인식할 글이 없는 페이지입니다. 원래 화면으로 보세요 | | 보관본의 이미지 일부가 안 보인다 | 보관할 때 받지 못한 이미지입니다(알림에 개수가 나옵니다). 인터넷이 연결되면 보이며, 원문에서 다시 `Ctrl+S` 해도 됩니다 | | 로그인이 유지되나요? | 네. 로그인 상태(쿠키)는 여백 전용 프로필(`%LOCALAPPDATA%\Yeobaek\WebView2`)에 남습니다. 비밀번호와 자동 완성 정보는 저장하지 않습니다 | | 다른 PC 로 옮기고 싶다 | **⋯ → 데이터 폴더 열기** 에서 `rules.db`, `blocklist.txt`, `settings.json`, `archive` 폴더를 복사 | | 이상하게 동작한다 | **⋯ → 데이터 폴더 열기** 의 `error.log` 에 기록이 남습니다. 문제를 알릴 때 함께 보내 주세요 | | 지우고 싶다 | 여백 폴더와 `%LOCALAPPDATA%\Yeobaek` 폴더를 지우면 깨끗이 지워집니다 | --- ## 요구 사항 - Windows 10 1809 이상 - [.NET 10 Desktop Runtime](https://dotnet.microsoft.com/download) - [Microsoft Edge WebView2 Runtime](https://developer.microsoft.com/microsoft-edge/webview2/) (Windows 11에는 기본 포함) --- ## 빌드와 실행 ```bash git clone https://github.com/jacking75/Yeobaek.git cd Yeobaek dotnet build # → bin\Debug\Yeobaek.exe dotnet run --project src/Yeobaek dotnet test # 단위 테스트 → bin\Debug\tests\ ``` 빌드 산출물은 저장소 루트의 `bin\<구성>\`에 모이며 `net10.0-windows` 같은 프레임워크 폴더는 만들지 않습니다(`Directory.Build.props`). 배포용 단일 실행 파일 (→ `bin\publish\Release\Yeobaek.exe`): ```bash dotnet publish src/Yeobaek -c Release -r win-x64 --self-contained false -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true ``` 결과는 `Yeobaek.exe` 파일 하나(약 5MB)입니다. 네이티브 DLL(WebView2Loader, SQLite)과 디버그 기호도 그 안에 들어 있어, 이 파일만 복사해 쓰면 됩니다(대상 PC 에는 .NET 10 Desktop Runtime 이 필요합니다). ### 프로젝트 구성 ``` src/Yeobaek/ ├─ App.xaml(.cs), AppServices.cs 시작, 공유 서비스(WebView2 환경은 하나만) ├─ MainWindow.* 탭 줄·도구 모음·단축키·알림 줄 ├─ Browser/ 탭, 1층 차단, 2층 주입, 우클릭 메뉴, 팝업, 메시지 브리지 ├─ Reader/ 3층 리더 모드 (SmartReader), 본문 추출 ├─ Archive/ 오프라인 보관 (이미지 내려받기·보관본 서빙) ├─ Data/ SQLite 규칙·예외·나중에 읽기·보관 색인, 설정 파일 ├─ Ui/ 테마, 문자열 표 연결, 규칙 관리·나중에 읽기·보관함 창 ├─ Strings/ 한국어·영어·일본어·중국어 간체 문자열 표 └─ Assets/ prelude.js · picker.js (문서 생성 전 주입), 아이콘 tests/Yeobaek.Tests/ 핵심 로직 단위 테스트 (xUnit) ``` --- ## 기본 단축키 | 키 | 동작 | |---|---| | `Ctrl+T` | 새 탭 | | `Ctrl+N` | 새 창 | | `Ctrl+W` | 탭 닫기 (마지막 탭이면 창 닫기) | | `Ctrl+Tab` / `Ctrl+Shift+Tab` | 다음 / 이전 탭 | | `Ctrl+Shift+T` | 닫은 탭 복원 | | `Ctrl+R` | 리더 모드 토글 (새로 고침은 `F5`) | | `Alt+Shift+Z` | 광고 요소 선택 모드 (`↑`/`↓` 범위 조절, `Esc`로 취소) | | `Alt+Shift+A` | 이 사이트를 광고 차단 예외로 두기 / 다시 차단 | | `Ctrl+D` | 나중에 읽기에 추가 | | `Ctrl+S` | 이 글 보관하기 (이미지까지 PC에 저장, 오프라인으로 읽기) | | `Ctrl+Shift+F` | 보관함 · 보관한 글 검색 | | `Ctrl+L` | 주소창 포커스 | | `Alt+←` / `Alt+→` | 뒤로 / 앞으로 | --- ## 데이터 위치 ``` %LOCALAPPDATA%\Yeobaek\ ├─ rules.db 요소 숨김 규칙, 차단 예외 사이트, 나중에 읽기, 보관한 글 목록·검색 색인 ├─ blocklist.txt 네트워크 차단에 더하거나('!'로) 뺄 항목 (기본 목록은 앱에 내장) ├─ settings.json 시작 페이지·검색 주소·리더 서체/행간/폭/테마 ├─ reader\ 리더 모드 페이지 (7일 지나면 지움) ├─ archive\ 보관한 글 (글마다 index.html + images\, 보관함에서 지울 때까지 남음) ├─ error.log 예상하지 못한 오류 기록 (있을 때만) └─ WebView2\ WebView2 사용자 프로필 (쿠키·로그인 세션) ``` `rules.db`와 `blocklist.txt`만 백업하면 다른 PC에서 그대로 복원됩니다. 보관한 글까지 옮기려면 `archive\` 폴더도 함께 복사하세요. `blocklist.txt`와 `settings.json`은 메뉴(`⋯`)에서 바로 열 수 있고, 저장한 뒤 여백 창으로 돌아오면 다시 읽습니다. --- ## 로드맵 - [x] 1층 네트워크 차단 - [x] 2층 문서 생성 전 주입 - [x] 요소 선택기 + SQLite 규칙 저장 - [x] 탭 + 링크 우클릭 메뉴 - [x] 3층 리더 모드 (SmartReader) - [x] 나중에 읽기 목록, 차단 예외(후원) 사이트 - [x] FTS5 전문 검색 - [x] 오프라인 보관 --- ## 알아둘 점 WebView2는 시스템의 Edge WebView2 런타임을 공유하므로, 배포물이 작고 Chromium 보안 패치는 런타임 갱신으로 따라옵니다. 다만 **정식 uBlock Origin을 `AddBrowserExtensionAsync`로 넣어 쓰는 방식은 계획에 없습니다.** WebView2는 Edge의 Manifest V2 정책을 물려받고, Edge는 2026년 8월부터 일반 사용자 대상 MV2 퇴출을 시작해 연내 마무리·기업 환경 2027년 초로 예고되어 있습니다. 여백의 차단은 확장이 아니라 호스트 코드가 담당합니다. (이 정책 일정은 이후 변경될 수 있으니 착수 전 최신 상태를 확인하세요.) 사이트가 HTML 구조를 바꾸면 저장한 선택자는 깨집니다. 클래스명이 난독화된 사이트에서는 `#id`나 `[data-*]` 속성을 기준으로 잡는 편이 오래 버팁니다. 여백은 의도적으로 **소수의 사이트만 상대하도록** 설계되었습니다. 대상 도메인을 넓히는 순간 혼자 감당할 수 없는 경쟁이 시작되므로, 목록을 작게 유지하는 것이 설계의 일부입니다. 평소 즐겨 읽어 도움을 받는 블로그를 규칙 예외로 두는 기능(`Alt+Shift+A`)도 넣어두었습니다. --- ## 라이선스 개인 사용 목적. MIT.