MapleTools 2.2.71 공개판 · 2026-10-15

이번 수정과 추가 조사
- 과거 날짜 전투력 계산에서 당시 유효했던 훈련 일지 효과가 빠지는 버그 수정. 공식 기간(2026-06-18~09-23)과 응답의 실제 효과만 사용합니다. 현재·종료 후 계산에는 복원하지 않습니다.
- 9월 18일 묘패·주라미·째엔 독립 자료 3건이 API 전투력과 정수 단위로 일치합니다. 조회 날짜는 기본정보의 날짜를 기준으로 하며, 수집 시각과 구분합니다.
- 4개 캐릭터·21개 날짜별 요청(340회 호출)을 보관했습니다. 그중 넥타르의 8/30·9/2·9/4는 캐릭터 정보가 명시적으로 null이어서 계산할 수 없습니다.
- 묘패 10/8: 유니온 응답은 10/7과 같지만 캐릭터 스탯에서 유니온 효과가 빠져 있습니다. 유니온 기여분을 뺀 진단값만 API와 일치하며, 운영 계산에는 이 임의 제거를 적용하지 않습니다.
- 묘패 10/9 이후: 묘벤s C→B 승급과 올스탯20 오차 발생이 함께 관측됩니다. 갱신 시점 차이가 유력하지만 원인은 미확정입니다. 휘장·칭호·세트 효과를 임의로 빼지 않습니다.
- l넥타르l: 9/17~10/14의 능력치 원자료와 전투력은 같고, 만료일 경과로 계산값만 달라집니다. 9/17 접속 표시는 true, 이후 표본은 false입니다. 현재 약 -10.598088% 차이의 전체 원인은 미확정입니다.
- 기존 현재 전투력 산식과 불일치 시 프리셋 보류를 유지합니다. 조사용 출처 제거는 검색·계산 기능에 적용하지 않습니다.
- 51개 검사 통과. 검사 결과: CHECKS_2.2.71.txt. 원자료와 재현 도구: tests/fixtures/combat_dated_sources_20261015.json, tools/check_dated_combat_sources.py.
- 상세 조사: FOLLOWUP_2.2.71_DATED_SOURCES.json 및 FOLLOWUP_2.2.71_REPORT.md.

남은 검증
- 묘패 최신 오차 +449,113 및 l넥타르l 최신 오차 -12,749,228은 해결됐다고 판정하지 않습니다.
- 제논·데몬어벤져의 모든 스펙 및 실제 프리셋 전환 정확도는 미확정입니다.
- Windows 실기기 실행과 게임 내 실제 전환 검증은 수행하지 못했습니다.

공식 근거
훈련 일지 유효기간: https://maplestory.nexon.com/News/Update/805
챔피언 휘장 누적 효과: https://maplestory.nexon.com/News/Update/764

============================================================
이전 버전 기록
============================================================

MapleTools 2.2.48 공개판 · 2026-10-15

이번 수정
- 엔젤릭버스터 9/17 캐시 능력치 변경 반영: 일반 슬롯 무기·반지, 드레스 업 기본 슬롯 나머지 부위만 합산.
- 주라미·세상서럽 기존 오차와 째엔 추가 표본 오차가 API 전투력과 정수 단위로 일치.
- 직업 공통 만료 옵션·아티팩트 확인과 계산 내역 표시, 잘못된 날짜는 계산 보류.
- 검증 도구가 현재 전투력뿐 아니라 장비·캐시·하이퍼·어빌리티·유니온·아티팩트·스킬·안드로이드 입력을 재확인.
- 50개 검사 통과. 새 표본 24건 및 주요 입력 재조회 13건 기록.

남은 검증
- l넥타르l(일리움): 약 -10.598088%, 만료 자료 시점 차이 가능. 원인 미확정.
- 묘패(엔젤릭버스터): 약 +0.209525%, 원인 미확정.
- 제논·데몬어벤져의 모든 스펙과 실제 프리셋 전환 정확도는 미확정. 현재 API 전투력 검색은 지원.
- Windows 실기기 실행과 게임 내 실제 전환 검증은 수행하지 못함.
- 자세한 결과: IMPROVEMENTS_2.2.48_VALIDATION.json 및 FOLLOWUP_2.2.48_JOB_MATRIX_REPORT.md

공식 캐시 슬롯 규칙 근거
https://maplestory.nexon.com/News/Notice/Notice/150125

============================================================
이전 버전 기록
============================================================

MapleTools v2.2.47 공개판 — 장비 일치 보존·독립 복원·자동 수집 확대·백업 (2026-10-15)

- 조건에 맞는 장비를 확인하면 뒤쪽의 다른 장비나 낮은 우선순위 프리셋의 누락 때문에 전체 캐릭터를 미확인 처리하지 않습니다. 이름 등 확인된 독립 조건이 불일치하는 장비는 건너뜁니다. 우선순위가 높은 장비의 일치 여부가 불명확하면 재조회 및 미확인 처리를 유지합니다.
- 진행 기록과 검색 조건을 독립적으로 복원합니다. 진행 기록과 모든 백업을 읽을 수 없어도 정상적인 직전 검색 조건은 복원하며, 사용할 수 없는 이어하기/재조회 버튼은 활성화하지 않습니다.
- 자동 CSV/TXT 저장 실패는 검색 실패로 처리하지 않습니다. 확인 결과와 JSON 진행 기록은 정상적으로 저장하고 검색 완료/미완료 판정은 실제 조회 상태를 따릅니다. 결과 화면에 파일 저장 경고를 표시하며 수동 CSV 내보내기로 다시 저장할 수 있습니다.
- 장비/상세 검색의 후보 범위에 초기 페이지 한도, 자동 확대 여부, 최대 페이지를 추가했습니다. 기본은 초기 300페이지, 자동 확대 켬, 최대 3,000페이지입니다. 최대 5,000페이지까지 지정할 수 있습니다. 최초 한도 도달 시 두 배씩 늘려 이어서 조회하며 이전 페이지를 다시 조회하지 않습니다.
- 빈 페이지 또는 지정한 최저 레벨보다 낮은 페이지에서 수집을 멈춥니다. 지정한 최대 페이지에 도달하면 기존 수집 범위 제한 경고를 유지합니다. 상한 없는 수집을 하지 않습니다. 검색 조건 저장/불러오기와 초기화에도 수집 설정을 포함했습니다.
- 이름 붙인 검색 조건, 직전 실행 조건, 장비/상세 진행 기록을 원자적으로 저장하고 최신 저장본 미러(.bak)와 이전 유효본(.bak2)을 최대 두 개 보관합니다. 원본의 JSON/기록 형식이 깨지면 유효한 백업으로 복원하고 안내합니다. 둘 다 복구할 수 없으면 원본을 임의의 빈 기록으로 덮어쓰지 않습니다.
- 시작 시 최신 저장 결과를 자동 재검색하지 않습니다. 백업 복원은 저장 시점의 데이터이며 이어하기/실패 대상 재조회에서 필요한 현재 값을 다시 확인합니다. 프로그램 종료·재실행 복원은 같은 버전의 실행 폴더에 적용됩니다.
- 장비 판정 방식 변경으로 이전 버전의 진행 기록은 이번 버전에서 이어하기에 사용하지 않습니다. 저장 조건/사용자 목록 자동 이전은 유지합니다. 인증 키는 조건/진행 JSON 및 그 백업에 저장하지 않습니다.
- 이번 버전은 전투력 계산식을 변경하지 않았습니다. 기존 일리움/엔젤릭버스터 불일치 및 제논/데몬어벤져 보류 상태를 유지합니다. Windows 실기기 및 게임 내 실제 프리셋 전환 검증은 별도로 필요합니다.
- 검증 기록: IMPROVEMENTS_2.2.47_VALIDATION.json, LIVE_FEATURE_VALIDATION_2.2.47.json, CHECKS_2.2.47.txt

