실제 화면으로 보는
OverStudio 사용법

간단설명: 처음 쓰는 사용자는 Easy로 시작하고, 모든 진단/패키징/고급 도구가 필요할 때 Pro로 돌아오면 됩니다.

• Easy는 Pro보다 작은 간단 편집 창으로 전환되어 대상, 캡처, 조건, 저장, 실행 흐름만 보여줍니다.
• 커스텀 탭, YOLO 학습 버튼, 루프 확장, 액션 상세 폼, 고급 진단 버튼, 하단 파일 도구줄은 잠시 숨기되, 기본 동작 선택과 액션 목록은 남깁니다.
• Pro는 기존 OverStudio 화면 그대로이며 Match, Time, Fail, Pack, C++ 같은 전체 기능을 사용할 수 있습니다.

간단설명: 튜토리얼 파일을 메모장에 띄운 뒤 대상 연결, 캡처, 클릭+, 테스트를 단계별로 안내합니다.

• 튜토리얼은 OverStudio를 Easy 모드로 전환하고 set/tutorial/overstudio_tutorial_target.txt를 메모장으로 엽니다.
• 메모장 창을 찾으면 대상창으로 자동 연결하고, 화면에는 현재 단계의 참고 구간을 하이라이트합니다.
• 튜토리얼 중에는 카드의 이전, 실행, 다음, 끝내기 버튼만 클릭할 수 있습니다.
• 카드 밖을 누르면 실제 조작은 막고 “튜토리얼대로 진행하세요” 안내 토스트가 짧게 나타났다 사라집니다.
• 캡처 단계는 튜토리얼이 메모장 화면을 자동 캡처해 이미지 스크립트로 추가합니다.
• 클릭+와 테스트 단계는 말풍선의 실행 버튼으로 바로 진행할 수 있어 첫 성공까지 이동 경로가 짧습니다.

간단설명: “클릭할 그림을 찍고, 그림이 보이면 중심을 클릭한다”를 가장 짧은 경로로 완성하는 흐름입니다.

• Easy 상단의 진행 표시는 대상, 캡처, 클릭, 실행 준비 상태를 한눈에 보여줍니다.
• 처음 버튼은 현재 빠진 단계를 판단해서 대상 선택, 이미지 캡처, 클릭 액션 추가, 테스트 중 다음 작업으로 안내합니다.
• 클릭+는 마우스 상세 설정창을 열지 않고 이미지 중심 좌클릭 액션을 즉시 추가합니다.
• 테스트는 실제 START 전에 1회 진단 실행으로 이미지 인식과 클릭 준비 상태를 확인하는 용도입니다.

간단설명: 가장 먼저 만지는 곳입니다. 어떤 스크립트를 편집하는지, 실행 대상이 무엇인지 여기서 결정됩니다.

• 체크가 켜진 항목만 런타임이 반복 검사합니다.
• 선택한 항목의 미리보기와 액션은 오른쪽 편집 영역에 즉시 반영됩니다.
• 그룹, 폴더, 루프 레인 같은 구조가 붙으면 대규모 스크립트도 관리하기 쉬워집니다.

간단설명: “무엇을 찾을지”를 정하는 창구입니다.

• 이미지 추가와 이미지 편집은 이 기준 이미지를 교체하거나 보정하는 작업입니다.
• 이미지를 버리고 저장하면 이제 이미지 스크립트가 아니라 액션 스크립트 상태로 정리됩니다.
• YOLO 조건이 붙은 경우에는 일반 이미지 대신 학습 샘플/모델 쪽이 중심이 됩니다.

간단설명: 한 스크립트의 실제 의미를 만드는 곳입니다.

• 조건은 유사도, 엄격검증, OCR, YOLO 같은 인식 기준을 뜻합니다.
• 범위는 ROI이며, 화면 어디에서 찾을지를 결정합니다.
• 반응은 이미지 표시, 클릭, 입력, 스크립트, 로그 같은 액션 목록입니다.

간단설명: 편집이 끝났다면 결국 여기로 내려옵니다.

