재현성 결과·Python·보고서 연결

결과 연결에서 프로젝트를 고르고 합성 예제로 체험하기를 누르면, 실제 CPU 계산으로 만든 비공개 결과 두 개를 확인할 수 있습니다. 그래프·지표·표를 보고 섹션을 담아 보고서를 만들어 보세요. 동일한 프로젝트에서는 기존 예제를 재사용합니다. 실제 연구 데이터·GPU·AI·Notion 전송은 사용하지 않습니다.

보고서 → 재현성 결과 → 결과 연결에서 프로젝트를 고르고 연결 셀 복사를 누르세요. 기존 Colab·Jupyter 첫 셀이나 Python 파일 앞부분에 붙여 실행하면 SDK 0.3.0을 고정 wheel·SHA-256으로 준비하고 브라우저에서 연결을 확인합니다. 표시된 계정·프로젝트·확인 코드를 대조한 뒤 승인하세요. 유효한 연결은 현재 Python 메모리에 보관되어 같은 프로젝트의 여러 결과에 재사용됩니다. 연결만으로 전송하지 않으며 런타임 재시작 후에는 다시 연결합니다. 키 원문을 코드·출력·Git·AI 상담에 넣지 마세요. Colab에서는 PC localhost 대신 실제 플랫폼 HTTPS 주소를 사용합니다.

기존 계산 뒤 마지막 셀에 import luna_repro as repro; selection = repro.select()를 추가합니다. 지원되는 변수·표·그림을 로컬 후보로 추천하고 일부를 미리 체크할 수 있지만 자동 전송하지 않습니다. 제목·설명·순서를 확인하고 미리보기 뒤 검토한 결과 전송을 누르세요. 이미 보낼 객체를 정했다면 repro.publish(fig, results_df, metrics, title="Experiment results")가 명시적으로 전송합니다. 기본 추천은 AI 호출이 아니며 과학적 중요도·실험 성공을 판정하지 않습니다.

일반 .py나 위젯이 없는 환경에서는 selection.summary(), choose(), option(), preview("preview.html"), publish()를 사용합니다. 미리보기는 선택 내용을 고정하므로 나중의 변수 변경으로 몰래 바뀌지 않습니다. 닫힌 과거 그림·사라진 변수·계산 출처는 마지막 셀로 복원하지 못합니다. 그림이 닫히기 전에 선택적 capture() 범위를 열거나 파일로 보존하세요. 정교한 섹션·출처·실행 상태는 기존 page = repro.page(project_uuid, "실험 결과"), page.section("quality").metrics(metrics), repro.publish(page)로 지정할 수 있습니다. 수동 연결 키·환경 변수와 기존 ZIP 설치는 접힌 연결 설정에서 계속 사용할 수 있습니다.

텍스트·숫자 지표·표·PNG/JPEG를 자유롭게 조합합니다. 전체 미리보기에서 결과를 순서대로 확인하고 카드의 간단한 출처에서 코드로 이동합니다. 필요한 경우 상세 정보를 펼칩니다. 섹션마다 코드 링크와 등록 위치를 둘 수 있습니다. 자동 위치는 결과를 등록한 파일·줄이며 실제 계산 위치를 추론하지 않습니다. 계산 함수·커밋·노트북 셀은 명시적으로 지정하세요. 실행 환경 열기는 Colab 또는 자체 서버의 링크를 엽니다. 플랫폼이 학습·추론·GPU 작업을 대신 시작하지 않습니다.

기존 결과 가져오기, 실제 실행 기록, 합성 예제를 구분합니다. 실행 완료와 정량 평가 여부는 제출한 코드가 보고한 상태이며 독립 재현이나 연구자 검토를 뜻하지 않습니다. 버전 비교는 같은 이름의 수치 차이만 보여주며 성능 향상을 자동 판정하지 않습니다. 데이터·분할·정렬·평가 조건이 같은지도 확인하세요.

결과 페이지에서 필요한 섹션을 선택합니다. 선택 표시줄의 선택 검토에서 여러 페이지의 결과와 버전을 확인하고 순서를 조정한 뒤 보고서를 만듭니다. 기존 결과 보고서 편집 중에는 이 보고서에 추가를 사용하고 저장할 때 변경을 확정합니다. 플랫폼 보고서는 작성자 전용 초안으로 시작합니다. 참조한 결과의 버전은 고정되므로 새 실험이 올라와도 기존 보고서는 자동으로 바뀌지 않습니다. 제목·설명·과제·프로젝트·연구원·태그는 기존 자료 화면에서 관리합니다. 공유 권한은 재현성 페이지의 실행 프로젝트와 보기 범위를 따르며 검색용 메타데이터만 수정해서 확대되지 않습니다.