MapleTools v2.2.46 공개판 — 누락 검사·중단 복원·수집 범위 안내 (2026-10-14)

- 길드·생성년도·접속·해방 조건에 필요한 기본정보와 최신 재검증의 레벨·직업·월드·이름이 누락되면 캐시를 우회해 재조회합니다. 복구되지 않으면 조건 불일치로 확정하지 않고 미확인 대상으로 남깁니다.
- 소울 이름/효과/잠재/공격력/마력/증폭/활성, 익셉셔널 단계, 주문서 증가치의 필요한 항목을 검사합니다. 정상적인 명시적 null·0은 누락과 구분합니다.
- 장비 검색 중지 시 마지막 검사·결과를 체크포인트에 저장합니다. 재조회 중 중지되어도 원래 실패 대상 기록을 유지합니다.
- 최신 장비 검색 중단 기록을 자동 삭제하지 않습니다. 결과 화면의 '중단 검색 이어하기' 또는 같은 조건의 검색 시작에서 이어갈 수 있습니다. 미검사 대상을 먼저 확인하고 이전 일치·불일치·오류 대상을 현재 장비로 재검증합니다.
- 랭킹 300페이지 한도에 도달하면 수집 범위 제한 경고를 표시하고 기록에 보관합니다. 후보 검사가 끝나도 요청한 전체 레벨 범위를 확인했다고 표시하지 않습니다. ranking 항목이 누락된 응답을 정상적인 빈 페이지로 처리하지 않습니다.
- 재실행 시 직전 검색 조건·저장 결과·진행률·수집 범위 안내·실패 대상 재조회/이어하기 버튼을 복원합니다. 검색을 자동 시작하지 않습니다. 저장 결과에는 이전 조회값이라는 안내를 표시합니다.
- 복원 및 재조회/이어하기는 실행 당시 조건과 기준일을 사용합니다. 최신 검색의 캐릭터 정보는 다시 현재 API로 확인합니다. 화면의 입력값을 변경하거나 날짜가 바뀌어도 복원된 버튼은 직전 검색을 사용합니다. 새 검색은 현재 화면 입력으로 시작합니다.
- 인증 키는 직전 검색 조건 파일과 체크포인트에 저장하지 않습니다. 실행 때 내장 개인 키를 사용합니다. 이전 버전의 저장 조건/목록 자동 이전은 유지하며, 진행 기록과 결과는 같은 버전의 실행 폴더에서 복원합니다.
- 검색 누락 검사 방식이 바뀌어 이전 버전의 장비 체크포인트는 이어하기에 사용하지 않습니다. 이번 버전에서 실행한 검색부터 복원합니다.
- 전투력 계산식은 이번 버전에서 바꾸지 않았습니다. 미해결 일리움 1건·엔젤릭버스터 2건 및 제논·데몬어벤져의 기존 보류 상태를 유지합니다. Windows 실기기 시작과 게임 내 실제 프리셋 전환 검증은 별도로 필요합니다.
- 검증 결과는 IMPROVEMENTS_2.2.46_VALIDATION.json을 참고하세요.

MapleTools v2.2.45 공개판 — 실패 대상 재조회·결과 탐색·설정 이전 (2026-10-13)

- 장비 검색과 상세 검색에 “실패 대상만 재조회” 버튼을 추가했습니다. 직전 검색 조건과 수집 후보를 사용하며, 조회 오류·필수 데이터 누락·판정 불가 대상만 캐시를 우회해 확인합니다. 기존 확인 결과는 당시 조회값을 유지합니다.
- 오류가 남으면 “조회 미완료”와 미확인 인원수를 결과 화면에 표시합니다. 처리 진행 100%는 모든 후보를 시도했다는 뜻이며, 전원 판정 완료를 의미하지 않습니다. 검색 중지 상태도 확인된 결과만 표시된다는 안내가 남습니다.
- 상세 검색 체크포인트와 장비 검색 기록에 재조회 시각·대상·이전 실패·남은 실패 내역을 보관합니다. 복구된 대상은 후속 재조회에서 제외합니다. 재조회 도중 중지한 기록은 같은 조건의 검색으로 이어갈 수 있습니다.
- 장비 검색도 누락·부분 응답을 자동 재조회하며, 끝까지 확인할 수 없으면 조건 불일치로 처리하지 않습니다.
- 현재 기준일 입력이 잘못되어도 저장한 정상 조건을 불러올 수 있습니다. 손상된 저장 조건을 적용하다 실패하면 기존 입력과 날짜를 복원합니다.
- 결과에서 닉네임·직업·월드·장비명·길드로 검색합니다. 띄어쓴 검색어는 모두 포함되어야 합니다. 열 제목을 눌러 정렬하며 전투력·레벨·스타포스·유니온·HEXA 등은 실제 숫자로 정렬합니다.
- 정렬·필터링 중 결과가 추가되거나 갱신되어도 캐릭터 선택과 상세 정보가 일치합니다. CSV는 “전체 결과” 버튼에 표시한 대로 필터와 관계없이 전체 검색 결과를 저장합니다. 통계 역시 전체 확인 결과 기준입니다.
- 시작 시 이전 설치의 저장 조건과 사용자 장비/소울/HEXA 목록을 자동 이전합니다. 현재 폴더에 이미 있는 파일은 덮어쓰지 않습니다. 손상된 이전 파일은 건너뛰며 검색 체크포인트·API 캐시·인증 파일은 이전 대상에 포함하지 않습니다.
- 첫 업데이트는 이전 버전 폴더를 같은 상위 폴더에 두면 자동 감지합니다. 2.2.45 이후에는 마지막 실행 폴더도 기록하므로 다음 버전이 다른 위치에 있어도 해당 폴더가 남아 있으면 이전할 수 있습니다. 시작 화면 설정은 기존 공통 설정을 그대로 사용합니다.
- 검증: 구조/회귀 검사 40개, 실패·누락·불일치 혼합 반복 재조회, 실제 버튼 동선, 잘못된 날짜 복원, 정렬 후 상세/CSV 연결, 설정 이전 경계, 결과 5,000개 정렬·필터·갱신 시뮬레이션을 통과했습니다.
- 실제 API 동선 6종 통과: 장비 검색, 상세 API 전투력 검색, 프리셋 유추 방어 동선, 상세 프로필/계산, 날짜별 기록/외형, 유니온 챔피언 검색. 표본은 플위(플레임위자드, 크로아, Lv.300)입니다. 프리셋은 산출 불가 방어를 확인했으며 게임 내 착용 전환 일치를 검증한 것은 아닙니다.
- 전투력 계산식은 이번 버전에서 변경하지 않았습니다. 이전에 확인한 일리움 1건·엔젤릭버스터 2건의 차이는 미해결 상태를 유지합니다. Windows 실기기 시작과 게임 내 실제 프리셋 착용 전환은 이 환경에서 검증하지 못했습니다.
- 검증 기록: IMPROVEMENTS_2.2.45_VALIDATION.json / LIVE_FEATURE_VALIDATION_2.2.45.json

