---
title: 파일 인덱스 메모리 및 계산 CPU 최적화
date: 2026-11-03T10:40:38.131Z
version: v1.0.2
status: 완료
state: complete
project: windowsfoldersize
type: 작업 메뉴얼
report_kind: manual
category: 순차 작업 · 반복 QA
summary: 파일별 트리를 디스크 DB로 이동하고 CPU1%·캐시2MiB·동시스캔2개를 검증합니다.
format: tracefolio-v2
priority: normal
manual_id: windowsfoldersize-resources-20261103
round: 2
manual_state: complete
payload: ../assets/submissions/2026-11-03-manual-windowsfoldersize-resources-20261103-20261103104038131-v1.0.2.json
---

## 목표와 완료 기준

파일별 차액 갱신을 유지하며 메모리와 CPU 부담 줄이기

완료 기준: 디스크 인덱스 차액/이름변경/삭제/재시작 정확성, 메모리·CPU 실측, 빌드·MSI검증·단일dist·공개보고. 사용자화면제어금지로 설치와GUI적용은보류.

후속 2회차 · 순차 진행 · 전체 4개 · 이번 실행 T03, T04

## 순차 작업 메뉴얼

| 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 |
| --- | --- | --- | --- | --- | --- |
| T01 | 디스크 인덱스 및 제한 구현 | 파일별정보를디스크DB로옮기고캐시2MiB·동시스캔2·CPU1%적용 | 파일별정보를디스크DB로옮기고캐시2MiB·동시스캔2·CPU1%적용 | 실행결과·정확한합계·자원측정·배포대조 | 완료 |
| T02 | 회귀와 자원 측정 | 150000파일의기존맵과디스크DB메모리·CPU,차액·이동·삭제·영속성검증 | 150000파일의기존맵과디스크DB메모리·CPU,차액·이동·삭제·영속성검증 | 실행결과·정확한합계·자원측정·배포대조 | 완료 |
| T03 | 빌드와 공개 보고 | 최신단일설치파일·MSI검증·소스푸시·공개보고 | 최신단일설치파일·MSI검증·소스푸시·공개보고 | 실행결과·정확한합계·자원측정·배포대조 | 완료 |
| T04 | GitHub 릴리스 배포 | 고정MSI·SHA256을Actions태그배포로업로드하고공개다운로드해시대조 | 릴리스공개·Actions성공·로컬/다운로드SHA256일치 | GitHub API·공개다운로드·SHA256·로컬Git상태확인 | 완료 |

## QA 반복 기록

### Q01 · step · 2026-11-03T10:29:54.354Z

자원 및 정확성 회귀

- T01 r1 · pass: 디스크SQLite 캐시2MiB, 동시스캔2, 정상차액우선, 통지4096, 스캔양보8ms, CPU상한1% 구현. fdcd4fa 푸시. · 근거: agent.cpp/disk_index.hpp/build 결과
- T02 r1 · pass: 150000기존최대116002816B/신규9302016B, SQLite캐시2154960B, 신규평균CPU0.729%. 이동·추가·삭제·재열기·롤백 통과. 실제worker 초기7B→19B→삭제0B, 정상변경recovering없음. · 근거: resource_test 전체 및 최종quick, broker_resource_test 실제 실행
### Q02 · step · 2026-11-03T10:40:32.148Z

공개보고및릴리스배포확인

- T03 r1 · pass: MSI ICE0,고정dist16,소스푸시,공개보고서HTTP200·이미지200,대체Pages배포ec2e783 성공확인. · 근거: Pages배포성공·공개HTML/PNG HTTP200
- T04 r1 · pass: 77b1c32 및v1.0.16 푸시.41620963081 성공.19:38:41KST 공개.다운로드SHA256 dfa898faac89b84c6aefe43cbe2ad5d9268b31cb0c6a1ad2e55b2fb8869642ed 동일.로컬원본Gitclean. · 근거: GitHubActions41620963081·릴리스API·다운로드SHA256
### Q03 · final · 2026-11-03T10:40:32.154Z

구현·회귀·공개보고·릴리스전체완료기준대조;설치제외범위유지

- T01 r1 · pass: 디스크SQLite 캐시2MiB, 동시스캔2, 정상차액우선, 통지4096, 스캔양보8ms, CPU상한1% 구현. fdcd4fa 푸시. · 근거: 해당실행·배포근거
- T02 r1 · pass: 150000기존최대116002816B/신규9302016B, SQLite캐시2154960B, 신규평균CPU0.729%. 이동·추가·삭제·재열기·롤백 통과. 실제worker 초기7B→19B→삭제0B, 정상변경recovering없음. · 근거: 실행시험출력
- T03 r1 · pass: MSI ICE0,고정dist16,소스푸시,공개보고서HTTP200·이미지200,대체Pages배포ec2e783 성공확인. · 근거: 해당실행·배포근거
- T04 r1 · pass: 77b1c32 및v1.0.16 푸시.41620963081 성공.19:38:41KST 공개.다운로드SHA256 dfa898faac89b84c6aefe43cbe2ad5d9268b31cb0c6a1ad2e55b2fb8869642ed 동일.로컬원본Gitclean. · 근거: 공개다운로드및Actions

## 남은 작업과 다음 반복

설치및실제Explorer GUI검증은별도보류.공개완료를설치성공으로간주하지않음.

이전 회차: [메뉴얼 열기](../../../projects/windowsfoldersize/reports/2026-11-03-manual-windowsfoldersize-resources-20261103-20261103103005748-v1.0.1.html)

## 작업 시간

- 제안 시간: 5~10분
- 실제로 완료된 시간: 최적화19:16:44KST시작,공개검증19:35:09KST.추가릴리스19:36:07KST시작,릴리스공개19:38:41KST(2분34초).추가공개보고검증진행.
- XERJ: 미사용 — XERJ도구없음,rg사용