• New / Open / Save는 작업 파일 관리입니다.
• Scan / Fix / Diag / Pack은 실행 전 누락, 복구, 호환성, 패키징 점검입니다.
• Match / Time / Fail / Vars는 인식 점수, 실행 타임라인, 실패 진단, 변수 상태를 확인합니다.
• Box / Qual / Ship / Safe / Coach / Sim은 블랙박스, 품질검사, 릴리즈 체크, 자동저장, OCR/YOLO 코치, 무입력 시뮬레이션입니다.
• Dash / Map / Tune / Clean은 운영 대시보드, 스크립트 연결 맵, 튜닝 추천, 생성물 정리입니다.
• Perf / Env / Clip / Audit은 실행 성능, 환경 준비도, 프로세스 간 복붙, 최근 변경 감사를 확인합니다.
• Asset / Drift / Guard / Sec은 자산 누락, ROI 이탈, 액션 위험요소, 배포 민감정보를 점검합니다.
• Flow / Delay / Bind / Dry는 실행 순서, 딜레이 예산, 변수 계약, 패키지 드라이런을 확인합니다.
• C++는 이미지 매칭/대상창 캡처/런타임 코어 hot path의 네이티브 DLL 가속 상태를 확인합니다.
• START / STOP / PAUSE는 런타임 제어이며 실전 운용 시 가장 자주 누릅니다.

간단설명: 버튼, 아이콘, 메뉴, 바탕화면 오브젝트 클릭용입니다.

• 이미지 중심 기준, 특정 오프셋, 고정 좌표, 드래그 시작/끝 좌표 같은 옵션을 조절할 수 있습니다.
• 대상 프로그램이 비활성클릭을 막는 경우엔 활성클릭이 더 잘 맞습니다.
• 전체 모니터 대상은 내부적으로 화면 좌표 기준 입력 경로를 사용합니다.

간단설명: 로그인, 검색창 입력, 단축키 입력에 좋습니다.

• {CTRL_DOWN}a{CTRL_UP}{ENTER} 같은 토큰식 입력이 가능합니다.
• 최근 수정으로 토큰 텍스트는 잘못된 Python으로 해석되지 않고 키보드 입력으로 처리됩니다.
• 입력 전/후 지연, 반복 간격, 랜덤 지연을 세밀하게 조절할 수 있습니다.

간단설명: 고급 로직이나 변수 처리용입니다.

• OVER.ImageSearch(), OVER.Mouse(), OVER.Keybd(), OVER.GetRuntimeValue() 등을 조합할 수 있습니다.
• OCR 결과, YOLO 결과, 런타임 상태를 코드로 읽어 후속 액션을 더 똑똑하게 만들 수 있습니다.
• 로그 액션과 같이 써서 실제 흐름을 추적하면 디버깅이 쉬워집니다.

간단설명: 흐름을 읽기 좋게 만들고, 순서를 안정화하는 데 필수입니다.

• 로그는 현재 어느 액션까지 왔는지 바로 추적하는 데 가장 강력합니다.
• 딜레이는 화면 전환과 사람 같은 간격을 만드는 기본 장치입니다.
• 인식 전환/인식 순서 변경 액션을 쓰면 대규모 스크립트도 단계형으로 운용할 수 있습니다.

간단설명: 실행 전에 오류를 줄이는 가장 값싼 보험입니다.

• Save는 현재 XML과 연결 상태를 저장합니다.
• Scan은 누락된 이미지 경로, 모델 경로, 구조 문제를 찾는 데 유용합니다.
• Fix는 복구 가능한 항목을 정리해 주므로 패키지 이동 뒤 특히 좋습니다.

간단설명: “왜 안 되지?” 싶을 때 가장 먼저 열어볼 창입니다.

• 비활성 입력이 막히는지, 활성 입력이 필요한지 감을 잡을 수 있습니다.
• YOLO 모델 경로, 샘플 이미지, OCR 런타임 준비 상태도 함께 확인합니다.
• 판매용 패키지 내보내기 전 마지막 점검으로 특히 좋습니다.

간단설명: 디버깅의 중심입니다.