링크 복사는 섹션 주소, 내용·출처 복사는 가능한 서식과 출처를 전달합니다. 대상 프로그램이 이미지나 서식을 받지 못하면 Notion에 게시를 사용하세요. 같은 화면의 게시 창에서 대상과 자동 미리보기를 확인하고 게시합니다. 기본은 새 하위 페이지이며 기존 페이지 추가는 게시 옵션에 있습니다. 이미지 원본은 Notion에 업로드하고 지표·표는 native 블록으로 넣습니다. 대상 Notion 페이지의 실제 권한을 확인하세요. LUNA 접근을 회수해도 외부 사본을 자동 삭제하지 않습니다.

섹션에서 AI로 검토를 선택하거나 AI 검토 자료를 내려받아 원하는 상담에 전달합니다. 결과의 고정 버전, 지표·설명·코드 출처와 미실시 평가를 함께 확인하세요. 연결된 상담은 현재 결과 열람 권한을 다시 검사합니다. 읽기·내려받기만으로 AI를 호출하지 않으며 실제 상담 실행은 기존 AI 예산·권한을 따릅니다.

ChatGPT나 Codex에서는 접근 가능한 재현성 자료 링크 또는 내려받은 검토 자료를 명시적으로 전달하고 “이 결과의 코드 출처와 평가 조건을 확인하고 한계와 다음 실험을 제안해 주세요”라고 요청할 수 있습니다. 호스트에 실제 노출된 연결 도구의 범위 안에서만 작업합니다. 링크 전달만으로 외부 코드 전체를 읽거나 비공개 저장소 권한이 생기지 않습니다. 개선 코드 생성·합성 검사·실제 실행·연구 성공을 각각 구분하세요.

결과 등록·조회·보고서 조합·Notion 전송 자체는 추가 AI 호출이나 GPU를 시작하지 않습니다. 서버 저장·전송과 기존 외부 서비스의 요금은 별도이며 무료라고 보장하지 않습니다. 모델·대용량 데이터는 기존 Colab·자체 서버·Drive 등에 남기고 선택한 작은 결과만 전송하세요. SDK JSON은 16MiB, 이미지 하나는 8MiB, 표는 2,000행·100열까지입니다. Notion 전달은 한 번에 40개 섹션·10개 이미지, 표마다 99행·40열까지 지원합니다.

전송이 실패하면 SDK는 로컬 .luna-repro/outbox에 결과를 보관하고 pending을 반환합니다. 이 폴더도 비공개 연구자료입니다. 연결·키·권한을 확인한 다음 python -m luna_repro sync로 명시적으로 재전송하세요. 같은 요청은 중복 저장하지 않습니다. 권한 오류는 프로젝트 참여·키 만료·키 철회를 확인하고, 413 오류는 이미지 또는 선택한 결과 크기를 줄이세요.

기본 프로젝트 보관 한도는 결과 JSON과 이미지 합계 1GiB입니다. 같은 요청 재전송은 보관 용량을 추가로 차감하지 않습니다. 409 보관 한도 오류는 선택한 결과와 관리자 저장 정책을 확인하고, 429 오류는 요청 간격을 두고 다시 시도하세요. 기본 수신 제한은 사용자당 15분에 120회, 프로젝트당 600회이며 AI 일일 한도와 별개입니다. 기존 결과를 자동 삭제해 용량을 확보하지 않습니다.

Notion 전송은 대기·전송·확인 완료를 구분합니다. 결과가 불확실한 상태에서는 같은 내용을 자동 반복하지 않습니다. 대상 페이지를 확인하고 연결 상태를 점검하세요. 실제 확인 전에는 게시 완료라고 표시하지 않습니다. 플랫폼 원본과 버전·소형 이미지 바이트는 기존 암호화 운영 DB 백업 대상이며 개인 결과를 연구실의 평문 보존 사본에 자동 합치지 않습니다.

SDK에 함께 제공되는 examples/repro 예제는 결정적인 CPU 합성 검사와 Pasa 출력 폴더 어댑터를 구분합니다. Pasa 어댑터는 기존 실행의 manifest·선택한 렌더·카메라 진단·존재하는 평가표를 읽습니다. 원래 추론·학습 코드를 실행하거나 누락된 평가를 만들어내지 않습니다.

GT가 없거나 평가를 생략한 실행은 미실시 상태로 등록합니다. 카메라 진단 실패를 보존하고 일부 추론 시간을 전체 파이프라인 시간으로 바꾸지 않습니다. 실제 Pasa 재현은 접근 가능한 데이터·모델과 CUDA 실행 환경에서 별도로 수행해야 합니다. 합성 예제 통과, 기존 결과 가져오기, 새 Pasa 실행, 독립 검증은 각각의 증거를 확인하세요.