MapleTools v2.2.44 공개판 — 이어검색 누락·부분 응답·조건 저장·제로 보정 (2026-10-13)

- 현재 검색을 이어서 실행하면 미검사 대상을 먼저 확인하고, 이전 일치·불일치 대상을 모두 현재 입력으로 다시 검증합니다. 이전 대상은 캐시를 우회합니다. 갱신 전에 찾은 결과를 그대로 표시하지 않습니다.
- 조회 오류와 필수 항목 누락은 검사 완료로 기록하지 않아 과거 날짜 검색의 이어하기에서도 다시 확인합니다. 저장한 이어하기 기록이 있으면 완료된 대상이 0명이어도 이어하기 가능으로 표시합니다.
- 상세 검색의 장비·HEXA 응답 검사에 목록·코어 이름/종류/레벨·요청한 장비 필드·HEXA 스탯 단계 검사를 추가했습니다. 필요한 정보가 누락되면 한 번 재조회하며, 정상적인 빈 목록·0·비어 있는 프리셋은 정보 누락과 구분합니다.
- 장비 검색과 상세 검색에 이름으로 검색 조건 저장/불러오기/삭제를 추가했습니다. 장비명·잠재/에디/추옵·소울·범위·프리셋 선택·HEXA 조건 등을 복원하며 두 검색의 저장 목록은 분리합니다. API 키와 결과 목록은 저장하지 않습니다.
- 최신 날짜로 저장한 조건은 불러올 때 최신 기준일을 다시 사용하고, 과거 날짜는 고정합니다. 잘못된 저장 조건은 적용 전 상태로 복구하고 손상된 저장 파일을 덮어쓰지 않습니다. 저장 조건은 user_data/saved_searches.json에 기록되므로 새 버전으로 옮길 때 user_data 폴더를 유지하세요.
- 제로 아스트라 아워글라스 착용 시 대체된 보조 라피스/라즐리 옵션을 중복 합산하지 않도록 수정했습니다. 아워글라스 자체 능력치는 합산하며, 2026-06-18 이후에는 공식 전투력 제외 항목인 기본 보공을 빼고 잠재 보공은 유지합니다.
  공식 근거: https://maplestory.nexon.com/News/Update/794 및 https://maplestory.nexon.com/News/Update/806
- 제로 안깜찍 2회 수집 입력: 기존 계산 315,348,444(+22.496364%) → 수정 후 257,434,943(API와 정수 일치). 캐릭터 이름이나 표시 전투력으로 보정 계수를 선택하지 않습니다.
- 과거 일반 직업 잔여 7건은 개별 닉네임/원자료가 보관돼 있지 않아 동일 7건의 해결 여부를 판단할 수 없습니다. 해당 5직업을 새로 8명씩 총 40명 수집하고 불일치 4명을 다시 전체 조회했습니다. 수정 후 34명 일치·3명 불일치·3명 보류입니다. 남은 일리움 l넥타르l, 엔젤릭버스터 주라미·세상서럽의 불일치는 미해결로 보존합니다.
- 만료 캐시 옵션 복원과 예비 반지 제외를 진단용으로 비교했으나 남은 불일치를 모두 설명하지 못했습니다. 검증되지 않은 역산 수치나 만료 효과를 현재 계산에 반영하지 않습니다.
- 직업별 검증 화면의 저장 표본을 최신 40명 재조사 입력까지 통합했습니다. 서로 다른 검증의 표본 구성을 구분하며 전체 캐릭터 정확도를 보장하지 않습니다.
- 실제 API 동선 6종 통과(플위, Lv.300, 크로아, 전투력 347,900,320). 장비·전투력·유니온 검색 대상 결과를 확인했고 계산 내역은 정수 일치했습니다. 프리셋 경로는 산출 불가 방어를 확인했습니다.
- 상세 결과: IMPROVEMENTS_VALIDATION_20261013.json / GENERAL_RECHECK_ANALYSIS_20261013.json
- 구조 및 검사 파일 38개 통과. 저장 UI 실제 버튼 동선, 조건 복원, 날짜 정책, 중단 전 오류/누락/불일치가 복구되는 시나리오와 장비/HEXA 부분 응답 복구를 확인했습니다. 기존 일반 직업 46종·109개 정수 일치 회귀도 유지합니다.
- Windows 실기기 시작과 게임 내 실제 프리셋 착용 전환은 검증하지 않았습니다. 제논·데몬어벤져 프리셋 예상 검색 제외, 기본 API 전투력 검색, 검색 기본값 전체와 프리셋 유추 기본 해제를 유지합니다.

MapleTools v2.2.43 공개판 — 검색 누락·이어하기 재검증·직업별 검증 표시 (2026-10-13)