• 유사도, OCR 결과, YOLO 점수, 입력 성공/실패가 로그에 남습니다.
• 로그 연결 추적으로 어떤 문구가 어느 액션에서 나온 것인지 바로 역추적할 수 있습니다.
• 중요한 스크립트에는 직접 로그 액션을 넣어 단계별 상태를 남기는 습관이 좋습니다.

간단설명: 클릭이 안 되는 문제는 대부분 여기와 관련 있습니다.

• 일반 앱은 비활성 입력이 잘 먹는 경우가 많고, 바탕화면/전체 모니터는 활성 입력이 더 잘 맞습니다.
• 보장 클릭, 재시도, 안정화 옵션을 조절하면 까다로운 창도 조금 더 다룰 수 있습니다.
• 실행 로그에는 내부 구현값 대신 활성클릭/비활성클릭만 표시됩니다.

간단설명: 고객 PC에서 “왜 안 눌렀는지”를 되짚는 기록 장치입니다.

• 인식 실패가 발생하면 일정 간격으로 ROI 화면 스냅샷을 저장합니다.
• 점수, 기준값, ROI, 실패 사유가 같이 남아 지원 리포트에도 포함됩니다.
• 실제 클릭을 재실행하지 않고 문제 상황을 리플레이처럼 확인하는 용도입니다.

간단설명: Scan보다 판매/운영 관점에 가까운 품질 점검입니다.

• 누락 이미지, 외부 경로, 낮은 유사도, 큰 ROI, 액션 없는 활성 스크립트를 봅니다.
• OCR 색상 규칙, YOLO 모델/샘플 경로, confidence 기준도 같이 점검합니다.
• 점수가 낮으면 Pack 또는 암호화 배포 전에 먼저 고치는 편이 좋습니다.

간단설명: 내보내기 전에 보는 출고 전 검사표입니다.

• 품질 점수, 실행 전 점검, 호환성 진단, 패키지 스크립트 개수, 썸네일 상태를 봅니다.
• 오류가 남아 있으면 출고 보류로 판단하고, 경고는 사용자가 납득 가능한지 확인합니다.
• 암호화/기간 설정과 지원 리포트 준비 여부도 같이 안내합니다.

간단설명: 작업 파일을 날리는 불안을 줄이는 안전장치입니다.

• 앱 실행 중 60초마다 현재 스크립트 자동 저장본을 갱신합니다.
• 강제 종료 후 자동 저장본이 원본보다 최신이면 복구 여부를 물어봅니다.
• 복구 전 기존 원본은 백업 흐름을 거치므로 되돌릴 여지를 남깁니다.

간단설명: YOLO가 25~40%에 머물거나 OCR이 흔들릴 때 먼저 봅니다.

• YOLO 모델 파일, 대표 샘플 이미지, confidence 기준, 의존성 준비 상태를 확인합니다.
• OCR 문자색 Pick, 배경 제거, 변수명, 허용 문자 설정을 점검합니다.
• 최근 Match 기록의 평균 점수도 같이 보여줘 재학습/조건 조정 판단에 도움을 줍니다.

간단설명: 위험한 프로그램에 바로 클릭을 보내기 전 테스트하는 기능입니다.

• 이미지, OCR, YOLO 조건을 현재 화면 기준으로 검사합니다.
• 통과한 스크립트는 실제 START에서 액션 실행 후보가 됩니다.
• 입력은 보내지 않으므로 좌표와 조건만 안전하게 확인할 수 있습니다.

간단설명: 지금 프로젝트가 실행 가능한 상태인지 빠르게 보는 요약판입니다.

• 스크립트 품질 점수와 활성 항목 수를 요약합니다.
• 대상창 선택 여부, 최근 인식 실패 수, 블랙박스 이벤트 수를 같이 보여줍니다.
• 안정성 프로파일과 자동 저장 상태도 한 번에 확인할 수 있습니다.

간단설명: 스크립트가 많아질 때 끊긴 연결을 찾기 위한 지도입니다.

• E:script.xml|Image_1 형태의 연결 토큰을 해석합니다.
• 연결 대상이 현재 런타임 목록에 없으면 경고로 표시합니다.
• 외부에서 호출되지 않는 항목 수도 요약해 대규모 작업 정리에 도움을 줍니다.

