docs(tools): align_analyze.py 이관 + CH3 flicker fix Python replay 검증 결과

- tools/align_analyze.py 신규: AlignGuide4Stage 상태머신 Python 재현
  - `--both` 모드로 NEW (majority + relaxed + soft-hint) vs LEGACY (연속 3 hit)
    로직 병행 replay 지원
  - Kotlin AlignmentConstants (V_WIN/V_MAJ/L_WIN/L_MAJ/STUCK/SOFT) 값 그대로 매핑
- tools/README.md: align_analyze.py 사용법 + 파라미터 매핑 표 + data123/
  4 세션 검증 결과 표 (Phantom / Human 0·1·3 CM) 정리
- tools/labdb_upload.py 신규 추가 (기존 문서만 있고 실체 미커밋 상태였음)
- VesiScan_Android_Pipeline_Summary.md v7 patch (2026-07-13):
  align_analyze.py 도구 언급 + CH3 flicker fix 실측 검증 결과 요약

검증 결과 요약 (data123/ human 4 세션):
- Human 0CM (CH3 31.8%): LEGACY 즉시 회귀 → NEW flick 1/4 흡수 유지
- Human 1CM (CH3 77.3%): LEGACY idx15 oscillation → NEW idx13 조기 진입
- Human 3CM (CH3 97.2%): 양쪽 정상 (회귀 없음)
- Phantom: 양쪽 정상 (relaxed mode 오진입 없음)
This commit is contained in:
2026-07-13 15:21:07 +09:00
parent 43ad32ba8a
commit eb25c01c97
4 changed files with 740 additions and 1 deletions
+7 -1
View File
@@ -2,7 +2,7 @@
## 작성일: 2026-04-23
## 작성자: dwjang
## 마지막 업데이트: 2026-07-10 (v7) — 1.2.0-demo (versionCode 26)
## 마지막 업데이트: 2026-07-13 (v7 patch) — 1.2.0-demo (versionCode 26)
## 권장 펌웨어: **VBTFW0120+** (mim FIFO 지원 필수. VBTFW0121 은 `mls mode 0` handler 취약)
### v7 주요 변경 요약 (2026-07-06 ~ 2026-07-10)
@@ -62,6 +62,12 @@
- **`tools/labdb_upload.py` 신규** — LabdbUploader.kt 의 `buildPayload` 로직을
Python 으로 이식. 외부 저장 세션 폴더 일괄 업로드용.
자세한 사용법: [tools/README.md](tools/README.md).
- **`tools/align_analyze.py` 신규** (2026-07-13) — `AlignGuide4Stage` 상태머신을
Python 으로 재현하여 alignment 세션 JSON 을 오프라인 replay. `--both` 모드로
NEW (majority + relaxed + soft-hint) vs LEGACY (연속 3 hit) 로직 비교 지원.
`data123/` 인체 임상 4 세션 (Phantom / Human 0·1·3 CM) replay 결과 CH3 flicker
fix 회귀·조기 진입 개선 확인, relaxed mode false-positive 없음.
파라미터 매핑 · 결과 표: [tools/README.md](tools/README.md).
**참고**
- 이번 세션에서 발견되었으나 아직 미조치: PiezoMonitoringView (2900L) /