- 상세 검색에서 API 응답은 있지만 필요한 전투력·스타포스·심볼·유니온 항목이 빠진 경우도 캐시를 우회해 한 번 재조회합니다.
- 빈 스탯 목록, 숫자가 아닌 값, 일부 항목 누락을 조건 불일치와 구분합니다. 재조회 후에도 없으면 데이터 누락 사유와 미복구 건수를 표시합니다. 정상적인 0은 누락으로 처리하지 않습니다.
- 최신 검색 이어하기 시 저장된 일치 결과는 현재 조건으로 다시 검증합니다. 중단 중 전투력이나 장비가 바뀐 캐릭터의 이전 결과를 그대로 표시하지 않습니다. 과거 날짜 검색은 기존 이어하기 동작을 유지합니다.
- 상세 검색 전투력 영역과 계산 내역에 직업별 검증 보기 버튼을 추가했습니다. 48직업의 저장 표본 수·정수 일치·차이·보류·기본 계산 관측 오차·관측일과 프리셋 사용 조건을 확인할 수 있습니다.
- 직업·캐릭터별 가장 최근 보관 입력을 중복 없이 재검산한 160개 특정 표본을 사용합니다. 앞서 수행한 384명 다표본 검증과 표본 구성이 다르며, 전체 캐릭터의 정확도나 보장 범위를 뜻하지 않습니다.
- 제논의 구형 자료와 큰 오차 사례, 데몬어벤져 참고 추정 67명의 전체 관측 오차를 숨기지 않고 표시합니다. 두 직업은 다른 프리셋 전투력 검색에서 계속 제외합니다.
- 계산 내역의 오차율을 소수점 6자리로 표시하고 복사 내역에도 검증 기록을 포함합니다.
- 전투력 계산식과 검색 기본값은 유지합니다. 기본 검색은 API 전투력이며 프리셋 전투력 유추는 기본 해제입니다.
- 구조 및 검사 파일 35개 모두 통과했습니다. 추가 검색 신뢰성 시나리오 8개도 통과했습니다.
- 실제 랭킹 표본 메뿌엥(미하일, Lv.294, 루나, API 전투력 177,365,410) 한 명의 API 동선 6종을 확인했습니다. 장비·상세 API 전투력·유니온 검색에서 대상 결과를 확인했고, 계산 내역은 정수 일치했습니다. 프리셋 예상 검색은 산출 불가 방어 경로를 통과한 것으로, 다른 프리셋의 실제 착용 일치를 검증했다는 뜻은 아닙니다.
- 상세 기록: RESUMED_VALIDATION_20261013.json
- 개발 검사는 python tools/run_all_checks.py로 한 번에 실행합니다. 소스 경로와 Qt 실행 환경을 자동 설정해 개별 검사 파일의 실행 경로 차이를 해소했습니다.
- 이번 수정은 Linux에서 검사했습니다. Windows VBS/부트스트랩 실기기 실행과 게임 내 실제 프리셋 착용 전환은 별도로 확인하지 않았습니다.

MapleTools v2.2.42 공개판 — 검색 기본값·검증 상태·복구 개선 (2026-10-12)

- 장비 검색기와 상세 캐릭터 찾기의 직업 대분류·세부 직업·월드 기본값을 모두 `전체`로 통일했습니다.
- 장비명 검색은 최초 실행과 기본값 초기화 모두 `이름 포함`으로 통일했습니다.
- 상세 결과에 `전투력 기준`과 `검증 상태` 열을 추가해 API 실제값·일반 직업 프리셋 추산·미조회 상태를 바로 구분합니다.
- 필수 API 응답이 비어 있으면 캐시를 우회해 한 번 자동 재조회하고, 재조회·복구·미복구 건수와 주요 제외 사유를 표시합니다.
- 상세 검색 진행률에 완료 인원과 예상 남은 시간을 표시합니다.
- 상세 검색을 중지하거나 오류가 발생해도 완료 후보와 결과를 저장하고, 같은 조건으로 다시 시작하면 이어서 검색합니다. API 키는 이어하기 기록에 저장하지 않습니다.
- 전투력 계산 내역에 이벤트·세트·장비 고유 옵션·투사체 가정·만료 장비를 한눈에 확인하는 요약을 추가했습니다.
- 선택 기능 2건, 전체 기존 테스트 파일 31개, 실제 API 사용자 동선 6종을 모두 통과했습니다.
- requests가 없는 환경에서도 내장 urllib로 바로 실행하도록 첫 실행 부트스트랩을 수정하고, Qt 시작 진단을 통과했습니다.

MapleTools v2.2.41 공개판 — 48직업 다표본·전 기능 실검증 (2026-10-12)

- 등록한 API 키로 48직업을 직업당 8명씩, 총 384명(전투력 약 0.3억~15억) 최신 실표본으로 재검증했습니다.
- 일반 직업 안정 표본 356개 중 296개는 기본 정수 일치, API가 제공하지 않는 화살·표창·불릿 공격력 선택으로 19개를 추가 재현했습니다.
- 만료된 `훈련 일지`가 API에 남은 과거 스냅샷 4개는 잔존 효과를 진단용으로 복원하면 정확히 재현됩니다. 현재 프리셋 예상에는 다시 더하지 않고 갱신 시점 경고를 표시합니다.
- `환영의 마법`·`메이플 스위츠`의 API 표시 공마·올스탯·보공을 반영해 해당 표본의 오차를 줄였습니다. 나머지 규칙은 미확정으로 남겼습니다.
- 용연도·드래고닉 용연도의 API 설명에 누락된 듀얼블레이더 고유 크리티컬 데미지 10%를 아이템 규칙으로 반영했습니다.
- 데몬슬레이어의 루인 포스실드 최종 데미지 10% 배율을 데몬어벤져에만 적용하던 누락을 수정했습니다.
- 유니온 챔피언 실검색에서 결과를 낸 뒤 `time` 이름 오류로 중단되던 문제를 수정했습니다.
- 다표본의 입력 시점을 다시 조회한 결과, 히어로·루미너스·비숍 3건은 계산식 수정 없이 API 값이 갱신되어 정확히 일치했습니다.
- 장비 필터 전 종류, 유니온 조합 1,000건 독립 대조, 5,000행 통계, 모든 화면 이동, CSV·PNG·PDF·장비 이미지 내보내기를 오프라인에서 시뮬레이션했습니다.
- 실API로 장비 검색, 상세 API 전투력 검색, 프로필·계산 내역, 타임라인·코디, 유니온 챔피언을 직접 통과했습니다. `프리셋 전투력 유추`는 여전히 기본 해제이며, 제논·데몬어벤져는 선택 검색에서 제외합니다.
- 일반 직업 잔여 불일치 7개와 제논 1개, 데몬어벤져 산식은 미확정입니다. 불일치를 임의 보정하지 않고 현재 장비 검색은 API 전투력을 사용합니다.
- 상세 결과: FULL_FEATURE_VALIDATION_20261012.json

MapleTools v2.2.40 공개판 — 프리셋 전투력 검색 선택 적용 (2026-10-12)

- 상세 검색의 전투력 범위 아래에 `프리셋 전투력 유추` 체크박스를 추가했습니다. 기본값은 체크 해제입니다.
- 체크 해제 시 넥슨 API 전투력만 검색합니다. 장비 조건이 다른 프리셋에서 일치해도 전투력은 API 값을 사용합니다.
- 체크 시 현재 장비는 API 전투력을 사용하고, 다른 장비 프리셋은 현재 하이퍼·어빌리티·유니온을 유지한 예상값으로 검사합니다.
- 현재 공개 옵션 계산이 API 전투력과 정수 단위로 일치하고 기존 장비·칭호·세트·안드로이드 검증을 통과한 일반 직업만 프리셋 예상값을 사용합니다.
- 제논·데몬어벤져는 표본별 오차가 커 프리셋 예상값 검색에서 제외했습니다. 두 직업의 현재 API 전투력 검색은 그대로 지원합니다.
- 결과와 CSV에 사용 전투력, 원래 API 전투력, 전투력 기준, 장비 프리셋 출처를 기록합니다. 최신 검색의 최종 후보는 전체 입력을 다시 조회합니다.
- 체크 모드는 전체 공개 옵션을 추가 조회하므로 API 전투력 전용 검색보다 느릴 수 있습니다.
- 기존 일반 직업 46종·109개 API 표본 정수 일치, 제논 29개 검사, 데벤 참고 추정/UI, 프리셋 방어조건, 검색 우선순위, 성능 회귀를 통과했습니다.
- Windows 네이티브 실행과 실제 프리셋 착용 전환 시험은 수행하지 않았습니다.
- 상세 기록: PRESET_COMBAT_SEARCH_VALIDATION_20261012.json

