<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="color-scheme" content="light">
<title>notParsec — GPU 영상 경로와 이전 구조 분석</title>
<style>
:root{--bg:#f4f5f7;--paper:#fff;--ink:#17202e;--muted:#576477;--line:#dce2e9;--teal:#086b61;--teal-bg:#e7f5f1;--blue:#2459ac;--blue-bg:#eaf1fe;--amber:#86510b;--amber-bg:#fff3de;--red:#a03835;--red-bg:#fcedeb;--mono:Consolas,'Liberation Mono',monospace}
*{box-sizing:border-box}html{scroll-behavior:smooth;scroll-padding-top:28px}body{margin:0;background:var(--bg);color:var(--ink);font:16px/1.8 'Segoe UI','Malgun Gothic','Apple SD Gothic Neo',sans-serif}a{color:var(--teal);text-underline-offset:4px}a:hover{text-decoration-thickness:2px}button,input,select{font:inherit}button{cursor:pointer;border:1px solid var(--line);padding:8px 13px;background:white;border-radius:7px;color:var(--ink)}button:hover{border-color:var(--teal)}:focus-visible{outline:3px solid var(--blue);outline-offset:3px}h1,h2,h3,p{margin:0 0 14px}h1{font-size:clamp(32px,4vw,52px);line-height:1.23;letter-spacing:-1.6px}h2{font-size:28px;letter-spacing:-.8px;line-height:1.4}h3{font-size:18px;line-height:1.5}strong{font-weight:700}code{font: .88em/1.7 var(--mono);overflow-wrap:anywhere}pre{font:13px/1.8 var(--mono);white-space:pre-wrap;overflow-wrap:anywhere;background:#182537;color:#e7edf5;padding:22px;border-radius:10px;margin:18px 0}small,.small{font-size:13px;color:var(--muted)}.shell{max-width:1460px;margin:auto;display:grid;grid-template-columns:225px minmax(0,1fr)}aside{position:sticky;top:0;height:100vh;padding:34px 23px;border-right:1px solid var(--line);overflow:auto}.brand{font-size:24px;font-weight:750;letter-spacing:-1px}.brand span{color:var(--teal)}.edition{font:11px/1.8 var(--mono);color:var(--muted);letter-spacing:.6px;margin:10px 0 30px}nav{display:grid;gap:4px}nav a{display:block;padding:9px 0;text-decoration:none;color:var(--muted);font-size:14px}nav a:hover{color:var(--teal)}.aside-note{font-size:12px;color:var(--muted);margin-top:30px}main{padding:44px clamp(22px,4.5vw,66px) 70px;min-width:0}.eyebrow{font:12px var(--mono);letter-spacing:1px;color:var(--teal);margin-bottom:18px}.lead{font-size:19px;line-height:1.75;max-width:830px}.muted{color:var(--muted)}.meta{display:flex;flex-wrap:wrap;gap:10px 20px;font-size:12px;color:var(--muted);margin:23px 0}.actions{display:flex;gap:12px;flex-wrap:wrap;align-items:center;font-size:13px}.section{margin-top:44px;padding-top:38px;border-top:1px solid var(--line)}.section-no{display:block;font:12px var(--mono);color:var(--teal);margin-bottom:10px}.callout{padding:19px 22px;border-left:4px solid var(--teal);background:var(--teal-bg);border-radius:0 8px 8px 0;margin:22px 0}.callout.warn{background:var(--amber-bg);border-color:var(--amber)}.callout.red{background:var(--red-bg);border-color:var(--red)}.callout p:last-child{margin-bottom:0}.grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:18px}.metrics{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:12px;margin:24px 0}.metric{background:var(--paper);padding:18px;border:1px solid var(--line);border-radius:10px}.metric strong{display:block;font:700 27px/1.5 var(--mono);letter-spacing:-1px}.metric span{font-size:12px;color:var(--muted)}.badge{display:inline-block;font-size:11px;font-weight:700;padding:2px 8px;border-radius:4px;vertical-align:middle;background:var(--teal-bg);color:var(--teal);white-space:nowrap}.badge.suspect{background:var(--amber-bg);color:var(--amber)}.badge.unknown{background:#e9edf3;color:#4b5a70}.legend{display:flex;gap:14px;flex-wrap:wrap;font-size:12px;color:var(--muted);margin:14px 0 24px}.card{background:var(--paper);border:1px solid var(--line);border-radius:10px;padding:22px;min-width:0}.card p:last-child{margin-bottom:0}.source-ref{font-size:12px;color:var(--muted);margin-top:12px}.source-ref a{font-family:var(--mono)}.flow{background:#fff;border:1px solid var(--line);border-radius:12px;padding:25px;margin:22px 0}.flow-grid{display:grid;grid-template-columns:minmax(0,1fr) 30px minmax(0,1.12fr) 30px minmax(0,1fr);align-items:stretch;gap:8px}.node{border-top:3px solid var(--teal);background:var(--teal-bg);padding:18px 15px;min-width:0}.node.server{background:var(--blue-bg);border-color:var(--blue)}.node small{font:11px var(--mono)}.node h3{margin:8px 0 12px}.node p{font-size:13px;line-height:1.8;margin:0}.arrow{display:flex;justify-content:center;align-items:center;font-size:23px;color:var(--teal)}.route{margin-top:18px;padding-top:17px;border-top:1px solid var(--line);font-size:13px}.route span{display:block}.route b{color:var(--teal)}.steps{list-style:none;padding:0;margin:20px 0;counter-reset:step}.steps li{counter-increment:step;display:grid;grid-template-columns:32px minmax(0,1fr);gap:14px;padding:16px 0;border-bottom:1px solid var(--line)}.steps li:before{content:counter(step,decimal-leading-zero);font:14px var(--mono);color:var(--teal);padding-top:6px}.steps p{font-size:14px;margin:5px 0 0}.table-scroll{overflow-x:auto;border:1px solid var(--line);border-radius:9px;margin:20px 0}table{width:100%;border-collapse:collapse;background:#fff;font-size:13px}th,td{padding:14px 16px;text-align:left;vertical-align:top;border-bottom:1px solid var(--line)}th{font-size:12px;color:var(--muted);background:#edf1f6}tr:last-child td{border-bottom:0}td:first-child{font-weight:600}td p{margin:0}td small{display:block;margin-top:7px}ul{padding-left:22px}li{margin:7px 0}.issue{display:grid;grid-template-columns:40px minmax(0,1fr);gap:12px;margin:22px 0;padding-bottom:22px;border-bottom:1px solid var(--line)}.issue-num{font:20px var(--mono);color:var(--red);padding-top:4px}.issue h3{margin-bottom:8px}.issue p{font-size:15px}.calc{background:#fff;border:1px solid var(--line);border-radius:12px;padding:24px;margin:25px 0}.controls{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:24px}.controls label{display:block;font-size:13px;font-weight:600}.controls output{display:block;color:var(--teal);font:700 22px/1.8 var(--mono);margin:5px 0}input[type=range]{width:100%;accent-color:var(--teal)}.calc-result{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:16px;margin-top:22px}.calc-result>div{border-top:2px solid var(--line);padding-top:12px}.calc-result strong{font:700 24px/1.5 var(--mono);display:block}.calc-result small{display:block}.cycle{display:flex;height:35px;border-radius:5px;overflow:hidden;margin:22px 0 6px;color:#fff;font:12px/35px var(--mono)}.cycle .wait{background:#526783;text-align:center;min-width:1px}.cycle .work{background:var(--teal);text-align:center;min-width:1px}.diagram-caption{font-size:12px;color:var(--muted)}.scale-chain{display:flex;gap:8px;align-items:center;margin:20px 0;flex-wrap:wrap}.scale-stage{flex:1;min-width:135px;background:var(--paper);padding:15px;border:1px solid var(--line);border-radius:8px}.scale-stage strong{display:block;font-size:17px}.scale-stage small{display:block}.code-summary{padding:8px 0;font-size:13px;color:var(--teal);cursor:pointer}details{margin:16px 0}details[open] summary{margin-bottom:12px}.code-excerpt{margin:0}.resolution{font:13px var(--mono);color:var(--muted)}.priority{color:var(--teal);font:12px var(--mono);letter-spacing:.6px;margin-bottom:8px}.file-list{margin:20px 0;display:grid;gap:12px}.file-list>div{border-bottom:1px solid var(--line);padding-bottom:12px;font-size:13px}.file-list strong{display:block;margin-bottom:3px}.hash{font:11px/1.8 var(--mono);overflow-wrap:anywhere;display:block}.footer{font-size:12px;color:var(--muted);margin-top:40px;padding-top:20px;border-top:1px solid var(--line)}.no-js{margin:20px;padding:18px;background:var(--amber-bg)}
@media(max-width:1050px){.shell{grid-template-columns:185px minmax(0,1fr)}aside{padding:28px 17px}main{padding:32px 24px 60px}.metrics{grid-template-columns:repeat(2,minmax(0,1fr))}.flow{padding:15px}.flow-grid{grid-template-columns:1fr}.arrow{height:28px;transform:rotate(90deg)}.controls{gap:15px}.node{padding:17px}}
@media(max-width:700px){.shell{display:block}aside{position:static;height:auto;border-right:0;border-bottom:1px solid var(--line);padding:20px}.brand{font-size:22px}.edition{margin:4px 0 12px}nav{display:flex;gap:6px 16px;flex-wrap:wrap}nav a{padding:2px 0;font-size:12px}.aside-note{display:none}main{padding:28px 18px 50px}h1{font-size:34px}h2{font-size:24px}.lead{font-size:17px}.grid,.controls,.calc-result{grid-template-columns:1fr}.metrics{gap:8px}.metric{padding:14px}.metric strong{font-size:23px}.section{margin-top:32px;padding-top:30px}.calc{padding:19px}.issue{grid-template-columns:26px minmax(0,1fr);gap:8px}.issue-num{font-size:16px}th,td{padding:12px}.table-scroll table{min-width:620px}.actions{font-size:12px}}
@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}}
@media print{body{background:white;font-size:11pt}.shell{display:block}aside,.actions,.controls{display:none}main{padding:0}.section{break-before:auto;margin-top:24px;padding-top:20px}.card,.issue,.node,.calc,.metrics,.file-list>div{break-inside:avoid}.flow-grid{grid-template-columns:1fr 24px 1fr 24px 1fr}.arrow{transform:none;height:auto}.table-scroll{overflow:visible}table{font-size:9pt;min-width:0!important}a{color:inherit}.badge,.node,.callout,.cycle{-webkit-print-color-adjust:exact;print-color-adjust:exact}h1{font-size:29pt}h2{font-size:20pt}pre{font-size:9pt}details{display:block}.footer{font-size:9pt}}
</style>
</head>
<body>
<div class="shell">
<aside>
<div class="brand">not<span>Parsec</span></div>
<div class="edition">IMPLEMENTATION REVIEW<br>2026.09.23 · SOURCE SNAPSHOT</div>
<nav aria-label="문서 목차">
<a href="#gpu-update">새 GPU 구현·업데이트</a>
<a href="#summary">01 · 지금 구현된 것</a>
<a href="#path">02 · 연결과 화면 경로</a>
<a href="#performance">03 · 프레임이 낮은 이유</a>
<a href="#picture">04 · 화면이 이상한 이유</a>
<a href="#limits">05 · 큐와 제한값</a>
<a href="#next">06 · 수정 우선순위</a>
<a href="#evidence">07 · 코드·배포·검증 근거</a>
</nav>
<p class="aside-note">상단은 새 GPU 구현 안내입니다. 아래 JPEG 분석은 2026-09-23 배포 당시의 기록이며 계산기 수치는 실측 성능이 아닙니다.</p>
</aside>
<main>
__GPU_UPDATE_NOTICE__
<header>
<div class="eyebrow">REMOTE DESKTOP / CURRENT ARCHITECTURE</div>
<h2>이전 JPEG 버전은<br>어떻게 화면을 전달했나</h2>
<p class="lead">앱은 하나로 합쳐졌고 실제 화면·입력도 전달합니다. 다만 현재 미디어 경로는 <strong>GDI 캡처 → CPU JPEG → 서버 중계 → CPU 디코딩</strong>입니다. 저지연 영상 엔진으로 완성된 상태는 아닙니다.</p>
<div class="meta"><span>코드·운영 확인: 2026-09-23 18:47–18:50 UTC</span><span>대상: 통합 notparsec.exe</span><span>사용자 보고: 심한 끊김·화면 이상</span></div>
<div class="actions"><button id="print" type="button">인쇄 / PDF 저장</button><a href="UNIFIED_REMOTE.ko.md">통합 앱 사용법</a><a href="#evidence">분석한 코드와 파일 확인 ↓</a></div>
</header>
<section class="section" id="summary">
<span class="section-no">01 / CURRENT STATE</span><h2>증상과 연결되는 핵심 사실</h2>
<div class="callout red"><p><strong>끊김의 구조적 원인이 코드에 있습니다.</strong> 최대 10fps로 제한하며, 매 캡처·압축이 끝난 시점부터 다시 100ms를 기다립니다. 따라서 처리 시간이 50ms라면 네트워크가 완벽해도 약 6.7fps입니다. 이것은 설명용 계산이며 사용 중인 PC의 측정값은 아닙니다.</p></div>
<div class="metrics">
<div class="metric"><strong>≤ 10fps</strong><span>실제는 처리·대기 시간만큼 감소</span></div>
<div class="metric"><strong>1280×720</strong><span>전송 크기 상한 · 원본 비율 유지</span></div>
<div class="metric"><strong>JPEG 65</strong><span>매 프레임 전체 화면을 CPU 압축</span></div>
<div class="metric"><strong>WSS / TCP</strong><span>모든 화면·입력이 서버를 경유</span></div>
</div>
<div class="legend"><span><span class="badge">코드 확인</span> 구현에서 직접 확인</span><span><span class="badge suspect">영향 추정</span> 구조상 가능, 비용 미측정</span><span><span class="badge unknown">실측 필요</span> 현재 원인 확정 불가</span></div>
<div class="grid">
<article class="card"><h3>이미 연결된 기능</h3><p>하나의 Windows EXE에 접속받기와 접속하기, 관리자 승인, 기기 키 인증, 접속 비밀번호 확인, 인증서 자동 검증, 원격 화면과 입력 전달이 들어 있습니다.</p></article>
<article class="card"><h3>미디어 경로에서 빠진 기능</h3><p>하드웨어 영상 인코딩·디코딩, 직접 연결/NAT 탐색, 네트워크에 맞춘 화질 조정, 프레임 기한에 따른 폐기, 실시간 FPS·지연 통계가 연결되어 있지 않습니다. GPU 진단 코드의 존재와 실제 사용은 다릅니다.</p></article>
</div>
<p class="small" style="margin-top:18px">이전의 테스트 33개 통과는 인증·중계·프레임/입력 전달의 기능 검증입니다. Windows 두 PC에서의 FPS·시각 품질·입력 지연을 검증한 결과가 아닙니다.</p>
</section>
<section class="section" id="path">
<span class="section-no">02 / DATA PATH</span><h2>같은 앱, 세 개의 실행 위치</h2>
<p>두 Windows PC는 동일한 앱을 실행합니다. Ubuntu 서버는 등록·승인·접속 주선과 암호화된 바이트 중계를 함께 담당합니다. 화면 인코딩이나 디코딩은 서버에서 하지 않습니다.</p>
<div class="flow" role="group" aria-label="호스트 PC에서 Ubuntu 중계 서버를 거쳐 접속 PC로 가는 데이터 경로">
<div class="flow-grid">
<div class="node"><small>WINDOWS / HOST</small><h3>접속받을 PC</h3><p>notparsec.exe<br>① 주 모니터 GDI 캡처<br>② 720p 이내 축소·커서 합성<br>③ BGRA → RGB → JPEG<br>④ PC 간 TLS로 암호화</p></div>
<div class="arrow" aria-hidden="true">→</div>
<div class="node server"><small>UBUNTU / RELAY</small><h3>remote.n3m.kr</h3><p>HTTPS/WSS 프록시 → Nginx<br>→ 127.0.0.1:18080<br>→ Rust / Axum 서버<br>상대 소켓으로 바이트 전달<br>SQLite: 기기·관리자 인증 정보</p></div>
<div class="arrow" aria-hidden="true">→</div>
<div class="node"><small>WINDOWS / VIEWER</small><h3>접속할 PC</h3><p>notparsec.exe<br>① PC 간 TLS 복호화<br>② JPEG 전체 프레임 수신<br>③ UI 스레드에서 CPU 디코딩<br>④ egui 텍스처 갱신·표시</p></div>
</div>
<div class="route"><span><b>화면 →</b> 호스트 → 서버 → 뷰어</span><span><b>입력 ←</b> 뷰어 → 서버 → 호스트 → 같은 캡처 작업 스레드의 SendInput</span><span class="small">공개 도메인의 응답에서 Cloudflare 경유가 관측됐습니다. 개별 PC의 실제 접속 경로와 사용 도메인은 별도 확인이 필요합니다. 신규 기본 주소는 remote.n3m.kr이며 기존 저장 주소는 유지합니다.</span></div>
</div>
<div class="grid">
<div><h3>제어 경로</h3><p>HTTPS API로 등록·승인, 목록·온라인 상태, 호스팅 게시, 세션 생성과 종료를 처리합니다. 호스트는 2초마다 요청을 조회하고 약 8초마다 접속 허용을 갱신합니다. 이 2초 주기는 연결 시작 대기와 관련되며, 매 프레임 전송 주기는 아닙니다.</p></div>
<div><h3>미디어·입력 경로</h3><p>세션의 양쪽 PC가 <code>/v1/remote/sessions/{id}/relay</code>에 WSS로 연결합니다. 그 안에서 별도 PC 간 TLS 연결을 만듭니다. 영상은 <code>길이(u32) + JPEG</code>, 입력은 길이로 구분된 JSON 메시지입니다. 내부 TLS의 양방향 스트림을 공유합니다.</p></div>
</div>
<ol class="steps">
<li><div><strong>한 번 승인하고 기기 키로 재인증</strong><p>관리자가 기기를 승인합니다. 이후 앱은 저장된 Ed25519 키로 서버에 인증합니다. 관리자 웹의 로그인 비밀번호와 PC 접속 비밀번호는 별개입니다.</p></div></li>
<li><div><strong>호스트가 접속 허용과 서명된 인증서를 게시</strong><p>기기 키가 PC 간 TLS 인증서에 서명합니다. 접속 앱은 대상 기기의 키와 인증서를 검증하므로 인증서 파일을 직접 옮기지 않습니다.</p></div></li>
<li><div><strong>중계 안에서 PC 간 인증과 비밀번호 확인</strong><p>클라이언트가 세션·nonce·인증서에 묶인 서명을 전송하고, 호스트가 접속 비밀번호를 확인합니다. 성공 후에만 화면 캡처·입력 처리를 시작합니다. 비밀번호 검증은 매 프레임마다 실행되지 않습니다.</p></div></li>
<li><div><strong>호스트가 JPEG를 보내고 뷰어가 표시</strong><p>서버는 내부 TLS 내용을 해석하지 않고 전달합니다. 전송 경로를 바꾸더라도 이 인증과 PC 간 암호화 경계는 유지해야 합니다.</p></div></li>
</ol>
<p class="source-ref">근거: <a href="#src-session">session/remote.rs</a> · <a href="#src-relay">server/api/remote.rs</a> · <a href="#src-bridge">device-client/remote.rs</a></p>
</section>
<section class="section" id="performance">
<span class="section-no">03 / FRAME RATE & LATENCY</span><h2>프레임 드랍처럼 느껴지는 다섯 지점</h2>
<div class="issue"><div class="issue-num">01</div><div><h3>10fps 제한에 작업 시간이 추가됨 <span class="badge">코드 확인</span></h3><p><code>last_frame</code>은 캡처를 시작할 때가 아니라 <code>desktop.frame()</code>이 끝난 뒤 갱신됩니다. 다음 캡처는 여기서 다시 100ms 뒤입니다. 큐가 비어 있어도 <strong>주기 ≈ 100ms + 캡처·변환·JPEG 시간 + 스케줄링 지연</strong>입니다.</p><p>예를 들어 작업 20ms → 약 8.3fps, 50ms → 6.7fps, 100ms → 5fps입니다. 원래 60fps를 만들었다가 대부분 잃는 구조로 해석하면 원인을 잘못 짚게 됩니다.</p><details><summary class="code-summary">현재 스케줄링 코드 보기</summary><pre class="code-excerpt">if last_frame.elapsed() >= Duration::from_millis(100)
&& frames.capacity() > 0
{
let frame = desktop.frame()?;
// 길이 검사와 큐 전달
last_frame = Instant::now(); // 작업 완료 후 대기 시계 재시작
}
std::thread::sleep(Duration::from_millis(5));</pre><p class="source-ref">일부 중간 코드를 생략한 발췌 · session/remote.rs:294–304</p></details></div></div>
<div class="issue"><div class="issue-num">02</div><div><h3>전체 화면을 매번 CPU에서 처리 <span class="badge">코드 확인</span> <span class="badge suspect">시간 미측정</span></h3><p>GDI로 축소 복사한 뒤 모든 픽셀을 BGRA에서 RGB로 바꾸고 새 JPEG를 만듭니다. 변경된 영역만 보내는 처리가 없고, 프레임 간 압축도 없습니다. RGB/JPEG 버퍼를 매 프레임 새로 만듭니다. 원격 입력 주입도 이 작업 스레드에서 처리하므로 압축 중 들어온 입력은 작업이 끝날 때까지 기다릴 수 있습니다.</p><p class="source-ref">근거: <a href="#src-capture">platform-win/remote.rs:92–141</a> · <a href="#src-session">session/remote.rs:291–304</a></p></div></div>
<div class="issue"><div class="issue-num">03</div><div><h3>서버 중계와 순서 보장 전송의 대기 <span class="badge">코드 확인</span> <span class="badge suspect">기여도 미측정</span></h3><p>항상 서버를 경유하는 WSS/TCP 경로입니다. 화면은 순서대로 완성되어야 읽을 수 있어, 앞선 바이트의 재전송이나 밀림이 뒤 프레임의 도착을 늦출 수 있습니다. 이미 TLS/TCP에 넣은 오래된 프레임을 취소하는 기능은 없습니다.</p><p>PC의 WebSocket 브리지와 서버 중계 루프 모두 선택한 분기에서 송신 완료를 기다립니다. 특정 방향의 송신이 막히면 같은 루프의 반대 방향 처리가 늦어질 수 있습니다. TCP 자체는 전이중이므로 입력이 영상 뒤에 반드시 줄을 선다고 단정하지는 않습니다.</p><p class="source-ref">근거: <a href="#src-bridge">device-client/remote.rs:137–160</a> · <a href="#src-relay">server/api/remote.rs:310–336</a></p></div></div>
<div class="issue"><div class="issue-num">04</div><div><h3>UI 스레드에서 디코딩과 텍스처 교체 <span class="badge">코드 확인</span> <span class="badge suspect">시간 미측정</span></h3><p>수신된 JPEG를 <code>remote_view()</code> 안에서 디코딩하고 RGBA로 변환해 egui 텍스처를 갱신합니다. 작업이 길면 화면 그리기와 로컬 입력 처리가 함께 늦어질 수 있습니다. 별도 디코드 작업 스레드나 하드웨어 비디오 디코더는 이 경로에 없습니다.</p><p>접속 중에는 30ms 뒤 다시 그리기를 요청하지만, 이는 33fps 수신·표시 보장이 아닙니다. 입력 등 다른 이벤트가 더 빨리 갱신을 유발할 수도 있습니다.</p><p class="source-ref">근거: <a href="#src-viewer">remote_ui.rs:205–230, 332–349</a> · app.rs:1042–1046</p></div></div>
<div class="issue"><div class="issue-num">05</div><div><h3>실제 FPS·드랍 원인을 구분할 계측이 없음 <span class="badge">코드 확인</span></h3><p>영상 프레임에는 번호와 캡처 타임스탬프가 없습니다. 캡처·인코딩·송신·수신·디코딩·표시 각각의 시간과 프레임 수, 큐 대기, 교체·건너뜀 횟수가 표시되지 않습니다. 현재는 생성 자체가 느린 것인지, 전송이 밀리는지, 화면 표시를 건너뛰는지 수치로 구분할 수 없습니다.</p><p class="source-ref">근거: <a href="#src-wire">wire/remote.rs:81–97</a> · 수신측 watch 채널은 최신 JPEG만 보관</p></div></div>
<div class="calc" id="calculator">
<h3>작업 시간과 회선의 영향 계산</h3><p class="small">가상 입력으로 현재 스케줄링의 한계를 계산합니다. 두 PC를 측정하거나 서버 설정을 변경하지 않습니다. TLS·WebSocket·TCP 오버헤드, 재전송, 실제 버스트와 클라이언트 디코딩은 제외합니다.</p>
<div class="controls">
<div><label for="work-ms">캡처 + JPEG 작업 시간</label><output id="work-out" for="work-ms">50 ms</output><input id="work-ms" type="range" min="0" max="250" value="50" step="5"></div>
<div><label for="jpeg-kib">평균 JPEG 한 장 크기</label><output id="jpeg-out" for="jpeg-kib">150 KiB</output><input id="jpeg-kib" type="range" min="25" max="1024" value="150" step="1"></div>
<div><label for="link-mbps">경로에서 가장 느린 가용 구간</label><output id="link-out" for="link-mbps">10 Mbps</output><input id="link-mbps" type="range" min="1" max="100" value="10" step="1"></div>
</div>
<div class="cycle" aria-hidden="true"><span class="wait" id="wait-bar" style="width:66.67%">100ms 대기</span><span class="work" id="work-bar" style="width:33.33%">50ms 작업</span></div>
<p class="diagram-caption" id="cycle-caption">캡처 시작 간격의 단순 모델: 100 + 50 = 150ms. 5ms 루프·운영체제 스케줄링·큐 대기는 제외.</p>
<div class="calc-result" aria-live="polite" aria-atomic="true">
<div><small>캡처·압축 기준 상한</small><strong id="fps-out">6.7 fps</strong><small>1000 ÷ (100 + 작업 ms)</small></div>
<div><small>이 속도를 보내는 데 필요한 데이터율</small><strong id="rate-out">8.19 Mbps</strong><small>JPEG 크기 × fps × 8</small></div>
<div><small>회선·생성 중 느린 쪽의 상한</small><strong id="bottleneck-out">6.7 fps</strong><small>min(생성 fps, 구간 데이터율 ÷ 프레임 크기)</small></div>
</div>
<p class="callout" id="calc-note">예시에서는 생성 속도가 먼저 제한합니다. 실제 지연은 디코딩과 전송 대기를 더 측정해야 합니다.</p>
<p class="small" id="guard-note">서버는 약 33.55Mbps에 해당하는 4MiB/초 가드를 둡니다. 평균값이 낮아도 1초 카운트 구간의 버스트로 종료될 수 있습니다.</p>
</div>
</section>
<section class="section" id="picture">
<span class="section-no">04 / IMAGE & CURSOR</span><h2>화면 이상은 증상별로 구분해야 합니다</h2>
<p>현재 보고에는 흐림·색 이상·커서 어긋남·검은 화면 중 어떤 현상인지 세부 정보가 없습니다. 아래는 소스에서 확인한 처리와 점검 후보입니다. 사용자의 화면을 직접 재현한 판정은 아닙니다.</p>
<div class="scale-chain" aria-label="4K 화면이 720p로 축소되고 다시 표시 영역에 확대되는 예시">
<div class="scale-stage"><strong>3840×2160</strong><small>가정한 원본 모니터</small></div><span aria-hidden="true">→</span>
<div class="scale-stage"><strong>1280×720</strong><small>가로·세로 1/3 · JPEG 65</small></div><span aria-hidden="true">→</span>
<div class="scale-stage"><strong>뷰어 영역에 맞춤</strong><small>LINEAR 필터로 다시 확대 가능</small></div>
</div>
<div class="table-scroll"><table><caption class="small" style="text-align:left;padding:12px 16px">화면 증상과 현재 구현의 관계</caption><thead><tr><th scope="col">증상</th><th scope="col">확인한 구조</th><th scope="col">판정과 확인 방법</th></tr></thead><tbody>
<tr><td>글자·아이콘이 흐림</td><td>원본을 최대 720p로 축소 → 손실 JPEG → 표시 크기에 맞춘 선형 확대</td><td><span class="badge">처리 확인</span><br>세부 손실을 설명하는 직접 요인. 원본·전송 크기와 실제 뷰어 크기를 대조하고 1:1 표시로 비교.</td></tr>
<tr><td>커서가 크거나 클릭 지점과 어긋남</td><td>커서 좌표만 축소. <code>DrawIconEx</code>의 크기는 0, hotspot 보정 없음</td><td><span class="badge">구현 결함</span><br>화면과 커서의 축소 비율이 달라질 수 있음. 화살표·텍스트 커서·크기 조정 커서를 비교.</td></tr>
<tr><td>마우스가 두 개처럼 보이거나 뒤따라옴</td><td>원격 커서를 JPEG 안에 합성. 뷰어 로컬 커서를 숨기는 처리 없음</td><td><span class="badge suspect">재현 필요</span><br>로컬 커서는 즉시 움직이고 원격 커서는 영상 주기로 늦게 갱신될 수 있음.</td></tr>
<tr><td>색이 다르거나 HDR 화면이 이상함</td><td>8-bit RGB JPEG 경로. HDR 메타데이터·명시적 톤 매핑/색 관리 없음</td><td><span class="badge unknown">원인 미확정</span><br>HDR 여부·색 프로필을 기록하고 SDR 테스트 패턴과 원본/수신 이미지를 비교.</td></tr>
<tr><td>검은 영역·잔상·잘림·좌표 오차</td><td>주 모니터 GDI 경로만 사용. DPI·다중 모니터·특정 앱 조합 실기 검증 부족</td><td><span class="badge unknown">원인 미확정</span><br>문제가 나는 앱, 모니터 배치, DPI 100/150/200%, 전체 화면 여부를 고정해 재현. 단순 JPEG 압축 탓으로 단정할 수 없음.</td></tr>
<tr><td>해상도 변경 뒤 끊김</td><td>연결 중 주 화면 크기가 달라지면 오류로 세션 종료</td><td><span class="badge">의도된 동작</span><br>자동 재협상 없음. 현재는 재연결 필요.</td></tr>
</tbody></table></div>
<div class="callout warn"><p><strong>커서 합성에서 확인한 구체적 문제:</strong> 현재 <code>DrawIconEx(x × scale, y × scale, cursor, 0, 0, …)</code> 형태입니다. Windows API에서 이 좌표는 그림의 왼쪽 위이고 크기 0은 현재 플래그에서 커서 리소스 크기를 사용합니다. 커서의 클릭 기준점(hotspot)과 크기에도 축소 비율을 반영하거나, 커서를 별도 정보로 보내 뷰어에서 합성해야 합니다. 실제 사용자 증상과의 일치는 추가 확인이 필요합니다.</p><p class="small">API 근거: <a href="https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-drawiconex">Microsoft DrawIconEx</a> · <a href="https://learn.microsoft.com/en-us/windows/win32/api/winuser/ns-winuser-iconinfo">ICONINFO의 hotspot</a>. 코드: <a href="#src-capture">platform-win/remote.rs:110–122</a>.</p></div>
</section>
<section class="section" id="limits">
<span class="section-no">05 / QUEUES & GUARDS</span><h2>작은 큐가 곧 낮은 지연을 뜻하지는 않습니다</h2>
<p>앱의 큐 크기는 제한되어 있지만 여러 단계에 대기 데이터가 생깁니다. 특히 수신측에서 최신 JPEG만 남기는 처리는 <strong>그 JPEG를 네트워크로 전부 받은 뒤</strong>에 작동합니다.</p>
<div class="table-scroll"><table><thead><tr><th scope="col">위치</th><th scope="col">현재 값 / 정책</th><th scope="col">실제 영향</th></tr></thead><tbody>
<tr><td>호스트 프레임 생성</td><td>100ms 대기 + 처리 시간<br>대기 큐 1프레임</td><td>큐가 차면 새 캡처를 하지 않음. 대기 중인 오래된 프레임을 최신 프레임으로 덮어쓰는 구조는 아님.</td></tr>
<tr><td>영상 형식</td><td>최대 1280×720<br>JPEG quality 65 · 최대 1MiB</td><td>최대치를 넘은 프레임은 화질을 낮춰 재시도하지 않고 오류로 연결 종료.</td></tr>
<tr><td>PC의 WSS 브리지</td><td>Duplex 버퍼 128KiB<br>읽기 조각 최대 32KiB</td><td>여기에 TLS/WebSocket/OS 버퍼가 더 있음. 총 대기 크기를 128KiB 하나로 계산하면 부정확.</td></tr>
<tr><td>서버 중계</td><td>방향당 대기 메시지 4개<br>WS 메시지 최대 64KiB</td><td>일반 PC 송신은 최대 32KiB 조각이지만 서버 허용 크기는 64KiB. 서버에는 JPEG 프레임 경계를 이해하는 폐기 정책이 없음.</td></tr>
<tr><td>중계 데이터율 가드</td><td>방향당 4MiB / 약 1초 카운트 구간<br>≈ 33.55Mbps</td><td><strong>초과 시 연결 종료</strong>. 속도를 부드럽게 낮추는 제어가 아님. 평균과 순간 버스트를 구분해야 함.</td></tr>
<tr><td>수신 → UI</td><td><code>watch</code>로 최신 JPEG 하나 유지</td><td>UI가 읽기 전 여러 장이 도착하면 중간 장은 표시되지 않음. 이미 소모한 전송량이나 앞선 TCP 대기는 회수하지 못함.</td></tr>
<tr><td>입력</td><td>뷰어 큐 128개, 호스트 큐 128개<br>호스트 초당 500개 가드</td><td>큐 초과는 조용한 키 유실 대신 연결 종료로 처리. 캡처 스레드가 JPEG를 만드는 동안 입력 실행이 지연될 수 있음.</td></tr>
<tr><td>시간·수명</td><td>주요 쓰기 대기 5초<br>프레임 읽기 12초 · 입력/heartbeat 8초</td><td>정상 지연 목표가 아니라 연결 종료 한계. 별도 2초 입력 heartbeat가 있음.</td></tr>
<tr><td>호스팅·세션</td><td>호스팅 lease 30초<br>서버 4세션, 각 호스트·클라이언트 1세션</td><td>승인 폐기·lease·종료 상태는 약 3초마다 확인. DB 확인은 매 프레임 작업이 아님.</td></tr>
</tbody></table></div>
<div class="grid">
<div class="card"><h3>서버가 영상 압축 병목인 구조는 아님</h3><p>호스트가 압축하고 뷰어가 풉니다. 서버 회선·CPU·프록시의 영향은 측정해야 하지만, 서버를 빠르게 바꾸는 것만으로 100ms 추가 대기나 720p 축소가 사라지지는 않습니다.</p></div>
<div class="card"><h3>연결 성공과 부드러운 화면은 별도</h3><p>WSS 중계는 서로 다른 네트워크에서의 접속 경로를 마련합니다. 지연이 낮은 직접 경로 탐색, 비트레이트 조절, 오래된 프레임 폐기까지 제공하는 미디어 전송 계층은 아직 없습니다.</p></div>
</div>
</section>
<section class="section" id="next">
<span class="section-no">06 / CHANGE PRIORITIES</span><h2>수정은 이 순서로 검증해야 합니다</h2>
<p>다음은 코드 분석에 따른 제안이며 이 문서 작업에서 적용한 변경이 아닙니다. 10fps 숫자만 60으로 바꾸면 CPU·대역폭·큐 부담이 커져 더 나빠질 수 있습니다.</p>
<div class="grid">
<article class="card"><div class="priority">P0 · MEASURE</div><h3>실제 병목을 보이게 만들기</h3><p>프레임 번호, 캡처·인코드·송신·수신·디코드·표시 카운터, 단계별 p50/p95 시간, 바이트 수와 큐 대기/생략 사유를 수집합니다. 다른 PC의 시계를 바로 빼서 편도 지연으로 쓰지 말고 시계 동기화 오차 또는 왕복 측정 방식을 정의합니다.</p><p class="small">확인 기준: 정지 화면·스크롤·동영상 각각에서 어디서 FPS가 줄었는지 구분할 수 있어야 함.</p></article>
<article class="card"><div class="priority">P1 · CORRECTNESS</div><h3>현재 JPEG 경로의 결함 줄이기</h3><p>완료 후 100ms 대기를 목표 시각 기준 스케줄링으로 변경하고, 캡처·압축과 입력 처리를 분리합니다. 뷰어 디코딩을 UI 밖으로 옮깁니다. 커서 크기·hotspot, 표시 1:1 모드, 좌표와 DPI 검증을 추가합니다.</p><p class="small">확인 기준: 단계별 시간 감소, UI 응답, DPI·커서 모양별 클릭 위치 일치. 고주사율 완성으로 간주하지 않음.</p></article>
<article class="card"><div class="priority">P2 · VIDEO ENGINE</div><h3>영상에 맞는 캡처·코덱 연결</h3><p>기존 DXGI Desktop Duplication 진단 코드를 실제 캡처 수명 관리로 확장하고, GPU 텍스처 기반 처리와 저지연 하드웨어 코덱 경로를 구현·측정합니다. 모니터 변경·device lost·색 공간·폴백 경로를 함께 다룹니다.</p><p class="small">현재 진단 함수의 존재는 통합 앱이 이를 사용한다는 뜻이 아님. <a href="https://learn.microsoft.com/en-us/windows/win32/direct3ddxgi/desktop-dup-api">Microsoft Desktop Duplication API</a>는 DXGI 표면과 변경 영역 처리의 근거입니다.</p></article>
<article class="card"><div class="priority">P3 · TRANSPORT</div><h3>화면의 최신성을 지키는 전송</h3><p>측정된 대역폭에 맞춰 비트레이트·해상도·FPS를 조정합니다. 프레임 기한, 대기 프레임 교체, 입력 우선 처리를 정의합니다. 직접 경로 탐색과 UDP 기반 미디어 전송을 검토하고 막힌 네트워크에는 WSS 대체 경로를 유지합니다.</p><p class="small">확인 기준: 느린 업로드·손실·지연 조건에서 화면 나이와 입력 지연이 계속 증가하지 않을 것. 코덱 전환 시 참조 프레임 의존성을 고려해 폐기.</p></article>
</div>
<h3 style="margin-top:28px">Windows 실기 검증에 필요한 기록</h3>
<div class="table-scroll"><table><thead><tr><th scope="col">묶음</th><th scope="col">기록할 항목</th><th scope="col">구분하려는 문제</th></tr></thead><tbody>
<tr><td>환경</td><td>양쪽 EXE 해시, CPU/GPU, 화면 해상도, DPI, HDR, 모니터 수, 앱 창 크기</td><td>빌드 차이·스케일·색·장치별 재현 조건</td></tr>
<tr><td>호스트·뷰어</td><td>단계별 작업 시간, 프레임 크기, 생성/수신/표시 FPS, 프로세스 CPU/GPU</td><td>압축 병목과 디코딩·UI 병목 분리</td></tr>
<tr><td>경로</td><td>접속 도메인, 서버 왕복 시간, 업로드/다운로드 가용량, 송신 대기, 종료 사유</td><td>서버 경유·회선 부족·가드 초과의 영향</td></tr>
<tr><td>시각 비교</td><td>동일한 텍스트·격자·색 패턴, 원본과 수신 이미지, 커서 모양별 클릭 점</td><td>축소·JPEG 손실과 좌표/색/캡처 결함 분리</td></tr>
</tbody></table></div>
</section>
<section class="section" id="evidence">
<span class="section-no">07 / EVIDENCE & DEPLOYMENT</span><h2>어떤 코드를 확인했는가</h2>
<p>2026-09-23의 로컬 작업 트리를 기준으로 읽었습니다. 아직 커밋되지 않은 변경이 포함되어 있어 줄 번호는 이후 편집에서 달라질 수 있습니다. 링크는 이 HTML이 저장된 프로젝트의 상대 경로이며, 문서 본문과 계산기는 파일 하나만으로 동작합니다.</p>
<div class="file-list">
<div id="src-capture"><strong><a href="../crates/platform-win/src/remote.rs">crates/platform-win/src/remote.rs</a></strong>27–68: 주 화면·축소·GDI 자원 / 85–143: 캡처·커서·RGB/JPEG / 144–239: 입력 주입·키 해제</div>
<div id="src-session"><strong><a href="../crates/session/src/remote.rs">crates/session/src/remote.rs</a></strong>28–107: 접속·인증 / 109–141: 수신 JPEG와 입력 송신 / 268–348: 캡처 스레드·큐·100ms / 351–402: 요청 조회·호스팅 갱신</div>
<div id="src-bridge"><strong><a href="../crates/device-client/src/remote.rs">crates/device-client/src/remote.rs</a></strong>112–164: WSS 연결·128KiB Duplex·32KiB 조각·양방향 브리지 / 인증서 서명 검증</div>
<div id="src-relay"><strong><a href="../apps/control-server/src/api/remote.rs">apps/control-server/src/api/remote.rs</a></strong>52–61: API / 193–201: 세션 상한 / 260–269: 중계 큐·메시지 제한 / 284–343: 중계·4MiB 가드·폐기 확인</div>
<div id="src-viewer"><strong><a href="../crates/desktop-ui/src/app/remote_ui.rs">crates/desktop-ui/src/app/remote_ui.rs</a></strong>129–143: 수신/입력 채널 / 205–251: UI 디코딩·텍스처·스케일 / 332–349: JPEG 디코드 제한<br><a href="../crates/desktop-ui/src/app.rs">app.rs:1042–1046</a>: 접속 중 30ms 뒤 repaint 요청</div>
<div id="src-wire"><strong><a href="../crates/wire/src/remote.rs">crates/wire/src/remote.rs</a></strong>9–11: 크기 상한 / 55–79: 입력 메시지 / 81–97: 길이와 JPEG만 가진 영상 프레이밍</div>
<div><strong><a href="../crates/platform-win/src/windows_impl.rs">crates/platform-win/src/windows_impl.rs</a></strong>154: GPU·코덱 진단 / 219: Desktop Duplication 캡처 진단. 현재 통합 원격 세션에서는 별도 <code>RemoteDesktop</code>를 호출.</div>
<div><strong><a href="../deploy/ubuntu/nginx-proxy.conf">deploy/ubuntu/nginx-proxy.conf</a> · <a href="../deploy/ubuntu/notparsec-control.service">systemd 서비스</a></strong>127.0.0.1:18080 프록시, WebSocket 업그레이드, proxy_buffering off. 서비스 메모리 상한 256MiB. 이것이 현재 프레임 드랍의 원인인지는 측정하지 않음.</div>
<div><strong><a href="../crates/session/tests/remote_relay.rs">crates/session/tests/remote_relay.rs</a></strong>격리 서버·실제 기기 키·TLS 연결의 기능 검증. 실제 Windows 캡처와 SendInput 대신 테스트 화면 소스를 사용하므로 성능·시각 품질 검증이 아님.</div>
</div>
<div class="callout"><p><strong>운영 서버는 이번 통합 버전으로 갱신되어 있습니다.</strong> 서비스 시작은 18:39:31 UTC, 확인 시 active/running이었습니다. 운영 서버 실행 파일과 준비한 파일의 SHA-256이 일치했고, 운영 다운로드의 통합 EXE도 준비한 EXE와 일치했습니다. 공개 준비 상태는 200, 토큰 없는 신규 원격 API는 401로 응답했습니다. 이전 문서의 “설치 전” 기록보다 뒤의 관측입니다.</p><p class="small">이 확인은 서버와 배포 파일의 일치 증거입니다. 양쪽 PC에서 실행 중인 EXE 버전이나 실제 세션의 FPS를 확인한 것은 아닙니다.</p></div>
<details><summary class="code-summary">배포 파일 식별값 보기</summary><div class="card"><p><strong>Windows 통합 EXE</strong> · 13,457,408 bytes<span class="hash">bc838c5d09e3cd6e77252696c0fef1e07b239303edebf30cf7621ddc5db33608</span></p><p><strong>Ubuntu 서버</strong> · 7,582,184 bytes<span class="hash">4305622d194fab703e0961b6de28b11696b02167050a19697bbe78ff9b4a7d47</span></p></div></details>
<div class="callout warn"><p><strong>아직 모르는 것:</strong> 실제 생성/표시 FPS, 각 단계의 처리 시간, 프레임 손실·건너뜀 수, 네트워크 지연·재전송량, 사용자가 말한 화면 이상의 정확한 유형. 이 문서는 코드로 설명 가능한 원인을 제시하며 측정하지 않은 병목 비율이나 실측 FPS를 만들어내지 않습니다.</p></div>
</section>
<footer class="footer">notParsec · 현재 구현 구조 분석 · 2026-09-23<br>외부 폰트·스크립트·이미지 요청 없이 열리는 단일 HTML. 계산 입력은 외부로 전송하지 않습니다. 이번 작업의 산출물은 문서이며 원격 앱 동작은 변경하지 않았습니다.</footer>
</main></div>
<noscript><p class="no-js">JavaScript가 꺼져 있어 계산기와 인쇄 버튼은 동작하지 않습니다. 설명·도식·표는 그대로 읽을 수 있으며 브라우저의 인쇄 메뉴를 사용할 수 있습니다.</p></noscript>
<script>
(()=>{'use strict';
const $=id=>document.getElementById(id);
const number=(value,digits=1)=>value.toLocaleString('ko-KR',{minimumFractionDigits:digits,maximumFractionDigits:digits});
function update(){
const work=Number($('work-ms').value), kib=Number($('jpeg-kib').value), mbps=Number($('link-mbps').value);
const period=100+work, fps=1000/period, bytes=kib*1024, required=bytes*fps*8/1e6;
const networkFps=mbps*1e6/(bytes*8), bound=Math.min(fps,networkFps), guard=4*1024*1024*8/1e6;
$('work-out').textContent=work+' ms';$('jpeg-out').textContent=kib+' KiB';$('link-out').textContent=mbps+' Mbps';
$('wait-bar').style.width=(100/period*100)+'%';$('work-bar').style.width=(work/period*100)+'%';
$('work-bar').textContent=work>=20?work+'ms 작업':'';
$('cycle-caption').textContent='캡처 시작 간격의 단순 모델: 100 + '+work+' = '+period+'ms. 5ms 루프·운영체제 스케줄링·큐 대기는 제외.';
$('fps-out').textContent=number(fps)+' fps';$('rate-out').textContent=number(required,2)+' Mbps';$('bottleneck-out').textContent=number(bound)+' fps';
const networkLimited=required>mbps;
$('calc-note').classList.toggle('warn',networkLimited);
$('calc-note').textContent=networkLimited?'예시에서는 필요한 '+number(required,2)+'Mbps가 가용 '+mbps+'Mbps를 넘습니다. 전송 대기와 캡처 건너뜀이 생길 수 있습니다. 표시 FPS의 실측값은 아닙니다.':'예시에서는 생성 속도가 먼저 제한합니다. 실제 지연은 디코딩과 전송 대기를 더 측정해야 합니다.';
$('guard-note').textContent=required>guard?'생성 목표 데이터율이 서버의 4MiB/초 가드(약 33.55Mbps)보다 큽니다. 해당 양이 카운트 구간에 도착하면 연결을 종료합니다. 회선이 먼저 제한하면 도착량은 달라집니다.':'서버는 약 33.55Mbps에 해당하는 4MiB/초 가드를 둡니다. 평균값이 낮아도 1초 카운트 구간의 버스트로 종료될 수 있습니다.';
}
['work-ms','jpeg-kib','link-mbps'].forEach(id=>$(id).addEventListener('input',update));
$('print').addEventListener('click',()=>window.print());update();
})();
</script>
</body>
</html>
생성 코드·템플릿
notParsec — GPU 영상 경로와 이전 구조 분석
design/current-remote-architecture.template.html