간단설명: 수치를 무작정 바꾸기 전에 원인을 분류하는 기능입니다.

• 이미지 점수가 기준값 주변에서 흔들리는지, 0%로만 나오는지 구분합니다.
• YOLO 평균 confidence가 낮으면 학습 데이터 보강 방향을 제안합니다.
• OCR 평균 신뢰도가 낮으면 문자색, 배경 제거, 허용 문자 설정을 먼저 보라고 안내합니다.

간단설명: 작업 원본은 건드리지 않는 보수적인 정리 도구입니다.

• 블랙박스는 14일, 자동저장은 30일, 지원 리포트는 30일 이전 파일을 대상으로 합니다.
• 현재 최신 자동저장본은 삭제하지 않습니다.
• 앱이 만든 안전 경로 안의 파일만 삭제하고, 스크립트/이미지/패키지 원본은 삭제하지 않습니다.

간단설명: “느린 것 같은데 어디가 느린지”를 확인하는 실행 흐름 계기판입니다.

• START 후 런타임 사이클마다 간격, 로그 수, 인식 판정 수, 실행 액션 수를 자동 기록합니다.
• 평균 사이클 간격이 느리면 큰 ROI, 많은 조건, YOLO/OCR 조건을 점검하라고 안내합니다.
• 최근 Match 성공/실패 흐름도 같이 보여줘 Fail/Tune으로 이어서 확인하기 좋습니다.

간단설명: 실행 전에 PC 환경이 준비됐는지 보는 사전점검입니다.

• 현재 스크립트가 실행기 내부 루트에 있는지 확인해 패키징/복구 안정성을 높입니다.
• 대상창 또는 전체 모니터 선택 상태와 캡처 방식을 요약합니다.
• START/STOP/PAUSE 핫키 중복, OCR 엔진, YOLO/SAM 의존성 상태를 같이 점검합니다.

간단설명: OverStudio 여러 개를 띄워도 스크립트 복붙이 되는지 확인하는 창입니다.

• 내부 클립보드와 시스템 클립보드의 이미지/폴더/파일 포함 상태를 나눠 보여줍니다.
• 시스템 클립보드에 OverStudio 전용 데이터가 있으면 다른 프로세스에서도 Paste가 가능합니다.
• 이미지 파일 포함 항목은 전용 MIME과 텍스트 백업 포맷으로 같이 저장됩니다.

간단설명: 출고 직전 “방금 뭐가 바뀌었지?”를 빠르게 보는 변경 이력표입니다.

• 실행기 내부 action 작업 폴더 기준으로 XML, 이미지, YOLO 모델, JSON/Lua 파일을 검사합니다.
• 최근 수정 시간, 상대 경로, 파일 크기를 보여주며 원본 파일은 절대 수정하지 않습니다.
• 24시간 내 변경 파일 수를 요약해 패키징 전 최종 확인에 도움을 줍니다.

간단설명: 패키지 안에 필요한 파일이 다 들어갔는지 보는 자산 목록표입니다.

• 스크립트가 참조하는 이미지, YOLO 모델, 샘플 이미지, 키보드 액션 스크립트를 모읍니다.
• 실제 작업 폴더 파일과 비교해 누락 파일과 미사용 후보 파일을 나눠 표시합니다.
• 용량이 큰 미사용 모델/이미지는 경고로 보여주며, 원본 파일은 삭제하지 않습니다.

간단설명: 캡처 당시 화면과 지금 화면이 달라져서 클릭이 안 되는 상황을 찾습니다.

• 저장된 대상창 크기와 현재 대상창 또는 전체 모니터 크기를 비교합니다.
• 각 이미지 조건의 ROI가 현재 화면 밖으로 나가거나 지나치게 큰 경우를 경고합니다.
• 해상도/DPI/창 크기 변경 후 인식률이 흔들릴 때 먼저 확인하면 좋습니다.

간단설명: 고객 PC에서 과도하게 클릭하거나 엉뚱한 위치를 누를 위험을 미리 봅니다.