MapleTools v2.2.39 공개판 — 제논 구형 자료 임시 추정 (2026-10-08)

- 사용자 요청에 따라, 완전 일치 전이라도 관측 오차가 줄어드는 제논 임시 추정식을 반영했습니다.
- 확인 가능한 일반 심볼이 모두 개편 전 수치이고 기존 보정식의 저구간(step=0)에 해당할 때만
  공통 계수 2.975를 적용합니다. 캐릭터 이름이나 API 전투력으로 적용 여부·계수를 고르지 않습니다.
- 심볼·유니온·장비·HEXA 원본 입력은 그대로이며, 빈 유니온을 채우거나 만료 버프를 되살리지 않습니다.
- 계산 내역에 '구형 자료 추정 · 미검증'과 API 대비 차이, 적용 전 계산값·오차율을 함께 표시합니다.
- 2026-10-08 저장된 동일 입력 7명: 평균 절대오차 30.2234% → 11.4531%, 7명 모두 개선.
  적용 후 관측 오차는 -31.5025% ~ +8.8089%. 독립 검증·보장 범위가 아닌 선택에 사용한 표본의 결과입니다.
- 정확 일치 수는 늘지 않았습니다. 기존 38명은 23명 일치·9명 불일치·6명 보류로 유지됩니다.
- 조건 밖의 계산 결과는 동일하며, 검색·필터는 계속 API 전투력을 사용합니다.
  자료 시점 불일치가 있는 프리셋 계산은 계속 보류합니다.
- 제논 테스트 29개, 안드로이드 5개, 일반 직업 109개/46직업 검산 통과.
  Windows 네이티브 실행과 실제 장착 변경 실험은 수행하지 않았습니다.
- 이번 수치 비교는 저장된 전체 API 응답을 재생한 결과이며 새로 API를 조회한 결과가 아닙니다.
- 상세 수치: XENON_LEGACY_ESTIMATE_VALIDATION_20261008.json

MapleTools v2.2.38 공개판 — 제논 입력 시점 재조사 (2026-10-08)

- 최신 조회에 패치 전 심볼 수치가 남은 제논을 식별하고 계산 내역에 경고합니다.
- 불일치 자료에 만료 칭호·캐시 옵션이 있으면 만료 전 전투력 잔존 가능성을 표시합니다.
- 실제 심볼 수치, 만료 옵션 제외 규칙, 직업 보정 계수와 계산 결과는 변경하지 않았습니다.
- 확인한 불일치 9명 중 실압근휴먼은 만료 캐시(올스탯 20·공마 10), 충흐일기는 종료 이벤트를
  진단용으로 복원하면 API와 정확히 일치합니다. 이 효과를 현재 계산에 다시 더하지 않습니다.
- 나머지 7명은 패치 이전 심볼 수치가 반환되어 최신 식의 정확도 검증에 사용할 수 없습니다.
  7명의 전투력 차이를 모두 설명하는 과거 계산식은 미확정입니다.
- 이전 38명 결과는 23명 일치·9명 불일치·6명 보류 그대로입니다. 불일치를 성공으로 재분류하지 않았습니다.
- 재수집 13명 중 12명은 안정적이며 러스트제논은 조회 도중 변경되어 전체를 다시 수집했습니다.
- 기존 제논 20개+입력 시점 5개, 안드로이드 5개 검사 및 일반 109개/46직업 회귀 통과.
  실제 게임 내 착용 변경 실험과 Windows 네이티브 실행 시험은 수행하지 않았습니다.
- 상세 검증: XENON_SOURCE_DATE_VALIDATION_20261008.json

MapleTools v2.2.37 공개판 — 제논/안드로이드 보정 (2026-10-08)

- 계산 내역 조회에 안드로이드 API 수집과 재확인을 추가했습니다.
- 안드로이드 미장착이 확인된 경우 기계 심장의 능력치·잠재능력·스타포스를 제외합니다.
- 안드로이드 응답 누락/오류는 미장착으로 간주하지 않고 계산을 보류합니다.
- 다른 장비 프리셋의 안드로이드 적용 상태가 불명확하면 프리셋 예상값을 보류합니다.
- 제논 응답에 종료된 훈련 일지 등의 효과가 남으면 갱신 시점 경고와 프리셋 보류를 적용합니다.
- 검색 전투력은 넥슨 API 값이며, 직업 보정 계수는 변경하지 않았습니다.
- 안드로이드 정보가 없는 과거 저장 기록은 하트 활성 가정을 명시한 재현값입니다.
- 제논 38명 재수집: 수정 전 22명/수정 후 23명 정수 일치, 9명 불일치, 6명 계산 보류.
  러스트제논의 별도 개선은 계산식 수정이 아니라 API 값 갱신에 따른 일치입니다.
- 일반 직업 109개 저장 표본/46직업 수치 회귀, 제논 기존 20개 및 하트·갱신 5개 테스트 통과.
  실제 게임 프리셋 전환과 Windows 네이티브 실행 시험은 수행하지 않았습니다.

2.2.36 데몬어벤져 참고 추정치 · 관측 오차 표시

사용 위치: 캐릭터 장비·스펙 조회 → 계산 내역.
현재 API 전투력, 기본 추정, HP 출처 가설 적용값을 나란히 표시합니다.
각 추정안의 API 대비 차이와 같은 전투력 구간의 관측 오차·표본 수를 보여줍니다.
전체 67명의 최소/최대 관측 오차도 함께 표시합니다. 큰 오차 사례를 제외하지 않았습니다.
관측 범위는 보장 범위나 신뢰구간이 아닙니다. 공식 산식은 아직 미확정입니다.
API 검색·필터는 계속 실제 API 전투력을 기준으로 작동합니다.
다른 프리셋의 데벤 예상값은 아직 제공하지 않습니다.
435성 초과, 의지 등 필수 데이터 미상, 만료 효과, 조회 중 상태 변경, 비교 표본 없는 구간은 추정 보류입니다.
기본안과 HP 출처 가설 적용안을 모두 제시합니다. 가설 적용이 모든 캐릭터에서 더 정확하지는 않습니다.

검증: 기존 75명 관측 재생 → 67명 기존 연구 결과와 정수 단위 일치, 8명 보류 유지.
일반 직업 46종·109개 API 스냅샷 및 기존 프리셋·화면 회귀 검사 통과.
이번 릴리스의 정확 일치는 프로그램 이식 결과의 재현성을 뜻하며 실제 게임 공식의 검증을 뜻하지 않습니다.
오프라인 확인: python tests/test_da_reference.py / python tests/test_da_reference_ui.py
결과 기록: DA_REFERENCE_VALIDATION_20261008.json

