AX Agent transcript 렌더 계획/적용 구조를 분리해 유지보수성을 높이고 문서를 갱신한다
Some checks failed
Release Gate / gate (push) Has been cancelled

- ChatWindow transcript 렌더를 planner/execution 단계로 분리해 RenderMessages 오케스트레이션을 단순화함
- TranscriptRenderPlanner/TranscriptRenderExecution partial을 추가해 planning과 host 적용 책임을 나눔
- README와 DEVELOPMENT 문서에 2026-04-09 09:37 (KST) 기준 구조 개선 이력을 반영함
- dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify\\ -p:IntermediateOutputPath=obj\\verify\\ 검증 결과 경고 0개 오류 0개
This commit is contained in:
2026-04-09 00:39:47 +09:00
parent 8643562319
commit 594d38e4a9
5 changed files with 151 additions and 88 deletions

View File

@@ -5520,3 +5520,19 @@ ow + toggle ?쒓컖 ?몄뼱濡??ㅼ떆 ?뺣젹?덈떎.
- 구조 효과
- transcript 렌더링과 tool streaming 복구 정책의 책임 경계가 더 분명해졌다.
- 이후 남은 큰 작업인 `진짜 transcript 가상화``AgentLoopService 추가 분해`를 더 작은 변경 단위로 진행할 수 있는 기반을 마련했다.
## 2026-04-09 09:37 (KST)
- [ChatWindow.TranscriptRenderPlanner.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Views/ChatWindow.TranscriptRenderPlanner.cs)
- `TranscriptRenderPlan`을 도입하고, transcript 렌더 계획 생성 책임을 별도 partial로 분리했다.
- visible 메시지/실행 이벤트를 수집한 뒤 render key 리스트와 `FullRefresh` 필요 여부를 계산하도록 정리했다.
- 결과적으로 `RenderMessages()`는 더 이상 timeline 조립과 diff 판정을 함께 하지 않고 planner에서 render intent를 받는다.
- [ChatWindow.TranscriptRenderExecution.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Views/ChatWindow.TranscriptRenderExecution.cs)
- `TryApplyIncrementalTranscriptRender(...)`, `ApplyFullTranscriptRender(...)`를 분리해 render plan 적용 책임을 별도 partial로 이동했다.
- transcript host에 대한 add/replace/remove와 viewport 보존 시점을 planner와 분리해, 이후 virtualization window 정책과 render batching을 독립적으로 조정할 수 있는 구조를 만들었다.
- [ChatWindow.TranscriptRendering.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Views/ChatWindow.TranscriptRendering.cs)
- `RenderMessages()``데이터 수집 -> planner 호출 -> incremental/full 적용 -> viewport finalize` 순서만 담당하는 orchestration 메서드로 축소했다.
- `claw-code``Messages.tsx` + `VirtualMessageList.tsx`처럼 planning과 host 조작을 분리하는 방향으로 더 가까워졌고, transcript 변경의 파급 범위를 줄일 수 있게 됐다.
- 구조 효과
- transcript 렌더의 변경 포인트가 `계획 생성``실행 적용`으로 명확히 나뉘었다.
- 향후 실제 가상화 강화, render batching, incremental diff 정교화 작업을 더 안전하게 진행할 수 있다.