일반 탈퇴는 로그인과 프로젝트 접근을 종료하고 재현성 연결 키를 철회합니다. 결과·불변 버전·이미지와 작성자 이력은 보존합니다. 대기 중인 Notion 전달은 실행 직전 현재 접근 권한을 다시 검사하며, 접근이 종료되면 전송하지 않습니다. 이미 외부로 전달한 사본은 자동 삭제하지 않습니다.

재현성 결과·조합 보고서·Notion 전달 이력이 있는 계정은 완전 삭제 전에 보존·이관 검토가 필요합니다. 삭제 과정에서 불변 증거의 작성자를 임의로 바꾸지 않습니다. 연결 키만 있고 연구 이력이 없는 계정은 기존 완전 삭제 절차로 키를 함께 삭제할 수 있습니다.

보고서의 전체 보고서·재현성 결과 탭에서 목록을 전환합니다. 새 보고서 메뉴에서 직접 작성, 재현성 결과로 작성 또는 AI로 초안 작성을 선택하세요. 재현성 결과에서 결과 연결은 Python·Colab 안내를, 연결 관리는 본인이 발급한 키의 목록을 엽니다. 메뉴를 여는 것만으로 결과·키·AI 보고서를 생성하지 않습니다.

설정 → 재현성 연결에서는 여러 프로젝트의 내 연결을 모아 관리합니다. 프로젝트 설정 → 연결·연구 도구 → 연결 관리에서는 해당 프로젝트가 선택된 같은 관리 화면으로 이동합니다. 프로젝트 설정 권한이 없는 참여자는 설정이나 보고서에서 본인 연결을 관리할 수 있습니다. 프로젝트 관리자가 되어도 다른 사용자의 키를 열람하거나 해제할 권한이 자동으로 생기지 않습니다.

키는 발급자와 프로젝트에 묶이며, 같은 프로젝트의 여러 결과와 실행에 재사용합니다. Colab·서버별 이름으로 나누어 발급할 수 있지만 이름 자체가 장치를 인증하지는 않습니다. 키 원문은 발급 때만 표시됩니다. 기존 키를 잃어버렸거나 교체하려면 새 연결 키를 발급해 실행 환경에 설정한 뒤 기존 연결을 해제하세요. 해제해도 결과·보고서·버전 이력은 삭제되지 않습니다. 만료와 해제, 현재 프로젝트 접근 권한 없음을 구분하며, 권한이 없어진 본인 키도 통합 관리에서 해제할 수 있습니다. 열람자는 작성자의 키 대신 본인의 로그인과 현재 공유 권한을 사용합니다.

상세 실습 가이드: https://lunalab-ai.com/workspace/repro/guide/?lang=KO

설치 없이 완성 예시 보기: https://lunalab-ai.com/workspace/repro/demo/?lang=KO

Colab·Windows·Linux 준비부터 마지막 셀, 여러 셀에서 쌓기, text/metrics/table/image/figure 문법, 코드 셀·줄·고정 커밋 연결, 버전, 보고서, Notion, AI 검토, Pasa 어댑터, 전송 실패 복구를 순서대로 안내합니다. 설명서 HTML·Markdown과 직접 실행하는 walkthrough.py·walkthrough.ipynb를 실습 묶음 ZIP으로 내려받을 수 있습니다. HTML은 인터넷 없이 읽고 브라우저에서 PDF로 인쇄할 수 있습니다.

먼저 공개 합성 예시에서 결과 모양을 확인한 뒤 결과 연결에서 본인 프로젝트의 비공개 데모를 만드세요. 코드 실습은 로컬 저장까지만 기본 실행하며 직접 전송을 선택했을 때만 연결 키를 사용합니다. published 수신 확인과 pending 로컬 보존을 구분합니다. 두 합성 예제의 수치는 실제 연구 성능이나 독립 재현 검증이 아닙니다.

공개 SDK 설치·업그레이드 안내: https://github.com/lunalab-ai/luna-repro-sdk/blob/v0.3.0/docs/installation-ko.md