2.2.35 데몬어벤져 두 명의 입력·절삭 순서 집중 검증

같은 285레벨·제네시스 22성·루인 조합 2명을 전투력 수치 없이 선택해 재조회했습니다.
공개 직업·링크·길드 효과로 표시 공격력·보공·크뎀을 두 명 모두 정확히 재현했습니다.
기존 HP 합산 가정에서 절삭 24개 조합 모두 공통 고정 계수의 정확 일치가 불가능했습니다.
1경목 오차 -1의 후보는 새 저스펙 1명에서 실패했습니다. 다른 새 1명은 만료 장비 3개로 전투력 비교 보류입니다.
두 사람의 HP는 표시 상한이라 실제 전체 HP의 검증을 뜻하지 않습니다. 데벤 산식은 미해결입니다.
상세 결과: DA_NARROW_RESEARCH_2026-10-06.md / DA_NARROW_RESULT_2026-10-06.json
재생 도구: python tools/check_demon_avenger_narrow.py
전체 스킬 출처 수집에 hyperpassive 등급을 추가했습니다.

2.2.34 데몬어벤져 입력 수정·중단 복구 및 HP/전투력 분리 검증

중단 이후 재개 결과: DA_RESUMED_2026-10-06.md
새 원자료 6명 재조회 및 응답별 저장·재개 도구 추가.
HP 후보는 일부 표본에서 일치하지만 데벤 전투력 산식은 아직 미해결입니다.
장비 HP 80%·컨버전 550성·루인 효과·칭호 HP 표기 및 파프니르 환산 수정. 37명·39회 자료에서 6,656개 후보를 비교하고 새 6회 검증. 직업 보정식은 미해결이며 데벤 프리셋 예상은 미제공.
상세 결과 및 한계: DA_RESEARCH_2026-10-06.md

2.2.33 제논 프리셋 예상 지원
AP 전환 어빌리티 누락 수정, 에너지 무기 보정 확대, 현재값 일치·조회 안정·세트/칭호 확인 조건에서 프리셋 예상 계산.
남은 저스펙 불일치와 만료 장비는 보류. 상세 결과: XENON_PRESET_RESEARCH_2026-10-06.md

MapleTools Integrated 2.2.42 공개판

실행
- Run_MapleTools.vbs: 평상시 실행. 처음에는 필요한 Python/UI 환경을 자동 준비합니다.
- run_dev.cmd: 콘솔과 시작 오류 진단. 오류 기록은 runtime\logs에 저장됩니다.
- ZIP을 새 폴더에 완전히 풀고 실행하세요. 이전 버전 폴더에 덮어쓰면 옛 파일이 남습니다.
- 이전 검색 기록·학습 목록을 이어 쓰려면 이전 폴더의 user_data를 새 폴더로 복사하세요.

