---
title: 자동 렌더링 경로와 프리팹 대량 처리 보강
date: 2026-11-03T06:18:01.491Z
version: v1.0.6
status: 작업 중
state: progress
project: entityforge
type: 작업 메뉴얼
report_kind: manual
category: 순차 작업 · 반복 QA
summary: 불필요한 시뮬레이션과 프레임별 복사를 분리하고 생성·해제 경로를 개선합니다.
format: tracefolio-v2
priority: normal
manual_id: entityforge-runtime-fastpath-20261103
round: 3
manual_state: active
payload: ../assets/submissions/2026-11-03-manual-entityforge-runtime-fastpath-20261103-20261103061801491-v1.0.6.json
---

## 목표와 완료 기준

현재 자동 모드의 반복 처리/메모리 할당과 프리팹 생성·해제 비용을 줄일 구조를 구현

완료 기준: 프록시/시뮬레이션 분리, 재사용 렌더 버퍼와 대량 생성·해제, 생명주기 회귀/현재 소스 컴파일/패키지 대조 및 실제 성능 확인 범위 구분

후속 3회차 · 순차 진행 · 전체 11개 · 이번 실행 T04, T07, T08, T09, T10

## 순차 작업 메뉴얼

| 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 |
| --- | --- | --- | --- | --- | --- |
| T01 | 자동 프록시와 ECS 시뮬레이션 분리 | 렌더 쿼리/동작 쿼리 분리와 재사용 버퍼·Burst 행렬 준비 | 프록시에는 동작 잡이 실행되지 않고 매 프레임 데이터 배열 복사 제거 | 현재 코드 경로·컴파일·데이터 규약 검증 | 완료 |
| T02 | 대량 생성·해제와 진단 | 엔티티 일괄 생성/해제, 밀집 등록 저장소 및 런타임 카운터 | 전체 소스 반복 탐색 제거, 죽은 소스 정리와 원래 렌더러 복원 | 실제 저장소 소스 실행 테스트와 컴파일·생명주기 경로 대조 | 완료 |
| T03 | 비GUI 회귀와 패키지 반영 | 컴파일·순수 로직 실행·문서/번역·소스/패키지 대조 | 실행한 검증만 근거로 기록 | 소스 해시와 테스트 출력·패키지 원본 바이트 비교 | 완료 |
| T04 | 네이티브 회귀와 실제 성능 비교 | 같은 부하의 변환 ON/OFF로 프레임 시간·메모리·동작 비교 | 원래 행동 동등성과 실제 비용 감소 확인 | 실제 플레이어에서 동일 조건 비교와 프로파일러 근거 확보 | 진행 |
| T05 | 빌드 기록 카드 정리 | 기존 결과 카드 스타일로 버튼·목록·상세 묶기 | 모든 기록 요소가 같은 박스 안에 표시 | 실제 Unity 테마 전환·기록 선택·목록과 상세 부모 대조 | 완료 |
| T06 | 빌드 기록 요약 행 | UXML 요약 행과 선택/호버/선택 복원 | 파일명 대신 읽기 쉬운 날짜·플랫폼·변환 개수·상태 | 실제 마우스/키보드 선택·새로고침·테마 및 번역 인자 확인 | 완료 |
| T07 | 반복 오브젝트 이점·판매 문구 | 제품 UI·9개 가이드·포털 저장용 문구에 반복 메시/재질과 조건부 이점 및 실측 제한 명시 | 설치만으로 빨라진다는 보장 없이 조건과 빌드 적용 시점 표시 | 번역 9개·문서 링크·판매 초안 내용 대조 | 완료 |
| T08 | 자동 렌더링 중복 처리 제거 | 지속 렌더 페이지와 시뮬레이션 전용 gather, 변경된 재질만 복사, 진단 보강 | 정지 프록시의 매 프레임 gather/copy 제거, 원래 동적 동작/폴백 유지 | 실제 페이지 저장소 로직 실행·7개 어셈블리 컴파일·수명/폴백 경로 대조 | 완료 |
| T09 | 산출물·재측정 준비 | 측정값/동기화 비용 진단·프로파일링 계획과 새 패키지 생성 | 실측 통과와 구현/정적 검증을 구분하고 네이티브 검증 대기 명시 | 소스/패키지 해시 대조와 진단 데이터 계약 검사 | 완료 |
| T10 | 비모달 분석·하단 진행률 구현 | 씬/프리팹 분석을 EditorApplication.update 분할 처리, 분석 중 버튼과 고정 하단 상태줄, 탭 이동 지속·취소 정리·9언어 문구 구현 | 로딩 다이얼로그 호출 없이 진행률과 상태 표시 구조, 미리보기 지문 계산 제외, 기존 빌드 지문 유지 | 현재 C# 컴파일·UXML 하단 부모·모달 호출 없음·반복자 정리·번역/패키지 소스 대조. 실제 표시/마우스 회귀는 T04에서 재허용 후 | 완료 |
| T11 | 판매 포털 실제 초안 저장 | 현재 4개 언어 description을 다시 읽고 준비된 조건부 성능 설명을 Save 후 재열어 대조. Submit 금지 | 반복 메시/재질의 조건부 이점과 설치만으로 속도 향상 보장 없음이 실제 초안에 저장 | 포털 저장 전 SHA 대조와 새로고침 후 4개 언어 저장값 대조 | 대기 |

## QA 반복 기록

### Q01 · step · 2026-11-03T04:08:04.833Z

첫 정적 검사 스크립트의 호출 대상 문자열이 실제 소스와 달라 실패; 제품 코드 실패로 판정하지 않음

