5분

주간 개발일지 2026‑W32: 스캔 PDF OCR을 운영에서 완주하다

  • 주간 개발일지
  • 바이브코딩
  • 셀프호스팅 AI
  • 2026-W32
큰 파일을 작은 조각으로 전송한 뒤 소유자별로 조립하는 흐름. 2026-10-11에 생성한 개념 일러스트이며 실제 제품 화면이 아닙니다. 해당 주간의 주제를 설명하며 당시 배포 화면이나 현재 운영 상태를 증명하지 않습니다.

당시 개발 기록 / 근거

이번 주 OpenMake

이 주간에는 오케스트레이션 신뢰성과 프런트엔드·백엔드 기능 정합성을 다듬고, Cloudflare 요청 상한을 넘는 대용량 첨부를 청크로 전송한 뒤 텍스트 층이 없는 스캔 PDF까지 분석하는 경로를 완성했습니다. 작은 문서는 다중 페이지 네이티브 OCR 폴백으로 처리하고, 큰 문서는 샌드박스에서 필요한 페이지만 표적 OCR하도록 역할을 나눴습니다. 이어서 실패한 에이전트 작업 20건을 후향 실측해, 일시적 LLM 오류에는 지수 백오프 재시도를, 승인 무응답이 반복된 작업에는 승인 필요 도구를 걷어내고 마무리를 유도하는 강등을 추가했으며, 이 작업들은 히스토리에 에이전트 작업을 통합하는 변경과 함께 1.21.0으로 릴리스됐습니다.

기간
2026-08-03 – 2026-08-09
Git 커밋
112
근거
혼합 근거

01

전체 이력 재점검과 보완

청크 업로드·OCR과 자원 상한에서의 마무리 턴 외에 로컬 worktree diff 기준점·작업별 셸 승인도 들어갔습니다. 작성일 112개와 커밋일 114개의 차이를 명시해 재현 가능한 집계로 만듭니다.

2026-10-24에 main ac08a8a4의 전체 도달 가능한 이력을 다시 확인했습니다. 집계는 KST 월요일 00:00부터 일요일 23:59:59까지 작성일 기준이며 병합·릴리스 커밋과 병렬 브랜치의 별도 커밋을 포함합니다. 커밋 수는 기능 수가 아닙니다. 아래 기록된 테스트·운영 실측은 당시 소스 기록이며 이번 수정에서 다시 실행한 결과가 아닙니다.

세션에서 나온 설명은 기존 아카이브 회고를 이어받았습니다. 이번 재점검의 대상은 공개 Git 소스이며 원래 로컬 대화를 새로 전수 조사했다는 주장은 아닙니다.

02

개발 현황

  • 라우팅·후처리·에이전트 작업 완료 동작과 프런트엔드·백엔드 기능 정합성을 개선했습니다.
  • 인증 청크 업로드와 레이트 리밋 불변식을 추가하고, 30MB 생성 시점 OCR 게이트로 Cloudflare 응답 한도를 보호했습니다.
  • chat.openmake.cc에서 66MB·688쪽 실제 스캔 PDF를 업로드해 13쪽을 표적 OCR하고 4턴 만에 분석 보고서 아티팩트를 생성한 뒤, 유닛 5/5·관련 테스트 135/135와 PR #431 CI·병합·운영 배포까지 완료했습니다.
  • 에이전트 작업 재시도 정책 1단계를 병합했습니다 — 5xx·408·429와 연결류 오류만 기본 2회 지수 백오프로 재시도하고, 승인 무응답이 2회 누적되면 승인 필요 도구를 제거해 확보한 정보로 산출물을 마무리하게 하며, 재시도·강등 발동을 스텝으로 영속화해 집계합니다.
  • 히스토리 최근 대화 목록에 에이전트 작업을 읽기 전용으로 통합하고 작업 상세 딥링크를 추가했으며, README 아키텍처 서술을 현행 message-pipeline 실체에 맞게 정정한 뒤 재시도 정책·히스토리 통합을 묶어 1.21.0으로 릴리스했습니다.

근거 자료

근거

OPENMAKE · MIT OPEN SOURCE

개발일지로 돌아가기