---
title: 여러 폴더 조회 시 탐색기 대기 제거
date: 2026-11-03T07:28:13.288Z
version: v1.0.0
status: 작업 중
state: progress
project: windowsfoldersize
type: 작업 메뉴얼
report_kind: manual
category: 순차 작업 · 반복 QA
summary: 탐색기 크기 조회를 비동기 메모리 캐시로 분리하고 지연·무응답 브로커로 검증합니다.
format: tracefolio-v2
priority: normal
manual_id: windowsfoldersize-nonblocking-20261103
round: 1
manual_state: active
payload: ../assets/submissions/2026-11-03-manual-20261103072813288-v1.0.0.json
---

## 목표와 완료 기준

다수 폴더 크기 조회가 브로커 응답을 기다리지 않게 수정

완료 기준: 무응답 서버·다수 조회에서 호출 즉시 반환, 캐시 갱신·장애 시 숫자 유지, 호환성 검사와 설치 파일 생성, 공개 보고. 작업 방해 금지에 따라 설치·탐색기 재시작은 보류.

최초 1회차 · 순차 진행 · 전체 4개 · 이번 실행 T01, T02, T03, T04

## 순차 작업 메뉴얼

| 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 |
| --- | --- | --- | --- | --- | --- |
| T01 | 동기 대기 재현 | 현재 IPC 호출과 지연 서버의 실제 대기 시간 대조 | 문제 경로와 재현 수치 확인 | 20ms CallNamedPipe에 350ms 지연 응답 적용 | 진행 |
| T02 | 비동기 캐시 구현 | UI는 캐시만 조회, IPC는 제한 시간 있는 전용 스레드로 분리 | UI 경로에서 IPC와 대기 제거 | 무응답·지연·다수 폴더·숫자 유지 테스트 | 대기 |
| T03 | 회귀와 산출물 고정 | 네이티브 속성 표시 회귀, 빌드, MSI 구조와 해시 확인 | 테스트 통과 및 최신 단일 설치 파일 | headless 테스트 실행과 MSI 검증 | 대기 |
| T04 | 보고·공개 검증 | QA 근거와 적용 보류 사유를 공개 보고서로 게시 | 개별 보고서 외부 접근 성공 | 빌드·링크 검사와 배포 SHA·HTTP 본문 확인 | 대기 |

## QA 반복 기록

아직 실행한 QA가 없습니다. 준비된 절차를 통과 결과로 표시하지 않습니다.

## 남은 작업과 다음 반복

작업·QA 미실행

최초 회차입니다. 실패·미검증·남은 작업은 다음 회차에서1~5개로 줄여 이어갑니다.

## 작업 시간

- 제안 시간: 10~15분
- 실제로 완료된 시간: 2026-11-03 16:20:16 KST 시작, 진행 중
- XERJ: 미사용 — MCP 미제공, 프로젝트 검색 스크립트 없음; rg와 현재 소스로 대조