현재 기능
- 장비 검색(일반·상세), 유니온챔피언 검색, 장비·스펙 조회, 타임라인·코디 조회.
- 장비 클릭 상세 팝업, 현재/프리셋 장비, 선택/전체 이미지·CSV 내보내기.
- 장비·스펙 상단의 '계산 내역': 현재 공개 옵션을 직접 합산해 API 전투력과 비교합니다.
  캐시 개별 옵션, 마스터라벨 세트, 구독 전투 플러스, 이벤트, 펫·유니온·아티팩트·HEXA 스탯,
  익셉셔널, 소울 기본/고정 공마/증폭 잠재능력을 분리해 확인할 수 있습니다.
  방무·일반 몬스터 데미지·직업/링크 스킬·임시 전투 버프는 전투력 산식에서 제외합니다.
  일반 직업 46개의 주스탯·부스탯·공격력/마력 규칙으로 검산 범위를 확장했습니다.
  듀얼블레이더·섀도어·카데나는 LUK×4 + DEX + STR, 마법사는 INT×4 + LUK와 마력을 사용합니다.
  어빌리티의 고정 스탯은 스탯% 미적용으로 합산하고 '모든 능력치' 표현을 처리합니다.
  HEXA 데미지 증가(포인트당 0.75%)를 반영하고 구형 유니온 배치 응답 누락을 수정했습니다.
  유니온 챔피언 휘장은 등록된 캐릭터에만 적용합니다. 부캐라는 이유로 제외하지 않으며,
  챔피언 등록 여부를 알 수 없으면 계산을 보류합니다.
  무기는 확인한 강화 구성만 보정하고 알 수 없는 구성은 계산 보류로 표시합니다.
  계산이 모든 캐릭터에서 검증된 상태는 아닙니다. API와 다른 값은 차이를 그대로 표시합니다.
  칭호 불일치 제보 대응: API 옵션 칭호와 외형 칭호를 계산 내역·복사 결과에 구분해서 표시합니다.
  킹 오브 루타비스 착용 기록이 예티×핑크빈으로 표시된다는 제보는 공식 확인·원인 확정 전입니다.
  특정 칭호를 강제로 바꾸거나 보스 데미지를 일괄 보정하지 않습니다.
  API 전투력과 직접 계산의 일치는 API 자료끼리의 일치이며 실제 게임 내 착용 검증이 아닙니다.
  일치 자료 역시 게임 내 칭호를 별도로 확인하지 않은 API 회귀 자료입니다.
  빈 2·3번 칭호 프리셋은 연동 해제 여부에 따라 1번 칭호를 적용합니다. 정보가 없으면 보류합니다.
  연동 규칙 출처: https://maplestory.nexon.com/News/Update/806 (캐릭터 프리셋 개편)
  추가 특수 반지(API 슬롯명: 예비 특수 반지)의 기본 옵션 누락을 수정했습니다.
  하이퍼 스탯의 한국어 능력치(힘·민첩성·지력·운) 누락도 수정했습니다.
  하이퍼 스탯은 현재 적용 프리셋만 합산하고 스탯% 미적용 수치로 처리합니다.
  2026-10-05 KST API 자료 검산: 케페우스 124,377,250 / 아델 2,165,745,107 /
  강은호 현재 장비 프리셋 2는 700,755,101 / 저장된 프리셋 1은 1,944,846,810 모두 오차 0.
  현재 보관된 일반 직업 표본 117개: 기본 가정에서 정확 일치 109개(46직업), 차이 2개(보우마스터 두 시점), 만료 장비로 보류 6개(렌).
  2026-10-06 추가 일반 직업 조회 9개는 조회 전후 character/stat 응답이 모두 동일했습니다.
  에반 드래곤 장비와 메카닉 전용 장비를 누락 없이 한 번 합산합니다.
  보우마스터·신궁·윈드브레이커는 티타늄 화살(+9), 나이트로드·나이트워커는 플레임 표창(+29),
  캡틴은 자이언트 불릿(+22)을 기준으로 계산하며 소모품 종류는 API 미제공이므로 가정임을 표시합니다.
  메카닉은 불릿을 추가하지 않습니다.
  제로는 보조무기의 공유 기본 능력치를 중복 합산하지 않고 잠재능력은 각각 반영합니다.
  제로의 검증된 제네시스·데스티니 22성 강화 구성에 별도의 추가옵션 단계 보정을 적용합니다.
  이외 제로 무기 강화 상태는 계속 계산 보류로 표시합니다.
  2026-10-05 현재 재조회: 원동숙 51,210,409 / 초팬 562,104,413 / 새3봄 36,046,935 /
  다춰 43,530,661 모두 API와 정확 일치합니다.
  쵸여포·멩바이병장: 도전자 장비 세트의 API 8세트 공마 30을 합산하던 문제를 수정했습니다.
  2026 아이템 버닝 PLUS 공식 세트표에는 2~7세트만 있습니다. API는 8세트 공마 30을 추가 제공합니다.
  공식 세트표: https://maplestory.nexon.com/News/Event/Ongoing/1343
  공식 이미지: https://lwi.nexon.com/maplestory/2026/0618_board/06B667F0AD995C04.png
  문서화된 2026 시즌·확인한 공마 30 옵션에만 제외를 적용하고 원본과 보정 근거를 계산 내역에 남깁니다.
  다른 시점 또는 다른 8세트 옵션이면 임의 보정하지 않고 계산을 보류합니다.
  가선의듀블리: 어드벤처 딥다크 크리티컬 링의 item_description에 있는 고유 크리티컬 데미지를 누락했습니다.
  크리티컬 데미지 : +5%처럼 콜론과 더하기 기호를 함께 쓰는 옵션을 읽도록 수정했습니다.
  반지 실제 item_name과 설명을 사용하며 외형 이름, 임시 고급 무기 제련 버프, API 전투력 역산으로 추가하지 않습니다.
  기존 미해결 3명의 과거 두 시점과 새 조회 모두 오차 0입니다. 레테 3명에서도 도전자 세트 수정이 검증됐습니다.
  새 조회: 쵸여포 109,126,129 / 멩바이병장 26,347,066 / 가선의듀블리 37,278,709 모두 일치합니다.
  시시로제 보우마스터는 도전자 세트 수정 후에도 +191,730 차이가 남습니다.
  계산 내역에서 티타늄 화살(+9) 또는 미장착(+0)을 직접 선택할 수 있습니다. 전투력에 맞춰 자동 선택하지 않습니다.
  시시로제는 미장착 기준 API 48,060,293과 정확 일치하고 보마노랑이는 기존 티타늄 화살 기준 888,684,984와 일치합니다.
  미장착 선택의 일치도 실제 화살 상태 확인을 의미하지 않습니다. 복사 내역에 선택 기준과 API 미확인 사실을 남깁니다.
  렌 도전자의 폭검 18성(160레벨, 기본205/추옵82/주문서81/스타135, 업그레이드9회)을
  기준 무기 구성192/77/81/131=481로 변환합니다. 다른 별·추옵·주문서 구성은 계속 보류합니다.
  뉴비마켓의 기타 효과 STR (+%) 4.00을 빠뜨리던 입력 형식도 수정했습니다.
  기존 뉴비마켓·아크로렌의 도전자 장비는 각각 2026-04-23, 2025-12-18에 이미 만료됐지만 API 장비창에 남아 있습니다.
  날짜를 확인해 만료 장비가 포함된 자료는 현재 착용 검산을 보류하고 복사 내역에 장비·만료일을 표시합니다.
  만료된 도전자 장비에 2026 PLUS 시즌 8세트 보정을 적용하지 않습니다.
  추가 렌 자료: 후딘렌 110,165,930 / 토끼기우 97,144,393 / 은채영 151,031,230 모두 정확 일치합니다.
  추가 미해결 렌 4개도 만료 장비가 남아 있고 미접속 플래그입니다. 이를 직업 전체의 산식 오류로 확정하지 않습니다.
  API 응답을 두 번 받아 동일해도 장비가 실제로 현재 상태라는 보장은 아닙니다.
  제논은 STR·DEX·LUK 각각의 심볼과 HEXA 주력 스탯을 합산한 기여도 내역을 제공합니다.
  2026-09-17부터 HEXA 1포인트당 각 스탯66, 이전 자료는48을 사용하며 직업 보정식을 일반 LUK×4 산식으로 대체하지 않습니다.
  심볼은 각 능력치의 API 옵션을 사용합니다. 수정 근거: https://maplestory.nexon.com/News/Update/812
  최신 제논 5명(할미가·이어징·헥농·블핑이제논·탱이갓제논)의 입력을 최신 파서로 재검산했습니다.
  기존2.25 계수 가설은 5개 모두 불일치(오차 -1,977,056 / +481,142 / -2,043,952 / -2,167,015 / -6,088,532).
  제논 전투력 보정식은 아직 미검증입니다. 직접 전투력·프리셋 계산을 열지 않으며 데몬어벤져도 계속 보류합니다.
  tools/check_xenon_current.py는 최신 표본에 대한 거부된 가설을 재현하는 연구 도구이고 서비스 산식이 아닙니다.
  전체 직업·모든 장비 완성으로 취급하지 않습니다.
  본캐·부캐를 모두 조회하며 닉네임별 보정 계수나 API 전투력 역산으로 값을 맞추지 않습니다.
  계산 내역에서 장비·하이퍼·어빌리티 프리셋을 선택해 조합 예상값을 확인할 수 있습니다.
  현재 옵션의 계산이 API와 정확히 일치한 경우에만 조합 계산을 제공합니다.
  유니온은 현재 적용 상태를 유지하며 링크는 전투력 계산에서 제외합니다.
  장비 세트 구성 변경 및 미검증 무기·칭호 정보 누락은 계산 보류로 표시합니다.
  제논·데몬어벤져는 조합 계산을 보류하고 현재 API 전투력 조회·검색을 유지합니다.
  특수 직업 주의문구는 장비·스펙, 계산 내역, 검색 조건·결과·로그에 표시합니다.
  조회한 현재 장비·하이퍼·어빌리티·유니온 프리셋 번호를 함께 표시합니다. 새 유니온 배치는 10번까지 인식합니다.
  조회 전후의 모든 최종 스탯을 비교하여 조회 중 AP 등 능력치가 바뀐 경우 조합 계산을 보류합니다.
  다른 유니온 프리셋 정보가 없는 경우 미장착으로 추정하지 않습니다.
  직접 계산값은 검색 필터에 사용하지 않으며 기존 API 실측 검색 기준을 유지합니다.
  이 버튼을 열 때만 추가 조회하며 일반 검색·장비 조회의 호출 수를 늘리지 않습니다.
