현재 통합 앱의 실제 화면 전송 경로와 끊김·화질 문제는 현재 구조 분석 HTML에서 확인한다. 2026-09-23 소스 및 운영 파일을 대조했으며, 확인한 결함·실측이 필요한 병목·수정 우선순위를 구분한다. 외부 의존성 없이 열리며 처리 시간·회선 계산기가 포함되어 있다.
공개 주소 전체 문서 모음은 design/ 하위 문서의 루트다. 제목·파일 경로 검색, 종류별 분류, 문서 간 링크로 모든 하위 폴더의 Markdown·HTML·검증 JSON·생성 코드·라이선스를 읽는다. Markdown은 표·코드·목차를 갖춘 HTML로 표시하며 원문 다운로드도 제공한다. 게시·갱신은 관리자 웹 배포 안내의 “문서 모음 게시”를 따른다.
입문 설명, 현재 구조 분석, 개발 계획은 대표 문서다. 나머지는 /document/files/<design 안의 상대 경로>.html에서 읽는다. 폴더에 새 문서를 추가한 뒤 install-document.py --prepare와 설치를 수행하면 목록·검색·링크가 함께 갱신된다.
Parsec 대조표가 포함된 원격 main의 설계 HTML은 /document/plan#parsec-comparison 경로로 게시할 수 있다. 현재 브랜치의 오래된 계획 HTML을 덮어쓰지 않고 지정 commit의 보관본을 준비하며, 공개 페이지에 출처와 진행 기록 시점을 구분한다.
두 공개 문서의 #remote-basics에는 처음 원격 앱을 개발하는 사람을 위한 공통 입문 섹션을 삽입한다. 역할·캡처/압축/전송/표시·입력 왕복·FPS/지연·NAT/중계·인증/허용/암호화·개발 검증 순서를 설명하며, 클릭 결과가 보이기까지의 7단계를 버튼으로 탐색할 수 있다. 일반 개념과 현재 notParsec 구현을 구분한다. 아래 공통 원본을 수정한 후 install-document.py --prepare로 두 문서를 재생성한다.
2026-09-21 v6부터 Parsec 재현 기준이 과거 자체 설계 제안보다 우선한다. 다음 착수 지시와 저장소 AGENTS.md에도 같은 기준을 넣었다. 82개 기능 각각의 원본 대조 상태가 진행 표에 표시되며, 완료에는 원본·비교 근거 또는 명시 예외 검증이 필요하다. 기존 30개 기본 선택은 작업 묶음이며 최종 제품 범위가 아니다.
체크 가능한 HTML을 브라우저에서 연다. CSS·JavaScript·기능 데이터가 파일 안에 포함되어 별도 설치나 외부 CDN이 필요 없다.
전체 진행은 개발 진행 현황에서 확인한다. M0–M5, 전체 82개 기능의 구현/검증/통합 기록, 실제 근거, 남은 작업과 완료 이력을 표시한다. 사용자 수동 상태는 별도로 보존한다. 기록 갱신 방법.
현재 사용자의 전체 착수 요청으로 82개 기능·163개 설정 구현/감사를 진행 범위로 확정했다. 전체 지시문과 통합 Windows 앱 교정·실행 결과를 먼저 확인한다.
- 새 브라우저의 기본 선택은 개인용 첫 버전 F01–F25와 F46/F47와 F80–F82의 30개다. 체크는 개발 범위이며 실제 완료 상태는 옆의 선택 상자에서 따로 기록한다.
- 각 기능의 “설계 · 완료 기준 · 선행 기능”을 펼쳐 역할과 검증 조건을 확인한다. 선행 기능은 자동으로 선택되며 선행 기능을 해제하면 의존 기능도 함께 해제된다.
- F44/F45는 원본 대응 부품 조사다. Parsec의 제품/프로토콜/UI를 다른 제품 fork로 전환하는 선택지가 아니다.
- “착수 지시문 복사”를 눌러 다음 개발 요청에 붙여 넣는다. 또는 선택 JSON을 저장해 그 파일을 기준으로 개발하라고 요청한다.
- 브라우저를 바꾸거나 파일을 이동할 때는 JSON 또는 “체크 상태를 HTML로 저장”을 사용한다. 체크는 원본 HTML 파일을 직접 수정하지 않는다.
- “설정 전수 목록”의 163개 항목에서 개별 옵션을 구현·감사 범위로 선택할 수 있다. “Privacy + 가상 화면 추가”와 전체 설정 프리셋도 제공한다. 옵션 선택은 이 PC의 Parsec 설정을 바꾸지 않는다.
v1/v2/v3/v4의 브라우저 저장 상태와 JSON은 v5에서 읽을 수 있다. 기존 기능 ID·진행 기록·메모를 보존하고 새로 필요한 선행 기능 F46/F47을 추가한다. 개별 설정 선택은 별도 필드로 저장한다.
HTML 저장본에는 선택과 진행 기록이 내장된다. 브라우저의 로컬 저장소 허용 여부는 환경에 따라 달라지므로 JSON/HTML 내보내기를 별도 보관 수단으로 제공한다. 상세 설계·분석으로 연결되는 상대 링크는 이 design 폴더와 인접 analysis 폴더가 있어야 열린다. 저장한 HTML만 이동해도 체크리스트 자체의 데이터와 기능은 포함되어 있다.
- “UI 누락 재검토”에서 39개 화면 흐름을 원문·함수와 함께 검색하고 대응 기능을 체크한다. “새 UI 기능 7개 추가”는 F64–F70과 선행 기능을 포함한다. 제외·내부용 행의 F63은 구현 대신 판정 근거를 감사한다.
파일 구성
| 파일 | 용도 |
|---|---|
current-remote-architecture.html |
통합 앱의 실제 GDI/JPEG/WSS 경로, 성능·화질 문제, 큐·제한값, 개선 순서와 코드 근거 |
remote-basics.fragment.html, remote-basics.css, remote-basics.js |
공개 구조·설계 문서에 함께 삽입하는 입문 설명과 7단계 클릭 도식 |
notparsec-plan.html |
실제 사용할 단일 HTML |
development-status.json, PROGRESS_GUIDE.ko.md |
82개 기능의 구현 근거·단계별 상태와 기록 갱신 절차 |
development-progress.js, development-progress-ui.js, development-progress.fragment.html, development-progress.css |
진행 집계·필터·보고서와 HTML 화면 |
run-guide.fragment.html |
서버/host/client 경로·release EXE·설정·실행·오류 해결 안내. build_plan.py가 HTML에 내장 |
homeserver-architecture.html |
공인 IP·UDP 포트포워딩이 가능한 홈서버 운영 설명, 경로 비교·포트 표·회선 계산기 |
homeserver.template.html, homeserver-model.js |
홈서버 설명 화면과 트래픽 계산 원본 |
build_homeserver.py, homeserver.test.cjs |
홈서버 HTML 생성과 경로·계산·입력 검증 |
CONTROL_SERVER.ko.md, server_plan_extension.py |
F71–F79 서버 API·DB·권한·운영 계약과 기능 정의 |
ARCHITECTURE.ko.md |
Rust 모듈, 스레드·GPU 수명, 전송·인증·성능 계약 |
START_DEVELOPMENT.md |
기본 30개를 선택한 개발 지시문 |
plan-data.json |
82개 기능·의존 관계·완료 기준·설정·공식 출처 |
SETTINGS_AND_RECOVERY.ko.md, settings-catalog.json |
설정 전수 대조와 디컴파일 복구 범위 |
extract_settings_evidence.py |
원본 hash를 검증하고 139개 PE 설정 레코드를 정적으로 추출 |
UI_TEXT_AUDIT.ko.md, ui-text-catalog.json |
UI 39개 흐름과 누락/대체/제외/미복원 판정 |
extract_ui_evidence.py, ui_audit_catalog.py |
UI 문자열 복구·함수 참조 추출과 설계 확장 |
make_plan_data.py |
기능 카탈로그 편집 원본 |
plan.template.html, plan-core.js, plan-ui.js |
화면·상태 계산·상호작용 원본 |
build_plan.py, plan.test.cjs |
HTML 생성과 동작 검증 |
VERIFICATION.md |
이번 설계 도구의 검증 결과와 한계 |
워크스페이스 루트에서 수정 후 재생성한다.
python design/make_plan_data.py
python design/build_plan.py
node design/plan.test.cjs --write-brief
node design/write_briefs.cjs
기존 계획 화면의 QUIC 인증·host/client 설명은 통합 이전 이력을 포함한다. 현재 통합 앱은 GDI/JPEG 화면·입력 전송과 WSS 서버 중계를 사용하며 오디오는 지원하지 않는다. 현재 구조와 통합 앱 사용법을 기준으로 확인한다. Windows 실기 성능 검증은 기능 테스트와 구별한다.
홈서버 운영 설명
홈서버 설명 HTML은 사용자가 확인한 공인 IP와 UDP 포트포워딩 가능 조건을 반영한다. 직접 연결·홈서버 relay·WireGuard 허브·외부 VPS relay를 전환하고, 호스트 위치와 회선 조건에 따른 데이터 경로·집 WAN 사용량을 비교할 수 있다. 도메인 입력은 문서 예시만 바꾸며 DNS나 공유기 설정에 접속하지 않는다. 검토 체크 6개는 기존 개발 범위와 별도 브라우저 저장소에 기록한다.
python design/build_homeserver.py
node --test design/homeserver.test.cjs
서버 OS는 Ubuntu로 확정했다. 서버는 Ubuntu 24.04.4 LTS·Intel N100·x86_64다. 도메인·회선 속도는 배포 전에 대입한다. Parsec 공식 연결 구조와 표준 문서를 참고한 자체 설계이며, Parsec 서버의 복원본이나 배포 완료 결과가 아니다.
2026-09-20 검증: 홈서버 모델 5개와 기존 계획 14개, 총 19개 자동 검사 통과. 로컬 브라우저에서 4개 경로·호스트 위치에 따른 WAN 계산, 업로드 초과 표시, 도메인 예시 변경·잘못된 URL 거부, 검토 체크의 새로 고침 후 유지, 기본 데스크톱 화면 배치를 확인했다. 브라우저 오류·경고 0개. 실제 네트워크 성능이나 서버 배포는 검증한 것이 아니다.
v4 연결 관리 서버 추가
현재 82개 기능, 기본 30개 LAN 범위다. “연결 관리 서버 9개 추가”는 기존 선택·설정·진행·메모를 유지하면서 F71–F79와 선행 기능을 추가한다. 서버 섹션과 전체 기능 목록은 같은 상태를 사용하고 JSON/저장 HTML/착수 지시문으로 내보낼 수 있다. F64/F65와 F32를 선택하면 해당 서버 선행 기능도 포함된다. 과거 완료 상태는 유지하지만 새 선행 작업이 미완료이면 경고한다. 자동 NAT F32와 relay F33은 전체 서버 선택 시에도 자동 추가하지 않는다.