PKOS · 나의지식서재

흩어진 수업 자료와 그때의 생각을 모아 두고 다시 꺼내 쓰는 개인 기록 서재입니다. 기록은 각자의 브라우저에 저장됩니다. 전체 서재를 서버에 자동 업로드하지 않습니다.

기록장·변환기·사이트 만들기의 사용법과 화면 사진, QR은 PKOS 도구 모음(https://legoschool.github.io/pkos-workshop/)에 모아 두었습니다.

캡처·사진 미리보기와 문서 보기 선택

캡처한 이미지를 복사한 뒤 기록 본문에서 Ctrl+V를 누르면 현재 기록에 첨부하고 사진을 바로 보여 줍니다. 사진을 누르면 크게 미리 볼 수 있습니다. 원본 이미지와 이미지 링크를 담은 Markdown은 연결한 로컬 폴더에도 저장합니다. 일반 텍스트 붙여넣기는 그대로 사용할 수 있습니다.

사진·PDF·PPT를 끌어 놓거나 파일로 첨부할 때는 한 장씩 펼쳐 보기 / 슬라이드로 넘겨 보기를 먼저 고릅니다. PDF·PPTX 슬라이드 보기에서는 원본을 보관하고 미리보기를 열며, 펼쳐 보기에서는 페이지 이미지와 의견 칸을 만듭니다. 선택을 취소하면 해당 파일을 추가하지 않습니다.

페이지 삭제는 브라우저 저장 뒤 화면에 바로 반영하고 연결 폴더 저장은 이어서 처리합니다. 다른 페이지·원본·복원 기능은 유지합니다. 변경 및 검증 기록.

선택한 기록을 웹 주소로 공유하기

2026-10-13 GitHub Pages와 Vercel에 배포하고 각 주소에서 실제 게시·읽기·갱신·삭제 검사 7개를 확인했습니다. 설정 · 백업 → 웹으로 공유하기에서 기록을 고르고, 필요한 첨부를 개별 선택합니다. 기본은 글만 포함하며 노트북 이름과 태그도 따로 고릅니다. 포함 내용 미리보기 → 웹에 게시하기로 공유본을 만들고 주소 복사를 누릅니다. 받는 사람은 로그인 없이 주소로 읽습니다.

처음 게시하는 사람만 게시 설정에 게시자용 키를 등록합니다. 별도로 제공되는 게시 활성화 파일로 설정할 수 있으며 실제 키는 공개 저장소에 넣지 않습니다. 내가 게시한 문서 → 이 주소 갱신으로 대상을 고르고 미리보기를 확인한 뒤 선택한 주소 갱신을 누릅니다. 게시 삭제로 해당 주소의 게시를 취소합니다. 기록장을 수정하는 것만으로 공유본이 자동 갱신되지는 않습니다. 읽는 사람에게는 읽기 주소만 전달하고 게시 키나 활성화 파일은 전달하지 않습니다.

주소를 가진 사람은 공유본을 열 수 있습니다. 본문에 직접 적은 내용과 링크를 미리보기에서 확인하세요. 미선택 기록·첨부·휴지통·원본 폴더 위치·앱의 저장 설정은 포함하지 않습니다. 취소 후에도 받는 사람이 이미 내려받은 사본은 회수할 수 없습니다. 인터넷에 게시하지 않고 파일로 전달하려면 기존 웹문서 ZIP 저장을 사용합니다.

한 번에 기록 50개·본문 합계 200만 글자·첨부 50MB를 고릅니다. 게시 ZIP은 64MB·서버 전체 보관량은 500MB로 제한합니다. 실제 운영 시험에는 6MB 가상 첨부를 사용했고 시험 게시물은 모두 삭제했습니다. 최대 크기 전체를 실전 전송한 것은 아닙니다. 전체 개인 서재를 자동으로 올리지 않고 직접 선택한 읽기 묶음만 게시합니다.

게시 전 개인정보 검사와 올릴 곳 고르기

포함 내용 미리보기를 만들면 고른 기록의 제목·본문(노트북 이름과 태그를 포함했다면 그것도), 공유 제목, ai-dx 카드 제목·소개를 이 브라우저 안에서 검사합니다. 주민등록번호, 전화번호, 이메일, 계좌·카드번호, 주소, 생년월일, 차량번호, 이름(성명·작성자 같은 표시 옆, 「김민준 학생」처럼 호칭 앞, 다른 기록에서 확인한 이름)을 찾습니다. 체크한 곳은 이번 게시본에서만 가리고 기록장 원문은 바꾸지 않습니다. 체크를 푼 곳은 이대로 둡니다. 내 이름처럼 공개해도 되는 이름은 공개해도 되는 이름으로 한 번 정해 두면 다음부터 건너뜁니다. 정리하지 않은 항목이 남았거나 사진 첨부를 확인하지 않으면 웹 게시와 ai-dx 보내기가 막힙니다. 성을 빼고 부른 이름과 사진 속 얼굴은 찾지 못하니 미리보기에서 직접 확인합니다.

검사가 끝나면 **어디에 올릴까요?**에서 웹 공유 주소, ZIP 파일 가운데 고릅니다. AI·디지털 전환 지도 머리줄의 「기록장」으로 이 앱을 연 적이 있으면 ai-dx 지도도 고를 수 있습니다(aidx-link.js). 칸·종류·카드 제목·소개와 지도 강사 비밀번호를 넣어 ai-dx에 임시저장하면 공개되지 않은 채 저장되고, 지도 화면에서 확인하고 승인해야 공개됩니다. 같은 기록을 고쳐 다시 임시저장하면 같은 글의 다음 판이 되고, 지난번 가림·이대로 두기 결정을 다시 적용합니다. 확인 상태와 보완 요청 메모는 이 화면에 보입니다(글 번호와 열쇠는 이 브라우저에만 둡니다). 글만 보내고 첨부와 사진은 보내지 않습니다. 기록 메뉴 ai-dx에 임시저장 · 승인 상태는 지금 기록을 고른 채 검사까지 마친 화면을 엽니다. 시험: node --test tests/privacy-scan.test.mjs, 서버를 띄운 뒤 node tests/privacy-publish-browser.mjs.

빈 그림판에 직접 그리기

기록 편집 도구줄의 그리기를 누르면 빈 그림판이 열립니다. 펜·형광펜·지우개·도형·스티커를 고르고 마우스나 터치로 그린 뒤 그림 저장을 누르세요. 그림은 기록에 PNG로 붙고 다시 그리기로 열어 선과 도형을 수정할 수 있습니다. PNG 내려받기로 따로 저장하며, 전체 .pkem 백업에는 다시 편집할 그림 정보도 포함됩니다.

받아쓰기·설정·미리보기 등 별도 창은 창 바깥의 빈 곳을 눌러 닫습니다. 저장하지 않은 그림이나 녹음·받아쓴 글이 있으면 기존 닫기 동작과 같은 확인 절차를 거칩니다.

다른 기기에서도 게시하기

게시 키를 연결한 브라우저에서 웹으로 공유하기 → 게시 설정 → 다른 기기에서도 게시하기를 열고, 열 기록장 주소(GitHub 또는 Vercel)를 고른 뒤 연결 주소 만들기를 누릅니다. 그 주소를 게시할 기기에서 열고 이 브라우저에 연결을 누르면 게시 키를 옮겨 적지 않아도 그 브라우저에서 게시할 수 있습니다. 연결 주소는 한 시간 안에 한 번만 쓸 수 있고, 고른 기록장 주소에서만 열립니다. 받은 사람도 게시할 수 있게 되므로 본인 기기에서만 여세요.

본문 웹 주소와 YouTube 미리보기

본문에 HTTP(S) 주소나 이름이 붙은 Markdown 링크를 넣으면 입력칸 아래 본문 링크 카드가 나타납니다. 같은 주소는 하나로 모아 최대 20개를 표시하며 카드를 누르면 새 탭으로 엽니다. 일반 웹 주소는 도메인·주소로 표시하고 웹페이지 제목을 자동 수집하지 않습니다.

YouTube 링크는 미리보기 그림과 영상 미리보기 버튼을 제공합니다. 버튼을 눌러 같은 기록 안에서 재생창을 열고 미리보기 닫기로 접습니다. 자동 재생하지 않습니다. 읽기 화면에도 본문 하이퍼링크와 같은 카드가 보이며 작성 중 글·한글 입력·저장 흐름을 유지합니다.

로컬 폴더에 자동 저장하기

처음 튜토리얼의 저장할 로컬 폴더 선택, 상단의 로컬 폴더 연결 또는 설정 · 백업 → 로컬 폴더 자동 저장에서 저장할 PC 폴더를 한 번 선택하세요. 선택한 폴더 안의 전용 폴더에 기존 기록과 앞으로 저장하는 글을 제목이 있는 .md 파일로 쓰고, 녹음·사진·첨부 원본은 attachments에 함께 저장합니다. 자동 저장과 저장 버튼 모두 반영되며 화면의 로컬 폴더 저장됨으로 완료를 확인할 수 있습니다.

구글 드라이브 데스크톱이 동기화하는 로컬 폴더도 선택할 수 있습니다. 온라인 동기화는 그 프로그램이 맡습니다. PKOS는 브라우저 저장과 로컬 파일 저장을 따로 표시하며 권한이 끊기거나 파일 쓰기에 실패하면 지금 저장 · 다시 시도로 복구할 수 있습니다. 외부에서 수정한 파일과 제목 변경 전 파일은 보존하고, 로컬 폴더의 변경을 앱으로 자동 가져오지는 않습니다. 전체 서재 복원에는 기존 .pkem 백업을 사용하세요.

선택한 폴더는 같은 주소·브라우저에서 기억하고 다음 접속에 자동으로 다시 사용합니다. 자동 저장을 직접 끈 경우에는 꺼진 상태를 유지합니다. PC Edge·Chrome 등 폴더 선택을 지원하는 브라우저가 필요하며, 브라우저가 권한을 다시 요구할 때만 재허용하면 됩니다.

페이지 이미지에 그리기

페이지 위 그리기를 눌러 펜·형광펜·사각형·원·화살표·스티커를 추가합니다. 색과 굵기를 고르고 마우스나 터치로 그린 뒤 그림 저장을 누르세요. 지우개는 추가한 선·도형·스티커를 지우고, 되돌리기와 다시 실행도 지원합니다. 저장한 그림은 다시 열어 수정할 수 있습니다.

원본 슬라이드와 PNG는 보존하며, 연결한 로컬 폴더에는 그림을 합친 PNG와 갱신된 Markdown 링크를 저장합니다. 전체 .pkem 백업에는 다시 편집할 수 있는 그림 정보도 포함됩니다. PNG 내려받기로 그림을 따로 보관할 수 있습니다.

PDF·슬라이드를 페이지별로 기록하기

PDF나 PPTX를 기록장에 드래그하거나 첨부하면 페이지 전체를 개별 PNG 이미지로 만들고, 각 이미지 아래에 의견과 필기를 적을 수 있습니다. 편집 중에는 현재 글에 붙고 읽기 화면에서는 새 기록을 만듭니다. 이미 첨부한 문서는 원본 옆 페이지 이미지 만들기를 누릅니다. 연결한 로컬 폴더의 attachments에 문서이름-001.png처럼 쪽 번호를 붙인 이미지가 각각 저장되며, 이름 앞에는 중복을 구분하는 ID가 붙습니다. 의견은 같은 기록의 Markdown 파일에 해당 이미지와 함께 저장됩니다.

페이지 삭제를 누르면 기록장에서 그 페이지와 의견을 숨기고 연결한 폴더의 해당 PNG도 삭제합니다. 원본 문서와 다른 페이지는 유지합니다. 삭제한 페이지 → 복원으로 이미지와 의견을 복구할 수 있습니다. 폴더에서 직접 수정한 이미지나 다른 기록에서도 사용하는 이미지는 보존합니다. 폴더 권한·저장 실패가 있으면 상단 상태에서 확인하고 다시 시도하세요.

PDF·PPTX는 원본 한 개 20MB·200페이지까지 지원하며, 옛 .ppt는 PowerPoint에서 .pptx 또는 PDF 사본으로 저장해서 넣습니다. PPTX의 일부 글꼴·효과는 원본 프로그램과 다를 수 있습니다. 변환은 브라우저에서 처리하며 원본 파일은 보관합니다.

편집 공간 넓히기

일반·집중 모드 모두 제목을 위로 올리고 도구를 가로 한 줄로 정리했습니다. 제목 옆 태그 줄과 도구모음으로 각각 전체 영역을 접고 같은 버튼으로 다시 엽니다. 선택은 같은 주소·브라우저에서 기억하며 새로고침 뒤에도 유지됩니다. 저장 상태는 두 영역을 접어도 제목 옆에 보입니다. 좁은 화면에서는 두 버튼이 아이콘으로 보이고 도구줄은 좌우로 움직여 고릅니다.

왼쪽 메뉴와 기록 목록 머리의 « 버튼으로 각 영역을 접을 수 있습니다. 상단 메뉴 · 목록 버튼으로 다시 펼치며, 접은 상태를 기억합니다. 폴더는 노란색 채움 아이콘으로 표시합니다. 편집 중 제목과 펼쳐 둔 도구줄은 스크롤해도 위에 남고 여백을 줄였습니다. 받아쓰기의 음성 서비스 사용은 기본 선택되며 시작을 눌러야 듣습니다.

기록에 집중하기

기록 상단의 집중을 누르면 왼쪽 메뉴·목록·앱 상단을 숨깁니다. 집중 끝내기 또는 Esc로 이전 배치로 돌아옵니다. 본문은 길이에 맞춰 늘어나 한 화면으로 스크롤하고, 제목과 펼쳐 둔 편집 도구는 위에 남습니다. … → 본문 넓게 보기에서 폭을 바꾸고 같은 메뉴에서 읽기 편한 폭으로 돌아올 수 있습니다. 폭 선택은 같은 브라우저와 주소에서 기억합니다.

This is the beginning of the README. Read the rest at the original. Read the full README ↗