- 상세 검색 주요 조건 제목은 화면 순서대로 1~10번입니다.
- 전투력은 조회 시점의 착용 장비 기준입니다. 다른 프리셋의 전투력으로 조건을 입력하면 검색되지 않을 수 있습니다. 입력란·검색 결과·로그에 경고를 표시하고, 결과 상세/CSV에도 전투력 기준을 기록합니다. 과거 검색은 기준일 당시 착용 장비 기준입니다.
- 현재 장비 우선. 조건에 맞는 현재 장비가 없으면 프리셋을 순서대로 확인하고 캐릭터당 한 행 표시.
- 잠재능력·에디셔널·추가옵션·주문서 증가치·가위·익셉셔널·소울 별도 조건.
- HEXA 실제 스킬 아이콘, 최대 30레벨, 종류별 4칸. 빈 칸은 향후 코어용입니다.
- 총 스타포스, 아케인/어센틱포스, 전투력, 유니온/아티팩트 범위 검색.
- 상세 검색에 장비 조건이 없으면 장비 API 호출과 장비 검사를 생략합니다.
  프리셋 체크는 장비 검색을 켜지 않습니다. 결과에도 장비 검사 생략으로 표시합니다.
  소울 활성 상태는 조건 없음이 기본입니다. 비활성 소울만은 비활성 장비를 찾는 조건입니다.
- HEXA 기운/조각은 유니온 · HEXA 강화량 영역에서 바로 입력합니다.
  범위 검색 결과에는 기운·조각 계산값을 표시합니다.
  로그에 범위 불일치와 정보 부족으로 계산 불가인 경우를 구분해 표시합니다.
  기운은 메이플 프로필의 솔 에르다 표시 숫자 기준입니다. 500+이면 최소 500을 입력합니다.
  조각은 프로필의 조각 개수를 그대로 입력합니다. 입력·결과·로그는 같은 기준입니다.
  + 표시는 최소값만 입력하고 최대값을 비웁니다. 빈칸은 미적용입니다.
  현재 코어 강화 상태에 해당하는 비용을 계산하며 보유량·실제 평생 소비량이 아닙니다.
  솔 야누스는 항상 포함. HEXA 스탯 포함 체크 시 스탯 활성화 비용과 조각 예상치 합산.
  초기화·삭제한 코어·이벤트 할인/확률 이력은 반영하지 않습니다.
- 기본 최신 날짜는 현재 Open API 상세 정보, 직접 선택한 과거 날짜는 해당 기록 기준.
- 불독·썬콜 랭킹 직업 필터의 쉼표 누락을 수정했습니다. 잘못된 문자열은 다른 마법사 후보까지 반환했습니다.

폴더
- src: 수정 가능한 Python 소스. main → ui → core/shared/export 구조.
- assets: 화면에서 사용하는 이미지와 아이콘. 원본은 종류별 한 장씩 보존하고 완전히 같은 중복 이미지만 제거했습니다.
- data: 장비·소울·HEXA 비용표. 검색과 추천에 사용합니다.
- tools: 실행 준비·진단·구조 검사.
- tests: 개발 중 기능과 성능을 검증하는 검사 코드와 최소 예시 데이터.
- user_data: 사용자 설정·학습 목록. 실행 중 생성합니다.
- runtime: API/이미지 캐시, 검색 체크포인트, 로그. 실행 중 생성합니다.

정리 내용
- 버전별 CHANGELOG/VALIDATION 문서·검사 JSON, 검사용 화면 캡처, 이전 독립 UI 참고 코드를 제거했습니다.
- 화면에는 기존 경량 이미지를 사용합니다. 활성 원본은 assets에, 보관용 원본은 assets\originals에 한 장씩 남겼습니다.
- 별도 설치 바로가기는 기본 실행 파일과 역할이 겹쳐 제거했습니다.
- 앞으로 ZIP에는 최신 안내 한 파일만 넣고 과거 문서·임시 파일을 누적하지 않습니다.

개발 확인
- python tools\check_project.py
- python tests\smoke_core.py
- python tests\smoke_import_graph.py
- 상세 검사 스크립트는 tests 폴더에 있습니다.
- 전투력 검산: 46직업의 정확 일치 자료 109개를 회귀 검사합니다. API 표시값·최종 스탯 변조 및 방무 변경은 직접 계산값에 영향을 주지 않습니다.
- python tests/test_combat_general.py 및 tests/test_combat_audit.py, tests/test_combat_presets.py, tests/test_combat_round31.py 로 네트워크 없이 검사합니다.
- 구조·import·core·장비·HEXA·검색·프로필·UI·전투력 검산 등 검사 19개 통과.
- 추가 47캐릭터 현재 API 조회는 최종 스탯 재조회까지 47개 모두 동일했고 API 오류가 없었습니다. 제논 맑음은 요청 목록에 있었지만 계산·검증 집계에서는 제외했습니다.
- 일반 직업 검산은 tests/fixtures/combat_general_snapshots.json의 117개 원본으로 재현합니다.
- Windows 실기기 실행은 별도로 확인하지 못했습니다.

개인 개발판
- 개인 API 설정이 src\mapletools\dev_config.py에 포함되어 있습니다.
- 소스 암호화·난독화는 적용하지 않았습니다. 외부 배포용 보호본과 구분하세요.

2026-10-05 특수 직업 검산
- 흡혈·맑음 및 데몬어벤져·제논 각 2명을 추가 수집해 직접 옵션 합산과 후보식 계산을 비교했습니다.
- 후보 계수(데몬어벤져 0.81, 제논 2.25)는 미검증 연구 가정이며 게임 공식값이 아닙니다. 6명 모두 정확 일치하지 않았습니다.
- 흡혈에서는 +15,990 차이였지만 다른 데몬어벤져에서는 +6.85%/+25.64% 차이가 나서 공통 식으로 채택하지 않았습니다.
- 제논 3명은 각각 -0.30%/-0.04%/-1.98% 차이. HP 기본 합산·직업 변동 보정식은 추가 검증이 필요합니다.
- 이 자료는 실패한 후보식의 재현 기록입니다. 앱의 전투력 계산·프리셋 검색 기능은 변경하지 않았습니다.
- python tools\check_special_combat.py 로 네트워크 없이 재현할 수 있습니다. 입력은 API 원본 및 항목별 합산값, API 전투력은 마지막 비교에만 사용합니다.
- tests\fixtures\combat_special_research.json에 이번 6명 원본과 합산 기록을 한 파일로 보관했습니다. API 키·OCID는 포함하지 않았습니다.


2026-10-05 전투력 보정식 추가 연구
추가 20캐릭터·28개 API 표본과 별도 캐릭터 검증을 기존 연구 fixture에 통합했습니다.
제논 별도 검증 3명: 오차 -0.993190%, -0.028868%, -0.406168%, 정확 일치 0명.
데몬어벤져 후보식은 표본 제외 검증에서 불안정하여 기각했습니다.
자세한 식·오차·한계: COMBAT_RESEARCH_20261005.txt
검산: python tools/check_special_combat.py
후보식은 앱 검색 필터·프리셋 전투력으로 사용하지 않습니다.
