File Nexus Suite v1.1.2

v1.1.2 — Text Merger MD 출력 형식 추가 / Text Merger MD Output Format

Full Changelog: v1.1.1...v1.1.2

---

✨ Added

• Text Merger — MD 출력 형식 추가 / Text Merger — MD output format added
  • 저장 설정 영역에 출력 형식: TXT / MD 라디오버튼이 추가됨. MD 선택 시 파일 구분선이 ## 파일명 헤더 + --- 마크다운 양식으로 자동 전환되고, 기본 파일명도 merged.md로 변경됨. 선택한 형식은 설정으로 저장됨 / Output Format: TXT / MD radio buttons added to the save settings area. When MD is selected, file separators switch to ## filename header + --- Markdown form and the default filename becomes merged.md. The selected format is saved with other settings.

---

📝 Notes for Existing Users

• 기존 v1.1.1 사용자는 안전하게 v1.1.2로 이전 가능. 설정 데이터(FileNexusSuite.json)와 출력 파일(Output/)은 그대로 보존됩니다 / Existing v1.1.1 users can safely upgrade to v1.1.2. Settings (FileNexusSuite.json) and output files (Output/) are preserved.
• 기존 설정 파일에 출력 형식 항목이 없는 경우 TXT로 기본 복원됩니다 / If the output format entry is absent from an existing settings file, TXT is used as the default.

---

🔐 Release Signing

• Release commit [PLACEHOLDER] — SSH 서명 (Ed25519), GitHub Verified 뱃지 / SSH-signed (Ed25519), GitHub Verified
• 태그 v1.1.2 SSH 서명, GitHub Verified 뱃지 / Tag v1.1.2 SSH-signed, GitHub Verified
• GitHub Actions CI windows-latest + Python 3.10 환경에서 자동 통과 / GitHub Actions CI passed on windows-latest + Python 3.10

---

Tag: v1.1.2
Released: 2026-05-14
Build: FileNexusSuite_v1.1.2_win64.zip ([PLACEHOLDER] MB)

깊은 기술 변화 이력은 CHANGELOG.md 참조 / For detailed technical changes, see CHANGELOG.md

🌼

File Nexus Suite v1.1.1

v1.1.1 — 도움말 다국어 + 본체 i18n 정리 / Help Localization + Main Module i18n Cleanup

Full Changelog: v1.1.0...v1.1.1

---

🐛 Bug Fixes

• Text Converter — Book Info 패널 레이아웃 fix / Text Converter — Book Info panel layout fix
  • Debug Log 패널을 펼쳤을 때 우측 Book Info 패널의 Title / Author / Language / Chapter Split 입력 필드 라벨이 입력 박스에 가려지던 결함이 수정됨. v1.1.0부터 존재하던 문제 / The labels of Title / Author / Language / Chapter Split fields in the Book Info panel were hidden under the input boxes when Debug Log was expanded — fixed. Issue had been present since v1.1.0

---

✨ Changed

• 도움말 시스템이 OS 언어 설정에 따라 자동으로 5개 언어로 표시 / Help system now displays in 5 languages following OS language setting

  • v1.1.0에서 본체 UI 문자열에 적용되었던 Qt Linguist 다국어 런타임 워크플로가 도움말 콘텐츠까지 일관되게 확장됨. 도움말 텍스트가 OS 언어 자동 감지 또는 Settings → Language에서 선택한 언어로 표시됨 / The Qt Linguist runtime workflow used for main UI strings in v1.1.0 now extends to help content. Help text displays in the OS-detected language or the user-selected language from Settings → Language

• 본체에 남아있던 한국어 하드코드 6곳 정리 / Six remaining Korean-hardcoded sites in the main module cleaned up

  • v1.0.x 시절 단일 한국어 코드의 잔재로 본체에 남아있던 6곳(도움말 버튼 툴팁, 시작 로그 메시지, EPUB 메타데이터 '저자: ' 라벨, 설정창 사이드바 4개 라벨)이 5개 지원 언어로 정상 표시되도록 정리됨 / Six leftover Korean-hardcoded sites (help button tooltip, startup log message, EPUB metadata 'Author: ' label, four Settings sidebar labels) now display in all 5 supported languages

---

📝 Notes for Existing Users

• 기존 v1.1.0 사용자는 안전하게 v1.1.1로 이전 가능. 설정 데이터(FileNexusSuite.json)와 출력 파일(Output/)은 그대로 보존됩니다 / Existing v1.1.0 users can safely upgrade to v1.1.1. Settings (FileNexusSuite.json) and output files (Output/) are preserved
• 본 릴리즈 적용 후 Settings → Language에서 언어 변경 시 도움말 텍스트도 함께 변경됩니다 / After this release, changing language from Settings → Language will also update the help text in real time

---

🔐 Release Signing

• Release commit [PLACEHOLDER] — SSH 서명 (Ed25519), GitHub Verified 뱃지 / SSH-signed (Ed25519), GitHub Verified
• 태그 v1.1.1 SSH 서명, GitHub Verified 뱃지 / Tag v1.1.1 SSH-signed, GitHub Verified
• GitHub Actions CI windows-latest + Python 3.10 환경에서 자동 통과 / GitHub Actions CI passed on windows-latest + Python 3.10

---

Tag: v1.1.1
Released: [PLACEHOLDER — YYYY-MM-DD]
Build: FileNexusSuite_v1.1.1_win64.zip ([PLACEHOLDER] MB)

깊은 기술 변화 이력은 CHANGELOG.md 참조 / For detailed technical changes, see CHANGELOG.md

🌼

File Nexus Suite v1.1.0

v1.1.0 — 모듈화와 디자인 폴리싱: Qt Linguist 번역 시스템 전환 + 헬퍼/테마 모듈 분리 + 사이드바·진행률 톤 통합 / Modularization and Design Polishing: Qt Linguist Translation System Migration + Helper/Theme Module Extraction + Sidebar & Progress Tone Unification

v1.1.0은 v1.0.11의 코드 본질 강화 다음 자리에서, 모듈화와 디자인 폴리싱이 모이는 자리입니다. 본 릴리즈는 세 묶음(헬퍼 함수와 테마 시스템의 모듈 분리, Qt Linguist 번역 시스템 전환, 사이드바 카드와 Batch Renamer 진행률 다이얼로그의 디자인 톤 통합)으로 구성됩니다. 본체 모듈은 헬퍼와 테마 시스템 분리를 통해 약 15,662줄에서 13,274줄로 축소되었으며, 번역 시스템은 인라인 Python 딕셔너리에서 Qt Linguist .ts/.qm 런타임 양식으로 전환되어 데이터 계층이 Python 소스 외부로 이전되었습니다. 첫 실행 시 운영체제의 언어 설정에서 UI 언어가 자동 감지됩니다.

v1.1.0 follows v1.0.11's code essence deepening by gathering modularization and design polishing artifacts. This release bundles three threads (helper utilities and theme system extracted into sibling modules, Qt Linguist translation system migration, design tone unification across sidebar cards and Batch Renamer progress dialog). The main module shrinks from roughly 15,662 to 13,274 lines through helper and theme system extraction; the translation system migrates from an inline Python dictionary to Qt Linguist .ts/.qm runtime files, moving the data layer outside the Python source. The UI language is auto-detected from the OS settings on first launch.

---

✨ 주요 변경 / Major Changes

• Qt Linguist 번역 시스템 전환 / Qt Linguist translation system migration

  • 기존 FileNexusSuite.py 내부 인라인 TRANSLATIONS 딕셔너리가 Qt Linguist .ts (소스) + .qm (런타임) 양식으로 컴파일됨. 소스 파일은 translations_ts/ 아래, 런타임 파일은 translations/ 아래, 5개 언어 (ko/en/ja/zh_cn/zh_tw) × 25개 컨텍스트 × 503개 번역 / Inline TRANSLATIONS dict migrated to Qt Linguist .ts (source) + .qm (runtime) files. Source files under translations_ts/, runtime files under translations/, 5 languages × 25 contexts × 503 translations
  • 모든 UI 문자열이 기존 _t(key) 양식에서 self.tr(key)로 전환되어 런타임에 QTranslator를 통해 해석됨 / All UI strings migrated from _t(key) to self.tr(key), resolved at runtime through QTranslator
  • OS 언어 자동 감지 — 첫 실행 시 운영체제 언어 설정에 기반해 UI 언어가 자동 선택되며, 설정에서 변경 가능 / OS language auto-detection on first launch; changeable in Settings
  • scripts/update_translations.bat와 scripts/add_ts_contexts.py 헬퍼 스크립트가 lupdate/lrelease 사이클을 자동화. 번역 협업은 .ts 파일을 Qt Linguist로 직접 편집하며, UI 변경 후 .qm 런타임 파일을 재생성 / Helper scripts automate the lupdate/lrelease cycle; translators edit .ts files directly in Qt Linguist, with .qm files regenerated after UI changes

• 헬퍼 함수 및 테마 시스템 모듈 분리 / Helper utilities and theme system extracted into sibling modules

  • fns_utils.py 신규 — 17개의 순수 Python 헬퍼 함수가 본체 모듈에서 분리됨. 숫자/자연 정렬 유틸리티 (_pad, extract_number, _get_leading_num, extract_number_auto, auto_width_for_group, detect_common_prefix, natural_sort_key, _SKIP_FILES), Tag Editor 핵심 로직 (remove_tag_from_name, _build_tag_str, add_tag_to_name, depad_name, apply_renames), HTML escape/unescape 유틸리티 (_de, _h2t, _strip_xml_illegal, _ex) / New fns_utils.py — 17 pure-Python helpers extracted from the main module
  • fns_theme.py 신규 — 9개 테마 팔레트 딕셔너리 (THEMES, 테마별 18개 키), 5개 테마 헬퍼 (_hex_rgba, _combo_arrow_url, _detect_system_theme, _resolve_theme, make_style), 그리고 _apply_card_shadow 위젯 헬퍼가 분리됨. _apply_card_shadow의 시그니처는 _apply_card_shadow(widget)에서 _apply_card_shadow(widget, border_color)로 변경되어 BORDER global 의존을 명시적 인자로 풀고 모듈을 자기-완결로 유지 / New fns_theme.py — 9-theme palette dict, 5 theme helpers, and _apply_card_shadow widget helper extracted; signature change breaks the BORDER global dependency
  • 두 모듈 모두 PySide6 외 외부 의존이 없으며 본체 런타임 상태와 독립적으로 재사용 가능. 본체 모듈은 두 분리를 통해 약 532줄 감소 (15,662 → 15,130) / Both modules are independent of FNS runtime state; main module shrinks by roughly 532 lines through these two extractions

• 파일 목록 위젯의 가상화 base 클래스 통합 / File-list widget virtualization unification

  • 거의 동일한 QTreeWidget 패턴을 공유하던 5개 위젯 (MergeFileTree, BulkFixerFileList, TextConverterFileList, Tag Editor의 _file_list와 _tree)이 3개의 신규 base 클래스로 통합 / Five widgets sharing a near-identical QTreeWidget pattern unified under three new base classes
  • FileListModel(QAbstractTableModel) — 범용 평면 목록 모델 (서브클래스 제공 COLUMNS 기반 렌더링, PATH_ROLE = UserRole+4, sort()/sort_key()); FileListBase(QTableView) — 공통 계약 (COLUMNS, COLUMN_WIDTHS, SELECTION_MODE 등 6개 클래스 속성 + 공통 메서드); DragDropMixin — drag-drop 동작이 필요한 3개 서브클래스를 위한 mixin / FileListModel, FileListBase, DragDropMixin — base classes consolidating shared model/view/drag-drop logic
  • 결과: v1.0.11에서 Batch Renamer 미리보기에만 적용되었던 QAbstractTableModel 기반 가상화 렌더링이 다섯 위젯 모두에 적용되어, 큰 파일 목록도 어느 탭에서든 화면에 보이는 행만 렌더링됨. 약 350줄의 중복 코드가 270줄의 공유 base로 대체 / QAbstractTableModel virtualization (previously only on Batch Renamer preview) now applies uniformly to all five widgets; roughly 350 lines of duplicated subclass code replaced by 270 lines of shared base

• 사이드바 카드의 시각적 분리감 강화 / Sidebar card visual separation strengthened

  • 우측 사이드바 카드들 (Batch Renamer의 Number Reset / Start Number / Digits / Prefix-Suffix 등)이 정보 밀도는 유지하면서 살짝 떠 있는 형태로 시각적으로 그룹핑됨 / Cards in the right-hand sidebar feel slightly elevated and visually grouped while preserving information density
  • 세 가지 협조 변경: (1) 신규 _apply_card_shadow(widget) 헬퍼가 모든 QGroupBox에 부드러운 QGraphicsDropShadowEffect 적용 (blur radius 18, Y offset 3, BORDER에서 alpha 0.5로 derive); (2) 글로벌 QGroupBox 룰에 margin-bottom:6px와 강화된 padding 추가; (3) QGroupBox::title 색이 MUTED에서 ACCENT로 변경되어 카드 헤더가 섹션 마커처럼 읽힘 / Three coordinated changes: subtle QGraphicsDropShadowEffect on every QGroupBox, stronger margin/padding on the global QGroupBox rule, and QGroupBox::title color shifted from MUTED to ACCENT
  • AppSuite._apply_card_shadows()가 __init__과 apply_theme()에서 호출되어 라이트/다크 테마 변경 시 그림자 색이 BORDER를 따라 갱신 / Shadow color tracks BORDER across light/dark theme switches