• 반복 클릭 수가 많거나 입력 간격이 너무 짧은 액션을 경고합니다.
• 현재 대상 영역 밖으로 나가는 고정 좌표/드래그 좌표를 찾아줍니다.
• 액션 스크립트 파일 누락과 고위험 코드 호출 후보도 함께 표시합니다.

간단설명: 판매용 패키지에 개인 토큰이나 테스트 URL이 섞이지 않았는지 보는 검사입니다.

• XML, JSON, Lua/Python, 설정 파일에서 token/password/api key/webhook 후보를 찾습니다.
• 텔레그램 봇 토큰과 외부 URL 후보도 감지하며 값은 일부 마스킹해서 보여줍니다.
• 파일은 수정하지 않으므로, 확인 후 사용자가 직접 제거하거나 서버 연동 방식으로 옮기면 됩니다.

간단설명: 만든 스크립트가 어떤 순서로 흘러가는지 보는 동작 목차입니다.

• 각 스크립트를 IMAGE/OCR/YOLO/ACTION 조건으로 구분해 표시합니다.
• 활성 액션 수, 실행 간격, 액션 순서, 비활성 액션을 한 줄 흐름으로 확인합니다.
• 인식 전환/인식 순서 변경 액션은 연결 대상 스크립트와 태그를 함께 보여줍니다.

간단설명: 고객이 보기엔 멈춘 것처럼 느껴지거나 너무 빠르게 입력되는 문제를 찾습니다.

• 딜레이 액션과 랜덤 딜레이를 합산해 스크립트별 예상 대기 시간을 보여줍니다.
• 반복 마우스 입력의 대기 시간과 반복 수가 큰 항목을 표시합니다.
• 인식 간격이 지나치게 짧은 조건도 경고해 CPU 부하와 입력 누락 가능성을 줄입니다.

간단설명: 커스텀 UI, OCR, 스크립트 입력이 주고받는 변수 이름을 정리합니다.

• OCR 설정에서 저장하는 변수명을 수집하고 중복 생산 여부를 표시합니다.
• 액션 스크립트 안의 OVER.get, OVER.set 계열 사용 흔적을 찾아줍니다.
• 생산자 없이 사용되는 변수는 커스텀 UI 또는 외부 공급 가능 항목으로 안내합니다.

간단설명: ZIP/암호화 패키지를 만들기 전에 핵심 파일 목록만 미리 보는 검사입니다.

• 현재 런타임 스크립트, 이미지, YOLO 모델, 샘플, 액션 스크립트를 포함 후보로 계산합니다.
• 누락 파일과 100MB 이상 대용량 파일을 분리해 표시합니다.
• 실제 패키지를 생성하지 않으므로 출고 직전 안전하게 여러 번 확인할 수 있습니다.

간단설명: “C++화가 켜져 있는지”를 확인하는 상태 창입니다.