SDK 0.3.0과 결과 계약 luna.repro.page.v1, 플랫폼 버전은 별개입니다. SDK 공개는 키·연구 결과 공개를 뜻하지 않으며 설치만으로 기존 결과·연결·이력이 변경되지 않습니다. 버전을 바꾸기 전 현재 버전과 requirements를 기록하고 새 가상환경에서 합성 예제를 확인하세요. 복구는 기록한 이전 릴리스의 wheel·SHA-256을 같은 환경에 다시 설치하며 결과 JSON과 outbox를 지우지 않습니다. SDK·CPU 실습은 별도 GPU·유료 실행 서비스 없이 시작할 수 있으나 Colab 제공 자원·서버·저장·네트워크·선택한 AI의 비용은 별도입니다.

ChatGPT·Codex에 질문할 때는 SDK luna_repro 0.3.0, 결과 페이지 계약 luna.repro.page.v1, 선택한 결과 JSON과 오류 코드를 명시하면 기존 ReproKit 이벤트 API와 혼동하지 않습니다. 연결 키는 질문·첨부에 넣지 마세요. AI 검토 자료나 접근 가능한 섹션 링크를 먼저 전달하며, 실제로 노출된 도구와 현재 권한 범위에서 이어갑니다.

결과로 보고서 만들기에서 설명 셀 추가를 누르세요. Markdown으로 연구 배경, 방법, 데이터, 분석, 한계 등을 필요한 위치에 작성합니다. 결과와 설명 셀은 위·아래 버튼으로 이동하거나 데스크톱에서 이동 손잡이를 끌어 순서를 바꿀 수 있습니다. 결과 추가로 다른 재현성 페이지의 섹션을 가져올 수도 있습니다. 변경한 뒤 저장하세요. 결과 카드의 측정값은 이 편집기로 바꾸지 않습니다.

저장할 때 보고서 버전이 남습니다. 버전 이력에서 이전 내용을 확인하고 복원할 수 있으며, 복원도 새 버전으로 기록합니다. 다른 창에서 이미 수정했다면 현재 버전을 다시 확인해야 합니다. 셀에서 삭제한 결과는 보고서에서만 빠지고 원본 재현성 결과는 유지됩니다.

보고서를 저장한 뒤 AI 초안을 엽니다. 같은 연구실에서 현재 볼 수 있는 이전 자료·보고서를 선택하고 추가 지시를 적습니다. 이미지·저장된 코드 본문은 각각 포함을 선택한 경우에만 전달합니다. 링크만으로 외부 저장소·Colab 코드를 가져오지는 않습니다. 미리보기의 선택 수·전달 범위와 사용 정책을 확인한 뒤 요청합니다. 읽기와 미리보기는 AI 실행이 아닙니다. 실제 요청은 기존 AI 권한·일일 할당량·요청 정책을 사용합니다.

AI가 제목, 배경, 방법, 데이터 구성, 실험, 결과 해석, 한계와 토의 초안을 제안합니다. 근거가 없는 내용은 확인할 사항으로 남겨야 합니다. 완성된 초안에서 필요한 설명 셀과 제목만 선택해 적용하고 직접 검토하세요. 적용 전 보고서나 근거가 변경되면 예전 초안으로 덮어쓰지 않습니다. 이 셀 AI 보완은 해당 셀의 주제·분량을 유지해 편집 초안에만 반영하고 되돌릴 수 있습니다. 제목·다른 셀·결과 순서는 바꾸지 않으며, 보고서는 저장 버튼으로 확정합니다. 생성 중 수정했다면 비교 후 적용합니다. 실제 진행·경과 시간을 표시하고 같은 작업을 이어 확인합니다. @멘션과 [[자료·보고서 인용]]은 새로 추가한 셀에서도 사용할 수 있으며 인용 원문은 현재 권한으로 확인합니다. 실제 학습·추론·독립 검증을 수행하는 기능은 아닙니다.

본인 결과 카드 또는 상세 화면의 ⋯ → 휴지통으로 이동을 선택합니다. 참조 보고서·진행 중인 Notion 전송에 미칠 영향을 확인한 뒤 이동합니다. 목록·검색과 일반 조회에서 숨겨지지만 결과 ID, 버전, 이미지, 참조 이력은 유지됩니다. 휴지통에서 복원하면 같은 ID로 돌아옵니다. 다른 사용자의 비공개 결과를 관리 권한만으로 열 수는 없습니다.

휴지통 결과는 SDK 재전송으로 자동 복원되지 않습니다. result_trashed 오류가 나면 플랫폼에서 본인 결과를 명시적으로 복원하고 재전송하세요. 진행 중인 Notion 전송은 확인이 필요하며 외부 사본을 자동 삭제하지 않습니다. 원본 접근이 종료되거나 휴지통에 들어간 경우 이를 참조하는 보고서·AI·내려받기도 현재 권한을 다시 검사합니다. 완전 삭제로 연구 증거를 지우는 기능은 제공하지 않습니다.