• Batch Renamer 진행률 다이얼로그 FNS 톤 매치 / Batch Renamer progress dialog tone-matched with FNS theme

  • Batch Renamer의 ingest worker와 rename worker가 사용하던 Qt 기본 QProgressDialog를 신규 _build_progress_dlg 헬퍼로 빌드한 FNS 톤 모달 진행률 다이얼로그로 교체. 기존 _confirm / _build_dlg 색상 팔레트 계승 (SURFACE 배경, ACCENT 진행 바 chunk, BORDER 외곽선, _btn_style(False) 취소 버튼) / Qt's default QProgressDialog replaced with an FNS-toned modal dialog inheriting the _confirm/_build_dlg palette
  • 기존 동작 모두 보존: 모달 (Qt.WindowModal), 400 ms 최소 표시 지연 (QTimer.singleShot(400, ...) + 완료 플래그로 짧은 작업의 깜빡임 방지), 완료 시 자동 닫힘, 취소 전파 (worker.request_cancel()). QProgressDialog 심볼은 QtWidgets 임포트에서 제거 / All prior behaviors preserved: modal, 400 ms minimum-duration delay, auto-close on completion, cancel propagation

---

📦 추가 / Added

• _ElideLabel(QLabel) 헬퍼 위젯 / _ElideLabel(QLabel) helper widget
  • 너비가 내용보다 좁으면 텍스트를 '...'로 우측 절삭하는 재사용 가능 라벨. 전체 텍스트는 _full_text에 보관되고 resizeEvent에서 절삭이 재적용되어 부모 너비 변화에 따라 절삭 위치가 동적으로 갱신됨 / Right-elides text with '...' when narrower than content; full text stored in _full_text and re-applied on resizeEvent
  • 가로 QSizePolicy가 Ignored로 설정되어 긴 문자열이 부모의 최소 너비를 키우는 일이 없음. 전체 텍스트는 모든 setText() 호출에서 툴팁으로 노출됨 / Horizontal QSizePolicy.Ignored so long strings never inflate the parent's minimum width; full text exposed via tooltip
  • 현재는 Text Merger의 선택 요약 라벨에서 사용되며, 가용 너비보다 길어질 수 있는 모든 상태 라벨에 적용 가능 / Currently used by Text Merger's selection summary label; available for any future status label

---

🐛 수정 / Fixed

• Text Merger 선택 라벨 레이아웃 깨짐 (다중 파일 선택 시) / Text Merger selection-label layout breakage with multiple files selected

  • 하단 선택 요약 라벨 (_lbl_selection)이 이동/삭제 버튼과 같은 가로 행을 공유하고 있어, 다수의 파일이 선택되면 라벨의 길이가 좌측 패널의 최소 너비를 키워 우측(저장 설정) 패널을 화면 밖으로 밀어내고 이동/삭제 버튼 텍스트도 잘리는 현상 / The bottom selection summary label shared a horizontal row with the move/delete buttons; with many files selected, the label's intrinsic width inflated the left panel's minimum size and pushed the right panel off-screen
  • 수정: (1) 라벨을 bot_btn_row 아래의 별도 세로 행으로 이동, (2) _ElideLabel 헬퍼(위 Added 참고)로 감싸 가로 minimumSize를 무시하고 너비가 좁을 때 우측 절삭. 전체 선택 텍스트는 툴팁으로 그대로 확인 가능 / Fixed by moving the label to its own row and wrapping it in _ElideLabel; full selection text remains accessible via the tooltip
  • v1.0.11부터 존재하던 문제이며, v1.1.0 base 클래스 통합의 회귀가 아님이 확인됨 / Issue had been present since v1.0.11; not a regression of the v1.1.0 base-class refactor