- T01 r1 · pass: 새 쿼리/버퍼 구현의 현재 소스 컴파일 통과 · 근거: ../assets/runtime-fastpath-20261103/verification.json
- T02 r1 · pass: 실제 밀집 저장소 소스의 1만 항목 추가·제거·재등록과 재사용 테스트 통과 · 근거: ../assets/runtime-fastpath-20261103/registry-tests.txt
- T03 r1 · fail: checker expected manager.DestroyEntity but implementation uses world.EntityManager.DestroyEntity; checker corrected without changing product · 근거: ../assets/runtime-fastpath-20261103/verification-attempt1.txt
### Q02 · step · 2026-11-03T04:08:53.463Z

현재 소스와 순수 로직 검증 통과, 네이티브 실행 미실행

- T01 r1 · pass: 7개 어셈블리 현재 소스 컴파일과 구조/버퍼/의존성 대조 · 근거: ../assets/runtime-fastpath-20261103/verification.json
- T02 r1 · pass: 실제 ForgeDenseRegistry 코드의 1만 개 임의 삭제·재등록·반복 초기화 테스트 통과 · 근거: ../assets/runtime-fastpath-20261103/verification.json
- T03 r1 · pass: 7개 현재 소스 컴파일·9개 문서 및 402개 에셋 패키지 내용/해시 대조 통과 · 근거: ../assets/runtime-fastpath-20261103/verification.json
- T04 r1 · blocked: 사용자 실행 금지로 네이티브 미실행 · 근거: 미실행/차단 근거 없음
### Q03 · step · 2026-11-03T04:58:56.5297786+00:00

사용자 재허용 후 실제 실행

- T04 r2 · fail: 기능은 통과했으나 이 부하의 개선율 -1.62%, 추가 성능 검증 필요 · 근거: ../assets/native-validation-20261103/verification.json
### Q04 · step · 2026-11-03T05:06:01.3550422+00:00

추가 CI 상태 오류 수정·재빌드

- T03 r1 · pass: 현재 7개 어셈블리와 최종 402개 패키지 대조. 새 프로젝트 설치 후 최종 빌드 오류0 및 succeeded 로그 확인 · 근거: ../assets/ci-final-state-20261103/verification.json
### Q05 · step · 2026-11-03T05:13:48.942Z

빌드 기록 영역 카드화

- T05 r1 · pass: 실제 Unity에서 같은 카드 내부 목록/로그 표시 및 테마 전환·기록 선택 확인 · 근거: ../assets/history-card-20261103/after.jpg
### Q06 · step · 2026-11-03T05:22:07.226Z

빌드 기록을 날짜·상태·변환 개수의 요약 행으로 정리

- T06 r1 · pass: 실제 Unity 6000.0.83f1에서 날짜와 JSON startedUtc 대조, 10,000개 변환 및 succeeded/unknown 상태 대조, 마우스 선택·키보드 Down·새로고침 선택 유지·밝은/어두운 테마 확인. 7개 새 문구의 9개 언어 및 {0} 인자 검사 통과. 캡처는 영어입니다. 기존 로그 파일을 수정하거나 빌드하지 않았습니다. · 근거: ../assets/history-rows-20261103/after.jpg
### Q07 · step · 2026-11-03T06:17:52.724Z

반복 렌더링 경로·비모달 분석의 파일/로직 검사. 네이티브 UI·성능은 미실행

- T07 r1 · pass: 제품 설명·9개 가이드에 반복 메시/재질의 조건부 이점 반영. 최신 판매 페이지 4개 언어의 저장용 수정문 준비; 실제 Save는 별도 T11 미실행. · 근거: ../assets/repeated-rendering-20261103/verification.json
- T08 r1 · pass: 정지 프록시 재사용 draw 페이지, 동작 전용 gather, 재질 변경 감지, 구간별 진단 구현. 실제 생산 페이지 저장소/측정 정책 순수 로직과 컴파일 통과; 네이티브 성능 pending. · 근거: ../assets/repeated-rendering-20261103/verification.json
- T09 r1 · pass: 0.3.1-preview 407개 에셋을 현재 원본/메타와 읽기 대조. 0.3.0 원본 해시 보존. 포그라운드/타이밍 조건 진단과 명시적 네이티브 QA 준비; 실행하지 않음. · 근거: ../assets/repeated-rendering-20261103/verification.json
- T10 r1 · pass: 7개 어셈블리/97개 현재 소스, 9언어 514개 항목과 고정 하단 UXML 구조 검사 통과. 실제 Unity 표시·응답성 pending · 근거: ../assets/repeated-rendering-20261103/verification.json

## 남은 작업과 다음 반복

T04: 최신 네이티브 런타임/분석 UI·실측·문서 캡처. T11: 실제 판매 초안 Save/readback. 사용자 컴퓨터 유즈 금지로 실행하지 않음. 과거 -1.62% 결과는 보존하며 최신 개선율로 사용하지 않음. 교훈 검토: 기존 전역 근거/포커스 규칙 적용, 전역 변경 없음.

이전 회차: [메뉴얼 열기](../../../projects/entityforge/reports/2026-11-03-manual-entityforge-runtime-fastpath-20261103-20261103052242132-v1.0.5.html)

## 작업 시간

- 제안 시간: 30~60분 · 시작 2026-11-03 14:33:13 KST. 비모달 분석 추가 예상 8~15분
- 실제로 완료된 시간: 파일 구현·비GUI 검사 44.7분 · 2026-11-03 15:17:52 KST. 공개 배포는 이후 별도 확인. 네이티브 실행 완료 시각은 미정.
- XERJ: 실패 — XERJ node is not running. rg와 현재 소스로 확인.