• 동일 이미지 100% 탐색과 마스크 동일 탐색을 C++ DLL export로 우선 실행합니다.
• RGB/명암 구조 점수, 게이지 계산, 좌표 매핑 export와 ABI 버전을 표시합니다.
• 대상창 ROI 캡처 export 상태와 thread buffer 크기를 함께 표시합니다.
• ROI가 지정된 캡처는 전체 창을 뜬 뒤 자르는 대신 C++ 단계에서 필요한 영역만 직접 캡처합니다.
• 런타임 코어 DLL의 ABI 버전과 윈도우 핸들, 비활성 입력, 토글/순서, 액션 파라미터 해석 export 그룹을 표시합니다.
• 코어 DLL 빌드 스크립트는 새 DLL 빌드 성공 후에만 실제 DLL을 교체하므로 실패 시 기존 실행 DLL을 보존합니다.
• 빌드 성공 시 manifest JSON을 남겨 ABI, 빌드시각, 파일 크기, SHA-256 앞자리를 진단창에서 확인할 수 있습니다.
• manifest에 기록된 파일 크기와 SHA-256을 실제 DLL과 비교해 파일 불일치 또는 오래된 pending DLL을 경고합니다.
• 상단 헬스 요약에서 정상/주의 상태와 권장 조치를 먼저 보여줘 DLL 잠금, export 누락, manifest 불일치를 빠르게 판단합니다.
• Report 지원 리포트에는 native_status.json이 함께 들어가 원격 지원 시 DLL/manifest/pending 상태를 그대로 확인할 수 있습니다.
• 실행 전 점검과 호환성 진단에도 네이티브 헬스가 warning으로 연결되어 START 전/출고 전 상태를 미리 확인합니다.
• 실행 중이라 DLL 교체가 잠기면 *.pending.dll 대기 파일을 남기고, 다음 로드 시 자동 승격을 시도한 뒤 결과를 표시합니다.
• 앱을 완전히 종료한 뒤 python apply_pending_native_dlls.py --dry-run으로 확인하고 python apply_pending_native_dlls.py로 pending DLL을 백업 후 수동 적용할 수 있습니다.
• python apply_pending_native_dlls.py --wait-seconds 600을 사용하면 앱이 닫히는 순간까지 기다렸다가 잠금이 풀리면 자동 적용합니다.
• 마지막 pending 적용 시도 결과는 dll/native_pending_apply_report.json에 저장되며, C++ 진단창과 지원 리포트에서 바로 확인할 수 있습니다.
• 실행 전 점검과 지원 리포트처럼 짧은 시간에 상태를 여러 번 읽는 흐름은 1.5초 TTL 캐시를 사용해 DLL 해시/manifest 검증 반복을 줄입니다.
• 상태 수집 시간은 인식/캡처/코어/적용기록/헬스 단계별로 표시되어 네이티브 진단이 느릴 때 병목을 바로 볼 수 있습니다.
• 진단 전용 경량 로더가 cv2/numpy/PIL 초기화 없이 DLL export와 manifest만 확인해 C++ 상태 창을 더 빠르게 엽니다.
• 캡처 가속 상태도 인식 DLL export 목록을 재사용하는 경량 로더로 확인해 진단 중 PIL 초기화를 피합니다.
• 코어 DLL 상태는 PE export 테이블을 직접 읽는 경량 로더로 확인해 런타임 함수 전체 바인딩 비용을 줄입니다.
• 동점 후보가 여러 개면 C++ 경로에서도 ROI 중심부에 가까운 항목을 우선 선택합니다.
• DLL export가 없거나 로드에 실패하면 Python/OpenCV/GDI fallback으로 자동 전환됩니다.

간단설명: 팀 공유, 백업, 이동에 적합합니다.

• 현재 워크스페이스 구조와 메타 정보가 같이 저장됩니다.
• 패키지 가져오기 후에도 바로 작업을 이어가기 쉬운 형태입니다.
• 배포 전에는 YOLO 모델과 사운드/이미지 리소스가 내부 경로인지 확인하는 것이 좋습니다.

간단설명: 구매자용 배포판에 더 적합합니다.

• ID/비밀번호, 사용 기한, 최초 하드 등록, 자동 로그인 옵션을 붙일 수 있습니다.
• 읽기 전용 구조라 편집 화면이 바로 노출되지 않습니다.
• 현재 구조는 로컬 인증 중심이며, 서버 연동 전 완전한 원격 DRM까지는 아닙니다.

간단설명: 기능보다 “첫 실행 성공률”이 더 중요합니다.

• 패키지 제목, 설명, 버전, 썸네일을 꼭 넣어두세요.
• Scan, Diag, 실제 START 테스트를 끝내고 내보내는 것이 좋습니다.
• 고객이 쓰는 건 편집기가 아니라 실행 결과이므로, 필요하면 커스텀 UI까지 같이 준비하는 편이 좋습니다.

간단설명: 아래 순서대로 보면 대부분 빠르게 좁혀집니다.

• 1. 로그에서 인식 실패인지 입력 실패인지 먼저 분리합니다.
• 2. 인식 실패면 ROI, 이미지 품질, OCR/YOLO 조건을 봅니다.
• 3. 입력 실패면 대상창, 입력 방식, 활성/비활성 경로를 봅니다.
• 4. 마지막으로 Diag와 패키지 리소스 경로를 확인합니다.