• PyInstaller 빌드의 번역 파일 누락 / Translation files missing in PyInstaller frozen build

  • 빌드된 실행파일이 한국어 Windows 환경에서도 영어만 표시되고 설정 > Language 메뉴에 다른 4개 언어가 나타나지 않던 현상. 두 원인: (1) build_pyinstaller.py에 --add-data 플래그가 없어 translations/*.qm 파일이 frozen 빌드에 번들링되지 않음, (2) _resource_dir()이 os.path.dirname(sys.executable)을 반환하여 PyInstaller 6.x onedir 모드의 contents directory (_internal/)를 찾지 못함 / Built executable silently fell back to English on all platforms because --add-data was missing from the build script and _resource_dir() did not resolve to PyInstaller 6.x's _internal/ contents directory
  • 수정: (1) build_pyinstaller.py에 --add-data "translations;translations" 추가, (2) _resource_dir()이 getattr(sys, '_MEIPASS', os.path.dirname(sys.executable))을 반환하도록 변경. 5개 언어 모두 frozen 빌드에서 정상 노출 / Fixed by adding --add-data to the PyInstaller command and updating _resource_dir() to use sys._MEIPASS; all five languages restored in the frozen build

---

🧪 테스트 자동화 / Test Automation

• 594 → 513 passing (-81), 0 failures / 0 errors / 5 intentional skips (한림 로컬 + Git 폴더 이중 검증). Qt Linguist 마이그레이션에서 TRANSLATIONS 딕셔너리 literal에 대한 source-grep 테스트가 모두 제거되었기 때문 (딕셔너리가 Python 소스에 더 이상 존재하지 않음) / 594 → 513 passing (-81), Hanrim local + Git folder dual verification. Net reduction reflects removal of source-grep tests against the TRANSLATIONS dict literal (no longer in Python source after Qt Linguist migration)
• Qt Linguist 런타임용 테스트 스위트 마무리 — 동등한 커버리지가 TestV105RegressionModule (self.tr() 호출 기반 런타임 번역...

File Nexus Suite v1.0.11

v1.0.11 — 코드 본질 강화: Batch Renamer 대용량 응답성 재작성 + 영문 기본 전환 + 12개 인라인 UI i18n migration / Code Essence Deepening: Batch Renamer Scalability Rewrite + English-First Transition + 12 Inline UI i18n Migration

v1.0.11은 v1.0.10의 MIT 전환과 OSS 결의 시작점 다음 자리에서, 코드 본질을 OSS-facing 양식으로 더 깊게 다지는 트랙입니다. 본 릴리즈는 세 트랙(Batch Renamer 대용량 응답성 재작성, 메인 코드 + 부속 문서 영문 기본 전환, 12개 인라인 UI 문자열 TRANSLATIONS 이전)의 묶음입니다. 154,895 파일 / 2,714 폴더 / 86.8 GB 규모 데이터셋에서 발생하던 수십 초~수분 멈춤 현상이 풀렸으며 — 103,716 파일 / 1,767 폴더 / 32.7 GB에서 ✓ 검증되었습니다.

v1.0.11 follows v1.0.10's decisive turning point: OSS opening by deepening the code itself for OSS-facing posture. This release bundles three tracks (Batch Renamer scalability rewrite, English-first transition for main code + supporting documents, 12 inline UI strings migrated to TRANSLATIONS). The tens-of-seconds to minutes freeze observed at 154,895 files / 2,714 folders / 86.8 GB has been resolved — verified at 103,716 files / 1,767 folders / 32.7 GB.

---

✨ 주요 변경 / Major Changes

• Batch Renamer 대용량 응답성 재작성 / Batch Renamer scalability rewrite

  • 미리보기 테이블을 가상화된 QTableView + QAbstractTableModel (신규 BatchPreviewModel + BatchRowHeightDelegate)로 전환 — 기존 QTableWidget이 화면 갱신마다 생성하던 약 47만 개의 QTableWidgetItem 부담 제거. _f_refresh / _p_refresh는 셀별 위젯 구성 로직이 data(index, role)로 이동하면서 23 / 21줄에서 4줄로 축소 / Preview table converted to virtualized QTableView + QAbstractTableModel (new BatchPreviewModel + BatchRowHeightDelegate) — eliminates ~470,000 QTableWidgetItem allocations per render. _f_refresh / _p_refresh shrink from 23/21 lines to 4 lines as per-cell widget construction moves into data(index, role)
  • _f_ingest / _p_ingest와 _f_do_rename / _p_do_rename은 BatchIngestWorker(QThread)와 BatchRenameWorker(QThread)로 백그라운드 실행, 취소 가능한 모달 QProgressDialog(폴더별 진행률) 방식. rename worker 안에서는 깊이 우선 폴더 순회와 WinError 5 일괄 재시도 로직을 그대로 보존 / Ingest and rename now run on BatchIngestWorker(QThread) / BatchRenameWorker(QThread) with a modal QProgressDialog (cancel + per-folder progress); the rename worker preserves the depth-first folder traversal and the WinError 5 bulk-retry loop
  • 폴더 / 파일 탭이 'f' / 'p' kind 파라미터로 동일 model / worker 클래스를 공유 / Both folder + file tabs share the same model / worker classes via a 'f' / 'p' kind parameter
  • 5개 언어에 i18n 키 3개 추가 (dlg_cancel, batch_ingest_progress, batch_rename_progress). 두 worker 다이얼로그의 QProgressDialog 창 제목도 Qt 기본값 (python, sys.argv[0] 유래)에서 FileNexusSuite로 재정의 / 3 new i18n keys × 5 languages. Window title also overridden from Qt's default (python, from sys.argv[0]) to FileNexusSuite

• 메인 코드 + 부속 문서 영문 기본 전환 / English-first transition for main codebase + supporting documents

  • FileNexusSuite.py 한국어 주석/docstring/디버그 로그 1,133줄을 영문 전환 (사용자 노출 UI 문자열, 언어 분기 가이드 콘텐츠, 사전 키/값은 한국어 보존). 안전성을 위해 두 commit 분리: Step 1+2 (506줄, f54bc81)와 Step 3 final (627줄, 177598b) / 1,133 lines of Korean comments/docstrings/debug logs translated to English (user-facing UI strings, language-branched guides, dictionary keys/values preserved). Split into two commits for safety
  • test_file_nexus.py도 동일 양식으로 277개 매핑 (F1 L1–L3500: 90, F2 L3501–L4100: 120, F3 L4101–L4590: 67). 459 보호 라인(SAMPLE_KO_* 입력 변수, assertEqual 기대값, 한국어 인용 9건 등)은 언어 중립 동작 검증 코드라 보존 / test_file_nexus.py: 277 mappings across 3 chunks. 459 protected lines preserved (SAMPLE_KO_* test inputs, assertEqual expected outputs, 9 Korean evidentiary citations)
  • STORY.md 한/영 이중언어 양식 (c469f6b), README.txt 영문 기본 + 다국어 라벨 (3922250), 빌드 메타데이터 영문 전환 (7ca4f734) / STORY.md bilingual, README.txt English-first multilingual, build metadata translated

• 12개 인라인 UI 문자열 TRANSLATIONS 이전 / 12 inline UI strings migrated to TRANSLATIONS

  • 14개 신규 번역 키 × 5개 언어 = 70개 항목 추가 (crash_* 예외 처리 다이얼로그 / already_running_* 중복 실행 / rename_skip_* Batch Renamer 스킵 / lib_required_msg Bulk Fixer ImportError × 4 / dlg_info 다이얼로그 헤더 fallback / help_* 도움말 창) / 14 new translation keys × 5 languages = 70 entries
  • dead code 제거: SHORTCUT_DEFS의 'label' 필드 (별도 _sc_label_keys 맵이 i18n 키 보유, 한 번도 읽히지 않던 코드), _CARD_CFG의 'label' 필드 (한 자리만 사용 → _theme_label() 호출로 대체) / Dead code cleaned: SHORTCUT_DEFS['label'] and _CARD_CFG['label']
  • TRANSLATIONS 바깥 한국어 문자열 191 → 142 (-49). 남은 142건은 의도된 부분 (122건 if lang == 'ko' 분기 안 가이드 콘텐츠, 7건 폰트/저작권/언어명, 4건 _section_icons 호환성 lookup, 9건 기타) / Korean string literals outside TRANSLATIONS reduced 191 → 142

---

📦 추가 / Added

• Batch Renamer 그룹 헤더 + 새 이름 컬럼 툴팁 / Batch Renamer tooltips on group header and new-name column
  • 기존엔 원본 파일명 컬럼에만 setToolTip(full_path) 박혀 있었어 — 그룹 헤더(📂 parent_folder)와 새 이름 컬럼은 툴팁 ❌라 긴 한국어 책 제목이나 챕터 이름이 컬럼 너비로 잘렸을 때 한눈에 정찰 ❌ / Previously only original-name column had setToolTip(full_path) — group header and new-name column had no tooltips
  • _f_refresh / _p_refresh 양쪽에서 세 자리(그룹 헤더 / 원본 컬럼 / 새 이름 컬럼)에 일관 적용 / Now applied symmetrically across both panels at three sites
  • 원본과 새 이름 표시 사이의 대칭성 복원 / Restores symmetry between original and new-name display

---

🐛 수정 / Fixed

• Batch Renamer (file mode) 그룹별 자릿수 / per-group digit width

  • _p_calc_preview가 가장 큰 그룹의 파일 수에서 계산한 단일 auto_d 값을 모든 그룹에 전역 적용 → 9-파일 그룹이 100+ 파일 그룹과 같은 3자리로 렌더링되던 문제. 이제 각 그룹이 자신의 파일 수에 맞춰 자릿수 계산 (grp_max_num = start + len(files) - 1) / Each group now computes its own digit width based on its own file count

• Batch Renamer ingest 통합 empty-folder 다이얼로그 / consolidated empty-folder dialog

  • 비어있는 폴더 여러 개 드래그 시 폴더마다 모달 _dlg_info가 떠 팝업 폭주로 ~21+ 폴더에서 앱 강제 종료 위험. 이제 빈 폴더 목록을 모아 단일 통합 다이얼로그 (≤10개: 전체 표시, >10개: 처음 10개 + ... (+N)) / Skipped folders consolidated into a single dialog (≤10 paths shown, >10 truncated with ... (+N))

• 중국어 사전의 i18n 일관성 / i18n consistency in Chinese dictionaries

  • zh_tw에 simplified 누출 2건 (tag_drop2, merge_sel_one), zh_cn에 merge_sel_one 키 누락. simplified 사용자가 _t의 zh_cn → zh_tw fallback path를 silent하게 타고 traditional 값을 받던 우연한 시각 일치 현상. 양쪽 사전이 각자의 스크립트로 키를 갖도록 정정 / Both dictionaries now carry the keys in their respective scripts

• legacy %APPDATA% config fallback 제거 / Dropped legacy %APPDATA% config fallback in _show_already_running_popup

  • pre-v1.0.x try-block 잔재 — ~/AppData/Roaming/FileNexusSuite/FileNexusSuite.json을 먼저 시도 후 __file__ 상대 경로 fallback. 두 분기 모두 dead since v1.0.x onward (_CONFIG_PATH = _app_dir() / "FileNexusSuite.json"만 사용). 14줄 → 10줄 / 14-line probe-and-fallback reduced to 10 lines (-4 lines, single source of truth)

---

🔄 변경 / Changed

• Batch Renamer ingest: O(1) 중복 검사 / O(1) duplicate-path check
  • 기존 그룹들에 대한 O(N²) any() 선형 검사를 set 조회로 교체. 폴더 ingest (_f_ingest)와 파일 ingest (_p_ingest, os.walk 재귀 path 포함) 양쪽에 대칭 적용. ~2,700 폴더 일괄 드래그 시 메인 스레드 CPU 시간 ~170ms 절약 / set lookup replacing O(N²) any() linear scan, saves ~170 ms on 2,700 folders dragged

---

🧪 테스트 자동화 / Test Automation

• 535 → 594 passing (+59), 61 classes (+3), 0 failures / 0 errors / 5 skipped (한림 로컬 + Git 폴더 이중 검증) / 535 → 594 passing (+59), 61 classes (+3), zero failures/errors, 5 intentional skips (Hanrim local + Git folder dual verification)
• TestBatchRenamerDigitWidth (+20) — _p_calc_preview의 그룹별 digit width 로직 순함수 추출 (auto/nopad/pad2/pad3 모드 × 경계 파일 수 × 시작값 + per-group independence) / Pure-function extraction of per-group digit-width logic
• TestBatchRenamerEmptyFolderDialog (+5 → -5 skipped) — 통합 empty-folder dialog의 통합 검증. async BatchIngestWorker가 _BarePanel 양식에서는 QObject가 ❌라 skip 양식. 통합 동작 자체는 _run_ingest_worker.on_done() 안에서 보존됨 / Integration test of consolidated empty-folder dialog (5 skipped due to async worker requirement)
• TestBatchRenamerScenarioB (+5) — 시나리오 B의 source-grep 검증. 4 신규 클래스 (BatchPreviewModel / BatchRowHeightDelegate / BatchIngestWorker / BatchRenameWorker) + PySide6 imports + QTableView() 교체 + worker kind 검증 + model 공개 API / Source-grep checks for scenario B classes (PySide6 not required)
• _run_fix 영문 sibling 테스트 (+29) — 6 클래스 × 영문 자매 테스트, _SENT_END = '.!?…。！？‥」』）)}>]"\''의 언어 중립 동작을 영문 입력으로 검증. 12 SAMPLE_EN_* fixtures (CC0 1.0) 추가 / 29 English sibling tests across 6 classes
• 8 unclosed file handle 제거 — open(path, encoding='utf-8').read() 안티패턴을 with open(...) as _f 양식으로 정정. ResourceWarning 8 → 0 / 8 unclosed file handles closed (ResourceWarnings 8 → 0)

---

📁 파일 변경 / File Changes

파일 / File	변경 / Change
FileNexusSuite.py	14,915 → 15,347 줄 (+432) — 시나리오 B refactor + i18n migration + python 제목 정정 / Scenario B refactor + i18n migration + python title fix
test_file_nexus.py	4,798 → 5,008 줄 (+210) — 자동화 테스트 +59건 / +59 automated tests
LICENSE	변경 ❌ (v1.0.10 그대로 보존) / Unchanged
version_info.txt	4곳 갱신 (filevers / prodvers / FileVersion / ProductVersion) / Version (4 locations) updated
README.md / README_KO.md	version 뱃지 (1.0.10 → 1.0.11) + tests 뱃지 (589 → 594 passing) / version + tests badges updated
README.txt	v1.0.11 갱신 / v1.0.11 updated
SECURITY.md	Supported Versions 갱신 (1.0.10 → 1.0.11) / Supported Versions updated
CHANGELOG.md / CHANGELOG_KO.md	v1.0.11 섹션 추가 (시나리오 B + python 제목 정정 흡수) / v1.0.11 section added

---

🔐 릴리즈 서명 / Release Signing

• 단일 Release 커밋 + SSH 서명 (Ed25519, fingerprint SHA256:4H2f7lrFfI4u0YP0dpp6N9BQH2f74iKjjMRHu7lyjKI) / Single Release commit + SSH signature
• 커밋 메시지 / Commit message: Release v1.0.11: Batch Renamer scalability + English-first transition + 12 inline UI i18n
• Commit hash: 3ca7987
• 태그 v1.0.11 SSH 서명, GitHub Verified 뱃지 / Tag v1.0.11 SSH-signed, GitHub Verified badge
• GitHub Actions CI windows-latest + Python 3.10 환경에서 자동 통과 / GitHub Actions CI passed on windows-latest + Python 3.10

---

⚠ 알려진 이슈 / Known Issues

• 본 릴리즈에서 신규 알려진 이슈 ❌ — v1.0.10의 *`test_file_nexus.py...

File Nexus Suite v1.0.10

v1.0.10 — MIT 전환과 OSS 결의 시작점: 라이선스 전환 + LGPL 호환성 명시화 + SignPath OSS Sponsorship 신청 / The Start of the OSS Turn: License Transition + LGPL Compatibility Documentation + SignPath OSS Sponsorship Application

v1.0.10은 v1.0.5 ~ v1.0.9의 5개 릴리즈로 누적된 v1.0.x 시리즈 인프라를 OSS 커뮤니티로 개방하는 결정적 전환점입니다. 본 릴리즈는 세 트랙(라이선스 전환 Freeware → MIT, LGPL 호환성 명시적 문서화, SignPath OSS Sponsorship 신청 트랙)의 묶음이며, 코드 변경량은 v1.0.5~v1.0.9 어떤 릴리즈보다도 적습니다(FileNexusSuite.py 라인 수 변화 0, 텍스트 내용만 변경). 그러나 의미 변화는 가장 큽니다 — 사용자가 본 소프트웨어를 받아 쓸 때의 권리가 금지에서 허용으로 정확히 정반대 방향으로 확장되었습니다.

v1.0.10 marks the decisive turning point where the v1.0.x series infrastructure — accumulated across five releases (v1.0.5 ~ v1.0.9) — is opened to the OSS community. This release bundles three tracks (license transition Freeware → MIT, explicit LGPL compatibility documentation, SignPath OSS Sponsorship application track). Code changes are smaller than any v1.0.5~v1.0.9 release (FileNexusSuite.py line count delta 0, text-only changes). Yet the semantic change is the largest: the rights users gain when they receive this software have been flipped from prohibited to permitted in the exact opposite direction.

---

✨ 주요 변경 / Major Changes

• 라이선스 전환: Freeware (소스 공개) → MIT License / License transition: Freeware (source available) → MIT License

  • 사용·수정·재배포·판매가 모두 자유롭게 허용 (저작권 고지 유지 조건). 이전 버전의 "무단 재배포·재가공·판매 금지" 문구가 정확히 정반대 방향으로 전환 / All of use, modify, redistribute, and sell are now freely permitted (provided that the copyright notice is retained). The previous "unauthorized redistribution, repackaging, or resale prohibited" clause is reversed in the exact opposite direction
  • 사용자는 본 소프트웨어를 fork하여 자신의 프로젝트로 발전시키거나, 수정본을 배포하거나, 상업적 제품에 통합 가능 / Users may fork this software to develop into their own projects, distribute modified versions, or integrate into commercial products
  • 한림이 *"개인 작업 도구로 시작했지만, 같은 작업을 하는 다른 분들에게도 도움이 되기를"*이라는 결로 v1.0.x 시리즈 누적의 결과를 OSS 커뮤니티로 개방 / Released by Hanrim with the spirit "originally built as a personal tool, in the hope it may help others with similar workflows"

• MIT 선택의 결 / Why MIT specifically

  • 간결성: 21줄 표준 텍스트로 사용자가 읽고 이해하기 쉬움 / Conciseness: 21-line standard text easy for users to read and understand
  • 호환성: GPL을 비롯한 거의 모든 OSS 라이선스와 호환 — fork 시 라이선스 충돌 0 / Compatibility: Compatible with virtually all OSS licenses including GPL — zero license conflicts when forked
  • 상업 활용 명시적 허용: "GPL 전염성" 같은 의무 발생 0 / Commercial use explicitly permitted: zero obligations like "GPL contagion"
  • OSS 업계 표준: GitHub Top 프로젝트의 50% 이상이 MIT 사용 / OSS industry standard: 50%+ of GitHub Top projects use MIT

• Copyright © 2026 Hanrim. All rights reserved. → Copyright © 2026 Hanrim — "All rights reserved" 표기 6곳 일괄 정리. 1910년 부에노스아이레스 협약 잔재로 현대 저작권법에 법적 의미 없음 + MIT 라이선스 의미와 결 일관성 / "All rights reserved" notation cleaned across 6 locations. Vestige from the 1910 Buenos Aires Convention with no legal meaning in modern copyright law + consistency with MIT license semantics

---

📦 추가 / Added

• LGPL 호환성 명시적 문서화 / Explicit LGPL compatibility documentation

  • _build_license_html()의 PySide6 (LGPL-3.0) / chardet (LGPL-2.1) note 필드에 LGPL replacement 안내 1문장씩 추가 / One-sentence LGPL replacement note added to PySide6 (LGPL-3.0) / chardet (LGPL-2.1) note fields in _build_license_html()
  • 안내 문장: "File Nexus Suite is built with PyInstaller. Users may replace this LGPL library by rebuilding from source — see the GitHub repository for build instructions."
  • PyInstaller --onedir 빌드 모드의 _internal/ 폴더 분리 구조에서 사용자가 LGPL 라이브러리를 직접 교체 가능함을 명시. LGPL §3 의무를 암묵적 충족(GitHub source 공개)에서 명시적 충족으로 강화하여 회색지대 영구 차단 / Explicitly states that users can directly replace LGPL libraries thanks to PyInstaller --onedir mode's _internal/ folder separation. Strengthens LGPL §3 obligation from implicit fulfillment (GitHub source publication) to explicit documentation, permanently closing the gray zone

• README.txt _internal 폴더 보호 안내 / README.txt _internal folder protection note

  • PyInstaller --onedir 빌드 모드에서 사용자가 _internal/ 폴더를 *"필요 없어 보이는 데이터"*로 오해하여 삭제할 위험을 한/영 양쪽 안내로 차단 / Mitigates the risk of users mistaking _internal/ for "seemingly unnecessary data" and deleting it, with both Korean and English notices
  • README.txt가 *"포장지 안내 라벨"*에서 진짜 정체성인 *"_internal 보호 장치"*로 의도-산출물 정합을 갖춤 / README.txt achieves intent-artifact alignment, transitioning from "package label" to its true identity as "_internal protection device"

• README "이타심" 한 줄 / README "altruism" line

  • README.md / README_EN.md 라이선스 섹션 + _build_license_html() 본 프로젝트 항목 note에 일관 추가. "개인 작업 도구로 시작했지만, 같은 작업을 하는 다른 분들에게도 도움이 되기를 바라며 MIT 라이선스로 공개합니다." / Added consistently to README.md / README_EN.md license section + _build_license_html() project entry note. "Originally built as a personal tool, now released under MIT in the hope it may help others with similar workflows."
  • GitHub README와 앱 내 라이선스 페이지가 같은 결의 메시지를 사용자에게 전달 / GitHub README and in-app license page deliver the same message to users

---

🔄 변경 / Changed

• 5언어 license_summary 키 의미 정반대 재작성 / 5-language license_summary key reworded with opposite semantics

  • en/ko/ja/zh_cn/zh_tw 모두 "무단 재배포·재가공·판매 금지" → *"사용·수정·재배포·판매 모두 허용"*으로 정확히 정반대 방향. zh_cn은 v1.0.9 §5.1.G fallback chain의 영향을 받지 않도록 5언어 직접 정의 유지 (라이선스 핵심 키이므로 zh_tw 어휘 차이 보존) / All five languages reworded from "unauthorized redistribution, repackaging, or resale prohibited" → "use, modify, redistribute, and sell all permitted". zh_cn maintains direct 5-language definition unaffected by v1.0.9 §5.1.G fallback chain (license-critical key, preserves zh_tw vocabulary distinction)

• _build_license_html() 본 프로젝트 항목 전면 재작성 / _build_license_html() project entry fully reworded

  • Freeware — Free for Personal & Commercial Use → MIT License / Title field updated
  • note 필드: "무단 재배포·재가공·판매 금지" 단락 → "MIT 라이선스 / 저작권 고지 유지 시 모든 권리 허용" 단락. "이타심" 한 줄 신규 추가, AI 페어 프로그래밍 결 보존 / note field reworded; "altruism" line newly added, AI pair programming context preserved

• README 뱃지 시각 체계 재정립 / README badge visual system refined

  • *"v1.0.10이 v1.0.x 시리즈에서 OSS 도착점"*이라는 결을 색의 흐름으로 표현 / Expresses the narrative "v1.0.10 as the OSS arrival point of v1.0.x series" through color flow
  • 시작점 (#7B6FA3 보라): version 1.0.10 / Starting point (#7B6FA3 purple): version 1.0.10
  • OSS 활기 (#97CA00 짙은 OSS 초록): tests 535 passing / license MIT ← v1.0.10 신규 자리 / OSS vitality (#97CA00 deep OSS green): tests 535 passing / license MIT ← new placement in v1.0.10
  • 정체성 (#CC785C Anthropic 구릿빛): AI pair Claude / Download CTA / Identity (#CC785C Anthropic copper): AI pair Claude / Download CTA
  • 브랜드 인용 (외부 표준 그대로): python / PySide6 / platform / CI badge / Brand citations (external standards as-is): python / PySide6 / platform / CI badge

• LICENSE 파일 형식 전환 / LICENSE file format transition

  • 자체 작성 Freeware 형식 → MIT 표준 21줄 텍스트로 전환. GitHub Licensee gem이 정확히 "MIT License" 자동 탐지 / Custom Freeware format → 21-line MIT standard text. GitHub Licensee gem now correctly auto-detects "MIT License"
  • 한국어 안내 + Test Data Exception (CC0) 부록 보존. third-party libraries 목록은 LICENSE에서 제거 (_build_license_html() + README가 단일 진실 원천 책임) / Korean notice + Test Data Exception (CC0) appendix preserved. Third-party libraries list removed from LICENSE (_build_license_html() + README take single source of truth responsibility)

---

✅ 검증 / Verified

• 라이브러리 라이선스 호환성 무결 점검 / Library license compatibility integrity audit

  • 7종 의존 라이브러리 (Python/PySide6/chardet/python-docx/pdfplumber/openpyxl/python-hwpx) 모두 MIT 호환 확인 / All 7 dependencies (Python/PySide6/chardet/python-docx/pdfplumber/openpyxl/python-hwpx) confirmed MIT-compatible
  • LGPL 2종(PySide6/chardet)의 §3 의무가 (가) GitHub source 공개 + (다) 명시적 안내 추가의 이중 보장으로 회색지대 영구 차단 / LGPL libraries' §3 obligation permanently closed via dual guarantee: (가) GitHub source publication + (다) explicit replacement note

• 개인 자산 분리 점검 / Personal asset separation audit

  • LICENSE / _build_license_html() / README / RELEASE_NOTE 모든 OSS-facing 산출물에서 한림 개인 자산(블로그, 본명 등) 일절 미포함 확인. 이 결은 v1.0.10 이후 모든 릴리즈에 영구 적용 / All OSS-facing artifacts confirmed free of Hanrim's personal assets (blog, full name, etc.). This principle applies permanently from v1.0.10 onward

---

🧪 테스트 자동화 / Test Automation

• 535 passing (v1.0.9와 동일), 58개 클래스, 실패·오류·스킵 0 (한림 로컬 + Git 폴더 이중 검증 + GitHub Actions CI 통과) / 535 passing (same as v1.0.9), 58 classes, zero failures/errors/skips (Hanrim local + Git folder dual verification + GitHub Actions CI passed)
• v1.0.10 변경 영역(라이선스 텍스트 5언어 + 라이브러리 note 2곳 + 푸터 "All rights reserved" 제거 + 버전 갱신)이 자동 테스트 invariant와 충돌 0 / Zero conflicts between v1.0.10 change areas (license text 5 languages + library notes 2 locations + footer "All rights reserved" removal + version update) and test invariants
• v1.0.4 작업 시점에 도입된 정수 튜플 비교 패턴 (parts = tuple(int(p) for p in ver.split('.')))이 1.0.10 같은 두 자릿수 패치 버전을 자동 대응 — 모든 버전 비교 invariant 자연 통과 / Integer tuple comparison pattern introduced in v1.0.4 automatically handles two-digit patch versions like 1.0.10 — all version comparison invariants pass naturally

---

🚀 향후 트랙 / Deferred Tracks

• SignPath OSS Sponsorship 신청 / SignPath OSS Sponsorship application
  • v1.0.10 Release publish 직후 signpath.org에 OSS Sponsorship 신청서 제출. v1.0.10이 *"Latest release: first MIT release"*로 신청서에 기록됨으로써 검토 신뢰도 강화 / OSS Sponsorship application submitted to signpath.org immediately after v1.0.10 publish. v1.0.10 recorded in application as "Latest release: first MIT release" strengthens review credibility
  • 자격 조건 6개 모두 충족: OSI-approved license (MIT) / No malware / Actively maintained / Released / Documented / Verifiable build from source
  • 승인 후 v1.0.11에...

File Nexus Suite v1.0.9

v1.0.9 — v1.0.x 시리즈 마무리: ACDG 사후 정리 묶음 (표기 정책 동기화 + 빌드 도구 strict 모드 + zh_cn 사전 정리 + fallback chain) / End of v1.0.x series: ACDG cleanup bundle (notation policy sync + build strict mode + zh_cn dictionary cleanup + fallback chain)

v1.0.9는 v1.0.5 ~ v1.0.8 사이 4개 릴리즈로 무거워진 v1.0.x 시리즈를 닫는 사후 정리 / 데이터 청소 카테고리 릴리즈입니다. v1.0.8 인수인계 §5.1에서 정의된 ACDG 4개 작업(A: 표기 정책 동기화, C: 빌드 도구 strict 모드, D: HelpDialog 점검, G: zh_cn 사전 정리)을 묶어 진행했으며, 다음 시리즈(v1.1.0 — 구조 리팩토링 / 새 기능)와 결을 명확히 분리합니다. §5.1.D는 점검 결과 옵션 C 적용 불요로 0줄 작업으로 마감되어 잠재 결함 없음이 데이터로 확인됐고, §5.1.G는 인수인계 명세 "188개 키"가 데이터로 검증되지 않아 현실 데이터 47개 → invariant 보호 7개 제외 → 40개로 정직하게 재정의한 후 fallback chain(zh_cn → zh_tw → ko)을 함께 도입하여 사용자 동작 영향 0이 정의상 보장되도록 구조적으로 풀었습니다. 1차 적용 후 v1.0.5 회귀 테스트 6개 FAIL이 발견됐으나 회귀 수정 사이클을 거쳐 535/0/0/0으로 깨끗이 닫혔습니다.

v1.0.9 closes the v1.0.x series, which had grown heavy across four releases (v1.0.5 ~ v1.0.8), under the post-cleanup / data hygiene category. It bundles the four ACDG tasks defined in v1.0.8 handover §5.1 (A: notation policy sync, C: build strict mode, D: HelpDialog audit, G: zh_cn dictionary cleanup), drawing a clear line from the next series (v1.1.0 — structural refactor / new features). §5.1.D was closed as a 0-line task after the audit confirmed Option C didn't apply, with the absence of latent defects established as evidence; §5.1.G honestly re-defined the handover spec "188 keys" — which was not verifiable in data — to 47 actual matches → 40 after excluding 7 invariant-protected keys, while introducing a fallback chain (zh_cn → zh_tw → ko) so that user-observable behavior remains unchanged by definition. After initial application, six v1.0.5 regression tests failed, but a regression-fix cycle closed cleanly at 535/0/0/0.

---

✨ 주요 기능 / Major Features

• build_pyinstaller.py --strict 모드 도입 / build_pyinstaller.py --strict mode introduced

  • 버전 일관성 검증 단계를 빌드 전(step 5)으로 분리. mismatch 시 strict 모드에서 PyInstaller가 시작도 하기 전에 즉시 abort되어 수십 초 빌드 + UPX 압축 시간 절약 + 기존 빌드 산출물 보존 / Version consistency check separated to pre-build (step 5). In strict mode on mismatch, build aborts before PyInstaller even starts, saving tens-of-seconds build + UPX compression time and preserving prior dist artifacts
  • 신규 함수 check_version_consistency(strict) 추가, step 시퀀스 7→8단계로 재정렬 / New function check_version_consistency(strict) added, step sequence reorganized 7→8
  • build.bat wrapper에 %* 인자 패스스루 추가하여 build.bat --strict 직접 호출 가능 / build.bat wrapper now supports %* argument pass-through for direct build.bat --strict invocation

• zh_cn 사전 fallback chain 도입 / zh_cn dictionary fallback chain introduced

  • _t() / _rt() 함수에 zh_cn → zh_tw → ko fallback chain 추가. v1.0.5부터 ko 단일 fallback이었던 한계 보완 / _t() / _rt() now use zh_cn → zh_tw → ko chain. Improvement over single ko fallback since v1.0.5
  • zh_cn 사전에 미정의 키는 zh_tw로 1차 fallback되어 사용자 동작 영향 0이 정의상 보장 / Keys missing in zh_cn fall back to zh_tw first, guaranteeing zero user-observable impact by definition

• zh_cn 사전 40개 키 정리 / zh_cn dictionary 40-key cleanup

  • zh_cn ↔ zh_tw 값이 100% 동일한 키 47개 중 invariant 보호 7개 제외하고 40개 정리 / 40 keys cleaned among 47 with values identical to zh_tw, excluding 7 invariant-protected keys
  • 정리 대상: 이모지/심볼 (▶ 등), 짧은 단어 (取消/完成/字/行 등), 자릿수 표기 (最少2位/固定3位 등), 자리표시자 (例: jpg, png, gif 등), 테마명 (深色/蜂蜜/薰衣草 등), 인코딩 라벨 일부 / Cleaned: emojis/symbols, short words, digit notations, placeholders, theme names, partial encoding labels
  • 보호된 7개: dlg_yes/dlg_no/dlg_warning (다이얼로그 공통), conv_status_done/conv_sub_epub2txt/conv_sub_txt2epub (변환 상태), rename_cancel (취소) / 7 protected: dialog commons, conversion status, cancel — core UI keys retain direct 5-language definition

• test_zh_cn_fallback_to_zh_tw 신규 invariant / test_zh_cn_fallback_to_zh_tw new invariant

  • _t() / _rt() 두 함수 모두에 fallback 패턴이 살아있고 검증 대상 키가 존재하는지 검증 / Verifies fallback pattern is alive in both _t()/_rt() and that verification target keys exist
  • TEST_MANAGEMENT_POLICY.md §3 4번 원칙 적용. fallback 메커니즘이 향후 누군가의 실수로 깨지면 CI에서 즉시 자동 감지 / Applies TEST_MANAGEMENT_POLICY.md §3 principle #4 — accidental future breakage caught by CI immediately

---

🐛 버그 수정 / Bug Fixes

• (없음 — v1.0.9는 사후 정리 카테고리) / (None — v1.0.9 is a post-cleanup category release)
  • 본 릴리즈는 기능 수정이 아닌 코드 청결성 및 도구 개선이 핵심 / This release focuses on code hygiene and tooling improvement rather than functional fixes

---

🔄 변경 / Changed

• README.md / README_EN.md Copyright 및 제작자 표기 동기화 / README.md / README_EN.md copyright and author notation sync

  • Yongwoo Shin (Hanrim) → Hanrim 단독 (4곳). v1.0.8 §4.36 매체별 표기 정책에 따른 GitHub-facing 자료 동기화 / 4 locations changed to Hanrim alone. GitHub-facing material sync per v1.0.8 §4.36 medium-specific notation policy
  • 외부 격식 매체(포트폴리오, 기획서)는 풀네임 Yongwoo Shin (Hanrim) 유지 / Formal external materials (portfolio, planning docs) retain full form

• test_all_langs_same_key_count 재설계 / test_all_langs_same_key_count redesigned

  • 대칭 강제(5언어 동일 키 수)에서 비대칭 허용으로 전환 — zh_cn은 zh_tw 부분집합 허용, ko/en/ja/zh_tw는 동일 키 수 강제 / Switched from symmetric enforcement (all 5 languages same count) to asymmetric — zh_cn allowed as zh_tw subset, ko/en/ja/zh_tw must match
  • zh_cn fallback 메커니즘과 정합성 확보 / Aligned with zh_cn fallback mechanism

• test_all_languages_have_similar_key_count 갱신 / test_all_languages_have_similar_key_count updated

  • zh_cn은 fallback chain 사용 명시하여 키 수 검증에서 제외, 다른 4언어만 ≤5 차이 강제 / zh_cn excluded from count check (fallback intent), other 4 languages still constrained ≤5 diff
  • v1.0.5 시절 의도(완결성 보장) 유지하면서 §5.1.G 정합 / Retains v1.0.5-era intent (completeness guarantee) while aligning with §5.1.G

---

✅ 검증 / Verified

• HelpDialog 점검 — 옵션 C 적용 불요 확인 / HelpDialog audit — Option C not applicable confirmed
  • v1.0.8 SettingsDialog의 라벨 color 잔재 버그와 같은 구조적 결함이 다른 다이얼로그에 잠재할 가능성을 진단 / Audited whether the SettingsDialog label-color residue defect from v1.0.8 was latent in other dialogs
  • 호출 방식 비교 결과: HelpDialog는 단순 exec() 모달 + 시그널 연결 0개 / SettingsDialog는 "창 유지" + 시그널 3개 (theme/shortcuts/language) — 본질적으로 다른 패턴 / Comparison result: HelpDialog uses plain exec() modal + 0 signals; SettingsDialog uses "stays open" + 3 signals — fundamentally different patterns
  • HelpDialog의 refresh() 메서드는 의도적으로 pass + 주석 "exec() 모달이라 열릴 때마다 새로 생성됨"으로 의도 명문화. 다이얼로그가 살아있는 동안 외부 상태가 바뀌어 들어올 시나리오 자체가 구조적으로 존재하지 않음 / HelpDialog.refresh() is intentionally pass with comment "modal exec(), recreated on each open"; the scenario of external state changing while dialog is alive structurally cannot occur
  • 결론: 점검 자체가 v1.0.9 §5.1.D의 산출물 — 잠재 결함 없음을 데이터로 명시. 코드 변경 0줄로 마감 / Conclusion: the audit itself is the §5.1.D artifact — absence of latent defects established. Closed as 0-line task

---

🧪 테스트 자동화 / Test Automation

• 총 535개 테스트 통과 / 535 tests passing, 58개 클래스 / 58 classes, 실패 0 / 오류 0 / 스킵 0 / 0 failed / 0 errors / 0 skipped ⭐
• +1 vs v1.0.8 (534 → 535) — test_zh_cn_fallback_to_zh_tw 신규 invariant / test_zh_cn_fallback_to_zh_tw new invariant
• 회귀 발견 → 수정 사이클 / Regression-discovery → fix cycle:
  • §5.1.G 1차 적용 후 v1.0.5 회귀 테스트 6개 FAIL 발견 — merge_enc_utf8 / merge_enc_utf16 / merge_enc_shiftjis 3개가 invariant 보호 키였음을 1차 진단에서 누락 / After initial §5.1.G application, 6 v1.0.5 regression tests failed — first diagnosis missed that 3 keys (merge_enc_utf8 / merge_enc_utf16 / merge_enc_shiftjis) were invariant-protected
  • 정리 대상 47→40개로 축소 + test_all_languages_have_similar_key_count zh_cn 예외 갱신으로 회귀 닫음 / Resolved by reducing cleanup target 47→40 and updating test_all_languages_have_similar_key_count to except zh_cn
• 이중 검증 / Dual verification:
  • 작업 폴더: 535/0/0/0 / Work folder: 535/0/0/0
  • Git 폴더: 535/0/0/0 / Git folder: 535/0/0/0

---

🔍 검증 범위 / Verification Scope

• 단위 테스트 / Unit tests: 535 passing (한림 로컬 Windows + Git 폴더 이중 검증, GitHub Actions CI는 push 후 자동 재현 예정) / 535 passing (dual verification on Hanrim's local Windows + Git folder; GitHub Actions CI will reproduce automatically after push)
• 수동 QA — §5.1.G 직접 검증 권장 시나리오 / Manual QA — §5.1.G recommended scenarios:
  • 앱 언어를 简体中文(zh_cn)로 전환 후 정리한 40개 키가 사용되는 화면 확인 (예: 테마 설정의 "白色/深色", Batch Renamer의 "▶") / Switch app language to 简体中文 and visit screens using cleaned keys (e.g., theme settings "白色/深色", Batch Renamer "▶")
  • fallback chain으로 zh_tw 값과 동일하게 표시되어야 함 (값 100% 동일이라 시각 차이 0) / Should display identical to zh_tw values via fallback (100% value match means zero visual difference)
  • zh_tw / 기타 언어 회귀 확인 — 사전 미변경이라 영향 없어야 함 / zh_tw and other languages regression check — should be unaffected (dictionaries unchanged)
• 빌드 도구 검증 / Build tooling verification:
  • python build_pyinstaller.py 정상 빌드 (기존 동작 보존) / python build_pyinstaller.py normal build (existing behavior preserved)
  • python build_pyinstaller.py --strict 헤더 표시 + 정상 빌드 / python build_pyinstaller.py --strict header display + normal build
  • 의도적 mismatch 시나리오: README.txt 임시 변경 후 --strict 실행 시 step 5에서 즉시 abort 확인 / Intentional mismatch scenario: temporary README.txt change + --strict aborts immediately at step 5
  • build.bat / build.bat --strict wrapper 통과 / build.bat / build.bat --strict wrapper verification passed
• 버전 정합성 검증 / Version consistency verification:
  • APP_VERSION 상수 / version_info.txt 4곳 / README.md / README_EN.md 뱃지 / README.txt 모두 v1.0.9로 정합 / All aligned to v1.0.9: APP_VERSION constant, version_info.txt (4 locations), README.md/README_EN.md badges, README.txt

---

📦 구조적 변경 / Structural Changes

• 라인 수 변동 / Line count changes:
  • FileNexusSuite.py: 14,883 → 14,850줄 (-33: zh_cn 40개 키 제거 -40 + _t()/_rt() fallback 보강 +6 + APP_VERSION 갱신 등) / -33 lines (zh_cn 40-key removal -40 + _t()/_rt() fallback +6 + APP_VERSION etc.)
  • `test_file_nexus.py...

File Nexus Suite v1.0.8

v1.0.8 — 설정 다이얼로그 라벨 color 잔재 버그 구조적 해결 (페이지 lazy 재생성) / Settings dialog label color residue bug — structural fix via page lazy recreation

v1.0.8은 v1.0.5부터 다섯 릴리즈를 살아남은 본과제를 마침내 해결한 릴리즈입니다. v1.0.6에서 시도한 4가지 접근(QTimer 지연 / unpolish-polish / QApplication 전역 재적용 / findChildren update)이 모두 실패한 후 v1.0.7에서 이월됐던 본과제로, 이번에는 사전 조사 → 코드 진단 → 옵션 재평가의 정직한 흐름으로 풀어냈습니다. 코드 진단 결과 §11.1의 "영향 위젯 3가지"가 실제로는 22개 위젯 갱신 누락의 빙산 일각이었음이 드러났고, 처음 권장했던 옵션 A(Targeted 갱신, 6080줄)를 옵션 C(페이지 lazy 재생성, +17줄)로 변경하는 정직한 재평가를 거쳐 코드 변경량을 1/4로 줄이면서 누락 재발 위험을 영구 방지하는 구조적 해결에 도달했습니다. 워크어라운드(설정창 재오픈)와 동일한 메커니즘을 다이얼로그 내부에서 자동화한 방식으로, v1.0.6 Phase 2 Completion Record §11.3에서 한림이 사전 후보로 적어둔 "페이지 lazy 생성 + 재방문 시 조건부 재생성" 방향과 정확히 일치합니다. 사이드 결함 2건(_ver_lbl 갱신 누락, 출력 폴더 버튼 텍스트 갱신 누락)도 같은 구조적 해결로 동시 풀렸으며, TEST_MANAGEMENT_POLICY.md §3 4번 원칙(신규 기능에 대한 자동 커버리지 명시)에 따라 TestSettingsDialogStructureInvariant 클래스 3개 invariant가 추가되어 옵션 C 메커니즘이 향후 누군가의 실수로 깨질 시 CI에서 즉시 자동 감지됩니다.

v1.0.8 finally resolves the original target that survived five releases since v1.0.5. After v1.0.6's four attempted approaches (QTimer deferral, unpolish-polish, QApplication global re-apply, findChildren update) all failed and the issue was deferred through v1.0.7, this release tackles it through an honest sequence of preliminary research → code diagnosis → option re-evaluation. Code diagnosis revealed that the "3 affected widgets" mentioned in §11.1 were merely the visible tip of a 22-widget update omission iceberg, leading to a transparent re-evaluation that swapped the initially recommended Option A (targeted updates, 6080 lines) for Option C (page lazy recreation, +17 lines) — reducing code change to a quarter while permanently preventing recurrence. The mechanism automates the existing workaround (close and reopen the settings dialog) within the dialog itself, aligning precisely with the "page lazy recreation on revisit" approach that Hanrim had pre-listed in v1.0.6 Phase 2 Completion Record §11.3. Two side defects (_ver_lbl update omission, output folder button text update omission) were resolved as a byproduct of the structural fix, and following TEST_MANAGEMENT_POLICY.md §3 principle #4 (codify automated coverage for new features), TestSettingsDialogStructureInvariant with 3 invariant tests was added — ensuring CI automatically catches any future accidental breakage of the Option C mechanism.

---

✨ 주요 기능 / Major Features

• 설정 다이얼로그 페이지 lazy 재생성 메커니즘 도입 / Settings dialog page lazy recreation mechanism

  • 신규 메서드 SettingsDialog._recreate_pages() — 페이지 4개 destroy + recreate / New method SettingsDialog._recreate_pages() — destroy + recreate 4 pages
  • 7단계 안전 흐름: 단축키 캡처 안전 종료 → 출력 폴더 임시 입력값 보존 → 기존 페이지 위젯 제거(removeWidget + deleteLater) → 컨테이너 dict 초기화 → 새 페이지 생성 → 임시 입력값 복원 → 현재 페이지 전환 / 7-step safe flow: stop keyboard capture → preserve unsaved output folder input → remove old page widgets (removeWidget + deleteLater) → clear container dicts → create new pages → restore unsaved input → switch to current page
  • 워크어라운드(설정창 재오픈) 메커니즘의 명시적 자동화 — v1.0.6 Phase 2 Completion Record §11.3 권장 방향과 일치 / Explicit automation of the existing workaround — aligns with v1.0.6 Phase 2 Completion Record §11.3 recommendation

• _refresh_theme / _retranslate_dialog 책임 명확화 / _refresh_theme / _retranslate_dialog responsibility clarification

  • 다이얼로그 외곽 위젯만 책임지도록 단순화. 페이지 내부 위젯의 stylesheet·텍스트 갱신은 _recreate_pages에 일괄 위임 / Simplified to handle only outer dialog widgets; page-internal widget styling/text updates fully delegated to _recreate_pages
  • _refresh_theme: 32줄 → 30줄 / 32 lines → 30 lines
  • _retranslate_dialog: 48줄 → 16줄 / 48 lines → 16 lines

• TestSettingsDialogStructureInvariant 신설 — 옵션 C 메커니즘 구조 invariant / TestSettingsDialogStructureInvariant established — Option C mechanism structural invariant

  • test_settings_dialog_has_recreate_pages — _recreate_pages 메서드 존재 검증 (hasattr + callable) / _recreate_pages method existence verification
  • test_refresh_theme_calls_recreate_pages — _refresh_theme 본문에 self._recreate_pages() 호출 포함 검증 (inspect.getsource 기반) / _refresh_theme source-level call verification (inspect.getsource)
  • test_retranslate_dialog_simplified — _retranslate_dialog이 페이지 내부 attribute 9개(_theme_page_title, _lang_page_title 등)를 직접 갱신하지 않음 검증 / _retranslate_dialog does not directly touch 9 page-internal attributes (_theme_page_title, _lang_page_title, etc.)
  • TEST_MANAGEMENT_POLICY.md §3 4번 원칙(신규 기능에 대한 자동 커버리지 명시) 적용. 옵션 C 메커니즘이 향후 누군가의 실수로 깨지면 CI에서 즉시 자동 감지 / Applies TEST_MANAGEMENT_POLICY.md §3 principle #4 (codify auto-coverage for new features) — accidental future breakage caught by CI immediately

• 사전 조사 → 코드 진단 → 옵션 재평가 흐름 명문화 / Preliminary research → code diagnosis → option re-evaluation, codified

  • v1.0.6 §11.3의 "사전 조사 필수" 원칙을 실제 작업 흐름으로 적용한 첫 사례 / First execution of the "preliminary research mandatory" principle from v1.0.6 §11.3 as actual workflow
  • 4개 작업 문서 산출: 사전 조사 노트 / 코드 진단 보고서 / 옵션 재평가 보고서 / 옵션 C 작업 지시서 / 4 process documents produced: preliminary research note / code diagnosis report / option re-evaluation report / Option C work instruction
  • 이 흐름이 옵션 A → C 변경의 정직한 근거가 됨 (22개 누락 발견 후 권장 변경) / This flow provided the honest rationale for switching Option A → C (after discovering 22 omissions)

---

🐛 버그 수정 / Bug Fixes

• 설정 다이얼로그 라벨/프레임 color 잔재 버그 (v1.0.5부터 존재, 본과제) / Settings dialog label/frame color residue (pre-existing since v1.0.5, original target)

  • 현상: 라이트 → 다크 방향 테마 전환 후 다른 탭 이동 시 일부 위젯(언어 프레임 배경, 타이틀 라벨 color, 출력 폴더 위젯)이 이전 테마 값으로 잔재. 설정창 재오픈 시 정상 복귀 (워크어라운드) / Symptom: after light → dark theme switch and tab navigation, some widgets (language frame background, title label color, output folder widgets) retained previous-theme values. Closing and reopening the settings dialog restored normal display (workaround)
  • 근본 원인: 페이지 4개의 inline stylesheet에 색상값이 f-string으로 박혀 생성 시점 테마로 영구 고정 (v1.0.5부터의 구조적 한계). __init__에서 단 한 번 생성되어 QStackedWidget에 적층되며 절대 재생성되지 않음 / Root cause: f-string-embedded colors in pages' inline stylesheets froze them at creation-time theme (structural limitation since v1.0.5). Pages were created exactly once in __init__ and stacked into QStackedWidget, never recreated
  • 코드 진단으로 §11.1의 "영향 위젯 3가지"가 실제로는 22개 위젯 갱신 누락의 빙산 일각임이 드러남 — 페이지 내부 거의 모든 inline stylesheet 위젯이 동일한 구조적 문제 / Code diagnosis revealed §11.1's "3 affected widgets" were the visible tip of 22-widget update omission iceberg — nearly all page-internal inline-stylesheet widgets shared the same structural defect
  • 수정: 옵션 C(페이지 lazy 재생성) — 테마/언어 변경 시 페이지 4개를 destroy + recreate. 워크어라운드 메커니즘의 자동화 / Fix: Option C (page lazy recreation) — destroy + recreate all 4 pages on theme/language change. Automation of the existing workaround
  • 옵션 A → C 정직한 재평가: 처음 권장했던 옵션 A(Targeted 갱신, 6080줄)는 22개 위젯 발견 후 누락 재발 위험 영구 보유라는 한계가 드러남. 옵션 C(+17줄)로 변경하여 코드 변경량 1/4로 축소 + 구조적 해결 / Honest re-evaluation Option A → C: initially recommended Option A (targeted updates, 6080 lines) revealed permanent recurrence risk after the 22-widget discovery. Switched to Option C (+17 lines) — quarter the code change + structural resolution

• _ver_lbl 테마 전환 갱신 누락 (사이드 결함, v1.0.6 잔재) / _ver_lbl theme switch update omission (side defect, v1.0.6 residue)

  • 현상: 사이드바 하단 버전 라벨이 테마 전환 시 갱신되지 않아 이전 테마 색상으로 잔재 / Symptom: sidebar bottom version label retained previous theme colors after theme switch
  • 발견 경로: v1.0.6 코드에 # v1.0.6: 테마 전환 시 갱신용 self 저장이라 주석 달아놓고도 _refresh_theme 호출이 누락된 결함이 옵션 C 작업 중 코드 진단 단계에서 발견 / Discovery: v1.0.6 source contained the comment # v1.0.6: stored on self for theme switch updates but the actual _refresh_theme call was missing — surfaced during Option C code diagnosis
  • 수정: _refresh_theme에 1줄 추가 (외곽 위젯이라 _recreate_pages 처리 대상 아님) / Fix: 1 line added to _refresh_theme (outer widget, not handled by _recreate_pages)

• 출력 폴더 버튼 텍스트 갱신 누락 (사이드 결함, v1.0.6 D-2 잔재) / Output folder button text update omission (side defect, v1.0.6 D-2 residue)

  • 현상: 언어 변경 시 출력 폴더 [선택] / [기본값] 버튼 텍스트가 이전 언어로 잔재 / Symptom: output folder [Pick] / [Reset] button text retained previous language after language change
  • 근본 원인: _retranslate_dialog이 self._odir_btn / self._odir_reset_btn을 참조하지만, _page_language에서는 로컬 변수 odir_btn / odir_reset로만 만들어 hasattr 검사로 silently fail / Root cause: _retranslate_dialog referenced self._odir_btn / self._odir_reset_btn, but _page_language only created them as local variables odir_btn / odir_reset — the hasattr guard caused silent failure
  • 수정: 페이지 재생성으로 자동 해결 (옵션 C 부수 효과) / Fix: automatically resolved by page recreation (Option C byproduct)

---

📄 문서 / Documentation

• CHANGELOG.md v1.0.8 섹션 신설 / CHANGELOG.md v1.0.8 section added
  • Fixed / Changed / Added / Tests / Documentation / File Changes 6개 하위 섹션 / 6 subsections: Fixed / Changed / Added / Tests / Documentation / File Changes
• FileNexusSuite.py APP_VERSION 상수 갱신 / FileNexusSuite.py APP_VERSION constant update
  • L76 APP_VERSION = "1.0.7" → "1.0.8" — f-string으로 참조되는 도움말 창 타이틀 5개 언어 + 사이드바 버전 라벨이 자동 일관 갱신 / All f-string references (5-language help titles + sidebar version label) automatically updated
• version_info.txt 4곳 갱신 / version_info.txt 4-point update
  • filevers / prodvers 튜플 + FileVersion / ProductVersion 문자열 모두 v1.0.8 / 1.0.8.0으로 정합 확보. PyInstaller 빌드 시 Windows .exe 속성 창 메타데이터 정합 / All aligned to v1.0.8 / 1.0.8.0: filevers/prodvers tuples + FileVersion/ProductVersion strings. PyInstaller .exe properties metadata consistency secured
• README.md / README_EN.md 뱃지 동기화 / README.md / README_EN.md badge sync
  • version 뱃지 1.0.7 → 1.0.8, tests 뱃지 531 → 534 양쪽 일치 / version badge 1.0.7 → 1.0.8, tests badge 531 → 534 — both READMEs synchronized
• **`RE...

File Nexus Suite v1.0.7

v1.0.7 — 기술 부채 정리 + GitHub Actions CI 도입 + 테스트 관리 정책 수립 / Technical debt cleanup + GitHub Actions CI adoption + test management policy establishment

v1.0.7은 기능 추가가 아닌 기술 부채 정리와 인프라 강화에 집중한 릴리즈입니다. 3개 사전 작업 세션을 통해 번역키 고아 15건을 제거하고 invariant 테스트를 탭 기반 10개 대분류로 재구성했으며, 매 릴리즈마다 수동으로 이월해오던 버전 스냅샷 방식의 한계를 명문화한 **TEST_MANAGEMENT_POLICY.md**를 신설했습니다. 가장 중요한 변화는 GitHub Actions CI 도입으로, 첫 실행부터 로컬에서 발견되지 않던 숨은 이슈 2건(유령 PyPI 패키지, Windows 영어 로케일 UnicodeEncodeError)을 즉시 드러내며 가치를 입증했습니다. APP_VERSION 상수의 버전-독립 구조 검증 재설계, version_info.txt 정합 확보, README 뱃지 확장으로 v1.0.7부터 모든 릴리즈가 CI 자동 검증을 거친다는 새로운 기준선이 확립됐습니다.

v1.0.7 is a technical-debt-cleanup release focused on infrastructure reinforcement rather than new features. Through three preparatory sessions, 15 orphan translation keys were removed and invariant tests were restructured into tab-based 10 functional categories, and TEST_MANAGEMENT_POLICY.md — a new permanent reference document — was established to codify the limits of the version-snapshot approach previously migrated by hand each release. The most significant change is the adoption of GitHub Actions CI, which immediately proved its value by surfacing two hidden issues on its very first runs (a phantom PyPI package, and Windows English-locale UnicodeEncodeError) that had gone undetected locally. With the APP_VERSION constant redesigned for version-independent structural verification, version_info.txt alignment secured, and README badges expanded, a new baseline is established: every release from v1.0.7 onward passes CI's automatic verification.

---

✨ 주요 기능 / Major Features

• GitHub Actions CI 도입 / GitHub Actions CI adoption

  • 러너: windows-latest 단일 — 한림 로컬 Windows 환경과 일치, 531/0/0/0 재현 최우선 / Runner: windows-latest single — matches Hanrim's local Windows, prioritizing 531/0/0/0 reproduction
  • Python 3.10 단일 — 한림 로컬 Python 3.10.11과 일치 / Python 3.10 single — matches local Python 3.10.11
  • pip 캐시 적용 — 2번째 실행부터 12분 내 완료 / pip cache enabled — subsequent runs complete in 12 minutes
  • 트리거: main push/PR + workflow_dispatch / Triggers: main push/PR + workflow_dispatch
  • 커스텀 러너 exit code 계약 — 실패/오류 시 sys.exit(1) 반환으로 CI 뱃지 정확성 보장 / Custom runner exit-code contract — returns sys.exit(1) on failure/error for CI badge accuracy
  • CI 첫 실행에서 이미 2건의 숨은 이슈 발견 — 프로젝트 완성도의 실질적 향상 / Two hidden issues already surfaced on CI's first runs — real-world improvement in project completeness

• 세션 3 — 번역키 고아 15건 정리 / Session 3 — 15 orphan translation key cleanup

  • β 프로토콜 적용 감사: 17건 보고 → 2건 활성 사용 확인(conv_sub_txt2epub/conv_sub_epub2txt 동적 디스패치) → 15건 제거 + 2건 대표 키 편입 / β-protocol audit: 17 reported → 2 confirmed actively used (conv_sub_txt2epub/conv_sub_epub2txt dynamic dispatch) → 15 removed + 2 absorbed as representative keys
  • 제거된 키 15개: bulk_out_folder, bulk_save_dir, bulk_save_fixed, bulk_save_over, merge_file_list, merge_file_mgmt, p_prefix_ph, sort_header, tag_file_list, tag_preview_title, tf_dlg_overwrite, tf_grp_opt, tf_ph_input, tf_subtitle, tf_title / 15 removed keys
  • 총 76줄 제거 (15키 × 5언어 + 주석 1줄) / Total 76 lines removed (15 keys × 5 languages + 1 comment line)

• 세션 3 — invariant 테스트 탭 기반 10개 대분류 재구성 / Session 3 — invariant tests restructured into 10 tab-based major categories

  • 제거된 구 버전 스냅샷 테스트 7개: test_all_langs_have_dlg_keys, test_all_langs_have_sort_header, test_all_langs_have_sc_tab_bulk, test_all_langs_have_new_v010_keys, test_rename_keys_exist, test_all_langs_have_v010_1_keys, test_all_langs_have_v100_keys / 7 removed version-snapshot tests
  • 신설 9개 탭 기반 테스트: common_dialog / text_merger / text_converter / tag_editor / batch_renamer / text_fixer / settings / shortcut / misc (기존 bulk_fixer_keys 확장 유지) / 9 new tab-based tests
  • test_ko_has_minimum_keys 기준 수치 갱신 (280 → 400, 현 404개 기준 안전 마진) / Minimum key count threshold updated (280 → 400, safety margin based on current 404)
  • 관통 축: "역사는 Git 이력과 CHANGELOG가 담당하고, 테스트는 현재 살아있는 명세로 유지된다" / Guiding principle: "History belongs to Git log and CHANGELOG; tests remain living specifications"

• 세션 3 — TEST_MANAGEMENT_POLICY.md 신설 / Session 3 — TEST_MANAGEMENT_POLICY.md established

  • 프로젝트 영구 참조 문서 (155줄, 루트 배치) / Permanent project reference document (155 lines, placed at repo root)
  • 5대 원칙 명문화 + 데드 판정 기준 5개 (테스트 파일 invariant 등록 여부 신설 포함) / Codified 5 core principles + 5 dead-code judgment criteria (including new "test-file invariant registration" criterion)
  • 대분류 10개 명세 + 금지 사항 (버전 스냅샷 방식 invariant 신규 도입 금지) / 10 category specifications + prohibitions (ban on new version-snapshot-style invariants)

• TestAppVersion 버전-독립 구조 검증 재설계 / TestAppVersion redesigned for version-independent structural verification

  • 기존 관례: TestV104Regression → TestV105Regression → TestV106AppVersion 매 릴리즈 이월 / Previous pattern: migration at each release
  • 재설계: 세미버전(MAJOR.MINOR.PATCH) 포맷 검증으로 전환 — 향후 버전 갱신 시 테스트 수정 불필요 / Redesign: switched to semver (MAJOR.MINOR.PATCH) format validation — no test updates needed on future version bumps
  • TEST_MANAGEMENT_POLICY.md §4.4 "버전 스냅샷 방식 invariant 신규 도입 금지" 원칙을 번역키 외 코드 버전 스냅샷에도 적용 / Applied TEST_MANAGEMENT_POLICY.md §4.4 "ban on new version-snapshot-style invariants" to code version snapshots as well

---

🐛 버그 수정 / Bug Fixes

• APP_VERSION 상수 갱신 누락 / APP_VERSION constant update omission (세션 3 누락 / session 3 omission)

  • 현상: FileNexusSuite.py L76 APP_VERSION = "1.0.6" 그대로 남아 앱 타이틀·도움말 창 버전 표시가 v1.0.6으로 보임 / Symptom: L76 APP_VERSION = "1.0.6" left unchanged — app title and help window version display showed v1.0.6
  • 발견: 릴리즈 직전 한림의 findstr /S /I "1\.0\.6" 전수 검증으로 드러남 / Discovered: during Hanrim's pre-release findstr /S /I "1\.0\.6" verification sweep
  • 수정: APP_VERSION = "1.0.7" 갱신 — f-string으로 참조되는 앱 전역 버전 표시가 자동 일관 갱신 / Fix: updated to "1.0.7" — all f-string references across the app automatically reflect the new version

• version_info.txt 버전 4곳 잔존 / version_info.txt 4-point version residue

  • 현상: filevers, prodvers 튜플 + FileVersion, ProductVersion 문자열이 모두 1.0.6 / Symptom: filevers/prodvers tuples and FileVersion/ProductVersion strings all at 1.0.6
  • 영향: PyInstaller 빌드 시 Windows .exe 속성 창의 버전 메타데이터가 v1.0.6으로 표시됨 / Impact: PyInstaller builds would show v1.0.6 in Windows .exe file properties
  • 수정: 4곳 모두 v1.0.7 / 1.0.7.0으로 갱신 — Copyright © 2026 Hanrim 표기는 유지 (매체별 간결/풀네임 구분 정책) / Fix: all 4 locations updated — Copyright © 2026 Hanrim preserved (per-medium brevity/full-name policy)

• CI 첫 실행 hotfix — PyPI 유령 패키지 / CI first-run hotfix — phantom PyPI package

  • 현상: pip install -r requirements.txt 실행 시 PySide6-Qt6-Qt6Svg>=6.4.0에서 ERROR: Could not find a version that satisfies the requirement 실패 (CI #1, 39초) / Symptom: pip install failed with "No matching distribution found" for PySide6-Qt6-Qt6Svg>=6.4.0 (CI #1, 39s)
  • 원인: PyPI에 존재하지 않는 패키지. 한림 로컬에서는 이미 설치된 상태라 pip install 시 조용히 넘어가 발견되지 않음 / Cause: package does not exist on PyPI. Locally, it was already installed, so pip silently skipped — the issue went undetected
  • 수정: requirements.txt에서 해당 줄 제거. PySide6 본체가 QtSvg 모듈을 내장 / Fix: removed the line from requirements.txt. PySide6 bundles QtSvg natively
  • 의의: CI 도입의 가치가 첫 실행에서 바로 입증됨 / Significance: CI's value proven on its very first run

• CI 2번째 실행 hotfix — Windows 로케일 UnicodeEncodeError / CI second-run hotfix — Windows locale UnicodeEncodeError

  • 현상: 테스트 러너 실행 중 UnicodeEncodeError: 'charmap' codec can't encode character '\ud83d' (CI #2, 1분 10초) / Symptom: UnicodeEncodeError: 'charmap' codec can't encode character '\ud83d' during test runner (CI #2, 1m 10s)
  • 원인: GitHub Actions windows-latest 기본 콘솔 인코딩이 cp1252 (영어 로케일)라 한글·이모지 출력 실패. 한림 로컬은 cp949 또는 UTF-8 모드라 문제 없음 / Cause: GitHub Actions windows-latest default console encoding is cp1252 (English locale), failing on Korean/emoji output. Local Windows uses cp949 or UTF-8 mode
  • 수정: 커스텀 러너 진입부에 sys.stdout.reconfigure(encoding='utf-8') 추가 (Python 3.7+ 표준, hasattr 가드로 무해) / Fix: added sys.stdout.reconfigure(encoding='utf-8') at runner entry (Python 3.7+ standard, guarded by hasattr)

• 의존성 선언 불일치 / Dependency declaration inconsistency

  • requirements.txt에 python-hwpx>=2.9.0 누락 — v1.0.6 HWPX 입력 지원 의존성이 README·기술 스택에만 명시되고 requirements에서 빠져 있던 불일치 해소 / python-hwpx>=2.9.0 was missing from requirements.txt — v1.0.6 HWPX input support dependency was only stated in README/tech-stack but missing from requirements; inconsistency now resolved

• README_EN.md 뱃지 동기화 누락 / README_EN.md badge sync omission

  • 세션 3에서 한국어 README만 갱신하고 영어 버전을 누락 / Korean README was updated in session 3, but English version was overlooked
  • 수정: version 뱃지 1.0.6 → 1.0.7, CI 뱃지 추가, tests 뱃지 추가, 설치 명령어 pip install -r requirements.txt로 단순화 / Fix: version badge 1.0.6 → 1.0.7, CI badge added, tests badge added, install command simplified

---

📄 문서 / Documentation

• TEST_MANAGEMENT_POLICY.md 신설 (155줄, 루트 배치) / New TEST_MANAGEMENT_POLICY.md (155 lines, repo root)
  • 테스트 관리 5대 원칙, 대분류 10개 명세, 데드 판정 기준, 금지 사항을 명문화한 프로젝트 영구 참조 문서 / Codifies 5 core principles of test management, 10 category specifications, dead-code criteria, and prohibitions — permanent project reference
• CHANGELOG.md v1.0.7 섹션 확장 / CHANGELOG.md v1.0.7 section expanded
  • Fixed / Removed / Changed / Added / Tests / File Changes / Deferred 7개 하위 섹션 / 7 subsections: Fixed / Removed / Changed / Added / Tests / File Changes / Deferred
• README.md / README_EN.md 뱃지 확장 / README.md / README_EN.md badge expansion
  • CI 상태 뱃지 + 531 tests passing 뱃지 추가, 설치 명령어 단일 진실 원천화 (pip install -r requirements.txt) / CI status badge + 531 tests passing badge added; install command centralized

---

🧪 테...

File Nexus Suite v1.0.6

v1.0.6 — Text Converter 구조 리팩토링 + 부분 손상 파일 대응 + 설정 다이얼로그 번체 잔재 수정 / Text Converter refactoring + partial corruption handling + Settings dialog Traditional Chinese residue fix

Text Converter 레이아웃을 Bulk Fixer(v1.0.6) 패턴으로 재구성하여 드롭존 분리·5:4 레이아웃·하단 안내 박스 제거를 적용했고, 메모장에선 열리는데 Python strict 폴백이 모두 실패하던 부분 손상 인코딩 파일 대응을 추가했습니다(Phase 1 + Phase 2-a 티어드 자동 처리). Text Merger는 HWPX 입력 지원과 A1'' 인코딩 자동 추천 기능을 얻었고, v1.0.5부터 존재하던 설정 다이얼로그 번체 중국어 잔재 버그를 근본 수정했습니다. 데이터 손실 위험이 있던 toolTip 오염 버그와 헤더 정렬 버그도 함께 해결했고, 분 단위 걸리던 O(N×K) 위치 추적 알고리즘을 O(N)으로 재설계해 수백~수천 배 성능을 개선했습니다.

Rebuilt the Text Converter layout along the Bulk Fixer (v1.0.6) pattern — drop-zone separation, 5:4 left-right ratio, bottom help-box removal — and added proper handling for partially corrupted encoding files that Notepad opens fine but Python's strict fallback all fail on (Phase 1 + Phase 2-a tiered automatic processing). Text Merger gained HWPX input support and A1'' automatic encoding recommendation, and a pre-existing Settings dialog Traditional Chinese residue bug (from v1.0.5) was rooted out. Also resolved the toolTip contamination bug (with data-loss risk) and header-sort bug, and redesigned the O(N×K) position-tracking algorithm to O(N) for hundreds-to-thousands times speedup on previously minute-long operations.

---

✨ 주요 기능 / Major Features

• Phase 2-a — 인코딩 리포트 기능 + 티어드 자동 처리 / Phase 2-a — encoding report generation + tiered automatic processing

  • Bulk Fixer가 부분 손상 파일을 세 티어로 자동 분류 / Bulk Fixer now automatically classifies partially corrupted files into three tiers
  • Tier 1 (손상 ≤500자): 처리 + 리포트 생성 / Tier 1 (≤500 corrupt chars): process + generate report
  • Tier 2 (손상 5015000자): 처리 + 경고 수위 리포트 / Tier 2 (5015000 corrupt chars): process + elevated-warning report
  • Tier 3 (손상 5001자+): 원본 보호 스킵 + 리포트만 / Tier 3 (5001+ corrupt chars): skip to preserve original + report only
  • 리포트 파일명: {원본파일명}.encoding_report.txt (UTF-8 BOM 없음) / Report filename: {original}.encoding_report.txt (UTF-8 without BOM)
  • 실측 기반 임계값 결정 — make_tier_test_data.py로 경계값(499/5000/5001) 합성 데이터 회귀 검증 / Empirically-chosen thresholds — boundary values (499/5000/5001) validated via synthesized test data in make_tier_test_data.py
  • 설계 철학 분리: Text Fixer(사용자 동의 기반) / Bulk Fixer(사후 투명성 기반) / Philosophy separation: Text Fixer (user-consent based) vs. Bulk Fixer (post-hoc transparency based)

• #7 Text Converter 구조 리팩토링 / #7 Text Converter structural refactoring

  • 신규 클래스 TextConverterDropZone (109줄) — BulkFixerDropZone 복제 + mode 파라미터로 TXT↔EPUB 전환 시 텍스트·아이콘 자동 갱신 / New class TextConverterDropZone (109 lines) — cloned from BulkFixerDropZone + mode parameter auto-refreshing text/icon on TXT↔EPUB toggle
  • TextConverterFileList 단순화 — InternalMove → DragDrop 모드 전환, setSectionsClickable(True) 명시, startDrag CopyAction 강제 / Simplified TextConverterFileList — InternalMove → DragDrop, explicit setSectionsClickable(True), forced startDrag CopyAction
  • 레이아웃 5:4 재구성 — 왼쪽(드롭존+파일목록) 확대, 오른쪽(옵션+출력폴더+변환버튼+진행바+상태) 재배치 / Layout restructured 5:4 — left panel (dropzone + file list) expanded, right panel (options + output folder + convert button + progress + status) rearranged
  • 하단 안내 박스 제거 (conv_help 5개 언어 번역 키 삭제) / Bottom help-box removed (conv_help translation keys dropped across 5 languages)
  • 폴더 드롭 미지원 — EPUB 생성 시 원본 폴더 구조 보존 이슈 방지 (의도된 설계) / Folder drop unsupported — intentional design to avoid EPUB source-folder structure preservation issues
  • 실기 QA 9/9 전수 통과 — 드롭존 양방향 / 모드 전환 / 내부 드래그 / 헤더 정렬 / 5:4 / 5개 언어 / 변환 E2E / toolTip 회귀 / 테마 전환 / IceCream Ebook Reader 외부 검증 포함 / Manual QA 9/9 passed — dropzone bidirectional / mode toggle / internal drag / header sort / 5:4 / 5 languages / round-trip conversion / toolTip regression / theme switch / with external IceCream Ebook Reader verification

• Text Merger — HWPX 입력 지원 / Text Merger — HWPX input support

  • python-hwpx 2.9.0 (MIT) 도입, .hwpx → 텍스트 추출 / Added python-hwpx 2.9.0 (MIT), .hwpx → text extraction
  • MergeEncodingDelegate에 HWPX 배지(#9B59B6 보라색) 표시 / Purple HWPX badge (#9B59B6) on MergeEncodingDelegate
  • HWP(구형) 감지 시 통합 안내 다이얼로그 — 5개 언어 / HWP (legacy) detection shows a unified informational dialog across 5 languages
  • lxml 5.4.0으로 자동 다운그레이드 발생 (경고만, 동작 영향 없음) / lxml auto-downgraded to 5.4.0 (warning only, no functional impact)

• Text Merger — A1'' 인코딩 자동 추천 / Text Merger — A1'' automatic encoding recommendation

  • 새 함수 merger_recommend_save_encoding() — 모든 텍스트 파일이 같은 비유니코드 인코딩 + 신뢰도 ≥0.7일 때 그 인코딩 추천, 그 외 UTF-8 / New function merger_recommend_save_encoding() — recommends the non-Unicode encoding if all files share it with confidence ≥0.7, otherwise UTF-8
  • UI: 드롭다운 아래 "💡 추천: XXX" 라벨 + [적용] 버튼 / UI: "💡 Recommended: XXX" label + [Apply] button beneath the dropdown
  • 파일 추가/선택삭제/전체삭제/언어전환 4지점에서 자동 갱신 / Auto-refresh at 4 trigger points: add files / delete selected / clear all / language switch

• Phase 1 — 부분 손상 파일 안전 처리 / Phase 1 — safe handling of partially corrupted files

  • 공통 헬퍼 safe_read_text_with_report() — strict 폴백 8개 모두 실패 시 errors='replace'로 최종 재시도 / Shared helper safe_read_text_with_report() — final retry with errors='replace' when all 8 strict fallbacks fail
  • 깨진 바이트는 U+FFFD (�)로 대체 (Python 기본값, 유니코드 표준) / Corrupt bytes replaced with U+FFFD (�), Python's default and the Unicode standard
  • Text Fixer replace 모드 시 경고 다이얼로그 tf_warn_partial_enc (5개 언어) / Text Fixer replace mode shows warning dialog tf_warn_partial_enc in 5 languages
  • Bulk Fixer 미리보기·일괄 교정·Text Fixer 파일 로드 3곳 적용 / Applied in 3 locations: Bulk Fixer preview, Bulk Fixer worker, Text Fixer file load

• Phase 2-b — Text Fixer / Bulk Fixer 도움말 확장 / Phase 2-b — Text Fixer / Bulk Fixer help section expansion

  • Text Fixer 도움말: "Partially corrupted files note" + 단일 파일 검토 도구 명시 + Tier 3 자동 스킵 안내 / Text Fixer help: "Partially corrupted files note" + single-file review tool explanation + Tier 3 auto-skip notice
  • Bulk Fixer 도움말: "Automatic corruption tiering note" (Tier 1/2/3 상세) + 리포트 파일명 형식 + Text Fixer 개별 검토 유도 / Bulk Fixer help: "Automatic corruption tiering note" (Tier 1/2/3 details) + report filename format + Text Fixer individual review guidance
  • 5개 언어 모두 시각 검수 통과 / Visual review passed in all 5 languages

---

🐛 버그 수정 / Bug Fixes

• 설정 다이얼로그 번체 중국어 잔재 / Settings dialog Traditional Chinese residue (v1.0.5부터 존재 / pre-existing since v1.0.5)

  • 현상: 繁體 → 한국어 전환 시 단축키 리셋 버튼에 預設, 重設所有快捷鍵 / 출력 폴더 라벨에 輸出資料夾 / 버튼에 選擇資料夾 / 重設 등 번체 잔재 / Symptom: after switching 繁體 → Korean, residue like 預設, 重設所有快捷鍵, 輸出資料夾, 選擇資料夾, 重設 remained
  • 원인: SettingsDialog._retranslate_dialog가 일부 위젯 텍스트 갱신을 누락 (단축키 리셋 버튼 6개 + 전체 리셋 + 일반 설정 출력 폴더 라벨·버튼 + 라이선스 타이틀) / Root cause: SettingsDialog._retranslate_dialog missed text updates for 6 individual reset buttons + reset-all button + output folder label/buttons + license title
  • 수정 — 지시서 v2 기반: _apply_theme_now에 _retranslate_dialog() 호출 추가(§2.1), 위젯 self 저장 9개 보완(§2.2), _retranslate_dialog에 D-1/D-2/D-3 블록 확장(§2.4) / Fix — per Work Instruction v2: added _retranslate_dialog() call to _apply_theme_now (§2.1), preserved 9 widget self-references (§2.2), expanded _retranslate_dialog with D-1/D-2/D-3 blocks (§2.4)
  • AppSuite 내 데드 코드 3개 메서드 74줄 완전 제거(§2.5) — _page_language / _on_lang_selected / _retranslate_dialog (SettingsDialog가 별도 QDialog로 분리되기 전 잔재된 복제본) / Removed 3 dead methods (74 lines) in AppSuite (§2.5) — remnants from before SettingsDialog was split into a separate QDialog

• toolTip 오염 데이터 손실 버그 / toolTip contamination data-loss bug (v1.0.4부터 존재 / pre-existing since v1.0.4)

  • 현상: 신뢰도 <0.90 파일의 툴팁에 안내문이 덧붙어 item.toolTip(0) 기반 경로 조회 실패 → 삭제한 파일이 병합 결과에 포함되는 데이터 손실 / Symptom: low-confidence (<0.90) files had info appended to their toolTip, breaking item.toolTip(0) path lookups → deleted files included in merge output, causing data loss
  • 수정: _PATH_ROLE = Qt.ItemDataRole.UserRole + 4 신설, 순수 경로 저장 / Fix: new _PATH_ROLE = Qt.ItemDataRole.UserRole + 4 storing pure paths
  • 3개 클래스 적용: MergeEncodingDelegate, TextConverterFileList, BulkFixerFileList / Applied to 3 classes: MergeEncodingDelegate, TextConverterFileList, BulkFixerFileList
  • 하위 호환 폴백 유지: item.data(0, _PATH_ROLE) or item.toolTip(0) / Backward-compat fallback retained: item.data(0, _PATH_ROLE) or item.toolTip(0)

• 헤더 정렬 버그 / Header sort bug (v1.0.4부터 존재 / pre-existing since v1.0.4)

  • 현상: setSortingEnabled(False) + DragDrop 모드 조합에서 헤더 클릭으로 정렬이 동작하지 않음 / Symptom: with setSortingEnabled(False) + DragDrop mode, header-click sorting stopped working
  • 원인: Qt의 기본 동작으로 setSortingEnabled(False) 시 헤더 섹션 클릭이 비활성화됨 / Cause: Qt disables header section clicks when setSortingEnabled(False)
  • 수정: hdr.setSectionsClickable(True) 명시 추가 (MergeFileTree v1.0.3/1.0.4 패턴 복제) / Fix: explicit hdr.setSectionsClickable(True) (pattern cloned from MergeFileTree v1.0.3/1.0.4)

• alchemy_detect_encoding 폴백 신뢰도 0.0 → 0.7 / alchemy_detect_encoding fallback confidence 0.0 → 0.7

  • 폴백 루프 통과 시(cp949/shift_jis/gbk/big5) 신뢰도를 0.7로 상향 / Confidence raised to 0.7 on fallback-loop success (cp949/shift_jis/gbk/big5)
  • utf-8 strict 폴백도 0.0 → 0.7 (일관성) / utf-8 strict fallback also raised to 0.7 (consistency)
  • 짧은 한글 CP949 파일이 "70% CP949" 배지 + "💡 추천: CP949"로 정상 표시 / Short Korean CP949 files now correctly show "70% CP949" badge + "💡 Recommended: CP949"

---

⚡ 성능 개선 / Performance Improvements

• O(N×K) → O(N) 위치 추적 재설계 / O(N×K) → O(N) position tracking redesign
  • 기존: 파일당 손상 바이트 K개 찾기 위해 N바이트 전수 순회 → K회 반복 = O(N×K) / Before: for each of K corrupt bytes, scanned all N bytes → O(N×K)
  • 신규: codecs.register_error('_fns_track', ...) 기반 단일 패스로 디코딩 중 위치 수집 → O(N) / After: single-pass position collecti...

File Nexus Suite v1.0.5

v1.0.5 — Text Merger 저장 인코딩 드롭다운 UI 사용성 개선 / Text Merger save-encoding dropdown UI usability improvements

비프로그래머가 8종 저장 인코딩 중 무엇을 골라야 할지 직관적으로 판단할 수 있도록 Text Merger 드롭다운 라벨에 연관 언어를 병기하고 콤보박스 아래에 한 줄 도움말을 추가했습니다. 내부 키와 표시 라벨을 분리하는 addItem(display, userData) 리팩토링을 통해 v1.0.4 이하 설정 파일과도 완전 호환됩니다. 빌드 후 QA 중 발견된 "언어 전환 시 상태 메시지가 한국어로 남던 기존 버그"도 함께 해소했고, v1.0.2부터 식별됐던 번역 사전 중복 키 74개를 일괄 정리하여 기술 부채를 해소했습니다.

Redesigned the Text Merger save-encoding dropdown: each item now carries a language hint (e.g. Shift-JIS (일본어)), and a one-line helper ("If unsure, select UTF-8") sits beneath the combobox. Internally, display labels were separated from stable keys using the addItem(display, userData) pattern, preserving full config compatibility with v1.0.4 and earlier. A pre-existing bug where status messages stayed in Korean after language switch — discovered during post-build QA — was also fixed, and 74 duplicate translation keys identified since v1.0.2 were cleaned up as long-standing tech debt.

---

🐛 버그 수정 (빌드 후 QA에서 발견) / Bug Fixes (from post-build QA)

• 언어 전환 시 Text Merger 하단 상태 메시지가 한국어로 남던 문제 / Text Merger status messages stayed in Korean after language switch
  • 현상: 파일 추가 후 언어를 영어/일본어/중국어로 전환해도 26개 파일 추가됨 (인코딩 자동 감지 완료)가 한국어로 잔존 (v1.0.4 이전부터 존재한 기존 버그)
  • Symptom: After adding files, switching language to English/Japanese/Chinese left 26개 파일 추가됨... in Korean (pre-existing bug since before v1.0.4)
  • 원인: retranslate()가 merge_status_ready 상태일 때만 _lbl_status를 갱신 → 파일 추가/삭제/저장 후 메시지에서 무반응
  • Root cause: retranslate() only refreshed _lbl_status when it held the merge_status_ready text → messages after add/del/save never updated
  • 범위: 9종 상태 메시지 전부 (ready, add, del, clr, reading, save_done, save_err, path_set, path_reset_done) 동일 구조 버그
  • Scope: All 9 status messages (ready, add, del, clr, reading, save_done, save_err, path_set, path_reset_done) shared the same defect
  • 수정: _retranslate_status() 헬퍼 + _match_status_template() 정규식 매칭 유틸 신설
  • Fix: Added _retranslate_status() helper and _match_status_template() regex-based matching utility
  • 정적 메시지 5종(ready/clr/reading/save_err/path_reset_done): 단순 매핑 후 현재 언어로 재렌더
  • Static messages (5): simple lookup and re-render in current language
  • 복원 가능 동적 메시지 2종: 원본 정보로 재구성 — merge_status_add → len(self.file_list) / merge_path_set → self.save_dir
  • Recoverable dynamic messages (2): reconstructed from live state — merge_status_add → file count / merge_path_set → current save dir
  • 복원 불가 메시지 3종(del/save_done/bulk_scanning): ready로 리셋 + _glog 디버그 로그로 추적성 확보
  • Non-recoverable messages (3): reset to ready with _glog debug trace for traceability
  • 신용우님의 실기 QA 중 3개 언어(영·일·중간) 스크린샷으로 포착됨 ⭐
  • Discovered by developer's multilingual QA screenshots (EN / JA / zh_CN) ⭐

---

✨ 기능 추가 / New Features

• 드롭다운 8개 아이템에 연관 언어 병기 / Language hints added to all 8 dropdown items

  • 한국어 UI 예: Shift-JIS (일본어), EUC-KR (한국어), CP949 (한국어 Windows), GBK (중국어 간체), Big5 (중국어 번체)
  • Korean UI example: Shift-JIS (일본어), EUC-KR (한국어), CP949 (한국어 Windows), GBK (중국어 간체), Big5 (중국어 번체)
  • 5개 언어 모두 적용 — 중국어 간체/번체 UI에서는 일본어 표기를 日文으로 통일 (v1.0.4 tip 문구와 일관성)
  • Applied to all 5 languages — Chinese UIs (simplified/traditional) use 日文 for "Japanese" to match v1.0.4 tip wording
  • UTF-8 / UTF-8-BOM / UTF-16은 수식어 없이 유지 — 특정 언어에 종속되지 않음
  • UTF-8 / UTF-8-BOM / UTF-16 remain unlabeled — not tied to any specific language
  • 주관 표현((추천), (전용) 등) 배제, 사실 기반 수식어만 사용 (정직성 원칙)
  • No subjective qualifiers (e.g. "(recommended)", "(only)") — neutral, fact-based hints only (honesty principle)

• 콤보박스 아래 한 줄 도움말 라벨 추가 / One-line helper added beneath the combobox

  • 신규 번역 키 merge_enc_hint: "확실하지 않으면 UTF-8을 선택하세요" 외 5개 언어
  • New translation key merge_enc_hint: "If unsure, select UTF-8" (across 5 languages)
  • MUTED 색상 + font-size:11px로 기존 도움말 톤과 통일
  • Styled with MUTED color + font-size:11px to match existing helper-text tone
  • 비프로그래머가 5초 안에 UTF-8이 안전한 기본값임을 판단할 수 있도록 설계
  • Designed so non-programmers can recognize UTF-8 as the safe default within 5 seconds

---

🔧 리팩토링 / Refactoring

• 표시 라벨과 내부 키 분리 / Separated display labels from internal keys

  • 신규 클래스 상수 TextMergerPanel._ENC_ITEMS — [(internal_key, i18n_key), ...] 8-tuple 리스트
  • Added class constant TextMergerPanel._ENC_ITEMS — a list of (internal_key, i18n_key) 8-tuples
  • addItems([...]) → addItem(display, userData) 패턴으로 전환 (userData에 stable 키 보존)
  • Switched from addItems([...]) to addItem(display, userData) pattern (keys stored in userData)
  • currentText() → currentData(), findText() → findData() 마이그레이션
  • Migrated currentText() → currentData() and findText() → findData()
  • apply_config()에 구버전 폴백 내장: findData() 실패 시 findText() 재시도 → v1.0.4 이하 설정 파일 자동 호환
  • Legacy fallback in apply_config(): if findData() misses, retry with findText() → seamless v1.0.4-and-older config compatibility
  • retranslate()에 콤보박스 8개 아이템 라벨 갱신 루프 + 도움말 라벨 갱신 추가
  • retranslate() now iterates all 8 items updating display labels + refreshes the helper label

• 번역 사전 중복 키 74개 일괄 정리 / Cleaned up 74 duplicate translation keys

  • v1.0.2 인수인계에서 식별됐던 zh_cn 188개 키 중복 이슈의 실측 현황 재조사 → 74개 중복 라인 잔존 확인
  • Re-audited the "188 duplicate zh_cn keys" issue identified since v1.0.2 → 74 duplicate lines actually remaining
  • 분포: zh_cn 69개 + ko/en/zh_tw 각 1개 + ja 2개 = 74개
  • Distribution: zh_cn 69 + ko/en/zh_tw 1 each + ja 2 = 74
  • AST 파싱으로 각 중복 그룹의 두 값이 완전히 일치함을 검증한 뒤 안전 삭제 → 동작 영향 0
  • AST-verified that each duplicate pair held identical values before deletion → zero runtime impact
  • 주요 패턴: merge_open_explorer가 5개 언어 모두에서 중복 (dict 재삽입 흔적) / bulk_*·tf_* 접두사 키가 zh_cn에 대량 중복 (Bulk Fixer·Text Fixer 확장 시점의 의도치 않은 중복)
  • Main patterns: merge_open_explorer duplicated in all 5 languages (dict-reinsertion artifact) / bulk_* and tf_* prefix keys heavily duplicated in zh_cn (unintended duplication during Bulk Fixer / Text Fixer expansion)
  • 결과: 5개 언어 각 dict 390~391 키로 슬림화 (zh_cn 463줄 → 394줄)
  • Result: each language dict slimmed to 390~391 keys (zh_cn 463 lines → 394 lines)

---

🧪 테스트 자동화 / Test Automation

• 신규 회귀 테스트 30개 추가 / Added 30 new regression tests
  • TestV105Regression: 소스 검증 12개 (_ENC_ITEMS 상수, addItem 패턴, 도움말 라벨, currentData/findData 마이그레이션, 45개 번역 항목, 日文 표기 일관성 등)
  • TestV105Regression: 12 source-level checks (_ENC_ITEMS constant, addItem pattern, helper label, currentData/findData migration, 45 translation entries, 日文 consistency, etc.)
  • TestV105RegressionModule: 런타임 검증 6개 (APP_VERSION, 5개 언어 사전 완결성, 라벨-키 매핑, _ENC_ITEMS 순서, 도움말 UTF-8 안내 등)
  • TestV105RegressionModule: 6 runtime checks (APP_VERSION, 5-language dict completeness, label-key mapping, _ENC_ITEMS order, UTF-8 guidance in helper, etc.)
  • TestV105TranslationNoDuplicates: 중복 재발 방지 2개 (AST 기반 중복 0 검증 + 언어별 키 개수 편차 ≤5)
  • TestV105TranslationNoDuplicates: 2 no-duplicate-regression tests (AST-based zero duplicates + per-language key-count variance ≤ 5)
  • TestV105StatusRetranslate: 상태 메시지 재번역 10개 (정적/복원가능/복원불가/방어적 처리/단위 테스트)
  • TestV105StatusRetranslate: 10 status-retranslation tests (static / recoverable / non-recoverable / defensive / unit)
• v1.0.4 테스트 2개 시그니처 변경에 맞춰 업데이트 (의도 유지) / Updated 2 v1.0.4 tests for the new signature (intent preserved)
  • test_text_merger_combo_has_cjk_encodings: addItems 정규식 → _ENC_ITEMS 상수 블록 검색
  • test_text_merger_combo_has_cjk_encodings: addItems regex → _ENC_ITEMS constant block lookup
  • test_app_version_is_104 → test_app_version_is_104_or_later: 정확 일치 → 튜플 비교(≥ (1,0,4))로 완화
  • test_app_version_is_104 → test_app_version_is_104_or_later: strict equality → tuple comparison (≥ (1,0,4))

---

📊 검증 범위 / Verification Scope

• 단위 테스트 / Unit tests: 502 passing (v1.0.4: 472 + v1.0.5: 30) — 실패 0 / 오류 0 / 스킵 0 ⭐
  • 502 passing / 0 failed / 0 errors / 0 skipped ⭐
• 실기 검증 / Manual testing:
  • 드롭다운 라벨 + 도움말 문구를 5개 언어 모드에서 각각 스크린샷 검증 / Dropdown labels + helper text verified via screenshots across all 5 language modes
  • 빌드 후 언어 전환 시 상태 메시지 재번역 회귀 검증 (파일 추가 → 영어 전환 → Ready 리셋 + Debug Log에 merge_status_del → merge_status_ready 로그 확인) / Post-build verification of status message re-translation (add files → switch to EN → Ready reset + debug log line confirmed)
  • v1.0.4 설정 파일(combo_enc: "Shift-JIS")로 기동하여 findText() 폴백 정상 동작 확인 / Launched with a v1.0.4 config file (combo_enc: "Shift-JIS") to confirm the findText() fallback works correctly
• 구조적 안전성 / Structural safety:
  • addItem(display, userData) 전환으로 내부 키와 표시 라벨 완전 분리 / Clean separation of internal keys from display labels via addItem(display, userData)
  • currentData() 기반 저장 → 기존 설정 저장 스키마 키(combo_enc) 이름 유지 / currentData()-based save preserves the existing combo_enc config schema key
  • 번역 사전 중복 제거는 AST 값 동일성 검증 후에만 실행 → 동작 변화 0 / Duplicate key removal gated on AST-level value-equality check → zero behavioral change
  • TextMergerPanel 외 다른 탭(Text Converter / Tag Editor / Batch Renamer / Text Fixer / Bulk Fixer) 영향 0 / No impact on other tabs (Text Converter / Tag Editor / Batch Renamer / Text Fixer / Bulk Fixer)

---

🔐 릴리즈 서명 / Release Signing

• v1.0.5부터 SSH 서명 도입 / SSH signing introduced from v1.0.5
  • 커밋 + 태그 모두 Ed25519 SSH 키로 서명 → GitHub Verified 뱃지 획득 / Both commit and tag signed with Ed25519 SSH key → GitHub Verified badge
  • v1.0.1 이후 Verified 뱃지 복귀 (v1.0.2~v1.0.4는 비서명) / Verified badge returns since v1.0.1 (v1.0.2–v1.0.4 were unsigned)
  • Fingerprint: SHA256:4H2f7lrFfI4u0YP0dpp6N9BQH2f74iKjjMRHu7lyjKI

---

💬 검토 / Review

• Claude Opus 4.7 기반 정적 분석 ...