diff --git a/.editorconfig b/.editorconfig
index 9d08ceb..5e2af3c 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -1,17 +1,17 @@
 root = true
 
-# 기본은 LF
+# 기본?� LF
 [*]
 end_of_line = lf
 insert_final_newline = true
 charset = utf-8
 
-# Windows 전용 스크립트는 CRLF를 원하면(선택 사항):
+# Windows ?�용 ?�크립트??CRLF�??�하�??�택 ?�항):
 [*.bat]
 end_of_line = crlf
 [*.ps1]
 end_of_line = crlf
 
-# Bash/셸 스크립트는 반드시 LF
+# Bash/???�크립트??반드??LF
 [*.sh]
 end_of_line = lf
\ No newline at end of file
diff --git a/.gitattributes b/.gitattributes
index dfe0770..dd1a7fc 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,2 +1,9 @@
 # Auto detect text files and perform LF normalization
-* text=auto
+* text=auto eol=lf
+
+# Windows-specific scripts: CRLF
+*.bat text eol=crlf
+*.ps1 text eol=crlf
+
+# Shell scripts: LF
+*.sh text eol=lf
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index f0e409a..6e218ac 100644
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -1,39 +1,39 @@
-<!-- ablestack-qemu-exec-tools: Copilot 지침 (한국어) -->
-# 코드 어시스턴트를 위한 빠른 안내 (20–50줄)
+<!-- ablestack-qemu-exec-tools: Copilot 지시서(한국어) -->
+# 코드 시나리오에 대한 빠른 이해 (2025년 0월)
 
-이 저장소는 QEMU/libvirt VM 내부에서 qemu-guest-agent를 통해 명령을 실행하는 소형 셸 유틸리티들과 RPM/DEB/MSI 패키징을 제공합니다. AI 코딩 에이전트가 즉시 생산적으로 작업할 수 있도록 발견 가능한 핵심 정보를 간결하게 정리했습니다.
+이 저장소는 QEMU/libvirt VM 환경에서 qemu-guest-agent를 통해 명령을 실행하는 형편성 유틸리티와 RPM/DEB/MSI 패키징을 제공합니다. AI 코딩 어시스턴트가 즉시 산출물을 만들 수 있도록 프로젝트의 주요 구조와 발견 가능한 핵심 정보를 간결하게 정리합니다.
 
 - 개요
-  - 주요 스크립트: `bin/vm_exec.sh`, `bin/agent_policy_fix.sh`, `bin/cloud_init_auto.sh` — 공통 로직은 `lib/`(특히 `common.sh`, `cloud_init_common.sh`, 파서들)에 위치합니다.
-  - 빌드/패키지: `Makefile`에서 `rpm`, `deb`, `windows` 타깃을 실행합니다. 릴리스와 빌드는 GitHub Actions(`.github/workflows/`)로 자동화되어 있습니다.
+  - 주요 스크립트: `bin/vm_exec.sh`, `bin/agent_policy_fix.sh`, `bin/cloud_init_auto.sh` 및 공통 로직은 `lib/`(특히 `common.sh`, `cloud_init_common.sh`, 서버측 설치)
+  - 빌드/패키지: `Makefile`에서 `rpm`, `deb`, `windows` 타깃을 실행합니다. 릴리즈 시 빌드는 GitHub Actions(`.github/workflows/`)에서 자동화됩니다.
 
-- 주요 개발/운영 흐름
-  - 로컬 설치: `chmod +x install.sh ; sudo ./install.sh` (자세한 내용은 `INSTALL.md`).
+- 주요 개발/운영 워크플로우
+  - 로컬 설치: `chmod +x install.sh ; sudo ./install.sh` (자세한 사용은 `INSTALL.md`).
   - 패키지 빌드: `make rpm`, `make deb`, `make windows` (Windows는 `powershell` 호출 포함).
-  - 도구 실행 예: `vm_exec -l|-w|-d <vm-name> <command> [options]` (`bin/vm_exec.sh`, `docs/usage_vm_exec.md` 참고).
+  - 구동 실행 예: `vm_exec -l|-w|-d <vm-name> <command> [options]` (`bin/vm_exec.sh`, `docs/usage_vm_exec.md` 참고).
 
-- 코드/런타임 규약 (구체적)
-  - 셸 스크립트는 POSIX/Bash 스타일로 작성되어 있습니다. 설치 시 `lib/*`이 `/usr/local/lib/ablestack-qemu-exec-tools`로 복사되고 실행 시 해당 경로에서 `source` 합니다 (Makefile 참조).
-  - `virsh qemu-agent-command` 호출 결과를 `jq`로 파싱하는 패턴이 많습니다 (`bin/vm_exec.sh`). `jq` 의존성을 염두에 두세요.
-  - 표/CSV 출력 정규화 파서는 `lib/parse_linux_table.sh`, `lib/parse_windows_table.sh`, `lib/parse_csv.sh` 입니다. 출력 파싱이 필요하면 이들 재사용을 우선시하세요.
-  - 지역화: `lib/cloud_init_common.sh`는 로케일을 감지해 한국어/영어 메시지를 출력합니다. 사용자 출력 추가 시 `_IS_KO` 플래그를 존중하세요.
+- 코드/작성 규약 (구체적)
+  - 모든 스크립트는 POSIX/Bash 스크립트로 작성되어 있습니다. 설치 시 `lib/*`을 `/usr/local/lib/ablestack-qemu-exec-tools`에 복사하고 실행 시 해당 경로에서 `source` 합니다(Makefile 참조).
+  - `virsh qemu-agent-command` 호출 결과에 `jq`를 파싱하는 패턴이 많습니다 (`bin/vm_exec.sh`). `jq` 존재를 확인하세요.
+  - CSV 출력 규칙에서는 `lib/parse_linux_table.sh`, `lib/parse_windows_table.sh`, `lib/parse_csv.sh` 등이 있으며 출력 파싱이 필요하면 이들 라이브러리를 우선 사용하세요.
+  - 지역화: `lib/cloud_init_common.sh`에서 로케일을 감지하여 한국어 메시지를 출력합니다. 사용자 출력 추출 시 `_IS_KO` 플래그를 존중하세요.
 
-- 검증(실무) 팁
-  - 저장소에 자동 단위 테스트는 없습니다. 스크립트 문법 검사는 `bash -n <file>` 로 수행하세요. 수정 후에는 가능한 경우 테스트 VM에서 `vm_exec`로 스모크 실행 권장.
-  - 패키징 관련 변경은 `make deb` / `make rpm` / `make windows`로 빌드 확인을 수행하세요.
+- 검증 및 품질
+  - 프로젝트의 자동화 수준은 높습니다. 스크립트 문법 검증은 `bash -n <file>` 으로 실행하세요. 특정 에러가 있는 경우 테스트 VM에서 `vm_exec`를 시뮬레이션 실행 권장.
+  - 패키지 관련 변경 시 `make deb` / `make rpm` / `make windows`로 빌드 검증하세요.
 
-- 버전/릴리스 관련
-  - 버전 정보는 `VERSION` 파일에서 읽습니다. 버전을 갱신하고 태그(`git tag vX.Y.Z`)를 푸시하면 빌드/릴리스 워크플로우가 동작합니다.
-  - Windows MSI 빌드는 `windows/msi/` 내부 스크립트(`build-msi.ps1`)를 사용합니다.
+- 버전/릴리즈 관리
+  - 버전 정보는 `VERSION` 파일에서 관리합니다. 버전을 갱신하고 태그(`git tag vX.Y.Z`)를 생성 시 빌드/릴리즈 워크플로우가 자동으로 작동합니다.
+  - Windows MSI 빌드는 `windows/msi/` 내 스크립트(`build-msi.ps1`)를 사용합니다.
 
-- 통합 포인트 및 주의사항
-  - 외부 바이너리(예: `virsh`, `jq`, `dpkg-deb`, `rpmbuild`, `powershell`)에 강하게 의존합니다. 절대 경로 하드코딩을 피하고 명령어 이름을 그대로 사용하세요.
-  - 개발 중에는 `LIBDIR` 변수를 임시로 조정하거나 저장소 루트에서 실행하여 `/usr/local` 설치를 대신할 수 있습니다.
+- 통합 및 주의사항
+  - 필수 바이너리(예: `virsh`, `jq`, `dpkg-deb`, `rpmbuild`, `powershell`)는 강하게 존재하니 필요 경로 하드코딩 없이 명령어 이름을 그대로 사용하세요.
+  - 개발 중에는 `LIBDIR` 변수를 임시 조정하거나 저장소 루트에서 실행하여 `/usr/local` 설치와 유사한 환경을 만들 수 있습니다.
 
 - 참고 파일 (변경 시 우선 확인)
-  - `bin/vm_exec.sh` — 핵심 명령 동작과 옵션
-  - `lib/common.sh`, `lib/cloud_init_common.sh` — 공용 유틸리티와 cloud-init 관련 로직
-  - `docs/usage_vm_exec.md`, `docs/usage_agent_policy_fix.md` — 사용자 예제 및 사용법
-  - `Makefile`, `rpm/ablestack-qemu-exec-tools.spec`, `deb/control`, `windows/msi/*` — 패키징 관련 스크립트/템플릿
+  - `bin/vm_exec.sh` 주요 명령 작업 설명
+  - `lib/common.sh`, `lib/cloud_init_common.sh` 공용 유틸리티 및 cloud-init 관련 로직
+  - `docs/usage_vm_exec.md`, `docs/usage_agent_policy_fix.md` 사용법 세부 내용
+  - `Makefile`, `rpm/ablestack-qemu-exec-tools.spec`, `deb/control`, `windows/msi/*` 패키지 관련 스크립트/템플릿
 
-추가로 한국어 예제나 로컬 개발 절차(예: Windows에서 MSI 빌드 상세 단계 등)를 넣고 싶으면 어느 부분을 확장할지 알려주세요. 제가 바로 반영하겠습니다.
+추가 한국어 제안이나 로컬 개발 차원(예: Windows에서 MSI 빌드 시 계정 문제 등)에서 느끼는 부분을 알려주세요. 바로 반영하겠습니다.
diff --git a/.github/workflows/build-winpe-core.yml b/.github/workflows/build-winpe-core.yml
index dc9dfa0..7afdb45 100644
--- a/.github/workflows/build-winpe-core.yml
+++ b/.github/workflows/build-winpe-core.yml
@@ -58,8 +58,8 @@ jobs:
       WORKDIR: C:\winpe_work
       OUTDIR: C:\out
 
-      # Microsoft Learn(ADK/WinPE Add-on)에서 안내되는 fwlink를 사용.
-      # 향후 linkid 변경 가능성이 있으니, 실패 시 이 2개 URL만 갱신하면 됩니다.
+      # Microsoft Learn(ADK/WinPE Add-on)에서 제공하는 fwlink를 사용.
+      # 추후 linkid 변경 가능성이 있으므로 실패 시 URL을 갱신하면 됩니다.
       ADK_SETUP_URL: "https://go.microsoft.com/fwlink/?linkid=2289980"
       WINPE_ADDON_URL: "https://go.microsoft.com/fwlink/?linkid=2289981"
 
@@ -341,4 +341,4 @@ jobs:
           path: |
             C:\out\*.iso
             C:\out\SHA256SUMS
-          retention-days: ${{ inputs.retention_days }}
\ No newline at end of file
+          retention-days: ${{ inputs.retention_days }}
diff --git a/.github/workflows/build-winpe-release.yml b/.github/workflows/build-winpe-release.yml
index 43f7d70..06eb332 100644
--- a/.github/workflows/build-winpe-release.yml
+++ b/.github/workflows/build-winpe-release.yml
@@ -36,12 +36,12 @@ jobs:
       - name: Attach assets to GitHub Release
         uses: softprops/action-gh-release@v2
         with:
-          # 어떤 태그 릴리즈에 붙일지 명시 (tag push 이벤트 기준)
+          # 어떤 태그 릴리즈에 붙일지 명시 (tag push 이벤트 기반)
           tag_name: ${{ github.ref_name }}
-          # 릴리즈 본문/노트는 build.yml이 통합 생성(권장) → 여기서는 건드리지 않음
+          # 릴리즈 본문/노트는 build.yml에서 통합 생성(권장) 이므로 건드리지 않음
           generate_release_notes: false
           files: |
             dist/*.iso
             dist/SHA256SUMS
-          # 산출물 누락 시 조기 실패(릴리즈 누락 방지)
-          fail_on_unmatched_files: true
\ No newline at end of file
+          # 파일 매칭 실패 시 조기 실패(릴리즈 실패 방지)
+          fail_on_unmatched_files: true
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 3a55952..d3e1b2d 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -11,14 +11,14 @@ permissions:
 
 # NOTE (WinPE ISO)
 # - WinPE ISO는 별도 워크플로우(WinPE Core/Test/Release)에서 생성/관리되는 것이 기본이다.
-# - 본 build.yml에서는 "사전 준비된 WinPE ISO"가 리포지토리 내에 존재하거나,
-#   또는 동일 워크플로우 산출물로 준비된 경우에만 통합 ISO에 포함한다.
-# - 파일이 없으면 통합 ISO 빌드는 실패시키지 않고 "미포함"으로 진행한다.
+# - build.yml에서 "사전 준비된 WinPE ISO"가 리포지터리에 미리 존재하거나
+#   또는 별도 워크플로우의 아티팩트로 준비된 경우에만 통합 ISO를 포함한다.
+# - 별도로 통합 ISO 빌드를 실패해도 패키지 생성하고 "미포함"으로 진행한다.
 
 jobs:
-  # ───────────────────────────────────────────────
+  # ======================================================================
   # 1) RPM BUILD (Rocky 9 + 10 병행)
-  # ───────────────────────────────────────────────
+  # ======================================================================
   build-rpm:
     runs-on: ubuntu-latest
     strategy:
@@ -35,12 +35,12 @@ jobs:
       - name: Install build deps
         run: |
           set -e
-          # 🔧 Rocky 10.1 이후 rpm-sequoia + OpenSSL 조합이 바뀌면서
-          # 컨테이너 베이스 레이어와 라이브러리 버전이 어긋나는 경우가 있어
-          # → 먼저 distro-sync 로 rpm / openssl 계열을 리포 상태와 맞춘다.
+          # 만약 Rocky 10.1 이후 rpm-sequoia + OpenSSL 조합이 바뀌면
+          # 컨테이너 베이스에 이미 설치된 라이브러리 버전이 맞지 않는 경우가 있어
+          # 그래서 distro-sync로 rpm / openssl 계열의 리포 상태를 맞춘다.
           dnf -y distro-sync
 
-          # 빌드에 필요한 도구 설치
+          # 빌드에 필요한 의존성 설치
           dnf -y install make rpm-build tar git dnf-plugins-core createrepo_c
 
       - name: Build RPM
@@ -56,7 +56,7 @@ jobs:
           cp rpmbuild/RPMS/*/*.rpm "$WORKDIR"/
 
           echo "[INFO] Downloading runtime dependencies..."
-          # spec의 Requires를 기반으로 의존성 전부 모아 저장
+          # spec의 Requires를 기반으로 존재하는 모든 것을 모아둠
           dnf download --resolve --alldeps \
             --destdir="$WORKDIR" \
             bash jq libvirt-client cloud-init || true
@@ -64,7 +64,7 @@ jobs:
           echo "[INFO] Creating repo metadata..."
           createrepo_c "$WORKDIR"
 
-          # 아티팩트 디렉토리 정리
+          # 아티팩트 디렉터리 정리
           mkdir -p release/rpm
           mv repo release/rpm/
 
@@ -73,11 +73,11 @@ jobs:
           name: rpm-package-${{ matrix.os_version }}
           path: release/rpm/**
 
-  # ───────────────────────────────────────────────
+  # ======================================================================
   # 1-A) HANGCTL RPM BUILD (Rocky 9 only)
-  #  - 목표: Rocky9 ABLESTACK Host에서만 설치되도록 spec(%pre 가드) 반영
-  #  - build.yml에서는 "빌드/리포 구성/배포"만 담당 (가드는 spec에서 처리)
-  # ───────────────────────────────────────────────
+  #  - 목표: Rocky9 ABLESTACK Host에서만 설치되도록 spec(%pre 가서 반영
+  #  - build.yml에서는 "빌드/리포 구성/배포"를 담당 (가정은 spec에서 처리)
+  # ======================================================================
   build-hangctl-rpm:
     runs-on: ubuntu-latest
     container:
@@ -102,7 +102,7 @@ jobs:
           SPEC="rpm/ablestack_vm_hangctl.spec"
           test -f "${SPEC}" || (echo "[ERR] Missing spec: ${SPEC}" >&2; exit 2)
 
-          # VERSION / RELEASE는 repo 루트의 VERSION 파일을 동일하게 사용
+          # VERSION / RELEASE를 repo 루트의 VERSION 파일에서 일괄적으로 사용
           VERSION="$(. ./VERSION; printf "%s" "$VERSION" | tr -d '\r\n[:space:]')"
           RELEASE="$(. ./VERSION; printf "%s" "$RELEASE" | tr -d '\r\n[:space:]')"
           GIT_HASH="$(git rev-parse --short HEAD 2>/dev/null || echo nogit)"
@@ -111,9 +111,9 @@ jobs:
 
           mkdir -p rpmbuild_hangctl/{BUILD,RPMS,SOURCES,SPECS,SRPMS}
 
-          # tarball 이름은 spec의 Source0 규칙과 일치해야 하므로,
-          # 기존 패키지들과 동일하게 'spec 파일 basename'을 prefix로 사용
-          # (즉, ablestack_vm_hangctl-<version>.tar.gz)
+          # tarball 이름이 spec의 Source0 규칙에 맞춰야 함
+          # 기존 패키지와 동일하게 'spec 파일 basename'의 prefix를 사용
+          # (예 ablestack_vm_hangctl-<version>.tar.gz)
           NAME_HANGCTL="ablestack_vm_hangctl"
           TMP_TGZ="$(mktemp /tmp/${NAME_HANGCTL}-${VERSION}.tar.gz.XXXXXX)"
           tar czf "${TMP_TGZ}" \
@@ -164,9 +164,9 @@ jobs:
           name: hangctl-rpm-package
           path: release/hangctl-rpm/**
           
-  # ───────────────────────────────────────────────
-  # 1-B) V2K RPM BUILD (별도 경로, 기존 빌드 프로세스 훼손 금지)
-  # ───────────────────────────────────────────────
+  # ======================================================================
+  # 1-B) V2K RPM BUILD (별도 경로, 기존 빌드 프로세스 손상 금지)
+  # ======================================================================
   build-v2k-rpm:
     runs-on: ubuntu-latest
     container:
@@ -181,12 +181,12 @@ jobs:
         run: |
           set -euo pipefail
 
-          # ─────────────────────────────────────────────
-          # Rocky 9.6 vault 고정 (AirGap 수집용)
-          # - 기존 rocky.repo는 mirrorlist만 있고 baseurl이 없을 수 있음
-          # - releasever=9.6만으로는 해결 안됨 (baseurl이 없어서)
+          # ======================================================================
+          # Rocky 9.6 vault 고정 (AirGap 집합)
+          # - 기존 rocky.repo의 mirrorlist를 고정 baseurl로 변경
+          # - releasever=9.6만으로는 해결 안됨 (baseurl이 바뀌어야 함)
           # - 따라서 9.6 vault baseurl을 가진 repo를 "직접" 생성
-          # ─────────────────────────────────────────────
+          # ======================================================================
           cat > /etc/yum.repos.d/rocky-vault-9.6.repo <<'EOF'
           [rocky-vault-9.6-baseos]
           name=Rocky Linux 9.6 - BaseOS (vault)
@@ -210,8 +210,8 @@ jobs:
           dnf clean all
           dnf -y --disablerepo="*" --enablerepo="rocky-vault-9.6-*" makecache
 
-          # curl 충돌 회피: curl-minimal ↔ curl
-          # - 컨테이너 베이스에 curl-minimal이 깔린 경우, 필요 시 allowerasing으로 정리
+          # curl 충돌 회피: curl-minimal vs curl
+          # - 컨테이너 베이스에 curl-minimal이 깔린 경우, 필요 시 allowerasing으로 처리
           dnf -y --disablerepo="*" --enablerepo="rocky-vault-9.6-*" install \
             --allowerasing ca-certificates curl-minimal || true
 
@@ -222,8 +222,8 @@ jobs:
         run: |
           set -euo pipefail
 
-          # ❗ 핵심: rocky.repo를 "rewrite"하지 않는다.
-          # rocky.repo는 mirrorlist만 있고 baseurl이 없는 케이스가 있어
+          # 핵심: rocky.repo를 "rewrite"하는 대신
+          # rocky.repo의 mirrorlist를 고정 baseurl로 변경하는 케이스가 있어
           # mirrorlist를 주석 처리하면 "baseurl 없음"으로 dnf가 즉시 실패한다.
           # 따라서 9.6 vault baseurl을 가진 repo 파일을 별도로 생성해서 사용한다.
 
@@ -253,16 +253,16 @@ jobs:
           # vault repo만으로 캐시 생성
           dnf -y --disablerepo="*" --enablerepo="rocky-vault-9.6-*" makecache
 
-          # EPEL은 build-time only (nbd 등 수집 목적) → 여기서 활성화 가능
-          # ❗ vault repo만 켠 상태에서는 epel-release 패키지를 'dnf install'로 찾을 수 없음(No match).
-          #     → EPEL bootstrap rpm을 URL로 직접 설치한다.
-          #     (빌드/릴리즈 단계에서만 외부 접근 허용하고, 결과 rpm은 ISO에 포함)
+          # EPEL을 build-time only (nbd 패키지 목적) 로기적으로 구성하기 위해
+          # vault repo만으로는 캐시 생성 시 epel-release 패키지를 'dnf install'로 찾을 수 없음(No match).
+          #     그래서 EPEL bootstrap rpm의 URL을 직접 다운로드한다.
+          #     (빌드/릴리즈 계열에서만 임시로 사용하고, 결과 rpm에 ISO에 포함)
           EPEL_RPM_URL="https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm"
           echo "[INFO] Installing EPEL release RPM: ${EPEL_RPM_URL}"
           curl -fL -o /tmp/epel-release.rpm "${EPEL_RPM_URL}"
           rpm -Uvh --nosignature /tmp/epel-release.rpm
 
-          # EPEL repo id 자동 탐지(epel/epel-9/epel-next 등 케이스 대응)
+          # EPEL repo id 자동 감지(epel/epel-9/epel-next 케이스 모두 고려)
           EPEL_REPO_ID="$(dnf repolist all 2>/dev/null | awk 'tolower($1) ~ /^epel/ {print $1; exit}')"
           if [[ -z "${EPEL_REPO_ID}" ]]; then
             echo "[ERR] EPEL repo id not found after installing epel-release." >&2
@@ -272,14 +272,14 @@ jobs:
           echo "[INFO] Detected EPEL repo id: ${EPEL_REPO_ID}"
           echo "EPEL_REPO_ID=${EPEL_REPO_ID}" >> "$GITHUB_ENV"
 
-          # vault + epel 캐시 생성(딱 필요한 repo만)
+          # vault + epel 캐시 생성(필요한 repo만)
           dnf -y --disablerepo="*" --enablerepo="rocky-vault-9.6-*","${EPEL_REPO_ID}" makecache          
 
       - name: Build V2K RPM (separate path)
         run: |
           set -e
-          # NOTE: 기존 make rpm 경로와 분리된 V2K 전용 타겟을 사용해야 함
-          #       (예: make v2k-rpm)
+          # NOTE: 기존 make rpm 경로를 분리하여 V2K 용 패키지를 사용해야 함
+          #       (예 make v2k-rpm)
           make v2k-rpm
  
       - name: Verify ablestack_v2k rpm contains bash completion
@@ -297,14 +297,14 @@ jobs:
           WORKDIR="release/v2k/v2k-rpm-rocky9.6"
           mkdir -p "$WORKDIR"
 
-          # V2K 본체 RPM 수집 (프로젝트 산출 경로에 맞춰 필요 시 조정)
+          # V2K 본체 RPM 수집 (프로젝트 출력 경로에 맞춰 필요 시 조정)
           find . -type f -name "*.rpm" \( -iname "*ablestack*v2k*.rpm" -o -iname "*ablestack_v2k*.rpm" \) -exec cp -v {} "$WORKDIR"/ \;
 
           echo "[INFO] Collecting runtime deps for Air-Gap (Requires closure minus ABLESTACK baseline)..."
 
-          # --- 9.6 고정 (중요: 9.7 혼입 차단) ---
+          # --- 9.6 고정 (중요: 9.7 입력 차단) ---
           : "${EPEL_REPO_ID:?EPEL_REPO_ID is not set. Configure step must export it to GITHUB_ENV}"
-          # 옵션 문자열에 따옴표를 넣지 말고, 배열로 전달(파싱 안정성)
+          # 옵션 문자에 의존하지 말고, 배열로 전달(파싱 정확도)
           DNF_COMMON_OPTS=(
             --releasever=9.6
             --disablerepo=*
@@ -312,11 +312,11 @@ jobs:
             --setopt=install_weak_deps=False
           )
 
-          # ablestack-v2k.spec의 Requires와 동일하게 유지 (8개)
-          # ceph-common: rbd CLI 사용(생성/존재확인) 목적
+          # ablestack-v2k.spec의 Requires를 동일하게 처리 (8개)
+          # ceph-common: rbd CLI 사용(생성/존재 확인) 목적
           REQ_PKGS="jq python3 openssl nbd nbdkit nbdkit-vddk-plugin qemu-img libvirt-client"
 
-          # baseline 파일(ABLestack 9.6 호스트에서 rpm -qa 기반으로 생성해 커밋)
+          # baseline 파일(ABLestack 9.6 호스트에서 rpm -qa 기반으로 생성된 커밋)
           BASELINE_FILE="rpm/v2k_baseline_pkgs_ablestack_9.6.txt"
           if [[ ! -f "${BASELINE_FILE}" ]]; then
             echo "[ERR] Missing baseline file: ${BASELINE_FILE}" >&2
@@ -326,10 +326,10 @@ jobs:
           fi
 
           echo "[INFO] Sanity check: required pkgs availability (repo view)"
-          # nbd/nbdkit/qemu-img가 repo에서 안 보이면 여기서 즉시 실패해야 함(지금 문제 조기 차단)
+          # nbd/nbdkit/qemu-img가 repo에서 보이지 않으면 즉시 실패해야 하는 이유: 문제 조기 차단)
           dnf -q "${DNF_COMMON_OPTS[@]}" repoquery --available ${REQ_PKGS} >/dev/null
 
-          # Requires 의존성 클로저 산출 (패키지명만, 중복 제거)
+          # Requires 존재하는 것으로 출력 (패키지명만, 중복 제거)
           # dnf-plugins-core의 repoquery 사용
           dnf -y "${DNF_COMMON_OPTS[@]}" install dnf-plugins-core >/dev/null
           dnf -q "${DNF_COMMON_OPTS[@]}" repoquery \
@@ -337,15 +337,15 @@ jobs:
             --qf '%{name}' \
             ${REQ_PKGS} | sort -u > /tmp/v2k_dep_closure.txt
 
-          # (중요) Direct requires는 baseline subtract와 무관하게 반드시 포함
+          # (중요) Direct requires와 baseline subtract를 무조건 반드시 해야 함
           printf '%s\n' ${REQ_PKGS} | sort -u > /tmp/v2k_must_have.txt
 
 
-          # baseline에 이미 있는 패키지 제외 (없는 것만 다운로드)
+          # baseline에 없는 패키지 제외 (있는 것만 다운로드)
           sort -u "${BASELINE_FILE}" > /tmp/v2k_baseline.txt
           comm -23 /tmp/v2k_dep_closure.txt /tmp/v2k_baseline.txt > /tmp/v2k_to_download_closure.txt
 
-          # (중요) Direct requires는 baseline subtract와 무관하게 반드시 포함
+          # (중요) Direct requires와 baseline subtract를 무조건 반드시 해야 함
           printf '%s\n' ${REQ_PKGS} | sort -u > /tmp/v2k_must_have.txt
 
           # baseline subtract (closure - baseline)
@@ -360,18 +360,18 @@ jobs:
           head -n 50 /tmp/v2k_to_download_candidate.txt || true
 
           echo "[INFO] Filtering candidate list by repo availability (STRICT)..."
-          # ⚠️ 절대 $(cat ...) 쓰지 말 것. 인자 길이/에러/빈값으로 repo 전체가 나오는 사고가 난다.
-          # xargs로 "실제 repo에 존재하는 패키지명"만 남긴다.
+          # ⚠️ 주의: $(cat ...) 대신 xargs로 처리해야 하는 이유: 파일 내용이 너무 길거나 빈값으로 repo 전체가 깨지는 경우가 있다.
+          # xargs로만 repo에 존재하는 패키지를 필터링함
           : > /tmp/v2k_to_download_avail.txt
           cat /tmp/v2k_to_download_candidate.txt \
             | xargs -r -n 200 dnf -q "${DNF_COMMON_OPTS[@]}" repoquery --available --qf '%{name}' \
             | sort -u > /tmp/v2k_to_download_avail.txt
 
-          # langpack 폭발 방지(선제 제거) - 필요 없으면 과감히 제외
+          # langpack 관련 방지(완제 제거) - 필요 없으므로 과감히 제외
           grep -vE '^glibc-all-langpacks$|^glibc-langpack-' /tmp/v2k_to_download_avail.txt \
             | sort -u > /tmp/v2k_to_download.txt
 
-          # missing(후보엔 있었는데 repo엔 없는 것) 로깅
+          # missing(보고 있었는데 repo에 없는 것) 로깅
           comm -23 /tmp/v2k_to_download_candidate.txt /tmp/v2k_to_download_avail.txt > /tmp/v2k_missing_in_repo.txt
           if [[ -s /tmp/v2k_missing_in_repo.txt ]]; then
             echo "[WARN] Missing in enabled repos (skipped):"
@@ -382,7 +382,7 @@ jobs:
           echo "[INFO] Final to-download sample (first 50):"
           head -n 50 /tmp/v2k_to_download.txt || true
 
-          # 최종 방어: nbd/nbdkit/qemu-img는 반드시 있어야 한다
+          # 최종 방어: nbd/nbdkit/qemu-img가 반드시 있어야 함
           for p in nbd nbdkit qemu-img; do
             if ! grep -qx "$p" /tmp/v2k_to_download.txt && ! grep -qx "$p" /tmp/v2k_baseline.txt; then
               echo "[ERR] Required package '$p' is neither in baseline nor in final download list." >&2
@@ -390,7 +390,7 @@ jobs:
             fi
           done
 
-          # download (여기서는 exclude를 걸어도 되지만, 위에서 이미 제거했으니 없어도 됨)
+          # download (기본적으로 exclude 걸어주지만 에러에 대비해서 중복 제거하도록 처리함)
           if [[ -s /tmp/v2k_to_download.txt ]]; then
             xargs -r dnf "${DNF_COMMON_OPTS[@]}" download --destdir="$WORKDIR" < /tmp/v2k_to_download.txt
           else
@@ -409,9 +409,9 @@ jobs:
           name: v2k-rpm-package
           path: release/v2k/**
 
-  # ───────────────────────────────────────────────
+  # ======================================================================
   # 2) DEB BUILD (Ubuntu 22.04 / 24.04)
-  # ───────────────────────────────────────────────
+  # ======================================================================
   build-deb:
     strategy:
       matrix:
@@ -435,16 +435,16 @@ jobs:
           set -e
           sudo apt-get update -y
 
-          # ISO용 로컬 APT 리포 생성 공간
+          # ISO를 위한 로컬 APT 리포 생성 공간
           mkdir -p repo/pool
           find build/deb -type f -name "*.deb" -exec cp {} repo/pool/ \;
 
           cd repo/pool
 
           echo "[INFO] Starting dependency collection..."
-          # 이미 처리한 패키지 이름 기억
+          # 한번에 처리할 패키지 이름 기억
           seen_pkgs=""
-          # 새 .deb이 추가되는 동안 반복
+          # 각 .deb의 추가되는 동안 반복
           new_pkgs=1
           while [ "$new_pkgs" -eq 1 ]; do
             new_pkgs=0
@@ -456,7 +456,7 @@ jobs:
               fi
               seen_pkgs="$seen_pkgs $P"
 
-              # Depends 파싱: 콤마 분리, 버전/괄호 제거, 대체(|)는 첫 토큰, :any 제거
+              # Depends 파싱: 콤마 분리, 버전/괄호 제거, 또는|를 공백으로 큰, :any 제거
               DEPS=$(dpkg-deb -f "$deb" Depends | \
                      tr ',' '\n'          | \
                      sed -E 's/\(.*\)//g' | \
@@ -469,7 +469,7 @@ jobs:
 
               for dep in $DEPS; do
                 [ -n "$dep" ] || continue
-                # 이미 pool에 같은 패키지 내려받은 경우는 넘어감
+                # 이미 pool에 같은 패키지가 다운로드된 경우에는 건너뜀
                 if ls -1 ${dep}_*.deb >/dev/null 2>&1; then
                   continue
                 fi
@@ -490,7 +490,7 @@ jobs:
           mkdir -p repo/dists/stable/main/binary-amd64
           ( cd repo && dpkg-scanpackages pool /dev/null | gzip -9c > dists/stable/main/binary-amd64/Packages.gz )
 
-          # 배포용 위치로 정리
+          # 배포판 설정을 정리
           mv repo "deb-ubuntu${{ matrix.os_version }}"
           mkdir -p release/deb
           mv deb-ubuntu${{ matrix.os_version }} release/deb/
@@ -500,9 +500,9 @@ jobs:
           name: deb-package-${{ matrix.os_version }}
           path: release/deb/**
 
-  # ───────────────────────────────────────────────
+  # ======================================================================
   # 3) WINDOWS MSI BUILD
-  # ───────────────────────────────────────────────
+  # ======================================================================
   build-windows:
     runs-on: windows-latest
     steps:
@@ -524,9 +524,9 @@ jobs:
           name: msi-package
           path: windows/msi/out/*
 
-  # ───────────────────────────────────────────────
+  # ======================================================================
   # 4) RELEASE + ISO CREATION (VirtIO 통합 포함)
-  # ───────────────────────────────────────────────
+  # ======================================================================
   release:
     needs: [build-rpm, build-hangctl-rpm, build-deb, build-windows, build-v2k-rpm]
     runs-on: ubuntu-latest
@@ -535,8 +535,8 @@ jobs:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          # workflow_run에서는 기본 브랜치가 checkout될 수 있으므로,
-          # WinPE Release Build가 빌드한 동일 커밋으로 고정
+          # workflow_run에서 기본 브랜치로 checkout하므로
+          # WinPE Release Build가 빌드한 파일 커밋으로 고정
           ref: ${{ github.event.workflow_run.head_sha }}
 
       - name: Resolve tag from workflow_run
@@ -554,7 +554,7 @@ jobs:
           fi
           echo "RELEASE_TAG=$TAG" >> "$GITHUB_ENV"
 
-      # dist/ 아래에 모든 아티팩트 내려받기
+      # dist/ 아래에 모든 아티팩트 다운로드
       - uses: actions/download-artifact@v4
         with:
           path: dist
@@ -568,8 +568,8 @@ jobs:
           mkdir -p release/winpe
 
           echo "[INFO] Downloading WinPE ISO assets for tag: ${RELEASE_TAG}"
-          # WinPE workflow가 dist/*.iso 와 SHA256SUMS를 릴리즈에 붙였으므로, 여기서 가져온다.
-          # 파일명이 고정이 아닐 수 있어 패턴으로 수집
+          # WinPE workflow가 dist/*.iso 와 SHA256SUMS를 릴리즈에 붙여놓았으므로 여기서 가져옴
+          # 파일명이 고정되지 않을 수 있으므로 패턴으로 수집
           gh release download "${RELEASE_TAG}" \
             -p "*winpe*.iso" \
             -p "SHA256SUMS" \
@@ -592,7 +592,7 @@ jobs:
           set -e
           mkdir -p release/rpm release/deb release/msi release/assets/v2k/wheels release/v2k
 
-          echo "🔍 Collecting RPM repos..."
+          echo "모두 Collecting RPM repos..."
           for ver in 9 10; do
             SRC_DIR=$(find dist -type d -path "*/rpm-package-${ver}/release/rpm/repo/rpm-rocky${ver}" | head -n 1)
             if [ -d "$SRC_DIR" ]; then
@@ -611,7 +611,7 @@ jobs:
             fi
           done
 
-          echo "🔍 Collecting HANGCTL RPM repo (Rocky 9)..."
+          echo "모두 Collecting HANGCTL RPM repo (Rocky 9)..."
           HANGCTL_DIR="$(find dist -type d \( \
                           -path "*/hangctl-rpm-package/release/hangctl-rpm/repo/hangctl-rpm-rocky9" -o \
                           -path "*/hangctl-rpm-package/repo/hangctl-rpm-rocky9" \
@@ -624,7 +624,7 @@ jobs:
             echo "[WARN] No HANGCTL RPM repo found (hangctl-rpm-package)."
           fi
 
-          echo "🔍 Collecting DEB repos..."
+          echo "모두 Collecting DEB repos..."
           for ver in 22.04 24.04; do
             SRC_DIR=$(find dist -type d \( \
                         -path "*/deb-package-${ver}/release/deb/deb-ubuntu${ver}" -o \
@@ -639,7 +639,7 @@ jobs:
             fi
           done
 
-          echo "🔍 Collecting MSI artifacts..."
+          echo "모두 Collecting MSI artifacts..."
           find dist -type f -path "*/msi-package/*" -exec cp {} release/msi/ \;
 
       - name: Collect V2K RPM repo (Rocky 9.6) into ISO tree
@@ -674,10 +674,10 @@ jobs:
           set -euo pipefail
           python3 -m pip download -d release/assets/v2k/wheels "pyvmomi==8.0.3.0.1"
 
-      # VirtIO Windows Stable ISO 다운로드 후 "amd64 드라이버 + guest tools(qemu-ga 포함)"만 추출
+      # VirtIO Windows Stable ISO 다운로드 "amd64 드라이버 + guest tools(qemu-ga 포함)" 추출
       # - 중첩 ISO 금지
       # - DISM/WinPE에서 바로 INF 경로 지정 가능
-      # - 용량 절감(amd64 only)
+      # - 용량 감소(amd64 only)
       - name: Download & extract VirtIO (amd64-only + guest tools)
         run: |
           set -e
@@ -685,9 +685,9 @@ jobs:
           curl -fL -o dist/virtio-win.iso \
             "https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso"
 
-          # 1) DISM용: 핵심 드라이버 디렉토리의 amd64만 추출
-          #    (VirtIO ISO 버전에 따라 w11/2k22/2k19 등 하위 폴더명이 달라도, amd64 경로만 살리면 된다)
-          #    7z는 와일드카드 패턴을 허용하므로, */amd64/* 패턴으로 추출한다.
+          # 1) DISM을 위한 핵심 드라이버 디렉터리를 amd64로 추출
+          #    (VirtIO ISO 버전에 따라 w11/2k22/2k19 등 폴더명이 바뀌므로 amd64 경로로 일괄 처리함)
+          #    7z의 와일드카드 리턴을 활용하여 */amd64/* 패턴으로 추출함
           7z x -y -o"dist/virtio-src" dist/virtio-win.iso \
             "viostor/*/amd64/*" \
             "vioscsi/*/amd64/*" \
@@ -699,12 +699,12 @@ jobs:
             "vioinput/*/amd64/*" \
             "vioser/*/amd64/*" || true
 
-          # 2) Guest tools(qemu-ga 포함): exe/msi는 루트 또는 특정 위치에 있을 수 있으므로 '찾아서' 포함
-          #    - 둘 다 있으면 둘 다 포함(현장 선택 가능)
+          # 2) Guest tools(qemu-ga 포함): exe/msi를 루트 또는 특정 위치에서 찾아서 포함
+          #    - 가능한 모든 것을 포함(장점 선택 가능)
           7z x -y -o"dist/virtio-src" dist/virtio-win.iso "virtio-win-guest-tools.exe" || true
           7z x -y -o"dist/virtio-src" dist/virtio-win.iso "virtio-win-gt-*.msi" || true
 
-          # 3) release/virtio로 복사 (존재하는 것만)
+          # 3) release/virtio에 복사 (존재하는 것만)
           for d in viostor vioscsi NetKVM Balloon qemupciserial viorng pvpanic vioinput vioser; do
             if [[ -d "dist/virtio-src/${d}" ]]; then
               mkdir -p "release/virtio/${d}"
@@ -714,7 +714,7 @@ jobs:
           if [[ -f "dist/virtio-src/virtio-win-guest-tools.exe" ]]; then
             cp -a "dist/virtio-src/virtio-win-guest-tools.exe" "release/virtio/"
           fi
-          # MSI는 버전별 파일명이 달라질 수 있어 glob 복사
+          # MSI의 버전으로 파일명이 바뀌므로 glob 복사
           shopt -s nullglob
           for m in dist/virtio-src/virtio-win-gt-*.msi; do
             cp -a "$m" "release/virtio/"
@@ -733,8 +733,8 @@ jobs:
           mkdir -p release/winpe
 
           # 우선순위
-          #  1) 동일 워크플로우 아티팩트(dist) 내 winpe*.iso
-          #  2) 리포지토리 내 사전 준비 파일(assets/winpe/*.iso 또는 winpe/*.iso)
+          #  1) 별도 워크플로우의 아티팩트(dist) 에서 winpe*.iso
+          #  2) 리포지터리에 미리 준비된 파일(assets/winpe/*.iso 또는 winpe/*.iso)
           WINPE_ISO=""
           WINPE_ISO="$(find dist -type f -iname '*.iso' -iname '*winpe*' 2>/dev/null | head -n 1 || true)"
           if [[ -z "$WINPE_ISO" ]]; then
@@ -815,27 +815,26 @@ jobs:
               param(
                   [string]$Message = "ABLESTACK tools installation is complete. The system needs to reboot.",
                   [string]$Title   = "ABLESTACK",
-                  [int]   $Options = 0x0,     # 0x0: OK only / 0x4: Yes/No 등
+                  [int]   $Options = 0x0,     # 0x0: OK only / 0x4: Yes/No ??
                   [int]   $TimeoutSeconds = 60  # 사용자 입력 최대 대기 시간 (초)
               )
 
               $shell = New-Object -ComObject WScript.Shell
 
-              # 두 번째 인자에 타임아웃(초)을 넣는다.
+              # 두 번째 호출에서만 사용자에게 물어보는 이유
               # 반환값:
-              #   -1 : 타임아웃
+              #   -1 : 시간 초과됨
               #    1 : OK
-              #    6 : Yes (0x4 옵션일 때)
-              $result = $shell.Popup($Message, $TimeoutSeconds, $Title, $Options)
+              #    6 : Yes (0x4 옵션에서)              $result = $shell.Popup($Message, $TimeoutSeconds, $Title, $Options)
 
               if ($result -eq -1 -or $result -eq 1 -or $result -eq 6) {
                   Write-Host "Prompt_Reboot: user accepted or no response within timeout. Rebooting..."
-                  # 재부팅 바로 수행 (원래 스펙대로)
+                  # 시스템을 바로 재부팅 (원래 의도대로)
                   Restart-Computer -Force
-                  # MSI CustomAction이라면 실제로는 여기서
+                  # MSI CustomAction에서는 여기서 끝나고, 실제로는 여기까지 실행되지 않음
                   #   msiexec /i ... /norestart + REBOOT=ReallySuppress
-                  # 를 쓰고 시스템 재부팅은 별도 관리자 스크립트에서 처리하는 식도 가능하지만,
-                  # 지금 구조에서는 Restart-Computer 써도 됨.
+                  # 그러고 시스템 재부팅/종료를 별도 관리자 스크립트에서 처리하는 것도 가능하지 않음
+                  # 지금 구조에서는 Restart-Computer 방식이 적합함
               }
               else {
                   Write-Host "Prompt_Reboot: user canceled reboot (result = $result)."
@@ -919,7 +918,7 @@ jobs:
             # Completion message
             if ($global:rebootNeeded) {
               Prompt_Reboot "ABLESTACK tools installation completed. Reboot now?" "ABLESTACK" 0x0 30
-              # → 30초만 기다린 뒤 자동 재부팅
+              # 그렇지 않으면 30초만 기다리고 자동으로 진행함
             } else {
               Show-Info "Installation completed successfully. No reboot is required."
             }
@@ -943,7 +942,7 @@ jobs:
             exit /b 1
           )
           
-          REM --- 설치 절차 끝 ---
+          REM --- 설치 차례 ---
           mkdir "C:\ProgramData\AbleStack" 2>nul
           echo ok> "C:\ProgramData\AbleStack\autoinstall.done"
           echo [OK] Installation finished.
@@ -1024,11 +1023,11 @@ jobs:
                   sudo rm -f /etc/yum.repos.d/ablestack-qemu-exec-tools.repo
                   sudo dnf clean all
 
-                  # ───────────────────────────────────────────────
+                  # ======================================================================
                   # HANGCTL add-on (ABLESTACK Host only, Rocky 9 only)
                   #  - Install ablestack_vm_hangctl from ISO local repo
                   #  - If not ABLESTACK host / not Rocky9 -> skip
-                  # ───────────────────────────────────────────────
+                  # ======================================================================
                   if [[ "${PRETTY_NAME:-}" == *"ABLESTACK"* && "${MAJOR_VERSION:-}" == "9" ]]; then
                       echo "[INFO] ABLESTACK Host on Rocky 9 detected. Installing HANGCTL add-on..."
 
@@ -1057,12 +1056,12 @@ jobs:
                       echo "[INFO] HANGCTL add-on skipped (not ABLESTACK host or not Rocky 9)."
                   fi
 
-                  # ───────────────────────────────────────────────
+                  # ======================================================================
                   # V2K add-on (ABLESTACK Host only)
                   #  - based on bin/v2k_test_install.sh
                   #  - Air-Gap: pyvmomi installs from ISO offline wheels
                   #  - NO ldconfig / NO global linker path modifications
-                  # ───────────────────────────────────────────────
+                  # ======================================================================
                   if [[ "${PRETTY_NAME:-}" == *"ABLESTACK"* && "${VERSION_ID:-}" == 9.6* ]]; then
                       echo "[INFO] ABLESTACK 9.6 detected. Installing V2K add-on..."
 
@@ -1214,7 +1213,7 @@ jobs:
                           echo "[WARN] pyvmomi wheels dir not found in ISO: ${WHEEL_DIR}"
                       fi
 
-                      # 5) WinPE ISO 배치 (오프라인 드라이버 주입/복구용)
+                      # 5) WinPE ISO 배치 (에어갭 환경에서 드라이버 주입/복구용)
                       # - 통합 ISO에 winpe/*.iso 가 포함된 경우에만 설치
                       WINPE_SRC_DIR="${ISO_MNT}/winpe"
                       WINPE_DST_DIR="/usr/share/ablestack/v2k/winpe"
@@ -1252,7 +1251,7 @@ jobs:
                   ;;
           esac
 
-          # --- 설치 절차 끝 ---
+          # --- 설치 차례 ---
           mkdir -p /var/lib/ablestack
           echo ok > /var/lib/ablestack/autoinstall.done
           echo "[INFO] Installation complete."
@@ -1276,7 +1275,7 @@ jobs:
           echo "${DESC}" >> release_notes.md
           echo >> release_notes.md
 
-          # 태그 정보 보강 (혹시 몰라서)
+          # 태그 정보 보강 (직접 몰라도 됨)
           git fetch --tags --force || true
 
           # 직전 태그 찾기 (없으면 최초 릴리즈로 간주)
@@ -1306,7 +1305,7 @@ jobs:
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
-          # workflow_run 트리거에서는 tag_name을 명시해야 릴리즈 대상이 정확해짐
+          # workflow_run 트리거에서는 tag_name을 명시해야 릴리즈가 제대로 생성됨
           tag_name: ${{ env.RELEASE_TAG }}
           body_path: release_notes.md
           files: |
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 891a525..3bff3b4 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -18,5 +18,5 @@ jobs:
 
       - name: Run Make (all targets)
         run: |
-          echo "🔍 Running CI build (basic validation)"
+          echo "?�� Running CI build (basic validation)"
           make all
diff --git a/.vscode/settings.json b/.vscode/settings.json
new file mode 100644
index 0000000..86d38e6
--- /dev/null
+++ b/.vscode/settings.json
@@ -0,0 +1,5 @@
+{
+    "editor.formatOnSave": true,
+    "files.eol": "\n",
+    "editorconfig.enabled": true
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 72e20ec..93df6db 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,48 +1,60 @@
 # Changelog
 
-이 문서는 ablestack-qemu-exec-tools 프로젝트의 모든 변경 내역을 기록합니다.  
-형식은 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)를 참고했으며,  
-버전 표기는 [Semantic Versioning](https://semver.org/)을 따릅니다.
+이 문서는 ablestack-qemu-exec-tools 프로젝트의 모든 변경 이력을 기록합니다.
+형식은 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)를 참고하며
+버전 기기는 [Semantic Versioning](https://semver.org/)을 따릅니다.
 
 ---
 
 ## [Unreleased]
+
 ### Added
+
 - 새로운 기능 추가 예정 목록
 
 ### Changed
+
 - 변경 예정 사항
 
 ### Fixed
+
 - 수정 예정 버그 목록
 
 ---
 
 ## [0.3.0] - 2025-09-25
+
 ### Added
-- Windows MSI 빌드 스크립트(`build-msi.ps1`) 버전/릴리즈/깃해시 반영
-- Product.wxs에 설치 버전/릴리즈/깃해시를 MSI 속성과 레지스트리에 기록하는 기능 추가
-- GitHub Actions `build.yml` → 릴리즈 자동화 (RPM/DEB/MSI 빌드 및 Release 업로드)
+
+- Windows MSI 빌드 스크립트(`build-msi.ps1`) 버전/릴리즈 깃해시 반영
+- Product.wxs에 설치 버전/릴리즈 깃해시를 MSI 생성 시 메트리에 기록하는 기능 추가
+- GitHub Actions `build.yml` 에 릴리즈 자동화(RPM/DEB/MSI 빌드 및 Release 업로드)
 
 ### Changed
+
 - Makefile: `VERSION` 파일 참조 방식으로 변경
-- RPM spec/DEB control: 동적으로 버전/릴리즈 반영되도록 수정
+- RPM spec/DEB control: 자동으로 버전/릴리즈 반영하도록 수정
 
 ### Fixed
-- Windows 빌드 시 WiX 확장 처리 안정화
-- DEB 패키징 control 파일 버전 하드코딩 문제 수정
+
+- Windows 빌드 시 WiX 장치 처리 수정
+- DEB 패키지 control 파일 버전 하드코딩 문제 수정
 
 ---
 
 ## [0.2.0] - 2025-09-15
+
 ### Added
-- Linux용 vm_exec.sh, agent_policy_fix.sh 스크립트 안정화
-- DEB/RPM 패키징 초기 지원
+
+- Linux용 vm_exec.sh, agent_policy_fix.sh 스크립트 작성
+- DEB/RPM 패키지 초기 지원
 - GitHub Actions ci.yml 추가
 
 ---
 
 ## [0.1.0] - 2025-08-30
+
 ### Added
+
 - 프로젝트 초기 생성
-- 기본 VM 원격 명령 실행 기능 (Linux/Windows)
+- 기본 VM 게스트 명령 실행 기능 (Linux/Windows)
diff --git a/INSTALL.md b/INSTALL.md
index 245a1f3..7fa0813 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -1,11 +1,12 @@
 # ablestack-qemu-exec-tools 설치 및 배포 가이드
 
-## 1. 준비 사항
+## 1. 준비사항
+
 - **개발 환경**
   - GitHub 저장소 접근 권한
   - `git` 명령어 사용 가능
 - **CI/CD**
-  - GitHub Actions 활성화 (`.github/workflows/ci.yml`, `build.yml` 존재)
+  - GitHub Actions 설정됨(`.github/workflows/ci.yml`, `build.yml` 존재)
 - **필수 파일**
   - `VERSION` (버전 및 릴리즈 번호 정의)
   - `Makefile`
@@ -16,6 +17,7 @@
 ---
 
 ## 2. 버전 관리
+
 버전은 `VERSION` 파일에서 관리합니다.
 
 ```
@@ -23,25 +25,29 @@ VERSION=0.3.0
 RELEASE=1
 ```
 
-- **VERSION**: 주/부/패치 버전 (`0.3.0`)
-- **RELEASE**: 동일 버전 내 빌드 차수 (`1`, `2` …)
+- **VERSION**: 메이저/마이너 버전 (`0.3.0`)
+- **RELEASE**: 동일 버전 내 빌드 차수 (`1`, `2` 등)
 
 ---
 
 ## 3. 로컬 빌드 (옵션)
+
 ### RPM 빌드 (RHEL 계열)
+
 ```bash
 make rpm
 ls rpmbuild/RPMS/*/*.rpm
 ```
 
 ### DEB 빌드 (Ubuntu 계열)
+
 ```bash
 make deb
 ls build/deb/*.deb
 ```
 
 ### MSI 빌드 (Windows)
+
 ```powershell
 make windows
 Get-ChildItem windows/msi/out/*.msi
@@ -49,29 +55,32 @@ Get-ChildItem windows/msi/out/*.msi
 
 ---
 
-## 4. GitHub Actions – CI
-- **동작 조건**: `push` (main, develop 브랜치), `pull_request`
-- **실행 내용**:
-  - `make all` 실행 (기본 빌드 검증)
-- **목적**: 코드가 깨지지 않았는지 확인
+## 4. GitHub Actions 기반 CI
+
+- **?�작 조건**: `push` (main, develop 브랜�?, `pull_request`
+- **?�행 ?�용**:
+  - `make all` ?�행 (기본 빌드 검�?
+- **목적**: 코드가 깨�?지 ?�았?��? ?�인
 
 ---
 
-## 5. GitHub Actions – Release 빌드
-- **동작 조건**: `git tag vX.Y.Z && git push origin vX.Y.Z`
-- **실행 내용**:
-  - RPM 빌드 (Rocky Linux 9 컨테이너)
+## 5. GitHub Actions ??Release 빌드
+
+- **?�작 조건**: `git tag vX.Y.Z && git push origin vX.Y.Z`
+- **?�행 ?�용**:
+  - RPM 빌드 (Rocky Linux 9 컨테?�너)
   - DEB 빌드 (Ubuntu 최신)
   - MSI 빌드 (Windows + WiX v4)
-- **결과물**:
-  - GitHub Release에 `.rpm`, `.deb`, `.msi` 자동 업로드
-- **릴리즈 노트**:
-  - `git log` 기반 자동 생성 (직전 태그 이후 커밋 내역)
+- **결과�?*:
+  - GitHub Release??`.rpm`, `.deb`, `.msi` ?�동 ?�로??- **릴리�??�트**:
+  - `git log` 기반 ?�동 ?�성 (직전 ?�그 ?�후 커밋 ?�역)
 
 ---
 
-## 6. 릴리즈 절차
+## 6. 릴리�??�차
+
 1. **버전 갱신**
+
    ```bash
    echo "VERSION=0.3.0" > VERSION
    echo "RELEASE=1" >> VERSION
@@ -79,24 +88,25 @@ Get-ChildItem windows/msi/out/*.msi
    git commit -m "Bump version to 0.3.0-1"
    ```
 
-2. **태그 생성**
+2. **?�그 ?�성**
+
    ```bash
    git tag v0.3.0
    git push origin main --tags
    ```
 
-3. **GitHub Actions 실행**
-   - Actions 탭에서 워크플로우 확인
-   - 빌드 완료 후 Release 페이지 자동 생성
+3. **GitHub Actions ?�행**
+   - Actions ??��???�크?�로???�인
+   - 빌드 ?�료 ??Release ?�이지 ?�동 ?�성
 
-4. **릴리즈 확인**
-   - `Release` 페이지에서 `.rpm`, `.deb`, `.msi` 다운로드 가능
-   - 릴리즈 노트 = `git log` 자동 생성 내용
+4. **릴리�??�인**
+   - `Release` ?�이지?�서 `.rpm`, `.deb`, `.msi` ?�운로드 가??   - 릴리�??�트 = `git log` ?�동 ?�성 ?�용
 
 ---
 
-## 7. 설치 후 확인 (Windows)
-MSI 설치 후 PowerShell에서:
+## 7. ?�치 ???�인 (Windows)
+
+MSI ?�치 ??PowerShell?�서:
 
 ```powershell
 Get-ItemProperty "HKLM:\SOFTWARE\AbleStack\QemuExecTools" |
@@ -105,14 +115,15 @@ Get-ItemProperty "HKLM:\SOFTWARE\AbleStack\QemuExecTools" |
 
 ---
 
-## 8. 유지보수 팁
-- **새 버전 배포** 시에는 `VERSION` 파일만 수정 → 태그 푸시 → Actions 자동 실행
-- **긴급 패치** 시에는 `RELEASE` 값을 증가 (`2`, `3` …)
-- **릴리즈 노트 관리**를 더 정교하게 하려면 `CHANGELOG.md`를 추가해도 됨 (현재는 `git log` 기반)
+## 8. ?��?보수 ??- **??버전 배포** ?�에??`VERSION` ?�일�??�정 ???�그 ?�시 ??Actions ?�동 ?�행
+
+- **긴급 ?�치** ?�에??`RELEASE` 값을 증�? (`2`, `3` ??
+- **릴리�??�트 관�?*�????�교?�게 ?�려�?`CHANGELOG.md`�?추�??�도 ??(?�재??`git log` 기반)
 
 ---
 
-# ✅ 요약
-- **ci.yml** → 개발 브랜치/PR 빌드 검증  
-- **build.yml** → 태그 기반 정식 릴리즈 빌드 & 자동 업로드  
-- **사용자는 VERSION 수정 + 태그 푸시만 하면 됨**
+# ???�약
+
+- **ci.yml** ??개발 브랜�?PR 빌드 검�?
+- **build.yml** ???�그 기반 ?�식 릴리�?빌드 & ?�동 ?�로??
+- **?�용?�는 VERSION ?�정 + ?�그 ?�시�??�면 ??*
diff --git a/Makefile b/Makefile
index d232ab5..9e559a0 100644
--- a/Makefile
+++ b/Makefile
@@ -25,7 +25,7 @@ HANGCTL_SPEC = rpm/$(HANGCTL_NAME).spec
 VERSION := $(shell . ./VERSION; printf "%s" "$$VERSION" | tr -d '\r\n[:space:]')
 RELEASE := $(shell . ./VERSION; printf "%s" "$$RELEASE" | tr -d '\r\n[:space:]')
 
-# Git hash는 실행 시점에서 자동으로 추출
+# Extract git hash dynamically at execution time
 GIT_HASH := $(shell git rev-parse --short HEAD 2>/dev/null || echo "nogit")
 
 INSTALL_PREFIX = /usr/local
@@ -50,24 +50,24 @@ all:
 	@echo "VERSION: $(VERSION), RELEASE: $(RELEASE), GIT_HASH: $(GIT_HASH)"
 
 install:
-	@echo "🔧 Installing $(NAME)..."
+	@echo "Installing $(NAME)..."
 	install -d $(BIN_DIR)
 	install -m 0755 bin/vm_exec.sh $(BIN_DIR)/vm_exec
 	install -m 0755 bin/agent_policy_fix.sh $(BIN_DIR)/agent_policy_fix
 	@if [ -f install.sh ]; then install -m 0755 install.sh $(BIN_DIR)/install_ablestack_qemu_exec_tools; fi
 	install -d $(LIB_TARGET)
 	cp -a lib/* $(LIB_TARGET)/
-	@echo "✅ Installed to $(INSTALL_PREFIX)"
+	@echo "Installed to $(INSTALL_PREFIX)"
 
-##### ─────────────────────────────────────────────────────────────
+##### ------------------------------------------------------------
 ##### ablestack-qemu-exec-tools: uninstall targets (via uninstall.sh)
-##### ─────────────────────────────────────────────────────────────
+##### ------------------------------------------------------------
 
-# uninstall.sh 위치 (리포지토리 루트 기준)
+# uninstall.sh path, relative to repository root
 UNINSTALL_SCRIPT ?= ./uninstall.sh
 
-# 플래그를 Make 변수로 제어할 수 있게 매핑
-# 예) make uninstall NO_PROMPT=1 PURGE=1 REMOVE_ISO=1
+# Map Make variables to uninstall.sh flags
+# Example: make uninstall NO_PROMPT=1 PURGE=1 REMOVE_ISO=1
 UNINSTALL_FLAGS :=
 ifeq ($(strip $(DRY_RUN)),1)
   UNINSTALL_FLAGS += --dry-run
@@ -94,24 +94,24 @@ endif
 .PHONY: uninstall uninstall-dry-run uninstall-purge uninstall-remove-iso \
         uninstall-keep-bins uninstall-keep-profile uninstall-keep-lib
 
-## 기본 제거(무프롬프트 권장)
+## Default uninstall target
 uninstall:
 	@echo ">> Running $(UNINSTALL_SCRIPT) $(UNINSTALL_FLAGS)"
 	@sudo $(UNINSTALL_SCRIPT) $(UNINSTALL_FLAGS)
 
-## 제거 계획만 출력
+## Print uninstall plan only
 uninstall-dry-run:
 	@$(MAKE) uninstall DRY_RUN=1
 
-## 라이브러리까지 완전 삭제(백업 없음), 무프롬프트
+## Remove everything including libraries, no backup
 uninstall-purge:
 	@$(MAKE) uninstall NO_PROMPT=1 PURGE=1
 
-## ISO 파일까지 삭제(무프롬프트)
+## Remove ISO files as well
 uninstall-remove-iso:
 	@$(MAKE) uninstall NO_PROMPT=1 REMOVE_ISO=1
 
-## 선택 유지 옵션들(상황별 조합 가능)
+## Keep selected components
 uninstall-keep-bins:
 	@$(MAKE) uninstall KEEP_BINS=1
 
@@ -123,7 +123,7 @@ uninstall-keep-lib:
 
 
 rpm:
-	@echo "📦 Building RPM..."
+	@echo "Building RPM..."
 	mkdir -p rpmbuild/{BUILD,RPMS,SOURCES,SPECS,SRPMS}
 	@TMP_TGZ="$$(mktemp /tmp/ablestack-qemu-exec-tools-$(VERSION).tar.gz.XXXXXX)"; \
 	tar czf "$$TMP_TGZ" \
@@ -138,7 +138,7 @@ rpm:
 		. ; \
 	mv -f "$$TMP_TGZ" "rpmbuild/SOURCES/ablestack-qemu-exec-tools-$(VERSION).tar.gz"
 
-	# spec 파일 복사 (rpm 디렉토리에서 가져오기)
+	# Copy spec file from rpm directory
 	cp rpm/$(NAME).spec rpmbuild/SPECS/
 
 	rpmbuild --noplugins -ba --define "_topdir $(shell pwd)/rpmbuild" \
@@ -147,13 +147,13 @@ rpm:
 	         --define "githash $(GIT_HASH)" \
 	         rpmbuild/SPECS/$(NAME).spec
 
-	# 산출물 정리
+	# Collect build artifacts
 	mkdir -p build/rpm
 	cp rpmbuild/RPMS/noarch/*.rpm build/rpm/
-	@echo "✅ RPM package created: build/rpm/"
+	@echo "RPM package created: build/rpm/"
 
 hangctl-rpm:
-	@echo "📦 Building HANGCTL RPM (isolated)..."
+	@echo "Building HANGCTL RPM (isolated)..."
 	@test -f "$(HANGCTL_SPEC)" || (echo "[ERR] Missing spec: $(HANGCTL_SPEC)" >&2; exit 2)
 
 	@mkdir -p rpmbuild_hangctl/{BUILD,RPMS,SOURCES,SPECS,SRPMS}
@@ -183,10 +183,10 @@ hangctl-rpm:
 	mkdir -p build/rpm-hangctl
 	cp rpmbuild_hangctl/RPMS/noarch/*.rpm build/rpm-hangctl/ 2>/dev/null || true
 	cp rpmbuild_hangctl/RPMS/*/*.rpm build/rpm-hangctl/ 2>/dev/null || true
-	@echo "✅ HANGCTL RPM package created: build/rpm-hangctl/"
+	@echo "HANGCTL RPM package created: build/rpm-hangctl/"
 
 v2k-rpm:
-	@echo "📦 Building V2K RPM (isolated)..."
+	@echo "Building V2K RPM (isolated)..."
 	@test -f "$(V2K_SPEC)" || (echo "[ERR] Missing spec: $(V2K_SPEC)" >&2; exit 2)
 	@test -f "$(COMPLETIONS_FILE)" || (echo "[ERR] Missing completion file: $(COMPLETIONS_FILE)" >&2; exit 2)
 
@@ -225,7 +225,7 @@ v2k-rpm:
 	cp rpmbuild_v2k/RPMS/noarch/*.rpm build/rpm-v2k/ 2>/dev/null || true
 	cp rpmbuild_v2k/RPMS/*/*.rpm build/rpm-v2k/ 2>/dev/null || true
 
-	@echo "🔎 Verifying completion file is included in ablestack_v2k RPM..."
+	@echo "Verifying completion file is included in ablestack_v2k RPM..."
 	@RPM_FILE="$$(ls -1 build/rpm-v2k/$(V2K_NAME)-*.rpm 2>/dev/null | head -n 1)"; \
 	if [ -z "$$RPM_FILE" ]; then \
 	  echo "[ERR] Built RPM not found under build/rpm-v2k" >&2; exit 2; \
@@ -233,10 +233,10 @@ v2k-rpm:
 	rpm -qlp "$$RPM_FILE" | grep -qE "bash-completion/completions/$(V2K_NAME)$$" || \
 	  (echo "[ERR] completion file missing in RPM: $$RPM_FILE" >&2; exit 2)
 
-	@echo "✅ V2K RPM package created: build/rpm-v2k/"
+	@echo "V2K RPM package created: build/rpm-v2k/"
 
 deb:
-	@echo "📦 Building DEB..."
+	@echo "Building DEB..."
 	rm -rf $(DEB_BUILD_DIR)
 	mkdir -p $(DEB_DEBIAN_DIR) $(DEB_BIN_DIR) $(DEB_LIB_DIR) $(DEB_DOC_DIR)
 
@@ -249,18 +249,18 @@ deb:
 	# lib
 	cp -a lib/* $(DEB_LIB_DIR)/ 2>/dev/null || :
 
-	# docs & examples
+	# docs and examples
 	cp -a README.md $(DEB_DOC_DIR)/
 	@if [ -d docs ]; then cp -a docs/* $(DEB_DOC_DIR)/; fi
 	@if [ -f usage_agent_policy_fix.md ]; then cp -a usage_agent_policy_fix.md $(DEB_DOC_DIR)/; fi
 	@if [ -d examples ]; then cp -a examples/* $(DEB_DOC_DIR)/; fi
 
-	# control 파일 치환 (템플릿 -> 실제 버전 적용)
+	# Replace template values in control file
 	sed -e "s/\$${VERSION}/$(VERSION)/" \
 		-e "s/\$${RELEASE}/$(RELEASE)/" \
 		deb/control > $(DEB_DEBIAN_DIR)/control
 
-	# postinst 파일 추가
+	# Add postinst if present
 	@if [ -f deb/postinst ]; then \
 		cp deb/postinst $(DEB_DEBIAN_DIR)/postinst; \
 		chmod 755 $(DEB_DEBIAN_DIR)/postinst; \
@@ -271,15 +271,15 @@ deb:
 	dpkg-deb --build $(DEB_BUILD_DIR)
 	mkdir -p build/deb
 	mv $(DEB_BUILD_DIR).deb build/deb/$(DEB_PKG).deb
-	@echo "✅ DEB package created: build/deb/$(DEB_PKG).deb"
+	@echo "DEB package created: build/deb/$(DEB_PKG).deb"
 
 windows:
-	@echo "📦 Building Windows MSI..."
+	@echo "Building Windows MSI..."
 	powershell -ExecutionPolicy Bypass -File windows/msi/build-msi.ps1 \
 		-Version $(VERSION) -Release $(RELEASE) -GitHash $(GIT_HASH)
 	mkdir -p build/msi
 	cp windows/msi/out/* build/msi/ || echo "[WARN] No MSI files copied"
-	@echo "✅ Windows MSI built under build/msi/"
+	@echo "Windows MSI built under build/msi/"
 
 
 clean:
diff --git a/README.md b/README.md
index 80e4554..202ed04 100644
--- a/README.md
+++ b/README.md
@@ -1,22 +1,22 @@
 # ablestack-qemu-exec-tools
 
-**QEMU / libvirt 기반 가상머신에 대해 `qemu-guest-agent` 및 libguestfs 기반 제어를 활용하여, 원격 명령 실행·정책 자동화·자동 설치를 지원하는 통합 도구 세트입니다.**
+**QEMU / libvirt 기반 가상머신에 대해 `qemu-guest-agent` 와 libguestfs 기반 도구를 활용하여, 비대화형 명령 실행·에이전트 자동화·자동 설치 지원하는 통합 관리 툴입니다.**
 
 ---
 
-## 📌 주요 기능
+## 🚀 주요 기능
 
 - **VM 내부 명령 실행** (Linux / Windows)
-  - `virsh qemu-agent-command` 기반 비침입 원격 제어
+  - `virsh qemu-agent-command` 기반 비침투적 도구
   - JSON, CSV, TABLE, HEADERS 기반 출력 파싱
-  - 스크립트 실행(`--file`) 및 병렬 실행(`--parallel`) 지원
-- **에이전트 정책 자동화 (`agent_policy_fix.sh`)**
-  - VM 내부에서 qemu-guest-agent 서비스 정책 자동화, 활성화, 자동설치
-- **클라우드 초기화 자동화 (`cloud_init_auto.sh`)**
-  - VM 생성 시 cloud-init 자동 구성 보조
-- **자동 설치 기능 (`vm_autoinstall.sh`)** 🆕  
-  > 호스트에서 실행 중인 가상머신에 ISO를 자동 연결하고, OS에 맞는 설치 스크립트를 무인으로 실행  
-  > (vCenter의 “에이전트 자동 설치” 기능과 유사한 원클릭 설치)
+  - 스크립트 실행(`--file`) 과 병렬 실행(`--parallel`) 지원
+- **에이전트 정책 자동화(`agent_policy_fix.sh`)**
+  - VM 부팅 시 qemu-guest-agent 서비스 정책 자동화 생성 및 적용
+- **클라우드 초기화 자동화(`cloud_init_auto.sh`)**
+  - VM 생성 시 cloud-init 구동 구성 보조
+- **자동 설치 기능 (`vm_autoinstall.sh`)** ⭐
+  > 호스트에서 실행 중인 가상머신에 ISO를 자동 연결하고, OS에 맞는 설치 스크립트를 무인으로 실행
+  > (vCenter에서 제공하는 자동 설치 기능의 오픈소스 클론 버전)
 
 ---
 
@@ -29,82 +29,88 @@ chmod +x install.sh
 sudo ./install.sh
 ```
 
-### 의존성
-호스트에는 다음 패키지가 설치되어 있어야 합니다.
+### 호스트 시스템에 다음 패키지가 설치되어 있어야 합니다
 
-| 구분 | 필수 | 설명 |
+| 구분 | 패키지 | 설명 |
 |------|------|------|
-| 기본 | `jq`, `virsh` | libvirt 기반 명령 제어 |
-| 오프라인 주입 | `libguestfs-tools`, `virt-install` | virt-copy-in, virt-win-reg 등 필요 |
-| 선택 | `virt-xml` | XML 조작 시 안정성 향상 |
+| 기본 | `jq`, `virsh` | libvirt 기반 명령 도구 |
+| 오프라인 주입 | `libguestfs-tools`, `virt-install` | virt-copy-in, virt-win-reg 필요 |
+| 선택 | `virt-xml` | XML 조작 편의성 향상 |
 
 ---
 
-## 🧩 구성 파일 구조
+## 📁 구성 파일 구조
 
 ```
 bin/
- ├─ vm_exec.sh
- ├─ agent_policy_fix.sh
- ├─ cloud_init_auto.sh
- └─ vm_autoinstall.sh       # 🆕 ISO 자동 설치 스크립트
+ ├── vm_exec.sh
+ ├── agent_policy_fix.sh
+ ├── cloud_init_auto.sh
+ ├── vm_autoinstall.sh       # 자동 ISO 연결 설치 스크립트
 lib/
- ├─ libvirt_helpers.sh      # libvirt 및 guestfs 헬퍼 함수
- ├─ offline_inject_linux.sh # 오프라인 주입 (Linux)
- └─ offline_inject_windows.sh # 오프라인 주입 (Windows)
+ ├── libvirt_helpers.sh      # libvirt 와 guestfs 헬퍼 함수
+ ├── offline_inject_linux.sh # 오프라인 주입 (Linux)
+ ├── offline_inject_windows.sh # 오프라인 주입 (Windows)
 payload/
- ├─ linux/ablestack-install.service   # ISO 루트 install-linux.sh 실행용 systemd unit
- └─ windows/ablestack-runonce.ps1     # ISO 루트 install.bat 자동 실행용 PowerShell
+ ├── linux/ablestack-install.service   # ISO 루트 install-linux.sh 실행용 systemd unit
+ ├── windows/ablestack-runonce.ps1     # ISO 루트 install.bat 자동 실행용 PowerShell
 ```
 
 ---
 
-## 🚀 주요 사용법
+## 📖 주요 사용법
 
 ### 1. VM 명령 실행 (vm_exec)
+
 ```bash
 vm_exec -l|-w <vm-name> "<command>"
 ```
+
 - `-l` 또는 `--linux` : Linux VM
 - `-w` 또는 `--windows` : Windows VM
-- `--headers`, `--json`, `--table`, `--csv` 등 파싱 옵션 제공  
-- `--file <script>` : 외부 스크립트 실행  
+- `--headers`, `--json`, `--table`, `--csv` 파싱 옵션 제공
+- `--file <script>` : 외부 스크립트 실행
 - `--parallel` : 병렬 실행
 
 ---
 
-### 2. 에이전트 정책 자동화 (agent_policy_fix)
+### 2. 에이전트 정책 자동화(agent_policy_fix)
+
 ```bash
 sudo agent_policy_fix
 ```
-- RHEL/Rocky 계열: 서비스 활성화 및 정책 자동화  
-- Ubuntu/Debian: qemu-guest-agent 자동 설치 및 활성화  
+
+- RHEL/Rocky 계열: 서비스 정책 생성 및 적용
+- Ubuntu/Debian: qemu-guest-agent 자동 설치 및 설정
 
 ---
 
-### 3. 가상머신 자동 설치 (vm_autoinstall) 🆕
+### 3. 가상머신 자동 설치 (vm_autoinstall) ⭐
 
 ```bash
 sudo vm_autoinstall <vm-name> [--force-offline] [--no-reboot]
 ```
 
-#### 🔧 동작 개요
-| 상황 | 동작 |
+#### 🔄 작업 개요
+
+| 상황 | 작업 |
 |------|------|
-| QGA(게스트 에이전트) 있음 | 무중단 온라인 설치 (게스트 내부 명령 직접 실행) |
-| QGA 없음 | VM 종료 → 디스크 이미지에 1회 실행 훅 주입 → 부팅 시 자동 설치 |
-| Transient VM | 자동으로 XML 덤프 후 virsh create 재기동 |
-| Persistent VM | virsh start 로 재기동 |
-| 설치 후 | ISO 자동 분리 (detach_iso_safely 함수 활용) |
-
-#### 🧱 전제조건
-- 호스트에 ISO 존재:  
+| QGA(게스트 에이전트) 정상 | 무중단 온라인 설치 (게스트 내부 명령 직접 실행) |
+| QGA 비정상 | VM 종료 후 스냅샷 찍기 + 오프라인 주입 + 부팅 자동 설치 |
+| Transient VM | 임시로 XML 스냅샷 virsh create 시키기 |
+| Persistent VM | virsh start 시키기 |
+| 설치 완료 | ISO 연결 분리 (detach_iso_safely 함수 사용) |
+
+#### ⚠️ 사전조건
+
+- 호스트에 ISO 존재:
   `/usr/share/ablestack/tools/ablestack-qemu-exec-tools.iso`
-- ISO 루트에 스크립트 존재:  
-  - Windows → `install.bat`  
-  - Linux → `install-linux.sh`
+- ISO 루트에 스크립트 존재:
+  - Windows 용 `install.bat`
+  - Linux 용 `install-linux.sh`
 
 #### 💡 예시
+
 ```bash
 sudo vm_autoinstall win11-test
 sudo vm_autoinstall rhel9-guest --force-offline
@@ -112,21 +118,22 @@ sudo vm_autoinstall rhel9-guest --force-offline
 
 ---
 
-## 📦 ISO 제작 및 라벨 규칙
+## 📦 ISO 작업 및 레벨 규칙
 
 GitHub Actions(`build.yml`)에서 자동 생성:
+
 ```bash
 mkisofs -o ablestack-qemu-exec-tools-${VERSION}.iso   -V "ABLESTACK"   -r -J release
 ```
 
-> ISO 루트에는 `install.bat`, `install-linux.sh` 두 파일이 반드시 존재해야 하며,  
-> Windows는 `install.bat`, Linux는 `install-linux.sh`를 실행하여 도구를 설치합니다.
+> ISO 루트에는 `install.bat`, `install-linux.sh` 파일이 반드시 존재해야 하며,  
+> Windows는 `install.bat`, Linux는 `install-linux.sh`를 실행하여 구동 시 설치합니다.
 
 ---
 
-## 🧰 설치 후 구성 정보
+## 📁 설치 구성 정보
 
-| 항목 | 경로 |
+| 구성 | 경로 |
 |------|------|
 | 실행 파일 | `/usr/local/bin/` |
 | 라이브러리 | `/usr/local/lib/ablestack-qemu-exec-tools/` |
@@ -136,40 +143,40 @@ mkisofs -o ablestack-qemu-exec-tools-${VERSION}.iso   -V "ABLESTACK"   -r -J rel
 
 ---
 
-## 🧠 작동 원리 요약
+## 🔧 동작 로직 요약
 
-1. **QGA 감지**  
+1. **QGA 감지**
    - `virsh qemu-agent-command <domain> '{"execute":"guest-ping"}'`
-2. **온라인 모드**  
+2. **온라인 모드**
    - 게스트 내부에서 ISO 마운트 후 `/install-linux.sh` 또는 `install.bat` 실행
-3. **오프라인 모드**  
-   - `virt-copy-in`, `virt-customize`, `virt-win-reg` 로 1회 실행 훅 주입  
-   - 부팅 시 ISO 자동 마운트 → 루트 설치 스크립트 실행  
+3. **오프라인 모드**
+   - `virt-copy-in`, `virt-customize`, `virt-win-reg` 명령으로 주입
+   - 부팅 시 ISO 자동 마운트 후 루트 설치 스크립트 실행
    - `ablestack-install.service` / `ablestack-runonce.ps1` 사용
-4. **CD-ROM 관리**  
-   - XML 조작(`inject_cdrom_into_xml`)로 안전하게 ISO 연결  
-   - 설치 완료 후 `detach_iso_safely`로 ISO 제거
+4. **CD-ROM 관리**
+   - XML 조작(`inject_cdrom_into_xml`)으로 안전하게 ISO 연결
+   - 설치 완료 시 `detach_iso_safely`로 ISO 제거
 
 ---
 
-## 💬 트러블슈팅
+## 🐛 트러블슈팅
 
 | 증상 | 원인 / 해결 |
 |------|--------------|
 | `virt-*` 명령 실패 | 루트 권한 또는 `LIBGUESTFS_BACKEND=direct` 환경 필요 |
-| ISO 자동 분리 실패 | `virt-xml` 미설치 시 수동 `virsh detach-disk` 수행 가능 |
-| QGA 응답 없음 | 오프라인 주입 모드 자동 전환 |
-| Transient VM 사라짐 | XML 자동 덤프 후 `virsh create`로 복원 |
+| ISO 연결 분리 실패 | `virt-xml` 미설치 시 수동 `virsh detach-disk` 실행 가능 |
+| QGA 응답 없음 | 오프라인 주입 모드로 자동 전환 |
+| Transient VM 온라인 | XML 임시 스냅샷 `virsh create`로 복원 |
 
 ---
 
 ## 📄 라이선스
 
-Apache License 2.0  
+Apache License 2.0
 Copyright (c) 2025 ABLECLOUD
 
 ---
 
-## 📨 문의
+## 📞 문의
 
 - GitHub Issues 또는 ABLECLOUD 공식 채널
diff --git a/RELEASE_WORKFLOW.md b/RELEASE_WORKFLOW.md
index 1afc92d..9c803a4 100644
--- a/RELEASE_WORKFLOW.md
+++ b/RELEASE_WORKFLOW.md
@@ -1,68 +1,69 @@
 # Release Workflow Guide
 
-이 문서는 ablestack-qemu-exec-tools 프로젝트의 릴리즈 브랜치 전략과 배포 절차를 설명합니다.
+이 문서는 ablestack-qemu-exec-tools 프로젝트의 릴리즈 브랜치 전략과 배포 과정을 설명합니다.
 
 ---
 
-## 📌 브랜치 전략
+## 📋 브랜치 전략
 
 - **main**
-  - 항상 안정화된 코드만 포함
-  - GitHub Actions `ci.yml` 실행 대상으로 사용
-  - 태그(`vX.Y.Z`) 기준으로 정식 릴리즈 생성
+  - 최종 검증된 코드만 포함
+  - GitHub Actions `ci.yml` 실행 결과에 따라 사용
+  - 태그(`vX.Y.Z`) 기반으로 공식 릴리즈 생성
 
 - **develop**
-  - 새로운 기능 및 버그 수정이 통합되는 브랜치
-  - 모든 기능 브랜치(`feature/*`)는 PR을 통해 `develop`으로 머지
+  - 새로운 기능 및 버그 수정들을 통합하는 브랜치
+  - 모든 기능 브랜치(`feature/*`)들은 PR을 통해 `develop`으로 머지
 
 - **release/* (예: release/0.3.0)**
   - 새로운 릴리즈 준비용 브랜치
-  - `VERSION` 파일 수정, 문서 갱신(README, INSTALL.md, RELEASE_WORKFLOW.md 등)
-  - 최종 검증 후 `main`으로 병합 → 태그 생성
+  - `VERSION` 파일 설정, 문서 갱신(README, INSTALL.md, RELEASE_WORKFLOW.md 등)
+  - 최종 검증 후 `main`으로 병합 및 태그 생성
 
 - **feature/* (예: feature/add-windows-headers)**
-  - 단위 기능 개발 브랜치
-  - 완료 시 `develop`에 머지
+  - 개별 기능 개발 브랜치
+  - 완료 시 `develop`으로 머지
 
 - **hotfix/* (예: hotfix/fix-msi-path)**
-  - 운영 중 긴급 패치 브랜치
-  - `main`에서 분기 → 수정 후 `main`과 `develop`에 모두 병합
-  - `VERSION`의 RELEASE 값 증가 (`0.3.0-2` → `0.3.0-3`)
+  - 운영 중 긴급 수정 브랜치
+  - `main`에서 분기하여 수정 후 `main`과 `develop`으로 모두 병합
+  - `VERSION`에 RELEASE 증분 (`0.3.0-2` → `0.3.0-3`)
 
 ---
 
-## 📌 릴리즈 절차
+## 🚀 릴리즈 과정
 
 1. **기능 개발**
    - `feature/*` 브랜치에서 개발
-   - 완료 후 `develop`에 머지
+   - 완료 시 `develop`으로 머지
 
 2. **릴리즈 준비**
    - `develop`에서 `release/0.3.0` 브랜치 생성
-   - `VERSION` 파일 수정 (`VERSION=0.3.0`, `RELEASE=1`)
+   - `VERSION` 파일 설정 (`VERSION=0.3.0`, `RELEASE=1`)
    - 문서 갱신 (README.md, INSTALL.md, RELEASE_WORKFLOW.md)
    - 테스트 진행
 
-3. **정식 릴리즈**
-   - `release/0.3.0` → `main` 병합
+3. **공식 릴리즈**
+   - `release/0.3.0` 을 `main` 병합
    - 태그 생성 및 푸시:
+
      ```bash
      git tag v0.3.0
      git push origin v0.3.0
      ```
-   - GitHub Actions `build.yml` 실행 → `.rpm`, `.deb`, `.msi` 자동 생성 및 Release 업로드
 
+   - GitHub Actions `build.yml` 실행으로 `.rpm`, `.deb`, `.msi` 자동 생성 및 Release 업로드
 4. **개발 브랜치 갱신**
-   - `release/0.3.0` → `develop`에도 병합하여 변경사항 반영
+   - `release/0.3.0` ??`develop`?�도 병합?�여 변경사??반영
 
 ---
 
-## 📌 요약
+## ?�� ?�약
 
-- `main`: 안정/배포용  
-- `develop`: 통합 개발용  
-- `release/*`: 릴리즈 준비 및 검증  
+- `main`: ?�정/배포??
+- `develop`: ?�합 개발??
+- `release/*`: 릴리�?준�?�?검�?
 - `feature/*`: 기능 개발  
-- `hotfix/*`: 긴급 패치  
+- `hotfix/*`: 긴급 ?�치  
 
-릴리즈는 태그(`vX.Y.Z`)를 기준으로 GitHub Actions에 의해 자동 배포됩니다.
+릴리즈는 ?�그(`vX.Y.Z`)�?기�??�로 GitHub Actions???�해 ?�동 배포?�니??
diff --git a/VERSION b/VERSION
index 483e3d9..12d289d 100644
--- a/VERSION
+++ b/VERSION
@@ -1,3 +1,3 @@
 # VERSION file
-VERSION=0.7.0
+VERSION=0.7.2
 RELEASE=1
diff --git a/assets/VMware-vix-disklib-9.0.1.0.24964809.x86_64.tar.gz b/assets/VMware-vix-disklib-9.0.1.0.24964809.x86_64.tar.gz
index aa03400..70ce181 100644
Binary files a/assets/VMware-vix-disklib-9.0.1.0.24964809.x86_64.tar.gz and b/assets/VMware-vix-disklib-9.0.1.0.24964809.x86_64.tar.gz differ
diff --git a/assets/govc_Linux_x86_64.tar.gz b/assets/govc_Linux_x86_64.tar.gz
index 0ecea2d..9a19ca6 100644
Binary files a/assets/govc_Linux_x86_64.tar.gz and b/assets/govc_Linux_x86_64.tar.gz differ
diff --git a/bin/ablestack_vm_hangctl.sh b/bin/ablestack_vm_hangctl.sh
index 471f84f..4533ee3 100644
--- a/bin/ablestack_vm_hangctl.sh
+++ b/bin/ablestack_vm_hangctl.sh
@@ -148,24 +148,24 @@ hangctl_detect_probe_maybe_act_one_vm() {
   local vm="${1-}"
   local do_action="${2-0}"
 
-  # --- [단계 1] 생존 신호(QMP) 및 상태 기본 확인 ---
+  # --- [단계 1] VM 상태 수집 및 초기 분석 ---
   local qmp_status qmp_rc qmp_result
   qmp_status=""; qmp_rc=0
   
-  # QMP 프로브 실행
+  # QMP 프로토콜 실행
   hangctl_probe_qmp_query_status "${vm}" qmp_status qmp_rc || true
   qmp_result="$(hangctl__result_from_rc "${qmp_rc}")"
 
-  # QMP 상태값 소문자 정규화
+  # QMP 상태의 문법 규칙
   local qmp_status_lc
   qmp_status_lc="$(echo "${qmp_status}" | tr '[:upper:]' '[:lower:]' | xargs)"
 
-  # 블록 I/O 통계 수집 및 Stall 여부 확인
+  # 블록 I/O 계측 집계 Stall 감지
   local curr_rd=0 curr_wr=0
   hangctl_probe_blockstats "${vm}" curr_rd curr_wr || true
   
   local io_stall=1
-  # 0이면 Stall 의심, 1이면 정상 (이전 스캔 데이터와 비교)
+  # 0이면 Stall 의심, 1이면 정상 (이전 스캔 시점과 비교)
   hangctl_detect_block_stall "${vm}" "${curr_rd}" "${curr_wr}" || io_stall=$?
 
   # virsh를 통한 도메인 상태 확인
@@ -179,12 +179,12 @@ hangctl_detect_probe_maybe_act_one_vm() {
   local domstate="${domstate_full%% *}" 
   [[ -z "${domstate}" ]] && domstate="unknown"
 
-  # --- [단계 2] 시간 초기화 또는 누적 결정 (I/O Stall 반영) ---
+  # --- [단계 2] 시간 초기화에 따른 적적 결정 (I/O Stall 반영) ---
   if [[ "${qmp_rc}" == "0" && -n "${qmp_status_lc}" && "${qmp_status_lc}" != "unknown" && "${io_stall}" == "1" ]]; then
       hangctl_state_touch_heartbeat "${vm}"
       hangctl_log_event "detect" "vm.heartbeat" "ok" "${vm}" "" "" "reason=healthy status=${qmp_status_lc}"
   else
-      # QMP 응답 실패, unknown 상태, 혹은 I/O가 멈춘 경우 (최초 실패 시점 기록 로직 포함)
+      # QMP 응답 실패 또는 Stall 감지 시 기존 heartbeat 타임스탬프 확인
       local existing_ts
       existing_ts="$(hangctl_state__read_kv "$(hangctl_state__path "${vm}")" "last_change_ts" || true)"
       
@@ -199,38 +199,38 @@ hangctl_detect_probe_maybe_act_one_vm() {
       fi
   fi
 
-  # 마지막 heartbeat(또는 QMP/IO 실패 시작점)로부터 경과 시간 계산
+  # 마지막 heartbeat(또는 QMP/IO 실패 시작)로부터 경과 시간 계산
   local duration_sec
   duration_sec="$(hangctl_state_get_duration_sec "${vm}")"
   local stuck_sec="${duration_sec}"
 
-  # --- [단계 3] 마이그레이션/백업 작업 확인 및 임계값 결정 ---
+  # --- [단계 3] 마이그레이션/백업 작업 인식 및 계측 결정 ---
   local is_migration=0
   [[ "${domstate_full}" == *"migration"* ]] && is_migration=1
   
-  # libvirt가 자체적으로 감지한 디스크 에러 확인
+  # libvirt가 자체적으로 감지한 에러 상태 확인
   local is_disk_error=0
   [[ "${domstate_full}" == *"disk error"* ]] && is_disk_error=1
 
-  # [신규] 백업/스냅샷 작업 여부 확인 (domjobinfo 활용)
+  # [규칙] 백업/스냅샷 작업 여부 확인 (domjobinfo 이용)
   local job_out job_type
   job_out=$(virsh -c qemu:///system domjobinfo "${vm}" 2>/dev/null || true)
   job_type=$(echo "${job_out}" | grep "Job type:" | awk '{print $3}' || echo "None")
   
   local is_backup=0
-  # Job type이 None이 아니거나 Completed가 아니면 작업 중으로 간주
+  # Job type이 None이거나 Completed가 아니면 작업 중으로 간주
   [[ "${job_type}" != "None" && "${job_type}" != "Completed" && -n "${job_type}" ]] && is_backup=1
 
   local current_window="${HANGCTL_CONFIRM_WINDOW_SEC}"
   if [[ "${is_migration}" -eq 1 || "${is_backup}" -eq 1 ]]; then
-    # 마이그레이션 또는 백업 중인 경우 전용 임계값(예: 1800초) 적용하여 보호
+    # 마이그레이션 또는 백업 중인 경우 용인 계측을 1800초로 용인하여 보호
     current_window="${HANGCTL_MIGRATION_CONFIRM_WINDOW_SEC}"
   elif [[ "${domstate}" == "paused" || "${is_disk_error}" -eq 1 ]]; then
-    # 일반 paused 상태나 디스크 에러가 명시된 경우 별도 임계값 적용
+    # 일반 paused 상태에서 에러가 명시된 경우 별도 계측 적용
     current_window="${HANGCTL_PAUSED_CONFIRM_WINDOW_SEC}"
   fi
 
-  # --- [단계 4] 의심 상태(suspect) 1차 판정 ---
+  # --- [단계 4] 의심 상태(suspect) 1차 결정 ---
   local decision="normal"
   if [[ "${duration_sec}" -ge "${current_window}" ]]; then
     decision="suspect"
@@ -244,7 +244,7 @@ hangctl_detect_probe_maybe_act_one_vm() {
     return 0
   fi
 
-  # --- [단계 5] 정밀 검증 (마이그레이션 좀비 체크) ---
+  # --- [단계 5] 추가 검증(마이그레이션 좀비체크) ---
   if [[ "${is_migration}" -eq 1 ]]; then
     if ! hangctl_probe_migration_zombie_check "${vm}"; then
       hangctl_log_event "detect" "vm.migration_check" "ok" "${vm}" "" "" \
@@ -253,7 +253,7 @@ hangctl_detect_probe_maybe_act_one_vm() {
     fi
   fi
 
-  # --- [단계 6] 최종 확정 로직 ---
+  # --- [단계 6] 최종 결정 로직 ---
   local final_decision="suspect"
   local confirm_reason="domstate_stuck"
 
@@ -261,7 +261,7 @@ hangctl_detect_probe_maybe_act_one_vm() {
     final_decision="confirmed"
     confirm_reason="migration_zombie_no_progress"
   elif [[ "${is_backup}" -eq 1 ]]; then
-    # 백업 중 임계값 초과 시 확정 (이미 긴 시간을 대기했으므로 장애로 판단)
+    # 백업 시 계측 초과 시 결정 (이전 시간에 기록했으므로 애초에 단)
     final_decision="confirmed"
     confirm_reason="backup_stuck_over_threshold"
   elif [[ "${is_disk_error}" -eq 1 ]]; then
@@ -290,7 +290,7 @@ hangctl_detect_probe_maybe_act_one_vm() {
   hangctl_log_event "detect" "vm.decision" "ok" "${vm}" "" "" \
     "final=${final_decision} reason=${confirm_reason} domstate=${domstate_full} stuck_sec=${stuck_sec}"
 
-  # --- [단계 7] 액션 실행 ---
+  # 최종 결정이 clear 또는 normal이면 조치 없이 종료
   if [[ "${final_decision}" == "clear" || "${final_decision}" == "normal" ]]; then
     return 0
   fi
@@ -394,7 +394,7 @@ cmd_scan() {
   vm_array=()
 
   rc=0
-  # 1. 스캔 대상 추출 수정 (running과 paused 모두 포함)
+  # HANGCTL_VIRSH_TIMEOUT_SEC 초과 시 rc=124, libvirt 오류 시 rc=1, 성공 시 rc=0
   hangctl_virsh "${HANGCTL_VIRSH_TIMEOUT_SEC}" out err rc -- -c qemu:///system list --state-running --state-paused --name
   result="$(hangctl__result_from_rc "${rc}")"
   if [[ "${result}" != "ok" ]]; then
@@ -448,8 +448,8 @@ cmd_scan() {
   # -------------------------------------------------------------------
   local vm
   for vm in "${vm_array[@]}"; do
-    # 1. 각 VM 처리를 서브쉘 ( ) 내에서 실행하여 변수 간섭 방지
-    # 2. < /dev/null 을 통해 표준 입력 소비 방지
+    # 1. 각 VM 처리의 서브쉘( ) 에서 실행하여 변수 간섭 방지
+    # 2. < /dev/null 을 통해 불필요한 입력 차단 방지
     (
       hangctl_detect_probe_maybe_act_one_vm "${vm}" "1" || {
         hangctl_log_event "scan" "vm.skip" "fail" "${vm}" "" "" "reason=function_failed"
@@ -579,7 +579,7 @@ cmd_health() {
   while [[ $# -gt 0 ]]; do
     case "$1" in
       --config) cfg="${2-}"; shift 2 ;;
-      --dry-run) dry="1"; shift ;; # 의미는 없지만 글로벌 옵션 일관성 유지
+      --dry-run) dry="1"; shift ;; # 무시하지만 글로벌 옵션 처리
       --) shift; break ;;
       -*) echo "ERROR: unknown option for health: $1" >&2; usage >&2; exit "${EXIT_USAGE}" ;;
       *) shift ;;
diff --git a/bin/agent_policy_fix.sh b/bin/agent_policy_fix.sh
index 00ba254..63432c2 100644
--- a/bin/agent_policy_fix.sh
+++ b/bin/agent_policy_fix.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 #
-# agent_policy_fix.sh - 게스트 qemu-guest-agent 정책 자동화 (RHEL/Ubuntu 계열)
+# agent_policy_fix.sh - 게스트 qemu-guest-agent 정책 자동화(RHEL/Ubuntu 계열)
 #
 # Copyright 2025 ABLECLOUD
 #
@@ -21,7 +21,7 @@ source "$LIBDIR/cloud_init_common.sh"
 
 set -e
 
-# 1. 배포판 감지
+# 1. 리눅스 배포판 감지
 if [ -f /etc/os-release ]; then
     . /etc/os-release
     DIST=$ID
@@ -35,11 +35,12 @@ QGA_PKG="qemu-guest-agent"
 QGA_SERVICE="qemu-guest-agent"
 
 check_service_and_start() {
-    # 서비스 활성화 여부 확인 & 필요 시 enable/start
+    # 서비스 활성 상태 확인 및 필요 시 enable/start
     if ! systemctl is-active --quiet "$QGA_SERVICE"; then
-        msg "[WARN] $QGA_SERVICE 서비스가 활성화되어 있지 않습니다. enable 및 start를 시도합니다." "[WARN] $QGA_SERVICE service is not active. Attempting to enable and start."
+        msg "[WARN] $QGA_SERVICE 서비스가 활성 상태가 아닙니다. enable 및 start를 시도합니다." "[WARN] $QGA_SERVICE service is not active. Attempting to enable and start."
         sudo systemctl enable "$QGA_SERVICE"
         sudo systemctl start "$QGA_SERVICE"
+
         # 재확인
         if systemctl is-active --quiet "$QGA_SERVICE"; then
             msg "[SUCCESS] $QGA_SERVICE 서비스가 활성화되었습니다." "[SUCCESS] $QGA_SERVICE service has been activated."
@@ -48,52 +49,52 @@ check_service_and_start() {
             exit 3
         fi
     else
-        msg "[INFO] $QGA_SERVICE 서비스가 이미 활성화(실행) 상태입니다." "[INFO] $QGA_SERVICE service is already active (running)."
+        msg "[INFO] $QGA_SERVICE 서비스는 이미 활성(실행) 상태입니다." "[INFO] $QGA_SERVICE service is already active (running)."
     fi
 }
 
 if [[ "$DIST" =~ ^(rhel|centos|rocky|almalinux|ol)$ ]]; then
-    msg "[INFO] Rocky/RHEL 계열로 감지됨." "[INFO] Detected Rocky/RHEL family."
+    msg "[INFO] Rocky/RHEL 계열이 감지되었습니다." "[INFO] Detected Rocky/RHEL family."
 
     # 2-1. qemu-guest-agent 설치 확인 및 자동 설치 (RHEL 계열)
-    if ! rpm -q $QGA_PKG >/dev/null 2>&1; then
+    if ! rpm -q "$QGA_PKG" >/dev/null 2>&1; then
         msg "[WARN] $QGA_PKG가 설치되어 있지 않습니다. 자동 설치를 진행합니다." "[WARN] $QGA_PKG is not installed. Proceeding with automatic installation."
-        sudo dnf install -y $QGA_PKG
+        sudo dnf install -y "$QGA_PKG"
         if [ $? -ne 0 ]; then
             msg "[ERROR] $QGA_PKG 설치에 실패했습니다. 네트워크 또는 yum/dnf 설정을 확인하세요." "[ERROR] Failed to install $QGA_PKG. Please check your network or yum/dnf configuration."
             exit 2
         fi
-        msg "[SUCCESS] $QGA_PKG 패키지 설치 완료." "[SUCCESS] $QGA_PKG package installation completed."
+        msg "[SUCCESS] $QGA_PKG 패키지 설치가 완료되었습니다." "[SUCCESS] $QGA_PKG package installation completed."
     else
         msg "[INFO] $QGA_PKG가 이미 설치되어 있습니다." "[INFO] $QGA_PKG is already installed."
     fi
 
-    # 서비스 시작/활성화 확인 및 자동처리
+    # 서비스 시작/활성 상태 확인 및 자동 처리
     check_service_and_start
 elif [[ "$DIST" =~ ^(ubuntu|debian)$ ]]; then
-    msg "[INFO] Ubuntu/Debian 계열로 감지됨." "[INFO] Detected Ubuntu/Debian family."
+    msg "[INFO] Ubuntu/Debian 계열이 감지되었습니다." "[INFO] Detected Ubuntu/Debian family."
 
     # 2-2. qemu-guest-agent 설치 확인 및 자동 설치 (Ubuntu 계열)
-    if ! dpkg -l | grep -qw $QGA_PKG; then
+    if ! dpkg -l | grep -qw "$QGA_PKG"; then
         msg "[WARN] $QGA_PKG가 설치되어 있지 않습니다. 자동 설치를 진행합니다." "[WARN] $QGA_PKG is not installed. Proceeding with automatic installation."
         sudo apt-get update
-        sudo apt-get install -y $QGA_PKG
+        sudo apt-get install -y "$QGA_PKG"
         if [ $? -ne 0 ]; then
             msg "[ERROR] $QGA_PKG 설치에 실패했습니다. 네트워크 또는 apt 설정을 확인하세요." "[ERROR] Failed to install $QGA_PKG. Please check your network or apt configuration."
             exit 2
         fi
-        msg "[SUCCESS] $QGA_PKG 패키지 설치 완료." "[SUCCESS] $QGA_PKG package installation completed."
+        msg "[SUCCESS] $QGA_PKG 패키지 설치가 완료되었습니다." "[SUCCESS] $QGA_PKG package installation completed."
     else
         msg "[INFO] $QGA_PKG가 이미 설치되어 있습니다." "[INFO] $QGA_PKG is already installed."
     fi
 
-    # 서비스 시작/활성화 확인 및 자동처리
+    # 서비스 시작/활성 상태 확인 및 자동 처리
     check_service_and_start
 
     # Ubuntu 정책 자동화 안내
     msg "[NOTICE] Ubuntu 계열은 qemu-guest-agent의 모든 RPC 명령이 기본적으로 허용되어 있습니다." \
         "[NOTICE] In Ubuntu family, all RPC commands of qemu-guest-agent are allowed by default."
-    msg "         별도의 정책 설정이나 추가 자동화 작업은 필요하지 않습니다." \
+    msg "         별도의 정책 설정이나 추가 자동화 작업이 필요하지 않습니다." \
         "         No additional policy settings or automation tasks are required."
     exit 0
 else
@@ -102,10 +103,10 @@ else
     exit 0
 fi
 
-# 3. 환경파일 위치 확인
+# 3. 설정 파일 존재 확인
 CONF_FILE="/etc/sysconfig/qemu-ga"
 if [ ! -f "$CONF_FILE" ]; then
-    msg "[ERROR] 설정파일 $CONF_FILE 가 존재하지 않습니다." "[ERROR] Configuration file $CONF_FILE does not exist."
+    msg "[ERROR] 설정 파일 $CONF_FILE 가 존재하지 않습니다." "[ERROR] Configuration file $CONF_FILE does not exist."
     exit 3
 fi
 
@@ -121,11 +122,11 @@ BLOCK_CMDS_RAW=$(grep -E '^#.*--block-rpcs=' "$CONF_FILE" | \
     grep -v '^\s*$' | \
     grep -v '^?$')
 
-# allow-rpcs, block-rpcs 항목을 쉼표로 분리해서 배열화
+# allow-rpcs, block-rpcs 값을 콤마로 분리해서 배열화
 IFS=',' read -ra ALLOW_ARR <<< "$ALLOW_CMDS_RAW"
 IFS=',' read -ra BLOCK_ARR <<< "$BLOCK_CMDS_RAW"
 
-# 중복 없이 allow-rpcs 배열에 block-rpcs 항목 전체를 병합
+# 중복 없이 allow-rpcs 배열에 block-rpcs 값을 전체 병합
 for cmd in "${BLOCK_ARR[@]}"; do
     skip=0
     for allow in "${ALLOW_ARR[@]}"; do
@@ -134,7 +135,7 @@ for cmd in "${BLOCK_ARR[@]}"; do
     [[ $skip -eq 0 && -n "$cmd" ]] && ALLOW_ARR+=("$cmd")
 done
 
-# 배열 → 쉼표구분 문자열로 재조합
+# 배열을 콤마 구분 문자열로 재조합
 ALLOW_CMDS_FINAL=$(IFS=','; echo "${ALLOW_ARR[*]}" | sed 's/,,*/,/g;s/^,//;s/,$//')
 
 NEW_LINE="FILTER_RPC_ARGS=\"--allow-rpcs=$ALLOW_CMDS_FINAL\""
@@ -143,17 +144,17 @@ NEW_LINE="FILTER_RPC_ARGS=\"--allow-rpcs=$ALLOW_CMDS_FINAL\""
 sudo cp "$CONF_FILE" "${CONF_FILE}.bak.$(date +%Y%m%d%H%M%S)"
 sudo sed -i 's|^FILTER_RPC_ARGS=.*|'"$NEW_LINE"'|' "$CONF_FILE"
 
-msg "[INFO] $CONF_FILE의 FILTER_RPC_ARGS를 다음과 같이 수정했습니다:" "[INFO] Modified FILTER_RPC_ARGS in $CONF_FILE as follows:"
+msg "[INFO] $CONF_FILE 의 FILTER_RPC_ARGS를 다음과 같이 수정했습니다:" "[INFO] Modified FILTER_RPC_ARGS in $CONF_FILE as follows:"
 msg "      $NEW_LINE" "      $NEW_LINE"
 
 # 6. qemu-guest-agent 서비스 재시작
 msg "[INFO] qemu-guest-agent 서비스를 재시작합니다." "[INFO] Restarting qemu-guest-agent service."
-sudo systemctl restart $QGA_SERVICE
+sudo systemctl restart "$QGA_SERVICE"
 
 # 7. 서비스 상태 확인
-if systemctl is-active --quiet $QGA_SERVICE; then
+if systemctl is-active --quiet "$QGA_SERVICE"; then
     msg "[SUCCESS] qemu-guest-agent 서비스가 정상적으로 재시작되었습니다." "[SUCCESS] qemu-guest-agent service has been restarted successfully."
 else
-    msg "[ERROR] qemu-guest-agent 서비스가 비정상입니다. 로그 확인 요망." "[ERROR] qemu-guest-agent service is not active. Please check the logs."
+    msg "[ERROR] qemu-guest-agent 서비스가 비활성 상태입니다. 로그를 확인하세요." "[ERROR] qemu-guest-agent service is not active. Please check the logs."
     exit 4
-fi
\ No newline at end of file
+fi
diff --git a/bin/cloud_init_auto.sh b/bin/cloud_init_auto.sh
index ebf99b3..473364a 100644
--- a/bin/cloud_init_auto.sh
+++ b/bin/cloud_init_auto.sh
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/bin/bash
 #
 # ablestack-qemu-exec-tools cloud_init_auto.sh
 #
@@ -20,7 +20,7 @@ LIBDIR="/usr/libexec/ablestack-qemu-exec-tools"
 source "$LIBDIR/cloud_init_common.sh"
 
 # ----------------------------------------------------------------------
-# cloud-init이 네트워크(IP 할당) 이후에 실행되도록 Unit override 생성
+# cloud-init가 네트워크(IP 할당) 이후 실행되도록 Unit override 생성
 #   - /etc/systemd/system/cloud-init.service.d/ablestack-network-online.conf
 #     를 만들어서,
 #
@@ -40,11 +40,11 @@ ensure_cloud_init_after_network_online() {
 # so that metadata from virtual router (not ConfigDrive) is available.
 
 [Unit]
-# 기존 cloud-init.service의 Before=network-online.target 설정을 제거
+# 기존 cloud-init.service의 Before=network-online.target 설정 제거
 Before=sshd-keygen.service sshd.service systemd-user-session.service
 EOF
 
-    # systemd 에 설정 반영
+    # systemd 설정 반영
     if command -v systemctl >/dev/null 2>&1; then
         systemctl daemon-reload || true
     fi
@@ -52,9 +52,9 @@ EOF
 
 msg "[INFO] cloud-init 설치 확인 중..." "[INFO] Checking cloud-init installation..."
 if check_cloud_init_installed; then
-    msg "[INFO] cloud-init이 이미 설치되어 있습니다." "[INFO] cloud-init is already installed."
+    msg "[INFO] cloud-init가 이미 설치되어 있습니다." "[INFO] cloud-init is already installed."
 else
-    msg "[INFO] cloud-init이 설치되어 있지 않아 설치를 진행합니다." \
+    msg "[INFO] cloud-init가 설치되어 있지 않아 설치를 진행합니다." \
         "[INFO] cloud-init is not installed, so installation will proceed."
     install_cloud_init || { msg "[ERROR] cloud-init 설치 실패!" "[ERROR] cloud-init installation failed!"; exit 1; }
 fi
@@ -67,11 +67,11 @@ msg "[INFO] cloud.cfg에서 users 항목을 root로 설정합니다..." \
     "[INFO] Set users entry to root in cloud.cfg..."
 patch_cloud_cfg_users_root
 
-msg "[INFO] set_hostname, set_passwords, ssh, runcmd 항목만 매 부팅(always) 실행으로 패치합니다..." \
+msg "[INFO] set_hostname, set_passwords, ssh, runcmd 항목만 매 부팅 시 always로 실행되도록 조정합니다..." \
     "[INFO] Patch only set_hostname, set_passwords, ssh, runcmd items to always run on every boot..."
 patch_cloud_init_and_config_modules_frequency_partial
 
-# 🔽 여기서 cloud-init Network Stage가 network-online.target 이후 실행되도록 override 적용
+# 추가로 cloud-init Network Stage가 network-online.target 이후 실행되도록 override 적용
 msg "[INFO] cloud-init Network Stage가 network-online.target 이후 실행되도록 Unit override를 구성합니다..." \
     "[INFO] Configure cloud-init Network Stage to start after network-online.target via systemd override..."
 ensure_cloud_init_after_network_online
@@ -81,11 +81,11 @@ if [ -f /etc/os-release ]; then
     . /etc/os-release
     case "$ID" in
         ubuntu|debian)
-            msg "[INFO] Ubuntu/Debian detected: shutdown clean 서비스 등록을 건너뜁니다." \
+            msg "[INFO] Ubuntu/Debian 감지: shutdown clean 서비스 등록은 건너뜁니다." \
                 "[INFO] Ubuntu/Debian detected: skipping setup_cloud_init_clean_on_shutdown."
             ;;
         *)
-            msg "[INFO] cloud-init 초기화 설정을 가상머신 셧다운 시에 재설정(clean) 하도록 서비스를 등록합니다." \
+            msg "[INFO] cloud-init 초기화 설정이 가상머신 종료 시 초기화(clean)되도록 서비스를 등록합니다." \
                 "[INFO] Register a service to reset (clean) cloud-init initialization settings when the virtual machine is shut down."
             setup_cloud_init_clean_on_shutdown
             ;;
@@ -93,4 +93,4 @@ if [ -f /etc/os-release ]; then
 fi
 
 print_final_message
-exit 0
\ No newline at end of file
+exit 0
diff --git a/bin/vm_autoinstall.sh b/bin/vm_autoinstall.sh
index 45e7241..6c14169 100644
--- a/bin/vm_autoinstall.sh
+++ b/bin/vm_autoinstall.sh
@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
+#!/usr/bin/env bash
 #
 # Filename : vm_autoinstall.sh
 # Purpose : One-click automatic installation script for VMs
@@ -18,11 +18,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# ── ensure bash (re-exec if not) ───────────────────────────
+# bash가 아니면 재실행
 if [ -z "${BASH_VERSION:-}" ]; then
   exec /usr/bin/env bash "$0" "$@"
 fi
-# ────────────────────────────────────────────────────────────
 
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -41,7 +40,7 @@ print_bitlocker_help() {
   cat <<'HELP'
 [HELP] Offline injection cannot proceed because the guest disk is BitLocker-encrypted.
 
-Option 1 — Disable BitLocker inside the VM, then re-run:
+Option 1 - Disable BitLocker inside the VM, then re-run:
   1) Log in as an Administrator.
   2) Open PowerShell (Run as Administrator) and execute:
        Disable-BitLocker -MountPoint "C:"
@@ -49,7 +48,7 @@ Option 1 — Disable BitLocker inside the VM, then re-run:
   3) Wait until "PercentageEncrypted : 0" is shown for C:, then re-run:
        vm_autoinstall <VM-NAME>
 
-Option 2 — Manual install from the ISO:
+Option 2 - Manual install from the ISO:
   1) Log in to the VM.
   2) Open the CD/DVD drive that contains 'ablestack-qemu-exec-tools.iso'.
   3) Run 'install.bat' as Administrator.
@@ -79,13 +78,13 @@ done
 require_cmd virsh
 check_domain_exists "$DOM"
 
-# 0) ISO 핫플러그 (+ 라벨 부여를 원하면 virt-xml 로 라벨 설정)
+# 0) ISO 연결 (+ 필요하면 virt-xml 대신 기존 CD-ROM 설정 갱신)
 attach_cdrom_iso "$DOM" "${ISO_PATH_DEFAULT:-/usr/share/ablestack/tools/ablestack-qemu-exec-tools.iso}"
 
 # 1) QGA 경로 시도
 QGA="$(has_qga "$DOM")"
 if [[ "$FORCE_OFFLINE" == "no" && "$QGA" == "yes" ]]; then
-  echo "[INFO] QGA detected → Online (non-stop) installation path selected"
+  echo "[INFO] QGA detected - Online (non-stop) installation path selected"
   # OS 판별
   OS=$(detect_os_family_qga "$DOM")
   if [[ "$OS" == "linux" ]]; then
@@ -101,9 +100,9 @@ if [[ "$FORCE_OFFLINE" == "no" && "$QGA" == "yes" ]]; then
     if [[ -z "$vm_exec" ]]; then echo "[ERR] vm_exec not found (QGA caller)"; exit 1; fi
     "$vm_exec" -w -d "$DOM" \
       'powershell -NoProfile -ExecutionPolicy Bypass -File "$env:Temp\ablestack-runonce.ps1"' || true
-    # (교체) Windows 온라인 설치: ISO 루트의 install.bat 실행
+    # Windows 온라인 설치: ISO 루트의 install.bat 실행
     "$vm_exec" -w -d "$DOM" \
-      'powershell -NoProfile -ExecutionPolicy Bypass -Command "$p = (Get-CimInstance Win32_LogicalDisk -Filter `\"DriveType=5`\" | ForEach-Object { $f = Join-Path ($_.DeviceID+`\"\\`\") `\"install.bat`\"; if (Test-Path $f) { $f } } | Select-Object -First 1); if ($p) { Start-Process -FilePath `\"cmd.exe`\" -ArgumentList `\"/c`\", $p -Wait } else { Write-Host `\"[ERR] install.bat not found on any drive`\" }"'
+      'powershell -NoProfile -ExecutionPolicy Bypass -Command "$p = (Get-CimInstance Win32_LogicalDisk -Filter `"DriveType=5`" | ForEach-Object { $f = Join-Path ($_.DeviceID+`"\`") `"install.bat`"; if (Test-Path $f) { $f } } | Select-Object -First 1); if ($p) { Start-Process -FilePath `"cmd.exe`" -ArgumentList `"/c`", $p -Wait } else { Write-Host `"[ERR] install.bat not found on any drive`" }"'
     echo "[OK] Windows Guest Online Installation Attempt Completed"
     exit 0
   else
@@ -118,7 +117,7 @@ PERSIST=$(is_persistent "$DOM")
 TMPDIR="/var/lib/ablestack/vm_autoinstall/$DOM"
 mkdir -p "$TMPDIR"
 
-# 종료 전, 필수 정보 수집
+# 종료 전 필수 정보 수집
 XML_PATH="$TMPDIR/domain.xml"
 DISKS_FILE="$TMPDIR/disks.list"
 dump_transient_xml "$DOM" "$XML_PATH"
@@ -134,19 +133,19 @@ fi
 INSPECT_OUT="$TMPDIR/inspect.xml"
 INSPECT_ERR="$TMPDIR/inspect.err"
 
-# -a <disk> 쌍 생성
+# -a <disk> 인자 생성
 ARGS=()
 for d in "${DISKS[@]}"; do ARGS+=(-a "$d"); done
 
-# 👇 핵심: STDIN 닫기 + 타임아웃으로 사용자 입력 대기 방지
-#  - </dev/null : 아무 입력도 받지 않음 → 프롬프트가 떠도 즉시 EOF로 실패
-#  - timeout 10s : 혹시라도 블록되면 강제 종료
+# 핵심: STDIN 닫기 + 무한 대기 방지
+#  - </dev/null : 프롬프트가 떠도 즉시 EOF 처리
+#  - timeout 10s : 블록되면 강제 종료
 set +e
 timeout 10s virt-inspector "${ARGS[@]}" > "$INSPECT_OUT" 2> "$INSPECT_ERR" </dev/null
 rc=$?
 set -e
 
-# BitLocker / 암호화 감지 → 온라인 경로 안내 + 부팅
+# BitLocker / 암호화 감지 시 오프라인 경로 안내 후 부팅
 if grep -qiE 'BITLK|encrypt-on-write|could not find key to open LUKS|Enter key or passphrase' "$INSPECT_ERR" || [[ $rc -ne 0 ]]; then
   echo "[WARN] BitLocker-encrypted Windows volume detected. Skipping offline injection."
   echo "[INFO] Booting the VM so you can disable BitLocker or run install.bat manually."
@@ -155,10 +154,10 @@ if grep -qiE 'BITLK|encrypt-on-write|could not find key to open LUKS|Enter key o
   exit 0
 fi
 
-# virt-inspector는 <operatingsystems>/<operatingsystem>/<name> 에 OS 계열을 표기함
-# - Windows 계열: <name>windows</name> (일부 환경에서 mswindows 표기도 커버)
+# virt-inspector 결과로 OS 계열 판별
+# - Windows 계열: <name>windows</name>
 # - Linux 계열  : <name>linux</name>
-# 추가로 product_name/distro를 보조 지표로 사용해 견고성 강화
+# 추가로 product_name/distro를 보조 지표로 사용
 if grep -qiE '<name>\s*(ms)?windows\s*</name>|<product_name>[^<]*Windows' "$INSPECT_OUT"; then
   if ! "$ROOT_DIR/lib/ablestack-qemu-exec-tools/offline_inject_windows.sh" --disks "${DISKS[@]}"; then
     echo "[WARN] Offline injection failed on Windows (possible BitLocker or RO filesystem)."
@@ -167,20 +166,18 @@ if grep -qiE '<name>\s*(ms)?windows\s*</name>|<product_name>[^<]*Windows' "$INSP
     create_from_xml "$XML_PATH" >/dev/null 2>&1 || virsh start "$DOM" || true
     exit 0
   fi
-
 elif grep -qiE '<name>\s*linux\s*</name>|<distro>\s*(rocky|rhel|centos|almalinux|fedora|ubuntu|debian|opensuse|sles)\s*</distro>' "$INSPECT_OUT"; then
   "$ROOT_DIR/lib/ablestack-qemu-exec-tools/offline_inject_linux.sh" --disks "${DISKS[@]}"
-
 else
   echo "[ERR] Unsupported OS or detection failure"
   echo "----- inspector head -----"; head -n 50 "$INSPECT_OUT" || true
   exit 1
 fi
 
-# 재부팅: Persistent면 virsh start, Transient면 virsh create(ISO 포함 XML 사용)
+# 영구 VM이면 virsh start, transient이면 virsh create 사용
 ISO="${ISO_PATH_DEFAULT:-/usr/share/ablestack/tools/ablestack-qemu-exec-tools.iso}"
 
-# XML에 이미 우리의 ISO가 물려 있으면 skip, 아니면 XML 갱신
+# XML에 이미 ISO가 있으면 skip, 아니면 XML 갱신
 if [[ -f "$XML_PATH" ]]; then
   if [[ "$(xml_has_cdrom_iso "$XML_PATH" "$ISO")" == "yes" ]]; then
     echo "[OK] XML already has our ISO on a CD-ROM; skip XML edit"
@@ -191,30 +188,32 @@ if [[ -f "$XML_PATH" ]]; then
 fi
 
 if [[ "$PERSIST" == "yes" ]]; then
-  # 영구 도메인은 XML에 CD-ROM을 --config로 추가하는 편이 간단하지만
-  # 여기서는 재사용성을 위해 덤프 XML을 수정 후 define & start 로 처리
+  # 영구 VM은 XML 수정 후 define/start
   virsh define "$XML_PATH" >/dev/null
   start_domain "$DOM"
 else
-  # Transient: 덤프 XML에 CD-ROM 주입 → virsh create 로 부팅
+  # Transient는 수정한 XML로 create
   create_from_xml "$XML_PATH"
 fi
 
 # --- ISO 분리 정책 ---
-# 1) 강제 분리 요청 시: 즉시 이젝트
+# 1) 강제 분리 요청 시 즉시 eject
 if [[ "$FORCE_EJECT" -eq 1 ]]; then
   detach_iso_safely "$DOM" "$ISO" || echo "[WARN] ISO detach failed, but we will continue."
-# 2) 설치 완료 대기 옵션이 있고 QGA guest-exec 가능하면: 완료 감지 후 이젝트
+# 2) 설치 완료 대기 옵션 + QGA guest-exec 가능 시 완료 감지 후 eject
 elif [[ "$WAIT_COMPLETE" -eq 1 && "$(has_qga "$DOM")" == "yes" ]]; then
-  # OS 판별 결과 변수(GUEST_OS) 사용: linux/windows
-  if wait_install_done_via_qga "$DOM" "$GUEST_OS" 900; then    # 15분 타임아웃 예시
+  GUEST_OS="$OS"
+  if [[ -z "${GUEST_OS:-}" ]]; then
+    GUEST_OS=$(detect_os_family_qga "$DOM")
+  fi
+  if wait_install_done_via_qga "$DOM" "$GUEST_OS" 900; then
     detach_iso_safely "$DOM" "$ISO" || echo "[WARN] ISO detach failed after completion."
   else
     echo "[WARN] Could not confirm completion; leaving ISO attached for safety."
   fi
-# 3) 기본: 안전상 ISO 유지 (게스트 스크립트가 자체적으로 eject할 수도 있음)
+# 3) 기본: 안전하게 ISO 유지
 else
   echo "[INFO] Keeping ISO attached (no --wait-complete or QGA-exec not available)."
 fi
 
-echo "[OK] Offline auto-installation ready (automatic installation from ISO after booting)"
\ No newline at end of file
+echo "[OK] Offline auto-installation ready (automatic installation from ISO after booting)"
diff --git a/bin/vm_exec.sh b/bin/vm_exec.sh
index 12277af..e9a0d15 100644
--- a/bin/vm_exec.sh
+++ b/bin/vm_exec.sh
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/bin/bash
 #
 # vm_exec.sh - Remote VM command execution tool using qemu-guest-agent
 #
@@ -37,7 +37,7 @@ print_usage() {
   echo "  --json                     : Output result in JSON format"
   echo "  --csv                      : Parse CSV format output"
   echo "  --table                    : Parse table format output"
-  echo "  --headers "col1,col2,..."  : Use fixed-width columns based on header names (only with --table)"
+  echo "  --headers \"col1,col2,...\"  : Use fixed-width columns based on header names (only with --table)"
   echo "  --parallel                 : Execute commands in parallel (file mode only)"
   exit 1
 }
@@ -95,7 +95,7 @@ while [[ "$#" -gt 0 ]]; do
     --headers)
       shift
       if [[ "$#" -eq 0 || "$1" =~ ^-- ]]; then
-        echo "❌ Error: --headers option requires a comma-separated string argument."
+        echo "Error: --headers option requires a comma-separated string argument."
         exit 1
       fi
       USER_DEFINED_HEADERS="$1"
diff --git a/deb/control b/deb/control
index 71c8fa7..9d96c13 100644
--- a/deb/control
+++ b/deb/control
@@ -5,5 +5,5 @@ Priority: optional
 Architecture: all
 Depends: bash, jq, libvirt-clients, qemu-guest-agent, cloud-init
 Maintainer: ABLECLOUD <dev@ablecloud.io>
-Description: QEMU guest-agent 기반 VM 명령 실행 및 정책 자동화 도구
- QEMU/libvirt 환경에서 qemu-guest-agent를 이용한 VM 명령 실행, 정책 자동화 bash 스크립트 도구 세트.
+Description: QEMU guest-agent 기반 VM 명령 ?�행 �??�책 ?�동???�구
+ QEMU/libvirt ?�경?�서 qemu-guest-agent�??�용??VM 명령 ?�행, ?�책 ?�동??bash ?�크립트 ?�구 ?�트.
diff --git a/docs/hangctl/ablestack_vm_hangctl.md b/docs/hangctl/ablestack_vm_hangctl.md
index 5f0f680..93ac8ba 100644
--- a/docs/hangctl/ablestack_vm_hangctl.md
+++ b/docs/hangctl/ablestack_vm_hangctl.md
@@ -13,13 +13,13 @@ ABLESTACK 호스트(Rocky 9 기반)에서 **가상머신 Hang 상태 모니터
 - Logs
   - `/var/log/ablestack-vm-hangctl/events.log`
 
-## Commit 02 기준 동작
+## Commit 02 기반 작동
 
-현재 단계(Commit 02)에서는 다음만 제공합니다.
+현재 체계(Commit 02)에서 다음과 같이 제공합니다.
 
 - config 파일 로드(`/etc/ablestack/ablestack-vm-hangctl.conf`)
-- 런타임 디렉토리 자동 생성(`/run`, `/var/log`)
-- `scan` 수행 시 scan lifecycle 이벤트(stub) 기록
+- 필요한 디렉토리 자동 생성(`/run`, `/var/log`)
+- `scan` 실행 시 scan lifecycle 이벤트(stub) 기록
 
 ## 사용 예
 
diff --git a/docs/hangctl/ablestack_vm_hangctl_events.md b/docs/hangctl/ablestack_vm_hangctl_events.md
index 375334b..297dc4f 100644
--- a/docs/hangctl/ablestack_vm_hangctl_events.md
+++ b/docs/hangctl/ablestack_vm_hangctl_events.md
@@ -1,50 +1,50 @@
 # ablestack_vm_hangctl - Events (JSONL)
 
-`ablestack_vm_hangctl`은 운영/감사/원인분석을 위해 **append-only JSONL 이벤트 로그**를 기록합니다.
+`ablestack_vm_hangctl`의 운영/감사/분석을 위해 **append-only JSONL 이벤트 로그**를 기록합니다.
 
 - 기본 경로: `/var/log/ablestack-vm-hangctl/events.log`
 - 포맷: 1라인 = 1 JSON 객체 (JSONL)
 
 ## 스키마(고정)
 
-모든 이벤트는 아래 공통 필드를 가집니다.
+모든 이벤트는 다음과 같은 공통 필드를 가집니다.
 
 | Field | Type | Required | Description |
 |---|---:|:---:|---|
 | ts | string | Y | ISO8601 (+TZ) |
-| scan_id | string | Y | 스캔 실행 단위 식별자 |
-| incident_id | string | N | VM Hang 사건 단위 식별자 |
+| scan_id | string | Y | 스캔 실행 시위 식별자 |
+| incident_id | string | N | VM Hang 사건 시위 식별자 |
 | vm | string | N | VM 이름 |
 | stage | string | Y | scan/detect/confirm/evidence/action/libvirtd/verify/done/error |
-| event | string | Y | 이벤트명(단계 내 세부) |
+| event | string | Y | 이벤트명(체계 내 고유) |
 | result | string | Y | ok/fail/timeout/skip/warn |
 | rc | number | N | 커맨드 실행 결과 코드 |
 | elapsed_ms | number | N | 실행 시간(ms) |
-| details | object | N | 추가 정보(키/값) |
+| details | object | N | 추가 정보(선택) |
 
 ## Commit 03 범위
 
-Commit 03에서는 스캔 라이프사이클 이벤트만 기록합니다.
+Commit 03에서 스캔 라이프사이클 이벤트만 기록합니다.
 
 - `scan.scan.start`
 - `scan.scan.end`
 
-Commit 05에서는 circuit breaker / 대상 VM 수집 이벤트가 추가됩니다.
+Commit 05에서 circuit breaker / 대상 VM 수집 이벤트들을 추가합니다.
 
 - `scan.libvirtd.health`
 - `scan.scan.targets`
 
-Commit 06에서는 domstate 기반 정체(stuck) 개산 이벤트가 추가됩니다.
+Commit 06에서 domstate 기반 전체(stuck) 계산 이벤트들을 추가합니다.
 
 - `detect.vm.domstate`
 
-Commit 07에서는 probe(확정 신호) 이벤트 및 최종 판정 이벤트가 추가됩니다.
+Commit 07에서 probe(특정 시도) 이벤트와 최종 결정 이벤트들을 추가합니다.
 
 - `detect.probe.qmp`
 - `detect.probe.qga`
 - `detect.vm.decision`
 
-Commit 08에서는 confirmed VM에 대한 액션/사후 검증 이벤트가 추가됩니다.
+Commit 08에서 confirmed VM들의 조치/사후 검증 이벤트들을 추가합니다.
 
 - `action.incident.start`
 - `action.action.destroy`
@@ -53,7 +53,7 @@ Commit 08에서는 confirmed VM에 대한 액션/사후 검증 이벤트가 추
 - `verify.verify.domstate`
 - `action.incident.end`
 
-## 예시
+## ?�시
 
 ```json
 {"ts":"2026-02-12T19:15:00+09:00","scan_id":"20260212-191500-acde12","stage":"scan","event":"scan.start","result":"ok","details":{"policy":"default","dry_run":"1","config":"/etc/ablestack/ablestack-vm-hangctl.conf"}}
@@ -66,46 +66,49 @@ Commit 08에서는 confirmed VM에 대한 액션/사후 검증 이벤트가 추
 {"ts":"2026-02-12T19:15:00+09:00","scan_id":"20260212-191500-acde12","stage":"scan","event":"scan.end","result":"ok","details":{"policy":"default","dry_run":"1"}}
 ```
 
-향후 커밋에서 VM별 사건(incident_id), 증적(evidence), 액션(action), libvirtd 재시작 등이 추가됩니다. 
+?�후 커밋?�서 VM�??�건(incident_id), 증적(evidence), ?�션(action), libvirtd ?�시???�이 추�??�니??
 
 ---
 
-## Commit 05 검증 가이드
+## Commit 05 검�?가?�드
+
+### A) ?�상 케?�스
 
-### A) 정상 케이스
 ```bash
 truncate -s 0 /var/log/ablestack-vm-hangctl/events.log || true
 ablestack_vm_hangctl scan --dry-run
 tail -n 10 /var/log/ablestack-vm-hangctl/events.log | jq -r '.event + " " + .result'
 ```
 
-기대:
+기�?:
 
 - scan.start ok
 - libvirtd.health ok
 - scan.target ok
 - scan.end ok
 
-### B) libvirtd 비정상 (테스트 방법)
+### B) libvirtd 비정??(?�스??방법)
 
-일시ㅣ적으로 HANGCTL_VIRSH_TIMEOUT_SEC=0.001 같은 극단값을 config에 넣고 실행하면 timeout을 유발할 수 있습니다. 
-그 경우:
+?�시?�적?�로 HANGCTL_VIRSH_TIMEOUT_SEC=0.001 같�? 극단값을 config???�고 ?�행?�면 timeout???�발?????�습?�다.
+�?경우:
 
-- libvirtd.health timeout (또는 fail)
+- libvirtd.health timeout (?�는 fail)
 - scan.end warn (branch=libvirtd_unhealthy)
-- 이후 scan.targets는 발생하지 않아야 합니다. 
+- ?�후 scan.targets??발생?��? ?�아???�니??
 
 ---
 
-### 구현 메모(운영 안정성)
-- Circuit breaker 실패 시 VM probe를 더 하지 말고 즉시 종료합니다.
-- 다음 Commit 10에서 libvirtd 재시작 로직이 불가 전까지는, 여기서는 "조용히 warn 종료"가 안전합니다. 
+### 구현 메모(?�영 ?�정??
+
+- Circuit breaker ?�패 ??VM probe�????��? 말고 즉시 종료?�니??
+- ?�음 Commit 10?�서 libvirtd ?�시??로직??불�? ?�까지?? ?�기?�는 "조용??warn 종료"가 ?�전?�니??
 
 ---
 
-## Commit 07 적용 후 빠른 검증 포인트(명령)
+## Commit 07 ?�용 ??빠른 검�??�인??명령)
+
+1) `confirm_window`�??�시�??�게 ?�서 `suspect`�?만들�?probe가 ?�제�?찍히?��? ?�인:
 
-1) `confirm_window`를 임시로 작게 해서 `suspect`를 만들고 probe가 실제로 찍히는지 확인:
 ```bash
 sudo sed -i 's/^HANGCTL_CONFIRM_WINDOW_SEC=.*/HANGCTL_CONFIRM_WINDOW_SEC="3"/' /etc/ablestack/ablestack-vm-hangctl.conf
 sudo rm -rf /run/ablestack-vm-hangctl/state && sudo mkdir -p /run/ablestack-vm-hangctl/state
@@ -119,22 +122,23 @@ sudo jq -r 'select(.event=="probe.qmp" or .event=="probe.qga" or .event=="vm.dec
   /var/log/ablestack-vm-hangctl/events.log | head -n 30
 ```
 
-2) 확인 후 confirm_window 원복:
+1) ?�인 ??confirm_window ?�복:
 
 ```
 sudo sed -i 's/^HANGCTL_CONFIRM_WINDOW_SEC=.*/HANGCTL_CONFIRM_WINDOW_SEC="120"/' /etc/ablestack/ablestack-vm-hangctl.conf
 ```
 
-## Commit 08 action/verify 예시(개략):
+## Commit 08 action/verify ?�시(개략)
 
 ```
 json +{"ts":"...","scan_id":"...","incident_id":"...","vm":"w22-01","stage":"action","event":"incident.start","result":"ok","details":{"reason":"qmp_timeout","dry_run":"0"}} {"ts":"...","scan_id":"...","incident_id":"...","vm":"w22-01","stage":"action","event":"action.destroy","result":"fail","rc":124,"details":{"timeout_sec":"3","err_url":"..."}} {"ts":"...","scan_id":"...","incident_id":"...","vm":"w22-01","stage":"action","event":"action.kill.term","result":"ok","details":{"pids":"1234"}} +{"ts":"...","scan_id":"...","incident_id":"...","vm":"w22-01","stage":"verify","event":"verify.domstate","result":"ok","details":{"domstate":"shut off"}} +{"ts":"...","scan_id":"...","incident_id":"...","vm":"w22-01","stage":"action","event":"incident.end","result":"ok","details":{"result":"stopped"}} +
 ```
 
-향후 커밋에서 VM별 증적(evidence) 확장, libvirtd 재시작 등이 추가됩니다.
+?�후 커밋?�서 VM�?증적(evidence) ?�장, libvirtd ?�시???�이 추�??�니??
 
 ---
 
-## 구현 주의사항(운영 관점)
-- `hangctl_find_qemu_pids()`는 libvirt qemu argv에 포함되는 `-name guest=<VM>` 패턴 기반 **best-effort**입니다. (Commit 09에서 `/proc/<pid>/cmdline` 추가 검증 등으로 더 견고화 가능)
-- `verify.domstate`는 **domstate 조회 실패도 “도메인 소멸”로 간주하여 stopped 처리**합니다(실무에서 안전한 방향).
+## 구현 주의?�항(?�영 관??
+
+- `hangctl_find_qemu_pids()`??libvirt qemu argv???�함?�는 `-name guest=<VM>` ?�턴 기반 **best-effort**?�니?? (Commit 09?�서 `/proc/<pid>/cmdline` 추�? 검�??�으�???견고??가??
+- `verify.domstate`??**domstate 조회 ?�패???�도메인 ?�멸?�로 간주?�여 stopped 처리**?�니???�무?�서 ?�전??방향).
diff --git a/docs/usage_agent_policy_fix.md b/docs/usage_agent_policy_fix.md
index 98e25cb..39a9f11 100644
--- a/docs/usage_agent_policy_fix.md
+++ b/docs/usage_agent_policy_fix.md
@@ -3,102 +3,106 @@
 
 ## 개요
 
-`agent_policy_fix.sh`는 리눅스 가상머신(RHEL/Rocky/Alma/Ubuntu/Debian 계열) 내부에서 `qemu-guest-agent`의 설치, 서비스 활성화, 그리고 (RHEL 계열 한정) RPC 정책 자동화 작업을 수행하는 도구입니다.
+`agent_policy_fix.sh`는 리눅스 가상머신(RHEL/Rocky/Alma/Ubuntu/Debian 계열) 환경에서 `qemu-guest-agent`의 설치, 서비스 설정 그리고(RHEL 계열 특정) RPC 정책 자동화를 수행하는 도구입니다.
 
-- **주요 목적:**  
-  1. `qemu-guest-agent` 패키지가 설치되어 있는지 확인, 자동 설치  
-  2. 서비스가 활성화되어 있지 않으면 자동 활성화  
-  3. RHEL/Rocky/Alma 계열에서는 `/etc/sysconfig/qemu-ga`의 정책 옵션(`allow-rpcs`)을 자동 조정  
-  4. Ubuntu/Debian 계열에서는 모든 정책이 기본 허용임을 안내
+- **주요 목적:**
+  1. `qemu-guest-agent` 패키지가 설치되어 있는지 확인, 자동 설치
+  2. 서비스가 정상적으로 실행되고 있는지 확인, 자동 설정
+  3. RHEL/Rocky/Alma 계열에서 `/etc/sysconfig/qemu-ga`의 정책 옵션(`allow-rpcs`)을 자동 조정
+  4. Ubuntu/Debian 계열에서는 모든 정책을 기본 허용으로 유지
 
 ---
 
 ## 지원 환경
 
-- Rocky Linux 8/9, RHEL 8/9, AlmaLinux 8/9 등 (RHEL 계열)
-- Ubuntu 20.04/22.04/24.04, Debian 10/11/12 등 (Debian/Ubuntu 계열)
+- Rocky Linux 8/9, RHEL 8/9, AlmaLinux 8/9 등(RHEL 계열)
+- Ubuntu 20.04/22.04/24.04, Debian 10/11/12 등(Debian/Ubuntu 계열)
 
 ---
 
 ## 설치 및 실행
 
-1. VM(게스트) 내부에 `agent_policy_fix.sh` 파일이 있어야 합니다.
+1. VM(게스트) 환경에 `agent_policy_fix.sh` 파일을 복사합니다.
 2. root 또는 sudo 권한이 필요합니다.
 3. 실행:
+
     ```bash
     sudo agent_policy_fix
     ```
+
    또는 파일 직접 실행
+
     ```bash
     sudo ./agent_policy_fix.sh
     ```
 
 ---
 
-## 동작 방식
+## 작동 방식
 
 ### [RHEL/Rocky/Alma 계열]
 
 - `qemu-guest-agent` 설치 여부 확인, 자동 설치
-- 서비스가 비활성화/비실행 상태면 자동 enable+start
-- `/etc/sysconfig/qemu-ga`의 FILTER_RPC_ARGS를 읽어
+- 서비스가 비활성화/비실행 상태이면 자동 enable+start
+- `/etc/sysconfig/qemu-ga`에 FILTER_RPC_ARGS를 추가하여
   - allow-rpcs, block-rpcs 옵션 병합
-  - guest-exec 등 모든 RPC 명령 완전 허용 정책으로 변환
-- 서비스 재시작 및 정상 동작 확인
+  - guest-exec 등 모든 RPC 명령 전면 허용 정책으로 변경
+- 서비스 재시작 후 정상 작동 확인
 
 ### [Ubuntu/Debian 계열]
 
 - `qemu-guest-agent` 설치 여부 확인, 자동 설치
-- 서비스가 비활성화/비실행 상태면 자동 enable+start
-- **정책 자동화 필요 없음:**
-  - Ubuntu/Debian 계열은 qemu-guest-agent의 모든 RPC 명령이 기본 허용
-  - 별도 설정/자동화 없이 바로 사용 가능
+- 서비스가 비활성화/비실행 상태이면 자동 enable+start
+- **?�책 ?�동???�요 ?�음:**
+  - Ubuntu/Debian 계열?� qemu-guest-agent??모든 RPC 명령??기본 ?�용
+  - 별도 ?�정/?�동???�이 바로 ?�용 가??
 
 ---
 
-## 주요 옵션 및 인자
+## 주요 ?�션 �??�자
 
-- 본 스크립트는 **옵션이나 인자 없이 실행**하면 됨
-- 별도의 환경설정이나 추가 옵션 불필요
+- �??�크립트??**?�션?�나 ?�자 ?�이 ?�행**?�면 ??- 별도???�경?�정?�나 추�? ?�션 불필??
 
 ---
 
-## 사용 예제
+## ?�용 ?�제
 
-### 1. 기본 실행
+### 1. 기본 ?�행
 
 ```bash
 sudo agent_policy_fix
 ```
+
 or
+
 ```bash
 sudo ./agent_policy_fix.sh
 ```
 
-### 2. 예상 출력 예시
+### 2. ?�상 출력 ?�시
 
 ```
-[INFO] Ubuntu/Debian 계열로 감지됨.
-[INFO] qemu-guest-agent가 이미 설치되어 있습니다.
-[INFO] qemu-guest-agent 서비스가 이미 활성화(실행) 상태입니다.
-[NOTICE] Ubuntu 계열은 qemu-guest-agent의 모든 RPC 명령이 기본적으로 허용되어 있습니다.
-         별도의 정책 설정이나 추가 자동화 작업은 필요하지 않습니다.
+[INFO] Ubuntu/Debian 계열�?감�???
+[INFO] qemu-guest-agent가 ?��? ?�치?�어 ?�습?�다.
+[INFO] qemu-guest-agent ?�비?��? ?��? ?�성???�행) ?�태?�니??
+[NOTICE] Ubuntu 계열?� qemu-guest-agent??모든 RPC 명령??기본?�으�??�용?�어 ?�습?�다.
+         별도???�책 ?�정?�나 추�? ?�동???�업?� ?�요?��? ?�습?�다.
 ```
 
 ---
 
-## 유의사항
+## ?�의?�항
 
-- 반드시 **게스트(가상머신) 내부**에서 실행해야 합니다.
-- RHEL/Rocky 계열 정책 변경 시 `/etc/sysconfig/qemu-ga`가 백업됩니다.
-- 실행에 root 권한(또는 sudo)이 필요합니다.
-- 정책 파일 구조, 서비스명 등이 배포판/버전에 따라 일부 다를 수 있습니다.
+- 반드??**게스??가?�머?? ?��?**?�서 ?�행?�야 ?�니??
+- RHEL/Rocky 계열 ?�책 변�???`/etc/sysconfig/qemu-ga`가 백업?�니??
+- ?�행??root 권한(?�는 sudo)???�요?�니??
+- ?�책 ?�일 구조, ?�비?�명 ?�이 배포??버전???�라 ?��? ?��? ???�습?�다.
 
 ---
 
-## 라이선스 및 문의
+## ?�이?�스 �?문의
 
 - Apache License 2.0
-- 문의: ABLECLOUD 오픈소스 프로젝트 페이지 참고
+- 문의: ABLECLOUD ?�픈?�스 ?�로?�트 ?�이지 참고
 
 ---
diff --git a/docs/usage_vm_autoinstall.md b/docs/usage_vm_autoinstall.md
index 2969f75..033d346 100644
--- a/docs/usage_vm_autoinstall.md
+++ b/docs/usage_vm_autoinstall.md
@@ -1,14 +1,14 @@
 # vm_autoinstall 사용법 (ablestack-qemu-exec-tools)
 
-호스트에서 실행 중인 QEMU/libvirt 기반 가상머신에  
-**자동으로 ISO를 연결하고, 게스트 OS에 맞게 설치 스크립트를 실행하는 도구**입니다.  
+호스트에서 실행 중인 QEMU/libvirt 기반 가상머신에
+**자동으로 ISO를 연결하고, 게스트 OS에 맞게 설치 스크립트를 실행하는 도구**입니다.
 
-vCenter의 “에이전트 자동 설치” 기능처럼, **한 번의 명령으로**  
-Windows 및 Linux 게스트에 ablestack-qemu-exec-tools를 설치할 수 있습니다.
+vCenter의 게스트 OS에 전송하는 자동 설치 기능처럼, **한 번의 명령으로**
+Windows 및 Linux 게스트에 ablestack-qemu-exec-tools를 설치합니다.
 
 ---
 
-## 🧰 기본 실행 형식
+## 📋 기본 실행 형식
 
 ```bash
 vm_autoinstall <vm-name> [--force-offline] [--no-reboot]
@@ -16,136 +16,144 @@ vm_autoinstall <vm-name> [--force-offline] [--no-reboot]
 
 ---
 
-## ⚙️ 주요 동작 모드
+## ⚙️ 주요 작동 모드
 
-| 모드 | 조건 | 동작 방식 |
+| 모드 | 조건 | 작동 방식 |
 |------|------|-----------|
 | **온라인 설치 모드** | 게스트에 `qemu-guest-agent`(QGA)가 실행 중 | VM을 중단하지 않고, 게스트 내부에서 ISO 마운트 후 설치 스크립트(`install-linux.sh` 또는 `install.bat`) 실행 |
-| **오프라인 설치 모드** | QGA가 없거나 `--force-offline` 지정 | VM 종료 후 디스크 이미지에 1회 실행 훅 주입 → 부팅 시 자동으로 ISO 마운트 후 설치 |
-| **Transient VM 지원** | VM이 종료되면 libvirt 목록에서 사라지는 경우 | 종료 직전 XML 및 디스크 정보 백업 → 주입 후 `virsh create`로 재기동 |
-| **Persistent VM** | libvirt에 영구 등록된 VM | 오프라인 주입 후 `virsh start`로 재기동 |
+| **오프라인 설치 모드** | QGA가 거부되거나 `--force-offline` 지정 | VM 종료 후 스냅샷 찍기 + 주입 + 부팅 시 자동으로 ISO 마운트 후 설치 |
+| **Transient VM 지원** | VM이 종료되면 libvirt 목록에서 사라지는 경우 | 종료 직전 XML 및 스냅샷 정보 백업 후 주입 및 `virsh create`로 복기 |
+| **Persistent VM** | libvirt에 영구 등록된 VM | 오프라인 주입 후 `virsh start`로 부팅 |
 
 ---
 
-## 🧩 옵션
+## 📋 옵션
 
 | 옵션 | 설명 |
 |------|------|
-| `--force-offline` | QGA가 있더라도 강제로 오프라인 설치 절차를 수행 |
-| `--no-reboot` | 오프라인 모드에서 VM을 주입만 하고 자동 부팅하지 않음 |
+| `--force-offline` | QGA가 작동해도 강제로 오프라인 설치 과정을 수행 |
+| `--no-reboot` | 오프라인 모드에서 VM에 주입만 하고 부팅하지 않음 |
 | `-h`, `--help` | 사용법 출력 |
 
 ---
 
-## 🪶 동작 개요
+## 🔄 작동 개요
 
 1. **ISO 연결**
-   - `/usr/share/ablestack/tools/ablestack-qemu-exec-tools.iso` 를 VM CD-ROM 장치에 연결  
-   - 기존 ISO가 연결된 경우 자동으로 새 슬롯 추가 또는 안전한 교체 수행
+   - `/usr/share/ablestack/tools/ablestack-qemu-exec-tools.iso` 에 VM CD-ROM 디바이스에 연결
+   - 기존 ISO가 연결된 경우 자동으로 슬롯 추가 또는 전환 교체 수행
 2. **QGA 감지**
-   - `virsh qemu-agent-command <vm> '{"execute":"guest-ping"}'` 를 통해 확인
-3. **온라인 설치 (QGA 있음)**
-   - 게스트 내부에서 ISO 마운트 후:
+   - `virsh qemu-agent-command <vm> '{"execute":"guest-ping"}'` 으로 확인
+3. **온라인 설치 (QGA 정상)**
+   - 게스트 내부에서 ISO 마운트 후
      - Linux: `/install-linux.sh`
      - Windows: `/install.bat`
-   - 실행 완료 후 ISO 자동 분리
-4. **오프라인 설치 (QGA 없음)**
-   - VM을 종료하고, 게스트 이미지에 다음 항목을 주입:
+   - ?�행 ?�료 ??ISO ?�동 분리
+4. **?�프?�인 ?�치 (QGA ?�음)**
+   - VM??종료?�고, 게스???��?지???�음 ??��??주입:
      - Linux: `ablestack-install.service` (systemd unit)
-     - Windows: `ablestack-runonce.ps1` (RunOnce 등록)
-   - 부팅 시 ISO 자동 마운트 후 설치 스크립트 실행
-5. **재기동 및 검증**
-   - VM 자동 기동 (또는 `--no-reboot`일 경우 수동 부팅)
-   - 설치 완료 후 ISO 자동 제거 (`detach_iso_safely`)
+     - Windows: `ablestack-runonce.ps1` (RunOnce ?�록)
+   - 부????ISO ?�동 마운?????�치 ?�크립트 ?�행
+5. **?�기??�?검�?*
+   - VM ?�동 기동 (?�는 `--no-reboot`??경우 ?�동 부??
+   - ?�치 ?�료 ??ISO ?�동 ?�거 (`detach_iso_safely`)
 
 ---
 
-## 🔧 전제 조건
+## ?�� ?�제 조건
 
-| 항목 | 설명 |
+| ??�� | ?�명 |
 |------|------|
-| ISO 파일 | `/usr/share/ablestack/tools/ablestack-qemu-exec-tools.iso` |
-| ISO 라벨 | `"ABLESTACK"` (GitHub Actions에서 자동 지정됨) |
-| ISO 루트 스크립트 | Windows → `install.bat` / Linux → `install-linux.sh` |
-| 호스트 패키지 | `jq`, `virsh`, `libguestfs-tools`, `virt-install`, `virt-xml`(선택) |
+| ISO ?�일 | `/usr/share/ablestack/tools/ablestack-qemu-exec-tools.iso` |
+| ISO ?�벨 | `"ABLESTACK"` (GitHub Actions?�서 ?�동 지?�됨) |
+| ISO 루트 ?�크립트 | Windows ??`install.bat` / Linux ??`install-linux.sh` |
+| ?�스???�키지 | `jq`, `virsh`, `libguestfs-tools`, `virt-install`, `virt-xml`(?�택) |
 
 ---
 
-## 💡 사용 예시
+## ?�� ?�용 ?�시
+
+### ??기본 ?�용 (QGA 감�? ?�동)
 
-### ▶ 기본 사용 (QGA 감지 자동)
 ```bash
 sudo vm_autoinstall my-vm
 ```
-> QGA가 있으면 온라인 모드, 없으면 오프라인 모드로 자동 전환됩니다.
 
-### ▶ QGA가 없을 때 강제로 오프라인 모드로 주입
+> QGA가 ?�으�??�라??모드, ?�으�??�프?�인 모드�??�동 ?�환?�니??
+
+### ??QGA가 ?�을 ??강제�??�프?�인 모드�?주입
+
 ```bash
 sudo vm_autoinstall centos9-vm --force-offline
 ```
 
-### ▶ 오프라인 주입만 하고 재부팅은 나중에
-```bash
+### ???�프?�인 주입�??�고 ?��??��? ?�중??```bash
+
 sudo vm_autoinstall win11-vm --force-offline --no-reboot
+
 ```
-이후 수동으로 `virsh start win11-vm`을 수행하면 설치가 자동 진행됩니다.
+?�후 ?�동?�로 `virsh start win11-vm`???�행?�면 ?�치가 ?�동 진행?�니??
 
 ---
 
-## 🧾 출력 예시
+## ?�� 출력 ?�시
 
 ```
+
 [INFO] Attaching ISO /usr/share/ablestack/tools/ablestack-qemu-exec-tools.iso
-[INFO] QGA 감지됨 → 온라인 설치 경로
-[OK] Linux 게스트 온라인 설치 완료
-[OK] ISO 자동 분리 완료
+[INFO] QGA 감�??????�라???�치 경로
+[OK] Linux 게스???�라???�치 ?�료
+[OK] ISO ?�동 분리 ?�료
+
 ```
 
-또는 오프라인 모드의 경우:
+?�는 ?�프?�인 모드??경우:
 ```
-[INFO] 오프라인 설치 경로 진입
-[OK] Linux 오프라인 주입 완료
-[OK] virsh create 실행 (Transient 부팅)
+
+[INFO] ?�프?�인 ?�치 경로 진입
+[OK] Linux ?�프?�인 주입 ?�료
+[OK] virsh create ?�행 (Transient 부??
+
 ```
 
 ---
 
-## 🧠 작동 원리 요약
+## ?�� ?�동 ?�리 ?�약
 
-1. `libvirt_helpers.sh`의 `inject_cdrom_into_xml()`로 ISO 안전 연결  
-2. `has_qga()` → QGA 상태 판단  
-3. 온라인 모드: `vm_exec.sh`를 통해 게스트 내부에서 설치 스크립트 실행  
-4. 오프라인 모드:  
-   - `offline_inject_linux.sh` / `offline_inject_windows.sh` 사용  
-   - systemd unit 또는 RunOnce를 디스크 이미지에 주입  
-   - 부팅 시 ISO 자동 마운트 후 설치 진행  
-5. 설치 완료 후 `detach_iso_safely()`로 ISO 해제
+1. `libvirt_helpers.sh`??`inject_cdrom_into_xml()`�?ISO ?�전 ?�결  
+2. `has_qga()` ??QGA ?�태 ?�단  
+3. ?�라??모드: `vm_exec.sh`�??�해 게스???��??�서 ?�치 ?�크립트 ?�행  
+4. ?�프?�인 모드:  
+   - `offline_inject_linux.sh` / `offline_inject_windows.sh` ?�용  
+   - systemd unit ?�는 RunOnce�??�스???��?지??주입  
+   - 부????ISO ?�동 마운?????�치 진행  
+5. ?�치 ?�료 ??`detach_iso_safely()`�?ISO ?�제
 
 ---
 
-## ⚠️ 주의사항
+## ?�️ 주의?�항
 
-- 오프라인 모드에서는 VM이 **잠시 중단**됩니다.  
-- `virt-*` 명령은 루트 권한이 필요하며, 일부 환경에서는 `LIBGUESTFS_BACKEND=direct` 설정이 필요할 수 있습니다.  
-- ISO 파일이 없거나 손상된 경우 자동 주입이 실패합니다.  
-- `install.bat` / `install-linux.sh`는 ISO 루트에 반드시 존재해야 합니다.
+- ?�프?�인 모드?�서??VM??**?�시 중단**?�니??  
+- `virt-*` 명령?� 루트 권한???�요?�며, ?��? ?�경?�서??`LIBGUESTFS_BACKEND=direct` ?�정???�요?????�습?�다.  
+- ISO ?�일???�거???�상??경우 ?�동 주입???�패?�니??  
+- `install.bat` / `install-linux.sh`??ISO 루트??반드??존재?�야 ?�니??
 
 ---
 
-## 🗂 관련 파일
+## ?�� 관???�일
 
-| 파일 | 설명 |
+| ?�일 | ?�명 |
 |------|------|
-| `bin/vm_autoinstall.sh` | 메인 실행 스크립트 |
-| `lib/libvirt_helpers.sh` | ISO 연결, QGA 체크, XML 조작 함수 |
-| `lib/offline_inject_linux.sh` | Linux 오프라인 설치 주입 로직 |
-| `lib/offline_inject_windows.sh` | Windows 오프라인 설치 주입 로직 |
-| `payload/linux/ablestack-install.service` | Linux 부팅 후 install-linux.sh 실행용 systemd unit |
-| `payload/windows/ablestack-runonce.ps1` | Windows 부팅 후 install.bat 실행용 PowerShell |
+| `bin/vm_autoinstall.sh` | 메인 ?�행 ?�크립트 |
+| `lib/libvirt_helpers.sh` | ISO ?�결, QGA 체크, XML 조작 ?�수 |
+| `lib/offline_inject_linux.sh` | Linux ?�프?�인 ?�치 주입 로직 |
+| `lib/offline_inject_windows.sh` | Windows ?�프?�인 ?�치 주입 로직 |
+| `payload/linux/ablestack-install.service` | Linux 부????install-linux.sh ?�행??systemd unit |
+| `payload/windows/ablestack-runonce.ps1` | Windows 부????install.bat ?�행??PowerShell |
 
 ---
 
-## 🧾 참고
+## ?�� 참고
 
-- `vm_autoinstall`은 `vm_exec`과 달리 **게스트 내부 명령 실행을 자동화**하는 상위 도구입니다.  
-- ISO 기반 자동 설치는 QGA가 없어도 동작하므로, **초기 에이전트 배포 시** 특히 유용합니다.
+- `vm_autoinstall`?� `vm_exec`�??�리 **게스???��? 명령 ?�행???�동??*?�는 ?�위 ?�구?�니??  
+- ISO 기반 ?�동 ?�치??QGA가 ?�어???�작?��?�? **초기 ?�이?�트 배포 ??* ?�히 ?�용?�니??
diff --git a/docs/usage_vm_exec.md b/docs/usage_vm_exec.md
index 89ed9fe..6fc1c9e 100644
--- a/docs/usage_vm_exec.md
+++ b/docs/usage_vm_exec.md
@@ -1,17 +1,18 @@
 # vm_exec 사용법 (ablestack-qemu-exec-tools)
 
-QEMU/libvirt 기반 VM 내부에서 명령을 원격으로 실행하고 결과를 파싱하는 도구입니다.  
-qemu-guest-agent를 사용하는 `virsh qemu-agent-command`를 기반으로 작동합니다.
+QEMU/libvirt 기반 VM 환경에서 명령을 게스트에서 실행하고 결과를 파싱하는 도구입니다.
+qemu-guest-agent를 사용하는 `virsh qemu-agent-command`에 기반으로 작동합니다.
 
 ---
 
-## 🧰 기본 실행 형식
+## 📋 기본 실행 형식
 
 ```bash
 vm_exec -l|-w|-d <vm-name> <command> [args...] [options]
 ```
 
-### ▶ 실행 모드
+### 실행 모드
+
 | 옵션      | 설명                                      |
 |-----------|-------------------------------------------|
 | `-l`      | Linux VM (명령: `bash -c`)                |
@@ -25,31 +26,31 @@ vm_exec -l|-w|-d <vm-name> <command> [args...] [options]
 | 옵션               | 설명                                                         |
 |--------------------|--------------------------------------------------------------|
 | `--json`           | 전체 실행 결과를 JSON 형식으로 출력                          |
-| `--csv`            | CSV 형식의 결과를 파싱하여 JSON 변환                         |
-| `--table`          | 텍스트 테이블을 파싱하여 JSON으로 출력                       |
-| `--headers "..."`  | 고정폭 열 구분을 위한 명시적 헤더 지정 (CSV 아님, `--table`과 함께 사용) |
-| `--out <file>`     | 명령 결과를 지정된 파일에 저장                                |
+| `--csv`            | CSV 형식으로 결과를 파싱하여 JSON 변환                       |
+| `--table`          | 테이블을 파싱하여 JSON으로 출력                              |
+| `--headers "..."`  | 고정된 구분자를 가진 명시적 헤더 지정(CSV 파싱, `--table`과 함께 사용) |
+| `--out <file>`     | 명령 결과를 지정된 파일에 저장                               |
 | `--exit-code`      | guest-exec의 종료 코드 출력                                  |
 | `--file <file>`    | 스크립트 파일의 각 줄을 명령으로 실행                        |
 | `--parallel`       | 스크립트 파일 실행 시 명령들을 병렬로 실행                   |
 
 ---
 
-## 🔍 사용 예시
+## 💡 사용 예시
 
-### ▶ Linux VM에서 `ps aux` 실행 후 JSON으로 출력
+### 🐧 Linux VM에서 `ps aux` 실행 및 JSON으로 출력
 
 ```bash
 vm_exec -l ubuntu-vm ps aux --table --headers "USER,PID,%CPU,%MEM,COMMAND" --json
 ```
 
-### ▶ Windows VM에서 `tasklist` 결과 JSON 파싱
+### 🪟 Windows VM에서 `tasklist` 결과 JSON 파싱
 
 ```bash
 vm_exec -w win10-vm tasklist --table --headers "Image Name,PID,Session Name,Session#,Mem Usage" --json
 ```
 
-### ▶ CSV 결과(JSON 변환 포함)
+### ??CSV 결과(JSON 변???�함)
 
 ```bash
 vm_exec -d win-vm type perf.csv --csv --json
@@ -57,13 +58,13 @@ vm_exec -d win-vm type perf.csv --csv --json
 
 ---
 
-## 🗂 스크립트 파일 실행
+## ?�� ?�크립트 ?�일 ?�행
 
 ```bash
 vm_exec -l test-vm --file ./cmds.txt
 ```
 
-cmds.txt 예시:
+cmds.txt ?�시:
 
 ```
 df -h
@@ -71,7 +72,7 @@ uptime
 ps aux
 ```
 
-#### 병렬 실행 (모든 명령을 동시에 실행):
+#### 병렬 ?�행 (모든 명령???�시???�행)
 
 ```bash
 vm_exec -l test-vm --file ./cmds.txt --parallel
@@ -79,9 +80,9 @@ vm_exec -l test-vm --file ./cmds.txt --parallel
 
 ---
 
-## 🧪 출력 결과 예시
+## ?�� 출력 결과 ?�시
 
-### ▶ JSON 출력 (예시):
+### ??JSON 출력 (?�시)
 
 ```json
 {
@@ -103,16 +104,16 @@ vm_exec -l test-vm --file ./cmds.txt --parallel
 
 ---
 
-## ⚠️ 주의사항
+## ?�️ 주의?�항
 
-- guest VM 내부에 `qemu-guest-agent`가 실행 중이어야 합니다.
-- `virsh qemu-agent-command`는 VM이 실행 중이며 libvirt에서 접근 가능한 상태여야 작동합니다.
-- Windows 명령어 실행 시, 경로/권한 이슈로 인해 직접 실행(`-d`) 방식이 더 안정적인 경우가 있습니다.
+- guest VM ?��???`qemu-guest-agent`가 ?�행 중이?�야 ?�니??
+- `virsh qemu-agent-command`??VM???�행 중이�?libvirt?�서 ?�근 가?�한 ?�태?�야 ?�동?�니??
+- Windows 명령???�행 ?? 경로/권한 ?�슈�??�해 직접 ?�행(`-d`) 방식?????�정?�인 경우가 ?�습?�다.
 
 ---
 
-## 🧾 관련 파일
+## ?�� 관???�일
 
-- `vm_exec.sh`: 실행 스크립트
-- `parse_linux_table.sh`, `parse_windows_table.sh`: 테이블 파싱
-- `common.sh`: 공통 함수 모음
+- `vm_exec.sh`: ?�행 ?�크립트
+- `parse_linux_table.sh`, `parse_windows_table.sh`: ?�이�??�싱
+- `common.sh`: 공통 ?�수 모음
diff --git a/docs/v2k/v2k_events.md b/docs/v2k/v2k_events.md
index 81a0f30..3a69fd3 100644
--- a/docs/v2k/v2k_events.md
+++ b/docs/v2k/v2k_events.md
@@ -39,6 +39,6 @@
 
 ## 활용 방안
 
-- 실시간 상태 표시 대시보드
-- 외부 모니터링 연계
-- 장애 분석 및 감사 로그
+- 실시간 상태 표시 및 정보 제공
+- 외부 모니터링 시스템
+- 사후 분석 및 감사 로그
diff --git a/docs/v2k/v2k_manifest.md b/docs/v2k/v2k_manifest.md
index 527873c..9c27e0f 100644
--- a/docs/v2k/v2k_manifest.md
+++ b/docs/v2k/v2k_manifest.md
@@ -28,7 +28,7 @@
 | schema | manifest 스키마 버전 |
 | run_id | 실행 ID |
 | vm | VMware VM 식별자 |
-| target_storage_type | 타겟 스토리지 |
+| target_storage_type | 대상 스토리지 타입 |
 | target_format | 디스크 포맷 |
 | disks | 디스크 매핑 정보 |
 | phases | 단계별 상태 |
@@ -51,7 +51,7 @@
 
 ---
 
-## resume 동작
+## resume ?�작
 
-- `--resume` 옵션 시 manifest 기반으로 미완료 단계부터 재개
-- 완료 단계는 재실행되지 않음
+- `--resume` ?�션 ??manifest 기반?�로 미완�??�계부???�개
+- ?�료 ?�계???�실?�되지 ?�음
diff --git a/docs/v2k/v2k_migration.md b/docs/v2k/v2k_migration.md
index e2a7910..94e3ef4 100644
--- a/docs/v2k/v2k_migration.md
+++ b/docs/v2k/v2k_migration.md
@@ -1,13 +1,13 @@
 # ablestack_v2k
 
 `ablestack_v2k`는 VMware 기반 가상머신을 **ABLESTACK(KVM/libvirt)** 환경으로
-**CBT(Change Block Tracking)** 기반 최소 중단 방식으로 이관하기 위한 CLI 도구입니다.
+**CBT(Change Block Tracking)** 기반 최소 중단 방식으로 이전하기 위한 CLI 도구입니다.
 
 ## 주요 특징
 
 - VMware CBT 기반 base / incremental / final 동기화
-- qcow2 / raw(file) / raw(block, rbd) 타겟 지원
-- 단계별 수동 실행 및 `run(auto)` 기반 완전 자동화
+- qcow2 / raw(file) / raw(block, rbd) 대상 지원
+- 단계별 자동 실행 및 `run(auto)` 기반 전면 자동화
 - split-run (phase1 / phase2) 구조 지원
 - WinPE 기반 Windows 부트스트랩 자동화
 - manifest / events.log 기반 재개(resume)
diff --git a/docs/v2k/v2k_scenaris.md b/docs/v2k/v2k_scenaris.md
index 750dfa5..a8dbd5c 100644
--- a/docs/v2k/v2k_scenaris.md
+++ b/docs/v2k/v2k_scenaris.md
@@ -1,16 +1,18 @@
 # ablestack_v2k Operational Scenarios
 
-본 문서는 실환경에서 `ablestack_v2k`를 운영하기 위한 권장 시나리오를 정리합니다.
+이 문서는 다양한 환경에서 `ablestack_v2k`를 운영하기 위한 권장 시나리오를 정리합니다.
 
 ---
 
-## 1. 기본 자동 이관 (권장)
+## 1. 기본 자동 실행 (권장)
 
 ### 대상
-- 일반 서비스 VM
+
+- 일반 업무용 VM
 - qcow2 또는 raw(file) 스토리지
 
-### 절차
+### 실행
+
 ```bash
 ablestack_v2k run \
   --vm <VM> \
@@ -21,7 +23,8 @@ ablestack_v2k run \
 ```
 
 특징:
-- 전체 파이프라인 자동 수행
+
+- 전체 라이프사이클 자동 실행
 - 중단 시간 최소화
 - 오류 발생 시 `--resume` 가능
 
@@ -30,45 +33,48 @@ ablestack_v2k run \
 ## 2. Split-run 운영 (대규모 VM)
 
 ### Phase1 (주간/업무시간)
+
 ```bash
 ablestack_v2k run --split phase1 ...
 ```
 
-- base + incr1까지만 수행
-- 서비스 중단 없음
+- base + incr1까지만 실행
+- 업무 중단 없음
+
+### Phase2 (야간/휴일시간)
 
-### Phase2 (야간/점검시간)
 ```bash
 ablestack_v2k run --split phase2 --resume ...
 ```
 
 - 추가 incr 반복 후 cutover
-- 실제 서비스 중단 발생 구간
+- 실제 업무 중단 발생 구간
 
 ---
 
-## 3. Windows VM 이관
+## 3. Windows VM 이전
 
-- WinPE 자동 부트스트랩 기본 활성
-- virtio 드라이버 ISO 필요
-- 첫 부팅 후 장치 인식 확인 필수
+- WinPE ?�동 부?�스?�랩 기본 ?�성
+- virtio ?�라?�버 ISO ?�요
+- �?부?????�치 ?�식 ?�인 ?�수
 
 ---
 
-## 4. Block / RBD 스토리지
+## 4. Block / RBD ?�토리�?
 
-- `--target-map-json` 필수
-- 운영 환경에서는 사전 디바이스 검증 필수
-- 실수 방지를 위해 테스트 환경 선행 권장
+- `--target-map-json` ?�수
+- ?�영 ?�경?�서???�전 ?�바?�스 검�??�수
+- ?�수 방�?�??�해 ?�스???�경 ?�행 권장
 
 ---
 
-## 5. 장애 복구 전략
+## 5. ?�애 복구 ?�략
+
+- ?�업 중단 ??
 
-- 작업 중단 시:
 ```bash
 ablestack_v2k status
 ablestack_v2k run --resume
 ```
 
-- cleanup은 명시적으로 실행
+- cleanup?� 명시?�으�??�행
diff --git a/etc/ablestack-vm-hangctl.conf b/etc/ablestack-vm-hangctl.conf
index 6633184..148bca3 100644
--- a/etc/ablestack-vm-hangctl.conf
+++ b/etc/ablestack-vm-hangctl.conf
@@ -21,15 +21,13 @@ HANGCTL_VIRSH_TIMEOUT_SEC="3"
 HANGCTL_QMP_TIMEOUT_SEC="5"
 HANGCTL_QGA_TIMEOUT_SEC="5"
 
-# 가상머신 상태별 행(Hang) 판단 임계치 (초 단위)
-# Running 상태가 유지될 때 (QMP 응답 없음 등)
+# 가?�머???�태�???Hang) ?�단 ?�계�?(�??�위)
+# Running ?�태가 ?��?????(QMP ?�답 ?�음 ??
 HANGCTL_CONFIRM_WINDOW_SEC="120"
 
-# Paused 상태가 유지될 때 (사용자가 중지한 것이 아니라면 문제로 간주)
-# 필요에 따라 Running보다 길거나 짧게 설정 가능
-HANGCTL_PAUSED_CONFIRM_WINDOW_SEC="300"
-HANGCTL_MIGRATION_CONFIRM_WINDOW_SEC="3600" # 30분
-HANGCTL_MIGRATION_PROGRESS_CHECK_SEC="300"  # 5분간 데이터 변화 확인
+# Paused ?�태가 ?��?????(?�용?��? 중�???것이 ?�니?�면 문제�?간주)
+# ?�요???�라 Running보다 길거??짧게 ?�정 가??HANGCTL_PAUSED_CONFIRM_WINDOW_SEC="300"
+HANGCTL_MIGRATION_CONFIRM_WINDOW_SEC="3600" # 30�?HANGCTL_MIGRATION_PROGRESS_CHECK_SEC="300"  # 5분간 ?�이??변???�인
 
 HANGCTL_LOG_MAX_SIZE_MB="100"
 HANGCTL_LOG_ROTATE_COUNT="5"
diff --git a/examples/v2k/govc.env.example b/examples/v2k/govc.env.example
index b154c3b..37402c0 100644
--- a/examples/v2k/govc.env.example
+++ b/examples/v2k/govc.env.example
@@ -1,10 +1,10 @@
-# govc 환경변수 예시 (vCenter/govc 전용)
-# - snapshot/inventory/CBT 관리에 사용됩니다.
-# - VDDK(ESXi 데이터 전송) 인증은 별도 vddk.cred.example 파일을 사용하세요.
+# govc ?�경변???�시 (vCenter/govc ?�용)
+# - snapshot/inventory/CBT 관리에 ?�용?�니??
+# - VDDK(ESXi ?�이???�송) ?�증?� 별도 vddk.cred.example ?�일???�용?�세??
 
 export GOVC_URL="https://vcenter.example.local/sdk"
 export GOVC_USERNAME="administrator@vsphere.local"
 export GOVC_PASSWORD="***"
 
-# TLS 검증을 끄는 옵션 (운영 정책에 맞춰 0/1 선택)
+# TLS 검증을 ?�는 ?�션 (?�영 ?�책??맞춰 0/1 ?�택)
 export GOVC_INSECURE=1
diff --git a/examples/v2k/runbook.md b/examples/v2k/runbook.md
index 1735905..ef4df07 100644
--- a/examples/v2k/runbook.md
+++ b/examples/v2k/runbook.md
@@ -1,62 +1,65 @@
 # v2k Runbook (Operator)
 
-이 문서는 `ablestack_v2k` 기반 VMware → ABLESTACK(KVM) 최소 중단 마이그레이션을 운영 절차로 정리한 Runbook 입니다.  
+이 문서는 `ablestack_v2k` 기반 VMware → ABLESTACK(KVM) 최소 중단 마이그레이션의 운영 과정을 정리한 Runbook 입니다.
 (기본 정책: **final 단계는 shutdown 후 final snapshot 생성**)
 
 ---
 
-## 0. 목적과 범위
+## 0. 목적 및 범위
 
-본 Runbook은 `ablestack_v2k` 기반으로 **VMware → ABLESTACK(KVM)** 최소 중단 마이그레이션을 수행하기 위한 **운영 절차 문서**이다.
+이 Runbook은 `ablestack_v2k` 기반으로 **VMware → ABLESTACK(KVM)** 최소 중단 마이그레이션을 수행하기 위한 **운영 과정 문서**이다.
 
 - 대상: 운영 환경 VM
 - 방식: CBT + Snapshot + NBDKit(VDDK)
-- 원칙: **final 단계는 반드시 VM shutdown 이후 수행**
+- 원칙: **final 단계는 반드시 VM shutdown 후 진행**
 
 ---
 
-## 1. 사전 점검(Go / No-Go)
+## 1. 사전 검증(Go / No-Go)
 
 ### 1.1 VMware 측
-- [ ] VM에 CBT 활성화 가능 상태 (스냅샷/디스크 잠금 이슈 없음)
-- [ ] vCenter 접근 계정 준비 (govc 전용)
-- [ ] ESXi 접근 계정 준비 (VDDK 전용)
-- [ ] VM 디스크/컨트롤러 구성 확인 (SCSI 권장)
+
+- [ ] VM의 CBT 활성화 가능 상태 (스냅샷 기반 증분 이슈 없음)
+- [ ] vCenter 접근 계정 준비(govc 사용)
+- [ ] ESXi 접근 계정 준비(VDDK 사용)
+- [ ] VM 디스크 컨트롤러 구성 확인 (SCSI 권장)
 - [ ] Windows VM의 경우 Fast Startup / Hibernation 비활성화 권장
 
 ### 1.2 KVM(ABLESTACK) 측
-- [ ] 대상 스토리지 경로 확보 (예: `/var/lib/libvirt/images/<VM>`)
-- [ ] 필수 도구 설치: `qemu-img`, `virsh`, `jq`, `python3`
+
+- [ ] 대상 스토리지 경로 준비 (예: `/var/lib/libvirt/images/<VM>`)
+- [ ] 필수 패키지 설치: `qemu-img`, `virsh`, `jq`, `python3`
 - [ ] `nbdkit` 설치 및 실행 가능
 - [ ] VMware VDDK 라이브러리 설치
-- [ ] ESXi ↔ KVM 호스트 간 네트워크 통신 가능 (443/TCP)
+- [ ] ESXi ↔ KVM 호스트 간 네트워크 연결 가능(443/TCP)
 
 ---
 
 ## 2. 인증 구조 개요 (중요)
 
-본 파이프라인은 **인증을 명확히 분리**한다.
+라이프사이클에서 **인증을 명확히 분리**한다.
 
-| 구분 | 용도 | 사용 위치 |
+| 구분 | 용도 | 사용 계정 |
 |---|---|---|
 | GOVC (vCenter) | Inventory, Snapshot, CBT | `govc`, `pyvmomi` |
 | VDDK (ESXi) | 디스크 데이터 전송 | `nbdkit-vddk` |
 
-> ⚠️ **GOVC 계정 ≠ VDDK 계정**  
-> VDDK 단계에서 vCenter 계정을 사용하는 것은 제품 정책상 허용하지 않는다.
+> ⚠️ **GOVC 계정 ≠ VDDK 계정**
+> VDDK 계정에서 vCenter 계정을 사용하는 것이 제품 정책상 허용되지 않거나 권장되지 않음
 
 ---
 
 ## 3. 사전 환경 변수 및 인증 파일 준비
 
-### 3.1 vCenter (GOVC) 환경 변수
+### 3.1 vCenter (GOVC) ?�경 변??
 
 ```bash
 # vCenter API / Snapshot / CBT 관리용
 source examples/v2k/govc.env.example
 ```
 
-포함 항목:
+?�함 ??��:
+
 - `GOVC_URL`
 - `GOVC_USERNAME`
 - `GOVC_PASSWORD`
@@ -64,28 +67,29 @@ source examples/v2k/govc.env.example
 
 ---
 
-### 3.2 ESXi (VDDK) 인증 파일 생성
+### 3.2 ESXi (VDDK) ?�증 ?�일 ?�성
 
-VDDK는 **ESXi 호스트에 직접 접속**하여 디스크 데이터를 읽는다.
+VDDK??**ESXi ?�스?�에 직접 ?�속**?�여 ?�스???�이?��? ?�는??
 
 ```bash
 # examples/v2k/vddk.cred
 VDDK_USER="root"
 VDDK_PASSWORD="********"
 
-# (선택) 접속 주소 override
-# 지정 시 manifest의 .source.vddk.server 로 기록됨
+# (?�택) ?�속 주소 override
+# 지????manifest??.source.vddk.server �?기록??
 # VDDK_SERVER="10.10.10.21"
 ```
 
-보안 정책:
-- init 시 workdir로 복사
+보안 ?�책:
+
+- init ??workdir�?복사
 - 권한: `600`
-- manifest에는 **경로만 기록** (비밀번호 저장 안 함)
+- manifest?�는 **경로�?기록** (비�?번호 ?�??????
 
 ---
 
-### 3.3 기타 필수 환경 변수
+### 3.3 기�? ?�수 ?�경 변??
 
 ```bash
 export VMNAME="vmA"
@@ -96,19 +100,20 @@ export VDDK_CRED="./examples/v2k/vddk.cred"
 
 ---
 
-## 4. Init 단계 (Inventory + Manifest 생성)
+## 4. Init ?�계 (Inventory + Manifest ?�성)
 
 ```bash
 sudo ablestack_v2k init   --vm "${VMNAME}"   --vcenter "${GOVC_URL}"   --dst "${DST}"   --vddk-cred-file "${VDDK_CRED}"
 ```
 
-Init 단계에서 자동 수행되는 작업:
-- VM inventory 수집
-- 실행 중인 ESXi host 탐색
-- ESXi management IP 자동 결정
-- manifest.json 생성
-- `vddk.cred`를 workdir로 안전하게 복사
-- `.source.vddk.*`, `.source.esxi_*` 필드 구성
+Init ?�계?�서 ?�동 ?�행?�는 ?�업:
+
+- VM inventory ?�집
+- ?�행 중인 ESXi host ?�색
+- ESXi management IP ?�동 결정
+- manifest.json ?�성
+- `vddk.cred`�?workdir�??�전?�게 복사
+- `.source.vddk.*`, `.source.esxi_*` ?�드 구성
 
 ---
 
@@ -128,29 +133,30 @@ sudo ablestack_v2k --workdir <workdir> snapshot base
 sudo ablestack_v2k --workdir <workdir> sync base --jobs 4
 ```
 
-- Base sync는 전체 디스크 전송
-- 가장 오래 걸리므로 야간/저부하 시간대 권장
+- Base sync???�체 ?�스???�송
+- 가???�래 걸리므�??�간/?�부???�간?� 권장
 
 ---
 
-## 7. Incremental Loop (업무 중 반복)
+## 7. Incremental Loop (?�무 �?반복)
 
 ```bash
 sudo ablestack_v2k --workdir <workdir> snapshot incr
 sudo ablestack_v2k --workdir <workdir> sync incr --jobs 4
 ```
 
-컷오버 판단 기준:
-- incr 변경량이 충분히 감소
-- 마지막 incr sync 시간이 허용 범위 이내
+컷오�??�단 기�?:
+
+- incr 변경량??충분??감소
+- 마�?�?incr sync ?�간???�용 범위 ?�내
 
 ---
 
 ## 8. Cutover (Shutdown + Final Sync)
 
-1) VMware VM 종료 (운영자 확인)
+1) VMware VM 종료 (?�영???�인)
 
-2) Cutover 실행
+2) Cutover ?�행
 
 ```bash
 sudo ablestack_v2k --workdir <workdir> cutover --define-only --start
@@ -174,17 +180,20 @@ sudo ablestack_v2k --workdir <workdir> cleanup --keep-workdir
 
 ---
 
-## 11. 트러블슈팅 (VDDK 중심)
+## 11. ?�러블슈??(VDDK 중심)
+
+### VDDK ?�증 ?�패
 
-### VDDK 인증 실패
-- `vddk.cred`의 `VDDK_USER / VDDK_PASSWORD` 확인
-- ESXi Lockdown Mode 여부 확인
-- `.source.vddk.server` 우선 사용 여부 확인
+- `vddk.cred`??`VDDK_USER / VDDK_PASSWORD` ?�인
+- ESXi Lockdown Mode ?��? ?�인
+- `.source.vddk.server` ?�선 ?�용 ?��? ?�인
 - fallback: `.source.esxi_host`
 
-### govc 오류
-- `GOVC_*` 환경 변수 확인
+### govc ?�류
+
+- `GOVC_*` ?�경 변???�인
+
+### ?�능 ?�슈
 
-### 성능 이슈
 - `--jobs` 조정
-- 네트워크 병목 확인
+- ?�트?�크 병목 ?�인
diff --git a/examples/v2k/vddk.cred.example b/examples/v2k/vddk.cred.example
index 1bb2cd4..56277cd 100644
--- a/examples/v2k/vddk.cred.example
+++ b/examples/v2k/vddk.cred.example
@@ -1,15 +1,15 @@
-# VDDK(ESXi) 자격증명 예시
-# - nbdkit-vddk가 ESXi에 직접 접속할 때 사용하는 계정/비밀번호입니다.
-# - vCenter(GOVC_*) 계정과 분리됩니다.
+# VDDK(ESXi) ?�격증명 ?�시
+# - nbdkit-vddk가 ESXi??직접 ?�속?????�용?�는 계정/비�?번호?�니??
+# - vCenter(GOVC_*) 계정�?분리?�니??
 
-# ESXi 로그인 계정 (예: root 또는 권한 있는 계정)
+# ESXi 로그??계정 (?? root ?�는 권한 ?�는 계정)
 VDDK_USER="root"
 
-# ESXi 로그인 비밀번호
+# ESXi 로그??비�?번호
 VDDK_PASSWORD="***"
 
-# (선택) VDDK 서버 override
-# - 네트워크/방화벽/포트포워딩 등으로 인해, inventory에서 얻은 esxi_host 대신
-#   특정 주소로 붙어야 하는 경우에만 설정하세요.
-# - 설정 시 manifest: .source.vddk.server 로 반영됩니다.
+# (?�택) VDDK ?�버 override
+# - ?�트?�크/방화�??�트?�워???�으�??�해, inventory?�서 ?��? esxi_host ?�??
+#   ?�정 주소�?붙어???�는 경우?�만 ?�정?�세??
+# - ?�정 ??manifest: .source.vddk.server �?반영?�니??
 # VDDK_SERVER="10.10.10.10"
diff --git a/examples/vm_exec_example.sh b/examples/vm_exec_example.sh
index 3c8ed6c..a97e9db 100644
--- a/examples/vm_exec_example.sh
+++ b/examples/vm_exec_example.sh
@@ -18,17 +18,17 @@
 
 # 이 스크립트는 vm_exec 명령의 사용 예시를 보여줍니다.
 
-echo "▶ Linux VM: ps aux 출력 파싱 (table + headers + json)"
+echo "Linux VM: ps aux 출력 파싱 (table + headers + json)"
 vm_exec -l ubuntu-vm ps aux --table --headers "USER,PID,%CPU,%MEM,COMMAND" --json
 
 echo ""
-echo "▶ Windows VM: tasklist 출력 파싱"
+echo "Windows VM: tasklist 출력 파싱"
 vm_exec -w win10-vm tasklist --table --headers "Image Name,PID,Session Name,Session#,Mem Usage" --json
 
 echo ""
-echo "▶ 스크립트 파일 실행 예시 (serial)"
+echo "스크립트 파일 실행 예시 (serial)"
 vm_exec -l centos-vm --file ./examples/commands.txt
 
 echo ""
-echo "▶ 스크립트 파일 실행 예시 (parallel)"
+echo "스크립트 파일 실행 예시 (parallel)"
 vm_exec -l centos-vm --file ./examples/commands.txt --parallel
diff --git a/install.sh b/install.sh
index cb76a73..d068e19 100644
--- a/install.sh
+++ b/install.sh
@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 #
-# install.sh - ablestack-qemu-exec-tools 설치 스크립트 (통합)
+# install.sh - ablestack-qemu-exec-tools 설치 스크립트 (개발/소스 설치용)
 # (dev/source install 용)
 #
 # Copyright 2025 ABLECLOUD
@@ -27,14 +27,10 @@ LIB_SRC="lib"
 BIN_SRC="bin"
 SYSTEMD_UNIT_DIR="/etc/systemd/system"
 
-ISO_DEFAULT_DIR="/usr/share/ablestack/tools"   # ISO가 존재해야 하는 디렉토리
+ISO_DEFAULT_DIR="/usr/share/ablestack/tools"   # ISO가 존재해야 하는 기본 디렉터리 (vm_autoinstall에서 ISO_PATH_DEFAULT로 참조) - 설치 시 생성 및 안내
 ISO_DEFAULT_PATH="${ISO_DEFAULT_DIR}/ablestack-qemu-exec-tools.iso"
 
-# ───────────────────────────────────────────────────────────
 # ABLESTACK Host 감지
-#   - /etc/os-release 의 PRETTY_NAME 이 "ABLESTACK" 으로 시작하면 HOST 모드
-#   - 그 외는 일반 VM 모드
-# ───────────────────────────────────────────────────────────
 is_ablestack_host() {
   if [[ -f /etc/os-release ]]; then
     if grep -q '^PRETTY_NAME="ABLESTACK' /etc/os-release; then
@@ -45,18 +41,16 @@ is_ablestack_host() {
 }
 
 if is_ablestack_host; then
-  echo "▶ ABLESTACK Host 환경 감지됨 — 호스트 전용 모드로 설치합니다."
+  echo "ABLESTACK Host 환경 감지됨: 서비스용 모드로 설치합니다."
   INSTALL_MODE="HOST"
 else
-  echo "▶ 일반 Linux VM 환경 감지됨 — 전체 도구 모드로 설치합니다."
+  echo "일반 Linux VM 환경 감지됨: 자체 구성 모드로 설치합니다."
   INSTALL_MODE="VM"
 fi
 
-echo "▶ ablestack-qemu-exec-tools 설치를 시작합니다..."
+echo "ablestack-qemu-exec-tools 설치를 시작합니다.."
 
-# ───────────────────────────────────────────────────────────
-# 0) 필수/권장 의존성 점검 (부재 시 설치 중단보다는 경고)
-# ───────────────────────────────────────────────────────────
+# 0) 필수/권장 존재 여부 (부족시 설치 중단보다는 경고)
 MISSING=()
 
 need_cmd() {
@@ -64,40 +58,38 @@ need_cmd() {
   command -v "$c" >/dev/null 2>&1 || MISSING+=("$c")
 }
 
-# 필수
+# 필수 명령어
 need_cmd jq
 need_cmd virsh
 
-# 오프라인 주입 관련 권장(실제 기능에 필요)
-# NOTE: hangctl는 시스템 운영 도구이므로, 아래 권장 도구 유무와 무관하게 설치 가능
-#       (의존성은 런타임 환경에서 개별 충족)
+# 게스트 인젝션 관련 권장(자체 기능 필요)
+# NOTE: hangctl의 서비스 운영 구성에서 이들 권장 구성 업무를 무시하게 설치 가능
+#       (존재 여부에 따라 개별 충족)
 need_cmd virt-inspector
 need_cmd virt-copy-in
 need_cmd virt-customize
 need_cmd virt-win-reg
 
-# 선택(있으면 detach나 XML 조작이 더 안정적)
-# need_cmd virt-xml   # 권장이나 강제는 아님
+# 선택(그러나 detach나 XML 조작에 필요)
+# need_cmd virt-xml   # 권장이나 강제 아님
 
 if ((${#MISSING[@]})); then
-  echo "❌ 다음 명령이 필요합니다: ${MISSING[*]}"
-  echo "   Rocky 9 예) dnf -y install jq libvirt-client libguestfs-tools virt-install"
+  echo "다음 명령이 필요합니다: ${MISSING[*]}"
+  echo "   Rocky 9 에서 dnf -y install jq libvirt-client libguestfs-tools virt-install"
   exit 1
 fi
 
-# ───────────────────────────────────────────────────────────
-# 1) 실행 파일 설치/업데이트
+# 1) 실행 파일 설치
 #    - vm_exec.sh / agent_policy_fix.sh / cloud_init_auto.sh (기존)
-#    - vm_autoinstall.sh (신규)
+#    - vm_autoinstall.sh (규칙)
 #    링크 생성 시 .sh 확장자 제거 (vm_exec, agent_policy_fix, cloud_init_auto, vm_autoinstall)
-#    ※ ABLESTACK Host 에서는 vm_exec, vm_autoinstall 만 노출
-# ───────────────────────────────────────────────────────────
+#    ABLESTACK Host 에서 vm_exec, vm_autoinstall 등 호출
 
 if [[ "$INSTALL_MODE" == "HOST" ]]; then
-  # ABLESTACK Host: 최소 도구만 설치
+  # ABLESTACK Host: 최소 구성으로 설치
   BIN_SCRIPTS=("vm_exec.sh" "vm_autoinstall.sh" "ablestack_v2k.sh" "ablestack_vm_hangctl.sh" "v2k_test_install.sh")
 else
-  # 일반 VM: 전체 도구 설치
+  # 일반 VM: 자체 구성으로 설치
   BIN_SCRIPTS=("vm_exec.sh" "agent_policy_fix.sh" "cloud_init_auto.sh" "vm_autoinstall.sh" "ablestack_v2k.sh" "ablestack_vm_hangctl.sh" "v2k_test_install.sh")
 fi
 
@@ -105,7 +97,7 @@ for script in "${BIN_SCRIPTS[@]}"; do
   src="${BIN_SRC}/${script}"
   target="${BIN_DIR}/${script%.sh}"  # .sh 확장자 제거
   if [[ -f "$src" ]]; then
-    echo "➤ 실행 파일 링크 생성: $target -> $(pwd)/$src"
+    echo "실행 파일 링크 생성: $target -> $(pwd)/$src"
     mkdir -p "$(dirname "$target")"
     ln -sf "$(pwd)/$src" "$target"
     chmod +x "$src"
@@ -114,42 +106,39 @@ for script in "${BIN_SCRIPTS[@]}"; do
   fi
 done
 
-# ───────────────────────────────────────────────────────────
 # 2) 라이브러리 및 페이로드 설치
-#    - lib/*  →  ${LIB_TARGET}/
-#    - payload/* → ${LIB_TARGET}/payload/
-#    (오프라인 주입 스크립트가 payload를 참조)
-# ───────────────────────────────────────────────────────────
-echo "➤ 라이브러리 설치 경로: ${LIB_TARGET}"
+#    - lib/*  -> ${LIB_TARGET}/
+#    - payload/* -> ${LIB_TARGET}/payload/
+#    (게스트 인젝션 스크립트가 payload를 참조)
+
+echo "라이브러리 설치 경로: ${LIB_TARGET}"
 mkdir -p "$LIB_TARGET"
 if [[ -d "$LIB_SRC" ]]; then
   # 파일 복사
   cp -a "$LIB_SRC/"* "$LIB_TARGET/" 2>/dev/null || true
 
-  # 셸 스크립트 실행 권한 부여 (lib/*.sh, lib/**/**/*.sh)
+  # 모든 스크립트 실행 권한 부여(lib/*.sh, lib/**/**/*.sh)
   find "$LIB_TARGET" -type f -name "*.sh" -exec chmod 755 {} \;
 
-  # (참고) 서비스/PS1 등은 실행권한 필요 없음. 읽기권한만 보장
+  # (참고) 바이너리 PS1 등은 실행권한 필요 없음. 기본권한으로 보장
   find "$LIB_TARGET" -type f \( -name "*.service" -o -name "*.ps1" \) -exec chmod 644 {} \; 2>/dev/null || true
 else
-  echo "⚠️  라이브러리 소스 디렉토리 미존재: $LIB_SRC"
+  echo "⚠️  라이브러리 소스 디렉터리 미존재: $LIB_SRC"
 fi
 
 #
-# ───────────────────────────────────────────────────────────
-# 2.1) hangctl(systemd/config) 추가 설치 (dev/source install)
+# 2.1) hangctl 관련 시스템 서비스/타이머 유닛 및 기본 설정 설치
 #   - unit: lib/hangctl/systemd/*.service|*.timer -> /etc/systemd/system/
 #   - config(default): etc/ablestack-vm-hangctl.conf -> /etc/ablestack/ablestack-vm-hangctl.conf (noreplace)
-#   - enable/start는 하지 않음(운영 정책은 사용자가 결정)
-# ───────────────────────────────────────────────────────────
+#   - enable/start 여부는 아님(운영 책무에 따라 결정)
 HANGCTL_DEFAULT_CONF_SRC="etc/ablestack-vm-hangctl.conf"
 HANGCTL_DEFAULT_CONF_DST="/etc/ablestack/ablestack-vm-hangctl.conf"
 HANGCTL_UNIT_SRC_DIR="${LIB_SRC}/hangctl/systemd"
 
 if [[ -d "${HANGCTL_UNIT_SRC_DIR}" ]]; then
-  echo "➤ hangctl systemd unit 설치: ${SYSTEMD_UNIT_DIR}"
+  echo "hangctl systemd unit 설치: ${SYSTEMD_UNIT_DIR}"
   sudo mkdir -p "${SYSTEMD_UNIT_DIR}"
-  # service/timer만 복사
+  # service/timer 복사
   if ls "${HANGCTL_UNIT_SRC_DIR}"/*.service >/dev/null 2>&1; then
     sudo cp -a "${HANGCTL_UNIT_SRC_DIR}"/*.service "${SYSTEMD_UNIT_DIR}/"
     sudo chmod 644 "${SYSTEMD_UNIT_DIR}"/*.service 2>/dev/null || true
@@ -160,71 +149,67 @@ if [[ -d "${HANGCTL_UNIT_SRC_DIR}" ]]; then
   fi
   sudo systemctl daemon-reload 2>/dev/null || true
 else
-  echo "⚠️  hangctl systemd unit 소스 디렉토리 미존재(건너뜀): ${HANGCTL_UNIT_SRC_DIR}"
+  echo "⚠️  hangctl systemd unit 소스 디렉터리 미존재(건너뜀): ${HANGCTL_UNIT_SRC_DIR}"
 fi
 
 if [[ -f "${HANGCTL_DEFAULT_CONF_SRC}" ]]; then
-  echo "➤ hangctl 기본 설정 설치(존재 시 유지): ${HANGCTL_DEFAULT_CONF_DST}"
+  echo "hangctl 기본 설정 설치(존재 확인): ${HANGCTL_DEFAULT_CONF_DST}"
   sudo mkdir -p "$(dirname "${HANGCTL_DEFAULT_CONF_DST}")"
   if [[ -f "${HANGCTL_DEFAULT_CONF_DST}" ]]; then
-    echo "   ✅ 기존 설정 존재: ${HANGCTL_DEFAULT_CONF_DST} (덮어쓰지 않음)"
+    echo "   기존 설정 존재: ${HANGCTL_DEFAULT_CONF_DST} (덮어쓰지 않음)"
   else
     sudo cp -a "${HANGCTL_DEFAULT_CONF_SRC}" "${HANGCTL_DEFAULT_CONF_DST}"
     sudo chmod 644 "${HANGCTL_DEFAULT_CONF_DST}" 2>/dev/null || true
-    echo "   ✅ 설치 완료: ${HANGCTL_DEFAULT_CONF_DST}"
+    echo "   설치 완료: ${HANGCTL_DEFAULT_CONF_DST}"
   fi
 else
   echo "⚠️  hangctl 기본 설정 템플릿 없음(건너뜀): ${HANGCTL_DEFAULT_CONF_SRC}"
 fi
 
-echo "➤ 페이로드 설치 경로: ${LIB_TARGET}/payload"
+echo "페이로드 설치 경로: ${LIB_TARGET}/payload"
 mkdir -p "${LIB_TARGET}/payload"
 if [[ -d "$PAYLOAD_SRC" ]]; then
-  # 전체 payload를 덮어쓰기
+  # 전체 payload 복사 수행
   rsync -a "$PAYLOAD_SRC/"" " "${LIB_TARGET}/payload/" 2>/dev/null || cp -a "$PAYLOAD_SRC/"* "${LIB_TARGET}/payload/" 2>/dev/null || true
 else
-  echo "⚠️  페이로드 소스 디렉토리 미존재: $PAYLOAD_SRC"
+  echo "⚠️  페이로드 소스 디렉터리 미존재: $PAYLOAD_SRC"
 fi
 
-# ───────────────────────────────────────────────────────────
-# 3) ISO 기본 경로 안내/생성
-# ───────────────────────────────────────────────────────────
-echo "➤ ISO 기본 경로 확인: ${ISO_DEFAULT_DIR}"
+# 3) ISO 기본 경로 확인/생성 및 안내
+echo "ISO 기본 경로 확인: ${ISO_DEFAULT_DIR}"
 mkdir -p "${ISO_DEFAULT_DIR}"
 if [[ -f "${ISO_DEFAULT_PATH}" ]]; then
-  echo "   ✅ ISO 존재: ${ISO_DEFAULT_PATH}"
+  echo "   ISO 존재: ${ISO_DEFAULT_PATH}"
 else
   echo "   ⚠️  ISO가 없습니다: ${ISO_DEFAULT_PATH}"
-  echo "      - GitHub Actions 산출물을 이 경로로 배치하거나,"
-  echo "      - 다른 경로를 사용할 경우 vm_autoinstall에서 환경변수 ISO_PATH_DEFAULT로 지정하세요."
+  echo "      - GitHub Actions 출력물을 이 경로에 배치하거나"
+  echo "      - 다른 경로를 사용할 경우 vm_autoinstall에서 환경변수 ISO_PATH_DEFAULT를 지정하세요."
 fi
 
-# ───────────────────────────────────────────────────────────
-# 4) 환경 파일(선택): 라이브 경로/ISO 경로 힌트 제공
-# ───────────────────────────────────────────────────────────
+# 4) 환경 설정 파일 생성
 PROFILE_D="/etc/profile.d/ablestack-qemu-exec-tools.sh"
-echo "➤ 환경설정 힌트: ${PROFILE_D}"
+echo "환경설정 파일: ${PROFILE_D}"
 cat <<EOF | sudo tee "${PROFILE_D}" >/dev/null
 # ablestack-qemu-exec-tools env (hint)
 export ABLESTACK_QEMU_EXEC_TOOLS_HOME="${LIB_TARGET}"
 export ISO_PATH_DEFAULT="${ISO_DEFAULT_PATH}"
 EOF
 
-echo "✅ 설치 완료!"
+echo "설치 완료!"
 
 echo ""
 echo "사용 예시:"
-echo "  vm_autoinstall <domain>     # ISO 핫플러그 + (QGA 있으면 온라인) / (없으면 오프라인 주입+부팅)"
-echo "  vm_exec                      # 게스트 내부 명령 실행(QGA 필요)"
+echo "  vm_autoinstall <domain>     # ISO 기반 게스트 자동 설치 (vm_autoinstall.sh)"
+echo "  vm_exec                      # 게스트 시스템 명령 실행(QGA 필요)"
 echo ""
 echo "  ablestack_vm_hangctl health  # libvirtd 상태 점검"
-echo "  ablestack_vm_hangctl scan    # VM hang 스캔/조치(설정 기반)"
+echo "  ablestack_vm_hangctl scan    # VM hang 스캔 (domstate 및 QMP 기반)"
 echo ""
-echo "systemd(개발 설치 시 유닛만 배치, enable은 수동):"
+echo "systemd(개발 설치 시 유닛으로 배치, enable후 시동):"
 echo "  systemctl enable --now ablestack-vm-hangctl.timer"
 echo "  systemctl status ablestack-vm-hangctl.timer --no-pager -l"
 echo ""
 echo "참고:"
-echo "  - 오프라인 주입 스크립트는 ${LIB_TARGET}/payload/* 를 사용합니다."
+echo "  - 게스트 인젝션 스크립트는 ${LIB_TARGET}/payload/* 에서 사용합니다."
 echo "  - ISO는 ${ISO_DEFAULT_PATH} 에 존재해야 합니다."
-echo "  - Windows: ISO 루트의 install.bat 실행 / Linux: install-linux.sh 실행"
+echo "  - Windows: ISO 루트에 install.bat 실행 / Linux: install-linux.sh 실행"
diff --git a/lib/cloud_init_common.sh b/lib/cloud_init_common.sh
index 11a7f4c..99561e2 100644
--- a/lib/cloud_init_common.sh
+++ b/lib/cloud_init_common.sh
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/bin/bash
 #
 # ablestack-qemu-exec-tools cloud_init_common.sh
 #
@@ -57,11 +57,11 @@ install_cloud_init() {
 
     case "$os_id" in
         rocky|rhel|centos|almalinux)
-            msg "[INFO] cloud-init을 yum으로 설치합니다." "[INFO] Installing cloud-init with yum."
+            msg "[INFO] cloud-init를 yum으로 설치합니다." "[INFO] Installing cloud-init with yum."
             sudo yum install -y cloud-init
             ;;
         ubuntu|debian)
-            msg "[INFO] cloud-init을 apt로 설치합니다." "[INFO] Installing cloud-init with apt."
+            msg "[INFO] cloud-init를 apt로 설치합니다." "[INFO] Installing cloud-init with apt."
             sudo apt-get update
             sudo apt-get install -y cloud-init
             ;;
@@ -83,7 +83,7 @@ set_metadata_provider_configdrive_cloudstack() {
     # cloud.cfg.d가 없으면 생성
     sudo mkdir -p "$CFGD_DIR"
 
-    # 기존 datasource_list 삭제(충돌 방지)
+    # 기존 datasource_list 제거(충돌 방지)
     sudo sed -i '/^datasource_list:/d' "$MAIN_CFG" 2>/dev/null
 
     # 99_ablestack_datasource.cfg에 datasource_list 작성 (최우선 적용)
@@ -97,20 +97,17 @@ datasource:
   None: {}
 EOF
 
-    # cloud-init 초기화
-    sudo cloud-init clean --logs
-
-    # ds-identify.cfg에 policy: enabled 기록 (기존 내용 제거 후 새로 작성)
+    # ds-identify.cfg에 policy: enabled 기록 (기존 내용 제거 후 새로 생성)
     echo "policy: enabled" | sudo tee "$DSIDENTIFY_CFG" >/dev/null
 
-    msg "[INFO] metadata provider를 ConfigDrive, CloudStack, None 지정 완료" "[INFO] Metadata provider specified as ConfigDrive, CloudStack, None"
+    msg "[INFO] metadata provider를 ConfigDrive, CloudStack, None으로 지정 완료" "[INFO] Metadata provider specified as ConfigDrive, CloudStack, None"
 }
 
 patch_cloud_cfg_users_root() {
     CFG="/etc/cloud/cloud.cfg"
     sudo cp -a "$CFG" "$CFG.ablestack.bak"
 
-    # 시스템 ID 추출
+    # 호스트 OS ID 추출
     if [ -f /etc/os-release ]; then
         . /etc/os-release
         os_id="${ID,,}"
@@ -127,7 +124,7 @@ patch_cloud_cfg_users_root() {
             in_sysinfo=1
             sysinfo_done=1
             echo "$line" >> "$TMP"
-            # 다음 줄에 원하는 내용을 직접 추가
+            # 다음 줄에 필요한 내용을 직접 추가
             echo "  # This will affect which distro class gets used" >> "$TMP"
             echo "  distro: $os_id" >> "$TMP"
             echo "  # Default user name + that default users groups (if added/used)" >> "$TMP"
@@ -148,20 +145,22 @@ patch_cloud_cfg_users_root() {
             # system_info 아래 기존 내용은 모두 스킵
             continue
         fi
+
         # system_info 블록 내부는 건너뜀
         if [[ $in_sysinfo -eq 1 ]]; then
-            # 다음 상위 섹션(비인덴트 줄, 예: #, users:, cloud_init_modules:)에서 끝냄
+            # 다음 상위 섹션(비인덴트 줄)에서 빠져나감
             if [[ "$line" =~ ^[^[:space:]] ]]; then
                 in_sysinfo=0
                 echo "$line" >> "$TMP"
             fi
             continue
         fi
+
         # 나머지 줄은 그대로 복사
         echo "$line" >> "$TMP"
     done < "$CFG"
 
-    # 만약 system_info가 아예 없었다면, 마지막에 추가
+    # system_info가 아예 없었으면 파일 마지막에 추가
     if [[ $sysinfo_done -eq 0 ]]; then
         echo "" >> "$TMP"
         echo "system_info:" >> "$TMP"
@@ -182,30 +181,28 @@ patch_cloud_cfg_users_root() {
         echo "    cloud_dir: /var/lib/cloud/" >> "$TMP"
         echo "    templates_dir: /etc/cloud/templates/" >> "$TMP"
         echo "  ssh_svcname: sshd" >> "$TMP"
-
     fi
 
     sudo mv "$TMP" "$CFG"
 
-    msg "[INFO] system_info 블록(distro, default_user)만 패치 완료, users는 그대로 유지" \
+    msg "[INFO] system_info 블록(distro, default_user)만 수정 완료, users는 그대로 유지" \
         "[INFO] Only patched system_info block (distro, default_user); users left as-is"
 
-    # 2. disable_root: 값을 false로 교체 (존재시 치환, 없으면 루트 레벨 마지막에 추가)
+    # disable_root 값을 false로 교체 (존재 시 치환, 없으면 루트 레벨 마지막에 추가)
     if grep -q '^disable_root:' "$CFG"; then
         sudo sed -i 's/^disable_root:.*$/disable_root: false/' "$CFG"
     else
-        # 맨 마지막 users: 뒤가 아니라, 파일 마지막에 추가
         echo "disable_root: false" | sudo tee -a "$CFG" >/dev/null
     fi
 
-    # 3. ssh_pwauth: 값을 true로 교체 (존재시 치환, 없으면 루트 레벨 마지막에 추가)
+    # ssh_pwauth 값을 true로 교체 (존재 시 치환, 없으면 루트 레벨 마지막에 추가)
     if grep -q '^ssh_pwauth:' "$CFG"; then
         sudo sed -i 's/^ssh_pwauth:.*$/ssh_pwauth: true/' "$CFG"
     else
         echo "ssh_pwauth: true" | sudo tee -a "$CFG" >/dev/null
     fi
 
-    msg "[INFO] users, disable_root, ssh_pwauth 항목이 root/false/true로 패치 완료" \
+    msg "[INFO] users, disable_root, ssh_pwauth 항목을 root/false/true로 수정 완료" \
         "[INFO] users, disable_root, ssh_pwauth have been patched to root/false/true"
 }
 
@@ -213,7 +210,7 @@ patch_cloud_init_and_config_modules_frequency_partial() {
     CFG="/etc/cloud/cloud.cfg"
     sudo cp -a "$CFG" "$CFG.ablestack.bak.freq"
 
-    # 각 블록별 패치 대상 지정
+    # 각 블록별 수정 대상 지정
     modules_to_always_init=(set_hostname set_passwords ssh)
     modules_to_always_config=(runcmd)
 
@@ -236,7 +233,7 @@ patch_cloud_init_and_config_modules_frequency_partial() {
             continue
         fi
 
-        # 블록 내부
+        # 블록 내부 처리
         if [[ $in_block -eq 1 ]]; then
             # 블록 종료 감지(최상위 키)
             if [[ "$line" =~ ^[^[:space:]] && ! "$line" =~ ^- ]]; then
@@ -246,7 +243,7 @@ patch_cloud_init_and_config_modules_frequency_partial() {
                 continue
             fi
 
-            # - 모듈명 항목만 패치
+            # 모듈 항목만 수정
             if [[ "$line" =~ ^[[:space:]]*-[[:space:]]*([a-zA-Z0-9_]+) ]]; then
                 mod="${BASH_REMATCH[1]}"
                 patch=0
@@ -271,31 +268,30 @@ patch_cloud_init_and_config_modules_frequency_partial() {
             continue
         fi
 
-        # 블록 외에는 그대로
+        # 블록 밖 내용은 그대로 유지
         echo "$line" >> "$TMP"
     done < "$CFG"
 
     sudo mv "$TMP" "$CFG"
 
-    msg "[INFO] 지정된 모듈만 always로 패치 완료 (cloud_init_modules, cloud_config_modules)" \
+    msg "[INFO] 지정된 모듈만 always로 수정 완료 (cloud_init_modules, cloud_config_modules)" \
         "[INFO] Only the specified modules set to always (cloud_init_modules, cloud_config_modules)."
 }
 
 setup_cloud_init_clean_on_shutdown() {
-    # 실제 동작은 "shutdown" 이 아니라 "부팅 완료 후(clean at boot)" 로 변경
-    # → 기존 이름은 유지하지만, 동작은 대안 2번 방식으로 구현
+    # 실제 동작은 shutdown 시점이 아니라 다음 부팅 완료 시 clean at boot 방식으로 수행
 
     local HELPER="/usr/local/libexec/ablestack-qemu-exec-tools/cloud_init_clean_at_boot.sh"
     local UNIT_PATH="/etc/systemd/system/ablestack-cloud-init-clean-at-boot.service"
 
-    # 헬퍼 스크립트 위치 생성
+    # 헬퍼 스크립트 설치 경로 생성
     sudo mkdir -p "$(dirname "$HELPER")"
 
-    # 1) 부팅 시 실행될 헬퍼 스크립트 작성
+    # 1) 부팅 후 실행할 헬퍼 스크립트 생성
     sudo tee "$HELPER" >/dev/null <<'EOS'
 #!/bin/bash
 # cloud_init_clean_at_boot.sh
-# 1) /var/log/cloud-init*.log 를 /var/log/cloud-init/ 아래 timestamp 백업
+# 1) /var/log/cloud-init*.log 를 /var/log/cloud-init/ 아래 timestamp로 백업
 # 2) cloud-init clean --logs 실행
 
 set -euo pipefail
@@ -314,7 +310,7 @@ backup_one() {
 
     if [ -f "$src" ]; then
         dst="${DST_DIR}/${base}.${ts}"
-        # 퍼미션/소유권 유지 시도, 실패하면 일반 cp
+        # 가능하면 원래 권한 보존, 실패하면 일반 cp
         if ! cp -p "$src" "$dst" 2>/dev/null; then
             cp "$src" "$dst"
         fi
@@ -325,7 +321,7 @@ backup_one() {
 backup_one "${SRC_DIR}/cloud-init.log"
 backup_one "${SRC_DIR}/cloud-init-output.log"
 
-# 2) cloud-init clean --logs 실행 (실패해도 부팅은 계속되어야 하므로 무시)
+# 2) cloud-init clean --logs 실행 (실패해도 부팅은 계속되도록 무시)
 if command -v cloud-init >/dev/null 2>&1; then
     cloud-init clean --logs || true
 fi
@@ -335,7 +331,7 @@ EOS
 
     sudo chmod +x "$HELPER"
 
-    # 2) 부팅 완료 시점(multi-user.target)에서 한 번 실행되는 서비스 유닛 작성
+    # 2) 부팅 완료 시점(multi-user.target)에서 한 번 실행되는 서비스 유닛 생성
     sudo tee "$UNIT_PATH" >/dev/null <<EOF
 [Unit]
 Description=ABLESTACK: Backup and clean cloud-init logs at boot
@@ -352,23 +348,23 @@ EOF
     sudo systemctl daemon-reload
     sudo systemctl enable ablestack-cloud-init-clean-at-boot.service
 
-    msg "[INFO] 시스템 부팅 완료 시 cloud-init 로그 백업 및 clean이 자동으로 실행되도록 설정했습니다." \
+    msg "[INFO] 부팅 완료 후 cloud-init 로그 백업 및 clean을 자동으로 수행하도록 설정했습니다." \
         "[INFO] Configured a systemd service to backup and clean cloud-init logs at boot."
 }
 
 print_final_message() {
     # 현재 OS 로케일 감지
     locale="$(locale 2>/dev/null | grep LANG= | cut -d= -f2 | cut -d. -f1)"
-    case "$locale" in 
-        ko_KR|ko|ko_KR_*) # 한국어 로케일일 때
+    case "$locale" in
+        ko_KR|ko|ko_KR_*)
             echo "---------------------------------------------"
             echo "[INFO] 모든 cloud-init 자동화 설정이 완료되었습니다."
             echo "[INFO] 이제 아래 순서로 VM을 마무리하세요:"
             echo
-            echo "  1. 가상머신을 셧다운(shutdown) 하십시오."
-            echo "  2. 종료된 VM을 템플릿으로 등록 또는 이미지로 변환하십시오."
+            echo "  1. 가상머신을 종료(shutdown)하십시오."
+            echo "  2. 종료된 VM을 템플릿으로 등록하거나 이미지로 변환하십시오."
             echo
-            echo "※ 템플릿/이미지에서 신규 VM을 만들면, cloud-init이 부팅마다 최신 메타데이터를 자동 적용합니다."
+            echo "* 이 템플릿/이미지에서 새 VM을 만들면 cloud-init가 부팅마다 최신 메타데이터를 자동 적용합니다."
             echo "---------------------------------------------"
             ;;
         *)
@@ -383,4 +379,4 @@ print_final_message() {
             echo "---------------------------------------------"
             ;;
     esac
-}
\ No newline at end of file
+}
diff --git a/lib/common.sh b/lib/common.sh
index f5d6eee..c2669bf 100644
--- a/lib/common.sh
+++ b/lib/common.sh
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/bin/bash
 #
 # common.sh - Common utility functions for vm_exec.sh
 #
@@ -18,15 +18,15 @@
 
 # 로그 출력 함수
 log_info() {
-  echo -e "🔷 [INFO] $*"
+  echo -e "[INFO] $*"
 }
 
 log_warn() {
-  echo -e "⚠️  [WARN] $*"
+  echo -e "[WARN] $*"
 }
 
 log_error() {
-  echo -e "❌ [ERROR] $*" >&2
+  echo -e "[ERROR] $*" >&2
 }
 
 abort() {
diff --git a/lib/hangctl/actions.sh b/lib/hangctl/actions.sh
index 3560bc5..680e8a9 100644
--- a/lib/hangctl/actions.sh
+++ b/lib/hangctl/actions.sh
@@ -146,7 +146,7 @@ hangctl_action_handle_confirmed_vm() {
   local dump_path dump_sha dump_bytes
   dump_path=""; dump_sha=""; dump_bytes="0"
 
-  # hangctl_action_handle_confirmed_vm 내 덤프 호출 부분 개선 제안
+  # hangctl_action_handle_confirmed_vm 함수 호출 부분 개선 방안
   hangctl_collect_dump_pre_action "${vm}" "${incident_id}" dump_path dump_sha dump_bytes || {
       hangctl_log_event "evidence" "dump.skip" "warn" "${vm}" "${incident_id}" "" "reason=dump_failed_proceeding_to_action"
   }
diff --git a/lib/hangctl/detect.sh b/lib/hangctl/detect.sh
index 57baf5e..b394081 100644
--- a/lib/hangctl/detect.sh
+++ b/lib/hangctl/detect.sh
@@ -128,27 +128,27 @@ hangctl_probe_migration_zombie_check() {
   local vm="${1-}"
   local out err rc=0
   
-  # 1. 마이그레이션 작업 정보 조회
+  # 1. 마이그레?�션 ?�업 ?�보 조회
   hangctl_virsh "${HANGCTL_VIRSH_TIMEOUT_SEC}" out err rc -- -c qemu:///system domjobinfo "${vm}" || true
   
-  # 'Data processed' 또는 'Memory remaining' 수치 추출 (대상 호스트 기준)
+  # 'Data processed' ?�는 'Memory remaining' ?�치 추출 (?�???�스??기�?)
   local current_data
   current_data="$(echo "${out}" | grep -iE "Data processed|Memory processed" | awk '{print $3}' | tr -d ',' || echo "0")"
   
-  # 2. 진척도 비교 (이전 스캔 대비 데이터 유입량)
+  # 2. 진척??비교 (?�전 ?�캔 ?��??�이???�입??
   local diff
   diff="$(hangctl_state_get_migration_progress "${vm}" "${current_data}")"
   
-  # 데이터 변화가 0이고, 이미 설정된 마이그레이션 임계치를 넘었다면 좀비로 판단
+  # ?�이??변?��? 0?�고, ?��? ?�정??마이그레?�션 ?�계치�? ?�었?�면 좀비로 ?�단
   if [[ "${diff}" -eq 0 ]]; then
-    return 0 # 진척 없음 (위험)
+    return 0 # 진척 ?�음 (?�험)
   fi
-  return 1 # 진행 중 (정상)
+  return 1 # 진행 �?(?�상)
 }
 
-# detect.sh 에 추가
+# detect.sh ??추�?
 
-# QMP를 통해 모든 가상 디스크의 I/O 통계를 수집하는 함수
+# QMP�??�해 모든 가???�스?�의 I/O ?�계�??�집?�는 ?�수
 hangctl_probe_blockstats() {
   # usage: hangctl_probe_blockstats <vm> <out_rd_ops_var> <out_wr_ops_var>
   local vm="${1-}"
@@ -163,7 +163,7 @@ hangctl_probe_blockstats() {
   err=""
   rc=0
 
-  # QMP query-blockstats 실행 (모든 드라이브의 통계를 합산하여 전체 I/O 흐름 파악)
+  # QMP query-blockstats ?�행 (모든 ?�라?�브???�계�??�산?�여 ?�체 I/O ?�름 ?�악)
   local cmd='{"execute":"query-blockstats"}'
   hangctl_virsh "${HANGCTL_QMP_TIMEOUT_SEC}" out err rc -- -c qemu:///system qemu-monitor-command "${vm}" --cmd "${cmd}" || true
 
@@ -173,12 +173,12 @@ hangctl_probe_blockstats() {
     return "${rc}"
   fi
 
-  # jq를 사용하여 모든 드라이브의 rd_operations와 wr_operations 합계 추출
+  # jq�??�용?�여 모든 ?�라?�브??rd_operations?� wr_operations ?�계 추출
   if command -v jq >/dev/null 2>&1; then
     _rd_ops=$(echo "${out}" | jq '[.return[].stats.rd_operations] | add' 2>/dev/null || echo "0")
     _wr_ops=$(echo "${out}" | jq '[.return[].stats.wr_operations] | add' 2>/dev/null || echo "0")
   else
-    # jq가 없는 경우 첫 번째 장치의 수치만 sed로 추출 (fallback)
+    # jq가 ?�는 경우 �?번째 ?�치???�치�?sed�?추출 (fallback)
     _rd_ops=$(echo "${out}" | sed -nE 's/.*"rd_operations"[[:space:]]*:[[:space:]]*([0-9]+).*/\1/p' | head -n 1 || echo "0")
     _wr_ops=$(echo "${out}" | sed -nE 's/.*"wr_operations"[[:space:]]*:[[:space:]]*([0-9]+).*/\1/p' | head -n 1 || echo "0")
   fi
@@ -189,32 +189,32 @@ hangctl_probe_blockstats() {
   return 0
 }
 
-# 블록 I/O Stall 여부를 판단하는 함수
+# 블록 I/O Stall ?��?�??�단?�는 ?�수
 hangctl_detect_block_stall() {
   # usage: hangctl_detect_block_stall <vm> <curr_rd> <curr_wr>
-  # return: 0 (Stall 의심), 1 (정상 또는 판단 불가)
+  # return: 0 (Stall ?�심), 1 (?�상 ?�는 ?�단 불�?)
   local vm="${1-}"
   local curr_rd="${2-0}"
   local curr_wr="${3-0}"
 
   local prev_rd=0
   local prev_wr=0
-  # 1단계에서 만든 함수로 이전 값 로드
+  # 1?�계?�서 만든 ?�수�??�전 �?로드
   hangctl_state_get_prev_blockstats "${vm}" prev_rd prev_wr
 
-  # 현재 수치를 다음 스캔을 위해 저장
+  # ?�재 ?�치�??�음 ?�캔???�해 ?�??
   hangctl_state_update_blockstats "${vm}" "${curr_rd}" "${curr_wr}"
 
-  # 이전 기록이 없으면(첫 스캔) 정상으로 간주
+  # ?�전 기록???�으�?�??�캔) ?�상?�로 간주
   if [[ "${prev_rd}" -eq 0 && "${prev_wr}" -eq 0 ]]; then
     return 1
   fi
 
-  # 판단 로직: I/O 요청 횟수가 이전과 정확히 일치한다면?
-  # 1. 아예 I/O가 없는 한가한 상태이거나
-  # 2. I/O가 꽉 막혀서 처리가 안 되고 있는 상태임
+  # ?�단 로직: I/O ?�청 ?�수가 ?�전�??�확???�치?�다�?
+  # 1. ?�예 I/O가 ?�는 ?��????�태?�거??
+  # 2. I/O가 �?막�???처리가 ???�고 ?�는 ?�태??
   if [[ "${curr_rd}" -eq "${prev_rd}" && "${curr_wr}" -eq "${prev_wr}" ]]; then
-    # 이 시점에서는 의심(suspect) 단계로 보고 duration을 누적하게 됨
+    # ???�점?�서???�심(suspect) ?�계�?보고 duration???�적?�게 ??
     return 0
   fi
 
diff --git a/lib/hangctl/logging.sh b/lib/hangctl/logging.sh
index d7c90dc..cf12df8 100644
--- a/lib/hangctl/logging.sh
+++ b/lib/hangctl/logging.sh
@@ -31,23 +31,23 @@ hangctl_log_rotate_if_needed() {
 
   [[ -f "${log_file}" ]] || return 0
 
-  # 현재 크기 확인 (KB 단위)
+  # ?�재 ?�기 ?�인 (KB ?�위)
   local current_size_kb
   current_size_kb=$(du -k "${log_file}" | cut -f1)
   local max_size_kb=$(( max_size_mb * 1024 ))
 
   if [[ "${current_size_kb}" -ge "${max_size_kb}" ]]; then
-    # 회전 시작 로그 기록
+    # ?�전 ?�작 로그 기록
     hangctl_log_event "logging" "log.rotate" "ok" "" "" "" "reason=size_limit size_kb=${current_size_kb}"
     
-    # 이전 백업 파일들 밀어내기 (Rotation)
+    # ?�전 백업 ?�일??밀?�내�?(Rotation)
     local i
     for ((i=rotate_count-1; i>=1; i--)); do
       [[ -f "${log_file}.${i}" ]] && mv -f "${log_file}.${i}" "${log_file}.$((i+1))"
     done
     mv -f "${log_file}" "${log_file}.1"
     
-    # 새 로그 파일 생성 및 권한 설정
+    # ??로그 ?�일 ?�성 �?권한 ?�정
     touch "${log_file}"
     chmod 0644 "${log_file}" 2>/dev/null || true
   fi
diff --git a/lib/hangctl/state_cache.sh b/lib/hangctl/state_cache.sh
index 977826b..e39c6ac 100644
--- a/lib/hangctl/state_cache.sh
+++ b/lib/hangctl/state_cache.sh
@@ -41,7 +41,7 @@ hangctl_state__path() {
   echo -n "${dir}/${key}.state"
 }
 
-# Simple key=value 파일에서 특정 키의 값을 읽는 유틸리티 함수
+# Simple key=value ?�일?�서 ?�정 ?�의 값을 ?�는 ?�틸리티 ?�수
 hangctl_state__read_kv() {
   # usage: hangctl_state__read_kv <path> <key>
   local path="${1-}"
@@ -50,7 +50,7 @@ hangctl_state__read_kv() {
   grep -E "^${key}=" "${path}" 2>/dev/null | head -n 1 | cut -d= -f2-
 }
 
-# VM별 상태 기록 파일에 domstate와 마지막 변경 시점(timestamp)을 기록하여, hang 상태 지속 시간을 계산하는 데 활용
+# VM�??�태 기록 ?�일??domstate?� 마�?�?변�??�점(timestamp)??기록?�여, hang ?�태 지???�간??계산?�는 ???�용
 hangctl_state__write_file() {
   # usage: hangctl_state__write_file <path> <domstate> <last_change_ts>
   local path="${1-}"
@@ -73,7 +73,7 @@ EOF
   return 0
 }
 
-# VM의 현재 domstate를 기록하고, 상태 변경 시점을 업데이트하여 stuck_sec 계산에 활용
+# VM???�재 domstate�?기록?�고, ?�태 변�??�점???�데?�트?�여 stuck_sec 계산???�용
 hangctl_state_update_domstate() {
   # usage: hangctl_state_update_domstate <vm> <domstate>
   local vm="${1-}"
@@ -90,7 +90,7 @@ hangctl_state_update_domstate() {
 
   local change_ts="${prev_change}"
   if [[ -z "${prev_state}" ]]; then
-    # 처음 발견된 VM은 현재 상태를 기준으로 기록을 시작하여 stuck_sec을 0으로 유지
+    # 처음 발견??VM?� ?�재 ?�태�?기�??�로 기록???�작?�여 stuck_sec??0?�로 ?��?
     prev_state="${domstate}"
     change_ts="${now}"
   elif [[ "${prev_state}" != "${domstate}" ]]; then
@@ -102,7 +102,7 @@ hangctl_state_update_domstate() {
   hangctl_state__write_file "${path}" "${domstate}" "${change_ts}" || true
 }
 
-# VM이 hang 상태에서 벗어난 후에도 일정 시간 동안 기록을 유지하여, 스캔 간격이 길어도 stuck_sec 계산이 계속 유효하도록 함
+# VM??hang ?�태?�서 벗어???�에???�정 ?�간 ?�안 기록???��??�여, ?�캔 간격??길어??stuck_sec 계산??계속 ?�효?�도�???
 hangctl_state_get_duration_sec() {
   # usage: hangctl_state_get_duration_sec <vm>
   local vm="${1-}"
@@ -123,7 +123,7 @@ hangctl_state_get_duration_sec() {
   echo -n "${duration}"
 }
 
-# Migration 진행 상황 추적을 위해 별도 파일에 누적된 바이트 수 기록
+# Migration 진행 ?�황 추적???�해 별도 ?�일???�적??바이????기록
 hangctl_state_get_migration_progress() {
   # usage: hangctl_state_get_migration_progress <vm> <current_bytes>
   local vm="${1-}"
@@ -134,14 +134,14 @@ hangctl_state_get_migration_progress() {
   local prev
   prev="$(cat "${path}" 2>/dev/null || echo "0")"
   
-  # 현재 수치를 파일에 저장
+  # ?�재 ?�치�??�일???�??
   echo "${current}" > "${path}"
   
-  # 이전 수치와 비교하여 증분 반환
+  # ?�전 ?�치?� 비교?�여 증분 반환
   echo $(( current - prev ))
 }
 
-# VM이 종료되어 상태 초기화가 필요한 경우, 캐시 파일을 삭제하여 다음 스캔에서 새롭게 기록 시작
+# VM??종료?�어 ?�태 초기?��? ?�요??경우, 캐시 ?�일????��?�여 ?�음 ?�캔?�서 ?�롭�?기록 ?�작
 hangctl_state_reset_vm() {
   local vm="${1-}"
   local path
@@ -152,7 +152,7 @@ hangctl_state_reset_vm() {
   hangctl_log_event "state" "state.reset" "ok" "${vm}" "" "" "reason=vm_not_running"
 }
 
-# QMP 응답이 성공하면 이 함수를 호출하여 마지막 성공 시점을 현재로 갱신
+# QMP ?�답???�공?�면 ???�수�??�출?�여 마�?�??�공 ?�점???�재�?갱신
 hangctl_state_touch_heartbeat() {
   local vm="${1-}"
   local path
@@ -160,13 +160,13 @@ hangctl_state_touch_heartbeat() {
   local now
   now="$(date +%s)"
   
-  # 상태와 관계없이 마지막 응답 시점을 현재로 업데이트 (시간 초기화 효과)
+  # ?�태?� 관계없??마�?�??�답 ?�점???�재�??�데?�트 (?�간 초기???�과)
   hangctl_state__write_file "${path}" "alive" "${now}" || true
 }
 
-# state_cache.sh (업데이트 및 추가)
+# state_cache.sh (?�데?�트 �?추�?)
 
-# 기존 write_file을 확장하여 여러 키값을 유연하게 저장하도록 개선
+# 기존 write_file???�장?�여 ?�러 ?�값???�연?�게 ?�?�하?�록 개선
 hangctl_state__write_kv_all() {
   # usage: hangctl_state__write_kv_all <path> <key1=val1> <key2=val2> ...
   local path="${1-}"
@@ -176,7 +176,7 @@ hangctl_state__write_kv_all() {
   [[ -d "${dir}" ]] || mkdir -p "${dir}" 2>/dev/null || true
 
   local tmp="${path}.tmp"
-  # 기존 파일이 있으면 읽어서 유지하고, 새로운 값들로 덮어씀
+  # 기존 ?�일???�으�??�어???��??�고, ?�로??값들�???��?�
   if [[ -f "${path}" ]]; then
     cat "${path}" > "${tmp}"
   else
@@ -186,7 +186,7 @@ hangctl_state__write_kv_all() {
   for kv in "$@"; do
     local k="${kv%%=*}"
     local v="${kv#*=}"
-    # 기존 키가 있으면 삭제 후 추가
+    # 기존 ?��? ?�으�???�� ??추�?
     sed -i "/^${k}=/d" "${tmp}"
     echo "${k}=${v}" >> "${tmp}"
   done
@@ -194,7 +194,7 @@ hangctl_state__write_kv_all() {
   mv -f "${tmp}" "${path}" 2>/dev/null || return 1
 }
 
-# QMP 응답 성공 시 호출 (기존 함수 유지하되 확장된 write_kv_all 사용)
+# QMP ?�답 ?�공 ???�출 (기존 ?�수 ?��??�되 ?�장??write_kv_all ?�용)
 hangctl_state_touch_heartbeat() {
   local vm="${1-}"
   local path
@@ -202,11 +202,11 @@ hangctl_state_touch_heartbeat() {
   local now
   now="$(date +%s)"
   
-  # heartbeat 시점에 blockstats는 유지하고 alive 상태와 ts만 갱신
+  # heartbeat ?�점??blockstats???��??�고 alive ?�태?� ts�?갱신
   hangctl_state__write_kv_all "${path}" "domstate=alive" "last_change_ts=${now}" || true
 }
 
-# 신규: 블록 통계(Read/Write Ops) 저장
+# ?�규: 블록 ?�계(Read/Write Ops) ?�??
 hangctl_state_update_blockstats() {
   # usage: hangctl_state_update_blockstats <vm> <rd_ops> <wr_ops>
   local vm="${1-}"
@@ -218,7 +218,7 @@ hangctl_state_update_blockstats() {
   hangctl_state__write_kv_all "${path}" "prev_rd_ops=${rd_ops}" "prev_wr_ops=${wr_ops}" || true
 }
 
-# 신규: 이전 블록 통계 가져오기
+# ?�규: ?�전 블록 ?�계 가?�오�?
 hangctl_state_get_prev_blockstats() {
   # usage: hangctl_state_get_prev_blockstats <vm> <out_rd_var> <out_wr_var>
   local vm="${1-}"
diff --git a/lib/hangctl/systemd/ablestack-vm-hangctl.service b/lib/hangctl/systemd/ablestack-vm-hangctl.service
index 0f34982..7209085 100644
--- a/lib/hangctl/systemd/ablestack-vm-hangctl.service
+++ b/lib/hangctl/systemd/ablestack-vm-hangctl.service
@@ -6,7 +6,7 @@ Wants=libvirtd.service
 [Service]
 Type=oneshot
 ExecStart=/usr/local/bin/ablestack_vm_hangctl scan
-# scan 내에서 dump/evidence/timeout을 자체적으로 처리하므로 systemd timeout은 넉넉히
+# scan ?�에??dump/evidence/timeout???�체?�으�?처리?��?�?systemd timeout?� ?�넉??
 TimeoutStartSec=20min
-# 실패 시 systemd가 재시도하지 않게 (재시도는 timer가 담당)
+# ?�패 ??systemd가 ?�시?�하지 ?�게 (?�시?�는 timer가 ?�당)
 Restart=no
diff --git a/lib/libvirt_helpers.sh b/lib/libvirt_helpers.sh
index 64c230c..841a347 100644
--- a/lib/libvirt_helpers.sh
+++ b/lib/libvirt_helpers.sh
@@ -21,7 +21,7 @@
 # require bash when sourced
 if [ -z "${BASH_VERSION:-}" ]; then
   echo "[ERR] libvirt_helpers.sh requires bash (arrays, mapfile used)." 1>&2
-  # sourced면 return, 직접실행이면 exit
+  # sourced�?return, 직접?�행?�면 exit
   return 1 2>/dev/null || exit 1
 fi
 
@@ -33,11 +33,11 @@ ISO_PATH_DEFAULT="/usr/share/ablestack/tools/ablestack-qemu-exec-tools.iso"
 # usage: _list_cdrom_targets <domain>
 _list_cdrom_targets() {
   local dom="$1"
-  # --details 출력 형식: "Type  Device  Target  Source"
-  # 헤더/구분선 제외하고 cdrom 행만 추출
+  # --details 출력 ?�식: "Type  Device  Target  Source"
+  # ?�더/구분???�외?�고 cdrom ?�만 추출
   virsh domblklist "$dom" --details 2>/dev/null \
   | awk 'BEGIN{IGNORECASE=1}
-         NR<3 {next}                             # 헤더/구분선 스킵
+         NR<3 {next}                             # ?�더/구분???�킵
          $2 ~ /^cdrom$/ {
            dev=$3; src=$4;
            if (src=="-" || src=="") src="EMPTY";
@@ -88,11 +88,11 @@ attach_cdrom_iso() {
   local dom="$1" iso="${2:-$ISO_PATH_DEFAULT}"
   [[ -f "$iso" ]] || { echo "[ERR] ISO file not found: $iso"; exit 1; }
 
-  # 도메인 상태 확인
+  # ?�메???�태 ?�인
   local state
   state="$(virsh domstate "$dom" 2>/dev/null | tr 'A-Z' 'a-z' | awk '{print $1}')"
 
-  # 1) 실행 중이면: 기존 CD-ROM target(dev) 찾아 change-media --insert
+  # 1) ?�행 중이�? 기존 CD-ROM target(dev) 찾아 change-media --insert
   if [[ "$state" == "running" || "$state" == "paused" ]]; then
     local target
     if ! target="$(_pick_cdrom_target_for_insert "$dom")"; then
@@ -100,7 +100,7 @@ attach_cdrom_iso() {
     fi
 
     echo "[INFO] change-media: domain=$dom target=$target iso=$iso"
-    # 먼저 cdrom 비우기(있으면)
+    # 먼�? cdrom 비우�??�으�?
     virsh change-media "$dom" "$target" --eject --live   >/dev/null 2>&1 || true
     # live 반영
     virsh change-media "$dom" "$target" --insert "$iso" --live   >/dev/null 2>&1 || true
@@ -111,15 +111,15 @@ attach_cdrom_iso() {
     return 0
   fi
 
-  # 2) 꺼져 있으면: XML에 주입(기존 로직 재사용)
-  #    - 기존에 같은 ISO가 물려 있으면 skip
-  #    - 비어있는 CD-ROM 있으면 그 블록에 source 추가
-  #    - 없으면 새 CD-ROM 추가
+  # 2) 꺼져 ?�으�? XML??주입(기존 로직 ?�사??
+  #    - 기존??같�? ISO가 물려 ?�으�?skip
+  #    - 비어?�는 CD-ROM ?�으�?�?블록??source 추�?
+  #    - ?�으�???CD-ROM 추�?
   local tmp_xml
   tmp_xml="$(mktemp)"
   virsh dumpxml --security-info "$dom" > "$tmp_xml"
   inject_cdrom_into_xml "$tmp_xml" "$iso"
-  # persistent 정의 갱신
+  # persistent ?�의 갱신
   virsh define "$tmp_xml" >/dev/null
   rm -f "$tmp_xml"
   echo "[OK] ISO attached by XML update (offline)"
@@ -131,7 +131,7 @@ has_qga() {
   local dom="$1"
   local timeout="${2:-3}"   # sec, optional
 
-  # 0) ping: 채널 연결 확인
+  # 0) ping: 채널 ?�결 ?�인
   if ! virsh qemu-agent-command "$dom" '{"execute":"guest-ping"}' --timeout "$timeout" >/dev/null 2>&1; then
     echo "no"; return 0
   fi
@@ -150,7 +150,7 @@ has_qga() {
     echo "yes"; return 0
   fi
 
-  # 2) Linux fallback: /bin/sh -c true (sh 경로가 다른 배포 대응)
+  # 2) Linux fallback: /bin/sh -c true (sh 경로가 ?�른 배포 ?�??
   if _qga_try_exec "$dom" '{"execute":"guest-exec","arguments":{"path":"/bin/sh","arg":["-c","true"],"capture-output":true}}'; then
     echo "yes"; return 0
   fi
@@ -160,7 +160,7 @@ has_qga() {
     echo "yes"; return 0
   fi
 
-  # 전부 실패 → guest-exec 금지/미동작으로 판단
+  # ?��? ?�패 ??guest-exec 금�?/미동?�으�??�단
   echo "no"
 }
 
@@ -224,13 +224,13 @@ dump_transient_xml() {
 
 # Get disk image paths of the given domain (excluding cdrom/readonly)
 get_disk_paths() {
-  # 사용법: get_disk_paths <dom>
-  # 출력: 한 줄에 하나씩 디스크 이미지 경로(시디롬/readonly 제외)
+  # ?�용�? get_disk_paths <dom>
+  # 출력: ??줄에 ?�나???�스???��?지 경로(?�디�?readonly ?�외)
   local dom="$1"
   virsh domblklist "$dom" --details 2>/dev/null \
     | awk 'BEGIN{IGNORECASE=1}
-           NR<3 {next}                       # 헤더/구분선 스킵
-           $2=="disk" && $4!="" && $4!="-"{  # Device=disk 이고 Source 유효
+           NR<3 {next}                       # ?�더/구분???�킵
+           $2=="disk" && $4!="" && $4!="-"{  # Device=disk ?�고 Source ?�효
              print $4                        # Source 컬럼
            }'
 }
@@ -244,20 +244,20 @@ create_from_xml() {
 }
 
 # Inject or update a CD-ROM device with the specified ISO in the domain XML
-# - 기존 CD-ROM이 있으면 첫 번째 CD-ROM 블록에만 <source file=...> 교체/삽입
-# - 전혀 없으면 IDE 버스로 1개 추가(가장 호환성 높음)
+# - 기존 CD-ROM???�으�?�?번째 CD-ROM 블록?�만 <source file=...> 교체/?�입
+# - ?��? ?�으�?IDE 버스�?1�?추�?(가???�환???�음)
 inject_cdrom_into_xml() {
   local xml="$1" iso="$2"
   [[ -f "$xml" ]] || { echo "[ERR] xml not found: $xml"; exit 1; }
   [[ -f "$iso" ]] || { echo "[ERR] iso not found: $iso"; exit 1; }
 
   if grep -q "<disk[^>]*device=['\"]cdrom['\"]" "$xml"; then
-    # 첫 번째 cdrom 블록만 안전하게 수정 (구조 보존)
+    # �?번째 cdrom 블록�??�전?�게 ?�정 (구조 보존)
     ISO="$iso" perl -0777 -i -pe "$(cat <<'PERL'
 my $iso  = $ENV{ISO};
 my $done = 0;
 
-# <disk ... device='cdrom'>...</disk> 블록을 한 번만 수정
+# <disk ... device='cdrom'>...</disk> 블록????번만 ?�정
 s{
   ( <disk [^>]* device=(["']) cdrom \2 [^>]* > )   # $1: head
   ( .*? )                                          # $2: mid (lazy)
@@ -267,18 +267,16 @@ s{
   if ($done) { $head.$mid.$tail }
   else {
     if ($mid =~ m/<source\s/i) {
-      # 1) source가 이미 있으면 file 값만 ISO로 교체
+      # 1) source가 ?��? ?�으�?file 값만 ISO�?교체
       $mid =~ s{(<source\s+[^>]*file=)(["\']).*?\2}{$1.$2.$iso.$2}is;
     } else {
-      # 2) source가 없으면 삽입 우선순위:
-      #    a) <driver ...> 바로 뒤
-      #    b) <target ...> 바로 앞
-      #    c) </disk> 직전
+      # 2) source가 ?�으�??�입 ?�선?�위:
+      #    a) <driver ...> 바로 ??      #    b) <target ...> 바로 ??      #    c) </disk> 직전
       my $ins = "      <source file='$iso'/>\n";
       if ($mid =~ s{(<driver\b[^>]*>\s*)}{$1.$ins}i) {
-        # OK: driver 뒤에 삽입
+        # OK: driver ?�에 ?�입
       } elsif ($mid =~ s{(\s*)(<target\b)}{$ins.$2}i) {
-        # OK: target 앞에 삽입
+        # OK: target ?�에 ?�입
       } else {
         $mid = $mid.$ins;  # fallback: </disk> 직전
       }
@@ -293,14 +291,14 @@ PERL
     return 0
   fi
 
-  # CD-ROM 장치가 하나도 없으면: IDE로 1개 추가
+  # CD-ROM ?�치가 ?�나???�으�? IDE�?1�?추�?
   awk -v ISO="$iso" '
     BEGIN{added=0}
     /<\/devices>/ && !added{
       print "    <disk type='\''file'\'' device='\''cdrom'\''>";
       print "      <driver name='\''qemu'\''/>";
       print "      <source file='\''" ISO "'\''/>";
-      print "      <target bus='\''ide'\''/>";   # dev 생략: libvirt가 배정
+      print "      <target bus='\''ide'\''/>";   # dev ?�략: libvirt가 배정
       print "      <readonly/>";
       print "    </disk>";
       added=1
@@ -316,8 +314,8 @@ detach_iso_safely() {
   local tgt
   tgt="$(_find_cdrom_target_by_iso "$dom" "$iso")"
   if [[ -z "$tgt" ]]; then
-    echo "[WARN] target dev를 찾지 못함. cdrom 전체 스캔 시도"
-    # target을 못 찾으면 어쨌든 첫 번째 cdrom 하나라도 eject 시도
+    echo "[WARN] target dev�?찾�? 못함. cdrom ?�체 ?�캔 ?�도"
+    # target??�?찾으�??�쨌??�?번째 cdrom ?�나?�도 eject ?�도
     tgt="$(virsh domblklist "$dom" --details 2>/dev/null | awk 'NR>=3 && $2=="cdrom"{print $3; exit}')"
     [[ -z "$tgt" ]] && return 1
   fi
diff --git a/lib/offline_inject_windows.sh b/lib/offline_inject_windows.sh
index e93aa18..3750905 100644
--- a/lib/offline_inject_windows.sh
+++ b/lib/offline_inject_windows.sh
@@ -20,12 +20,12 @@
 
 set -euo pipefail
 
-# trap으로 에러 지점 표시(선택)
+# trap?�로 ?�러 지???�시(?�택)
 set -o errtrace
 trap 'echo "[DBG] failed at ${BASH_SOURCE[0]}:${LINENO} (rc=$?)"' ERR
 
 
-# libguestfs 안정화 (권장)
+# libguestfs ?�정??(권장)
 export LIBGUESTFS_BACKEND=direct
 
 # Resolve script root (repo root assumed to be parent dir)
@@ -35,10 +35,10 @@ PAYLOAD_DIR="${SCRIPT_DIR}/payload"
 
 RUNONCE_SRC="${PAYLOAD_DIR}/windows/ablestack-runonce.ps1"
 
-# 복사 실패 시 ISO에서 바로 실행하도록 폴백
+# 복사 ?�패 ??ISO?�서 바로 ?�행?�도�??�백
 RUN_FROM_ISO=${RUN_FROM_ISO:-0}
 DEST_WIN=${DEST_WIN:-/Windows/Temp}
-# 부팅 즉시(로그인 전) 실행할 서비스 이름
+# 부??즉시(로그???? ?�행???�비???�름
 SERVICE_NAME=${SERVICE_NAME:-ABLESTACK_AutoInstall}
 
 # Check payload exists
@@ -69,8 +69,7 @@ _inject_into_disks() {
   fi
 
   echo "[INFO] Copying runonce ps1 into Windows image(s)..."
-  # virt-copy-in 은 게스트 경로를 리눅스식 절대경로로 받아야 함
-  # 복사 실패 시 ISO에서 바로 실행하도록 폴백
+  # virt-copy-in ?� 게스??경로�?리눅?�식 ?��?경로�?받아????  # 복사 ?�패 ??ISO?�서 바로 ?�행?�도�??�백
   if ! virt-copy-in "${disk_args[@]}" "${RUNONCE_SRC}" "$DEST_WIN" 2>&1; then
     echo "[WARN] virt-copy-in failed (disk mode). The filesystem may be read-only (hibernation/dirty-bit)."
     echo "[WARN] Falling back to RunOnce-from-ISO (no copy)."
@@ -79,10 +78,10 @@ _inject_into_disks() {
 
   echo "[INFO] Registering RunOnce + Boot-time Service in offline registry..."
 
-  # --- .reg 본문 생성 (RUN_FROM_ISO 분기) ---
+  # --- .reg 본문 ?�성 (RUN_FROM_ISO 분기) ---
   regtmp="$(mktemp)"
   if [[ "$RUN_FROM_ISO" -eq 0 ]]; then
-    # 복사 성공: Temp의 PS1을 RunOnce + 서비스로 실행
+    # 복사 ?�공: Temp??PS1??RunOnce + ?�비?�로 ?�행
     cat > "$regtmp" <<REG
 Windows Registry Editor Version 5.00
 
@@ -91,7 +90,7 @@ Windows Registry Editor Version 5.00
 "ABLESTACK_OneShot_Installer"="powershell -NoProfile -ExecutionPolicy Bypass -File \\"C:\\\\Windows\\\\Temp\\\\ablestack-runonce.ps1\\""
 
 ; Boot-time Service (runs before logon as LocalSystem)
-; NOTE: Offline edit ⇒ use ControlSet001/002 explicitly (CurrentControlSet is not resolved by hivex)
+; NOTE: Offline edit ??use ControlSet001/002 explicitly (CurrentControlSet is not resolved by hivex)
 [HKEY_LOCAL_MACHINE\\SYSTEM\\ControlSet001\\Services\\${SERVICE_NAME}]
 "DisplayName"="ABLESTACK Auto Installer"
 "Description"="One-shot auto installer to run ABLESTACK installer at system boot"
@@ -114,16 +113,16 @@ Windows Registry Editor Version 5.00
 "ObjectName"="LocalSystem"
 REG
   else
-    # 복사 실패: ISO(CD-ROM)의 install.bat을 RunOnce + 서비스로 실행
+    # 복사 ?�패: ISO(CD-ROM)??install.bat??RunOnce + ?�비?�로 ?�행
     cat > "$regtmp" <<REG
 Windows Registry Editor Version 5.00
 
-; RunOnce (on logon) — find CD/DVD and run install.bat
+; RunOnce (on logon) ??find CD/DVD and run install.bat
 [HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\RunOnce]
 "ABLESTACK_OneShot_Installer"="powershell -NoProfile -ExecutionPolicy Bypass -Command \\"$d=(Get-CimInstance Win32_LogicalDisk -Filter 'DriveType=5' | ForEach-Object { \$f = Join-Path (\$_.DeviceID+'\\\\') 'install.bat'; if (Test-Path \$f) { return \$f } } | Select-Object -First 1); if (\$d) { Start-Process -FilePath 'cmd.exe' -ArgumentList '/c',\$d -Wait } else { Write-Host 'ABLESTACK ISO not found'; }\\""
 
-; Boot-time Service (before logon) — find CD/DVD and run install.bat
-; NOTE: Offline edit ⇒ use ControlSet001/002 explicitly (CurrentControlSet is not resolved by hivex)
+; Boot-time Service (before logon) ??find CD/DVD and run install.bat
+; NOTE: Offline edit ??use ControlSet001/002 explicitly (CurrentControlSet is not resolved by hivex)
 [HKEY_LOCAL_MACHINE\\SYSTEM\\ControlSet001\\Services\\${SERVICE_NAME}]
 "DisplayName"="ABLESTACK Auto Installer"
 "Description"="One-shot auto installer to run ABLESTACK installer at system boot (from CD if necessary)"
@@ -147,12 +146,12 @@ Windows Registry Editor Version 5.00
 REG
   fi
 
-  # --- virt-win-reg 실행: set -e 보호 + stdin 사용 + timeout ---
-  # disk_args(-a path ...) 에서 이미지 경로만 추출
+  # --- virt-win-reg ?�행: set -e 보호 + stdin ?�용 + timeout ---
+  # disk_args(-a path ...) ?�서 ?��?지 경로�?추출
   disk_imgs=()
   for ((i=0; i<${#disk_args[@]}; i++)); do
     if [[ "${disk_args[$i]}" == "-a" ]]; then
-      (( i += 1 ))  # ← set -e 안전 (항상 0이 아닌 값)
+      (( i += 1 ))  # ??set -e ?�전 (??�� 0???�닌 �?
       if [[ $i -ge ${#disk_args[@]} ]]; then
         echo "[ERR] malformed disk_args: -a without a following path"
         return 1
@@ -161,10 +160,9 @@ REG
     fi
   done
 
-  # 기존(문제): regtmp를 내부 셸에 변수로 안 넣어서 빈 문자열이 됨
-  # timeout 60s bash -c 'virt-win-reg --merge "$@" - < "$regtmp"' _ "${disk_imgs[@]}" "$regtmp"
+  # 기존(문제): regtmp�??��? ?�에 변?�로 ???�어??�?문자?�이 ??  # timeout 60s bash -c 'virt-win-reg --merge "$@" - < "$regtmp"' _ "${disk_imgs[@]}" "$regtmp"
 
-  # 교체(정상): $1을 regtmp로 받고, 나머지($@)는 이미지 목록으로 전달
+  # 교체(?�상): $1??regtmp�?받고, ?�머지($@)???��?지 목록?�로 ?�달
   set +e
   timeout 60s bash -c '
     reg="$1"; shift
@@ -176,8 +174,7 @@ REG
 
   if (( rc != 0 )); then
     echo "[WARN] virt-win-reg (disk mode) failed or timed out (rc=$rc)."
-    # 최후 폴백: ISO RunOnce로 다시 세팅하여 재시도
-    RUN_FROM_ISO=1
+    # 최후 ?�백: ISO RunOnce�??�시 ?�팅?�여 ?�시??    RUN_FROM_ISO=1
     cat > "$regtmp" <<'REG'
 Windows Registry Editor Version 5.00
 
@@ -215,7 +212,7 @@ _inject_into_domain() {
 
   echo "[INFO] Registering RunOnce + Boot-time Service in domain registry..."
 
-  # --- .reg 본문 생성 (RUN_FROM_ISO 분기) ---
+  # --- .reg 본문 ?�성 (RUN_FROM_ISO 분기) ---
   regtmp="$(mktemp)"
   if [[ "$RUN_FROM_ISO" -eq 0 ]]; then
     cat > "$regtmp" <<REG
@@ -226,7 +223,7 @@ Windows Registry Editor Version 5.00
 "ABLESTACK_OneShot_Installer"="powershell -NoProfile -ExecutionPolicy Bypass -File \\"C:\\\\Windows\\\\Temp\\\\ablestack-runonce.ps1\\""
 
 ; Boot-time Service (runs before logon as LocalSystem)
-; NOTE: Offline edit ⇒ use ControlSet001/002 explicitly (CurrentControlSet is not resolved by hivex)
+; NOTE: Offline edit ??use ControlSet001/002 explicitly (CurrentControlSet is not resolved by hivex)
 [HKEY_LOCAL_MACHINE\\SYSTEM\\ControlSet001\\Services\\${SERVICE_NAME}]
 "DisplayName"="ABLESTACK Auto Installer"
 "Description"="One-shot auto installer to run ABLESTACK installer at system boot"
@@ -249,12 +246,12 @@ REG
     cat > "$regtmp" <<REG
 Windows Registry Editor Version 5.00
 
-; RunOnce (on logon) — find CD/DVD and run install.bat
+; RunOnce (on logon) ??find CD/DVD and run install.bat
 [HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\RunOnce]
 "ABLESTACK_OneShot_Installer"="powershell -NoProfile -ExecutionPolicy Bypass -Command \\"$d=(Get-CimInstance Win32_LogicalDisk -Filter 'DriveType=5' | ForEach-Object { \$f = Join-Path (\$_.DeviceID+'\\\\') 'install.bat'; if (Test-Path \$f) { return \$f } } | Select-Object -First 1); if (\$d) { Start-Process -FilePath 'cmd.exe' -ArgumentList '/c',\$d -Wait } else { Write-Host 'ABLESTACK ISO not found'; }\\""
 
-; Boot-time Service (before logon) — find CD/DVD and run install.bat
-; NOTE: Offline edit ⇒ use ControlSet001/002 explicitly (CurrentControlSet is not resolved by hivex)
+; Boot-time Service (before logon) ??find CD/DVD and run install.bat
+; NOTE: Offline edit ??use ControlSet001/002 explicitly (CurrentControlSet is not resolved by hivex)
 [HKEY_LOCAL_MACHINE\\SYSTEM\\ControlSet001\\Services\\${SERVICE_NAME}]
 "DisplayName"="ABLESTACK Auto Installer"
 "Description"="One-shot auto installer to run ABLESTACK installer at system boot (from CD if necessary)"
@@ -278,7 +275,7 @@ REG
   # 기존(문제)
   # timeout 60s bash -c 'virt-win-reg --merge "$1" - < "$2"' _ "${dom}" "${regtmp}"
 
-  # 교체(정상)
+  # 교체(?�상)
   set +e
   timeout 60s bash -c '
     dom="$1"; reg="$2"
@@ -289,8 +286,7 @@ REG
 
   if (( rc != 0 )); then
     echo "[WARN] virt-win-reg (domain mode) failed or timed out (rc=$rc)."
-    # 이미 RUN_FROM_ISO 분기까지 포함했으므로 추가 조치는 로그만
-  fi
+    # ?��? RUN_FROM_ISO 분기까�? ?�함?�으므�?추�? 조치??로그�?  fi
 
   rm -f "${regtmp}"
 
@@ -310,7 +306,7 @@ if [[ "$1" == "--disks" ]]; then
     exit 1
   fi
   for d in "$@"; do
-    # 파일 또는 블록 디바이스 허용
+    # ?�일 ?�는 블록 ?�바?�스 ?�용
     if [[ ! -e "$d" ]]; then
       echo "[ERR] disk path not found: $d"
       exit 1
diff --git a/lib/parse_linux_table.sh b/lib/parse_linux_table.sh
index 690b991..34759a9 100644
--- a/lib/parse_linux_table.sh
+++ b/lib/parse_linux_table.sh
@@ -46,7 +46,7 @@ parse_linux_table() {
     done
 
     if [[ -z "$header_line" ]]; then
-      echo "❌ Header keyword '$first_word' not found in data." >&2
+      echo "??Header keyword '$first_word' not found in data." >&2
       echo '[]'
       return
     fi
diff --git a/lib/parse_windows_table.sh b/lib/parse_windows_table.sh
index 9f029be..f22b31b 100644
--- a/lib/parse_windows_table.sh
+++ b/lib/parse_windows_table.sh
@@ -46,7 +46,7 @@ parse_windows_table() {
     done
 
     if [[ -z "$header_line" ]]; then
-      echo "❌ Header keyword '$first_word' not found in data." >&2
+      echo "??Header keyword '$first_word' not found in data." >&2
       echo '[]'
       return
     fi
diff --git a/lib/v2k/engine.sh b/lib/v2k/engine.sh
index 5ef0030..146a402 100644
--- a/lib/v2k/engine.sh
+++ b/lib/v2k/engine.sh
@@ -96,11 +96,11 @@ v2k_linux_bootstrap_pick_nbd() {
     lock_dir="${V2K_NBD_LOCK_ROOT}/nbd${i}.lock.d"
     pid_file="${lock_dir}/pid"
 
-    # 1. 원자적 예약 시도 (nbd_utils.sh와 동일 메커니즘)
+    # 1. ?�자???�약 ?�도 (nbd_utils.sh?� ?�일 메커?�즘)
     if mkdir "${lock_dir}" 2>/dev/null; then
       echo "$$" > "${pid_file}"
       
-      # 2. 커널 상태 체크 (기존 함수들 활용)
+      # 2. 커널 ?�태 체크 (기존 ?�수???�용)
       if v2k_nbd_is_connected "${dev}" || \
          v2k_nbd_has_any_mountpoints "${dev}" || \
          v2k_nbd_has_children_types "${dev}"; then
@@ -109,7 +109,7 @@ v2k_linux_bootstrap_pick_nbd() {
          continue
       fi
       
-      # 추가: pid 파일 체크
+      # 추�?: pid ?�일 체크
       local kpid
       kpid="$(v2k_nbd_sys_pid "${dev}" 2>/dev/null || true)"
       if [[ -n "${kpid}" && "${kpid}" != "0" ]]; then
@@ -117,16 +117,16 @@ v2k_linux_bootstrap_pick_nbd() {
          continue
       fi
 
-      # 성공! [장치명] [락 디렉토리] 반환 (cleanup을 위해)
-      # 락 디렉토리 경로를 호출자가 알면 나중에 지울 수 있음
+      # ?�공! [?�치�? [???�렉?�리] 반환 (cleanup???�해)
+      # ???�렉?�리 경로�??�출?��? ?�면 ?�중??지?????�음
       echo "${dev}"
       return 0
     else
-      # 예약 실패 시 좀비 락 체크 (선택 사항이나 권장)
+      # ?�약 ?�패 ??좀�???체크 (?�택 ?�항?�나 권장)
       if [[ -f "${pid_file}" ]]; then
         owner_pid="$(cat "${pid_file}" 2>/dev/null || true)"
         if [[ -n "${owner_pid}" ]] && ! kill -0 "${owner_pid}" 2>/dev/null; then
-           # 주인이 죽었고 장치가 free하다면 락 제거
+           # 주인??죽었�??�치가 free?�다�????�거
            if ! v2k_nbd_is_connected "${dev}"; then
              rm -rf "${lock_dir}"
            fi
@@ -243,12 +243,12 @@ v2k_is_linux_guest() {
   # Return 0(true) if the guest looks like Linux.
   #
   # NOTE:
-  # VMware Tools 미동작/제한 환경에서는 guestFamily가 빈 값으로 내려오는 케이스가 있음
-  # (예: rockylinux_64Guest 인데 guestFamily == "").
+  # VMware Tools 미동???�한 ?�경?�서??guestFamily가 �?값으�??�려?�는 케?�스가 ?�음
+  # (?? rockylinux_64Guest ?�데 guestFamily == "").
   #
   # Policy:
-  # 1) guestFamily가 linuxGuest면 Linux
-  # 2) 아니면 guestId/guestFullName/osFullName 휴리스틱으로 Linux 판별
+  # 1) guestFamily가 linuxGuest�?Linux
+  # 2) ?�니�?guestId/guestFullName/osFullName ?�리?�틱?�로 Linux ?�별
   local gf gid gfull osfull probe
   gf="$(jq -r '.source.vm.guestFamily // empty' "${V2K_MANIFEST}" 2>/dev/null || true)"
   if [[ "${gf}" == "linuxGuest" ]]; then
@@ -500,8 +500,8 @@ v2k_linux_bootstrap_lvm_try_activate_by_pv() {
 
   udevadm settle >/dev/null 2>&1 || true
 
-  # pvscan rc==0이면 "활성화 후보 성공"으로 간주한다.
-  # 실제 LV active 판정은 vgchange -ay 이후 단계에서 수행.
+  # pvscan rc==0?�면 "?�성???�보 ?�공"?�로 간주?�다.
+  # ?�제 LV active ?�정?� vgchange -ay ?�후 ?�계?�서 ?�행.
   [[ "${act_rc}" -eq 0 ]] && return 0
   return 2
 }
@@ -640,8 +640,8 @@ v2k_linux_bootstrap_try_mount_lvm() {
   sleep 1
 
   # [Step 1 & 2] Force Cache Update & Discover VGs (Direct & Simple)
-  # lsblk로 확인하는 과정 없이, 필터가 적용된 LVM 명령을 직접 수행하여 VG를 찾습니다.
-  # 호스트 udev 간섭(Retry Storm)을 뚫기 위해 5회 재시도합니다.
+  # lsblk�??�인?�는 과정 ?�이, ?�터가 ?�용??LVM 명령??직접 ?�행?�여 VG�?찾습?�다.
+  # ?�스??udev 간섭(Retry Storm)???�기 ?�해 5???�시?�합?�다.
   
   local scan_out scan_rc vgs_out vgs_rc
   local attempt=0 max_retry=5
@@ -650,27 +650,27 @@ v2k_linux_bootstrap_try_mount_lvm() {
   while [[ "${attempt}" -lt "${max_retry}" ]]; do
       attempt=$((attempt+1))
 
-      # 1. 명시적 PVScan (캐시 갱신)
-      # 필터가 적용되어 있으므로 NBD 장치만 안전하게 스캔합니다.
+      # 1. 명시??PVScan (캐시 갱신)
+      # ?�터가 ?�용?�어 ?�으므�?NBD ?�치�??�전?�게 ?�캔?�니??
       v2k_linux_bootstrap_run_event "cmd_pvscan_direct" scan_out scan_rc -- \
          lvm pvscan --config "${cfg}" --cache --activate ay
       
-      # 2. 명시적 VGS 조회
-      # lsblk 조건 없이 바로 조회를 시도합니다. (사용자 수동 성공 방식)
+      # 2. 명시??VGS 조회
+      # lsblk 조건 ?�이 바로 조회�??�도?�니?? (?�용???�동 ?�공 방식)
       v2k_linux_bootstrap_run_event "cmd_vgs_direct" vgs_out vgs_rc -- \
          lvm vgs --config "${cfg}" --noheadings -o vg_name
       
-      # 결과 파싱
+      # 결과 ?�싱
       vgs="$(echo "${vgs_out}" | awk '{$1=$1}; $1!=""{print $1}' | sort -u)"
 
       if [[ -n "${vgs}" ]]; then
-          # VG를 찾았으면 루프 탈출
+          # VG�?찾았?�면 루프 ?�출
           v2k_event INFO "linux_bootstrap" "" "lvm_vg_found_retry" \
             "{\"attempt\":${attempt},\"vgs\":\"${vgs}\"}"
           break
       fi
       
-      # VG를 못 찾았으면 잠시 대기 (udev 폭풍 대기)
+      # VG�?�?찾았?�면 ?�시 ?��?(udev ??�� ?��?
       v2k_event WARN "linux_bootstrap" "" "lvm_scan_retry" \
         "{\"attempt\":${attempt},\"note\":\"waiting for lvm visibility\"}"
       sleep 2
@@ -866,7 +866,7 @@ v2k_linux_bootstrap_one() {
       v2k_linux_bootstrap_run_event "cmd_lvm_vgchange_deactivate" lvm_out lvm_rc -- \
         lvm vgchange --config "${cfg}" -an
 
-      # 1. NBD 장치를 물고 있는 DM 제거 (기존 로직)
+      # 1. NBD ?�치�?물고 ?�는 DM ?�거 (기존 로직)
       for holder in /sys/block/${bn}/holders/*; do
           if [[ -e "${holder}" ]]; then
               local dm_name
@@ -875,9 +875,9 @@ v2k_linux_bootstrap_one() {
           fi
       done
 
-      # 2. [추가] 'rl' (Rocky Linux) 관련 좀비 매핑 강제 제거
-      # Global Lock을 보유 중이므로, 현재 시스템에 보이는 'rl-*' 매핑은 
-      # 나의 좀비이거나 이전 실행의 찌꺼기일 확률이 높으므로 정리합니다.
+      # 2. [추�?] 'rl' (Rocky Linux) 관??좀�?매핑 강제 ?�거
+      # Global Lock??보유 중이므�? ?�재 ?�스?�에 보이??'rl-*' 매핑?� 
+      # ?�의 좀비이거나 ?�전 ?�행??찌꺼기일 ?�률???�으므�??�리?�니??
       for dm_path in /dev/mapper/rl-*; do
           [[ -e "${dm_path}" ]] || continue
           dmsetup remove --force "${dm_path}" >/dev/null 2>&1 || true
@@ -1056,15 +1056,15 @@ local qout qrc
 
   # -----------------------------------------------------------------------------
   # [FIX] Host LVM/udev Interference Mitigation (Rocky Linux Fix)
-  # 호스트 udev가 NBD 연결 즉시 'rl' VG를 자동 활성화하는 것을 강제로 해제합니다.
+  # ?�스??udev가 NBD ?�결 즉시 'rl' VG�??�동 ?�성?�하??것을 강제�??�제?�니??
   # -----------------------------------------------------------------------------
   udevadm settle >/dev/null 2>&1 || true
   
-  # 1. 호스트가 이 NBD 장치에서 활성화한 VG 즉시 비활성화 (필터 사용으로 안전 확보)
+  # 1. ?�스?��? ??NBD ?�치?�서 ?�성?�한 VG 즉시 비활?�화 (?�터 ?�용?�로 ?�전 ?�보)
   lvm vgchange --config "devices { filter=[ \"a|^${nbd_dev}|\", \"r|.*|\" ] }" -an >/dev/null 2>&1 || true
 
-  # 2. Device Mapper에 남은 좀비 매핑(holder) 강제 제거
-  # 호스트가 /dev/mapper/rl-root 등을 잡고 있으면 제거하여 이름 충돌 방지
+  # 2. Device Mapper???��? 좀�?매핑(holder) 강제 ?�거
+  # ?�스?��? /dev/mapper/rl-root ?�을 ?�고 ?�으�??�거?�여 ?�름 충돌 방�?
   local bn_fix
   bn_fix="$(basename "${nbd_dev}")"
   for holder in /sys/block/${bn_fix}/holders/*; do
@@ -1075,7 +1075,7 @@ local qout qrc
       fi
   done
 
-  # 3. LVM 캐시 갱신 (호스트가 이 장치를 더 이상 '사용 중'으로 인식하지 않게 함)
+  # 3. LVM 캐시 갱신 (?�스?��? ???�치�????�상 '?�용 �??�로 ?�식?��? ?�게 ??
   lvm pvscan --config "devices { filter=[ \"a|^${nbd_dev}|\", \"r|.*|\" ] }" --cache >/dev/null 2>&1 || true
   # -----------------------------------------------------------------------------
 
@@ -1424,7 +1424,7 @@ v2k_resolve_winpe_iso() {
   return 1
 }
 
-# vCenter(또는 지정 server)의 SSL SHA1 thumbprint 계산
+# vCenter(?�는 지??server)??SSL SHA1 thumbprint 계산
 v2k_get_ssl_thumbprint_sha1() {
   local host="$1"
   [[ -n "${host}" ]] || return 1
@@ -1561,7 +1561,7 @@ v2k_step_fail() {
 }
 
 v2k_load_runtime_flags_from_manifest() {
-  # manifest가 존재한다는 전제(v2k_require_manifest 이후 호출)
+  # manifest가 존재?�다???�제(v2k_require_manifest ?�후 ?�출)
   local force
   force="$(jq -r '.target.storage.force_block_device // false' "${V2K_MANIFEST}" 2>/dev/null || echo "false")"
 
@@ -1571,8 +1571,8 @@ v2k_load_runtime_flags_from_manifest() {
     export V2K_FORCE_BLOCK_DEVICE="0"
   fi
 
-  # Observability: force-block-device 상태를 event에 기록
-  # - command 별로 호출되므로, 해당 커맨드의 phase_start 전에 남겨도 문제 없음
+  # Observability: force-block-device ?�태�?event??기록
+  # - command 별로 ?�출?��?�? ?�당 커맨?�의 phase_start ?�에 ?�겨??문제 ?�음
   v2k_event INFO "runtime" "" "force_block_device" \
     "{\"enabled\":${force},\"source\":\"manifest\",\"manifest\":\"${V2K_MANIFEST}\"}"
 }
@@ -1614,9 +1614,9 @@ v2k_cmd_init() {
     v2k_vmware_load_cred_file "${cred_file}"
   fi
 
-  # (FIX) VDDK cred 파일은 workdir 확정/생성 이후에 저장해야 함.
-  # - 기존 코드: V2K_WORKDIR 설정 전에 install 수행 -> 빈 경로/오동작 가능
-  # - 정책: password는 manifest에 저장하지 않고, workdir 내 vddk.cred로만 보관
+  # (FIX) VDDK cred ?�일?� workdir ?�정/?�성 ?�후???�?�해????
+  # - 기존 코드: V2K_WORKDIR ?�정 ?�에 install ?�행 -> �?경로/?�동??가??
+  # - ?�책: password??manifest???�?�하지 ?�고, workdir ??vddk.cred로만 보�?
 
   # Validate & apply target overrides (CLI wins for this run)
   if [[ -n "${target_format}" ]]; then
@@ -1689,24 +1689,24 @@ v2k_cmd_init() {
     export V2K_VDDK_CRED_FILE=""
   fi
 
-  # ---- VDDK(vCenter) thumbprint 제품화 자동화 ----
-  # 1) cred_file 내부에 VDDK_THUMBPRINT가 있으면 우선 사용
-  # 2) 없으면 V2K_VDDK_SERVER(또는 vCenter host)로 openssl 계산
+  # ---- VDDK(vCenter) thumbprint ?�품???�동??----
+  # 1) cred_file ?��???VDDK_THUMBPRINT가 ?�으�??�선 ?�용
+  # 2) ?�으�?V2K_VDDK_SERVER(?�는 vCenter host)�?openssl 계산
   if [[ -n "${V2K_VDDK_CRED_FILE-}" && -f "${V2K_VDDK_CRED_FILE}" ]]; then
     # shellcheck disable=SC1090
     source "${V2K_VDDK_CRED_FILE}"
-    # cred 파일에 user/pass/server/thumbprint가 있다면 env로 승격
+    # cred ?�일??user/pass/server/thumbprint가 ?�다�?env�??�격
     [[ -n "${VDDK_USER-}" ]] && export V2K_VDDK_USER="${VDDK_USER}"
     [[ -n "${VDDK_SERVER-}" ]] && export V2K_VDDK_SERVER="${VDDK_SERVER}"
     [[ -n "${VDDK_THUMBPRINT-}" ]] && export V2K_VDDK_THUMBPRINT="${VDDK_THUMBPRINT}"
   fi
 
-  # thumbprint가 여전히 비어있으면 server 대상으로 자동 계산
+  # thumbprint가 ?�전??비어?�으�?server ?�?�으�??�동 계산
   if [[ -z "${V2K_VDDK_THUMBPRINT-}" ]]; then
     local server host_from_vcenter
     server="${V2K_VDDK_SERVER-}"
     if [[ -z "${server}" ]]; then
-      # GOVC_URL == https://x.x.x.x/sdk 형태에서 host만 추출
+      # GOVC_URL == https://x.x.x.x/sdk ?�태?�서 host�?추출
       host_from_vcenter="$(printf '%s' "${GOVC_URL-}" | sed -E 's#^[a-zA-Z]+://##; s#/.*$##; s#^.*@##; s#:[0-9]+$##')"
       server="${host_from_vcenter}"
       [[ -n "${server}" ]] && export V2K_VDDK_SERVER="${server}"
@@ -1873,16 +1873,16 @@ v2k_force_cleanup_run() {
   fi
 
   # ==============================================================================
-  # [삭제됨] 2) Defensive process kill (RunID/Workdir)
-  # 원인: RunID는 유니크하므로 좀비가 존재할 수 없으며, 오히려 부모 프로세스(sudo 등)를 죽여
-  #       스크립트가 중단되거나 세션이 종료되는 원인이 됨.
+  # [??��?? 2) Defensive process kill (RunID/Workdir)
+  # ?�인: RunID???�니?�하므�?좀비�? 존재?????�으�? ?�히??부�??�로?�스(sudo ??�?죽여
+  #       ?�크립트가 중단?�거???�션??종료?�는 ?�인????
   # ==============================================================================
   # [FIX] Do not kill myself (current PID $$) via pkill -f pattern match
   #if [[ -n "${run_id}" ]]; then
-    # 자기 자신($$)을 제외한 나머지 프로세스만 종료
+    # ?�기 ?�신($$)???�외???�머지 ?�로?�스�?종료
   #  pgrep -f "ablestack_v2k.*${run_id}" | grep -v "^$$\$" | xargs -r kill -TERM >/dev/null 2>&1 || true
   #fi
-  # [FIX 2] workdir 기반 종료 시 자기 자신($$) 제외 (지적해주신 부분)
+  # [FIX 2] workdir 기반 종료 ???�기 ?�신($$) ?�외 (지?�해주신 부�?
   #if [[ -n "${workdir}" ]]; then
   #  pgrep -f "${workdir}" | grep -v "^$$\$" | xargs -r kill -TERM >/dev/null 2>&1 || true
   #fi
@@ -1929,7 +1929,7 @@ v2k_cmd_sync() {
 
   v2k_require_manifest
   v2k_load_runtime_flags_from_manifest
-  local which="${1:-}" jobs=1 coalesce_gap=$((1024*1024)) chunk=$((4*1024*1024))
+  local which="${1:-}" jobs=1 coalesce_gap=$((64*1024)) chunk=$((4*1024*1024))
   shift || true
   while [[ $# -gt 0 ]]; do
     case "$1" in
@@ -1989,7 +1989,7 @@ v2k_cmd_sync() {
       v2k_event INFO "sync.base" "" "phase_start" "{\"jobs\":${jobs}}"
       v2k_transfer_base_all "${V2K_MANIFEST}" "${jobs}"
 
-      # [Fix] Base Sync 직후, 현재 Change ID를 조회하여 기준점 확보 (데이터 누락 방지)
+      # [Fix] Base Sync 직후, ?�재 Change ID�?조회?�여 기�????�보 (?�이???�락 방�?)
       local py_script_path="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/vmware_changed_areas.py"
       v2k_manifest_fetch_and_save_base_change_ids "${V2K_MANIFEST}" "${py_script_path}"
 
@@ -2105,7 +2105,7 @@ v2k_cmd_cutover() {
   guest_id="$(jq -r '.source.vm.guestId // .source.vm.guest_id // empty' "${V2K_MANIFEST}" 2>/dev/null || true)"
   guest_full="$(jq -r '.source.vm.guestFullName // .source.vm.guest_full_name // empty' "${V2K_MANIFEST}" 2>/dev/null || true)"
 
-  # windows heuristics (govc 기준)
+  # windows heuristics (govc 기�?)
   if [[ "${guest_family}" == "windowsGuest" ]]; then
     is_windows=1
   elif [[ "${guest_id}" =~ [Ww]in ]]; then
@@ -2211,8 +2211,8 @@ v2k_cmd_cutover() {
   # final sync (observable)
   # ---------------------------
   _ts="$(v2k_now_ms)"
-  v2k_step_start "cutover" "final_sync" "{\"jobs\":1,\"coalesce_gap\":$((1024*1024)),\"chunk\":$((4*1024*1024))}"
-  if v2k_transfer_patch_all "${V2K_MANIFEST}" "final" 1 $((1024*1024)) $((4*1024*1024)); then
+  v2k_step_start "cutover" "final_sync" "{\"jobs\":1,\"coalesce_gap\":$((64*1024)),\"chunk\":$((4*1024*1024))}"
+  if v2k_transfer_patch_all "${V2K_MANIFEST}" "final" 1 $((64*1024)) $((4*1024*1024)); then
     v2k_manifest_phase_done "${V2K_MANIFEST}" "final_sync" || true
     v2k_step_done "cutover" "final_sync" "${_ts}" 0 "{}"
   else
@@ -2390,7 +2390,7 @@ v2k_cmd_cutover() {
   v2k_event INFO "cutover" "" "phase_done" "{}"
   v2k_json_or_text_ok "cutover" "{}" "Cutover done (final snapshot + final sync)."
 
-  # Cleanup 진입 전 vCenter 상태 안정화 대기
+  # Cleanup 진입 ??vCenter ?�태 ?�정???��?
   sleep 3
 }
 
diff --git a/lib/v2k/fleet.sh b/lib/v2k/fleet.sh
index 22cf1f5..8546692 100644
--- a/lib/v2k/fleet.sh
+++ b/lib/v2k/fleet.sh
@@ -407,25 +407,25 @@ v2k_fleet_now_rfc3339() {
   date +"%Y-%m-%dT%H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 }
 
-# [Helper] 실행 중인 patch_apply.py 프로세스의 I/O 양을 조회하여 반환
+# [Helper] ?�행 중인 patch_apply.py ?�로?�스??I/O ?�을 조회?�여 반환
 v2k_fleet_get_active_patch_bytes() {
   local target_path="$1"
   [[ -z "${target_path}" ]] && echo 0 && return
 
-  # 1. target_path를 인자로 가지는 python3 patch_apply.py 프로세스 찾기
-  # pgrep -f는 전체 커맨드라인을 검색함.
-  # grep으로 patch_apply.py와 target_path가 모두 포함된 라인 필터링
+  # 1. target_path�??�자�?가지??python3 patch_apply.py ?�로?�스 찾기
+  # pgrep -f???�체 커맨?�라?�을 검?�함.
+  # grep?�로 patch_apply.py?� target_path가 모두 ?�함???�인 ?�터�?
   local pids
   pids=$(pgrep -f "patch_apply.py" 2>/dev/null || true)
   
   local total_active_bytes=0
   
   for pid in ${pids}; do
-    # 해당 PID의 cmdline 확인 (정확성 보장)
+    # ?�당 PID??cmdline ?�인 (?�확??보장)
     if [[ -f "/proc/${pid}/cmdline" ]]; then
-      # cmdline은 null로 구분되므로 cat -v 등으로 읽거나 grep -a 사용
+      # cmdline?� null�?구분?��?�?cat -v ?�으�??�거??grep -a ?�용
       if grep -a -q "${target_path}" "/proc/${pid}/cmdline"; then
-        # 2. /proc/[pid]/io 에서 write_bytes 추출
+        # 2. /proc/[pid]/io ?�서 write_bytes 추출
         # write_bytes: 123456
         local wb
         wb=$(grep "write_bytes:" "/proc/${pid}/io" 2>/dev/null | awk '{print $2}' || echo 0)
@@ -438,7 +438,7 @@ v2k_fleet_get_active_patch_bytes() {
 }
 
 # ------------------------------------------------------------
-# 상태 조회 상세 계산 (딜레이 제거, 상세 상태 복구, 에러 우선 감지)
+# ?�태 조회 ?�세 계산 (?�레???�거, ?�세 ?�태 복구, ?�러 ?�선 감�?)
 # ------------------------------------------------------------
 v2k_fleet_calculate_detailed_status() {
   local workdir="$1" manifest="$2" phase_hint="$3"
@@ -448,7 +448,7 @@ v2k_fleet_calculate_detailed_status() {
   local vm_total_phys=0 vm_current_phys=0 vm_sync_pct=0
   local t_gb c_gb ref_state="starting"
 
-  # 1. 로그 분석 (최근 50줄)
+  # 1. 로그 분석 (최근 50�?
   if [[ -f "${events_log}" ]]; then
     last_ev_json="$(tail -n 50 "${events_log}" 2>/dev/null | jq -sR '
       split("\n") | map(select(length>0) | fromjson?) 
@@ -460,7 +460,7 @@ v2k_fleet_calculate_detailed_status() {
     level_raw=$(echo "${last_ev_json}" | jq -r '.level // ""')
   fi
 
-  # 2. Step 문자열 상세 매핑
+  # 2. Step 문자???�세 매핑
   case "${phase_raw:-}" in
     cbt_enable)     step_str="cbt enabled" ;;
     snapshot.base)  step_str="base snap" ;;
@@ -468,7 +468,7 @@ v2k_fleet_calculate_detailed_status() {
     snapshot.incr)  step_str="incr snap" ;;
     sync.incr|incr_sync) step_str="incr sync" ;;
     
-    # [상세화] Cutover 및 Bootstrap 단계 세분화
+    # [?�세?? Cutover �?Bootstrap ?�계 ?�분??
     snapshot.final) step_str="final snap" ;;
     sync.final|final_sync) step_str="final sync" ;;
     linux_bootstrap)
@@ -496,12 +496,12 @@ v2k_fleet_calculate_detailed_status() {
     *)              step_str="${phase_raw:-Ready}" ;;
   esac
 
-  # 완료 이벤트 오버라이드
+  # ?�료 ?�벤???�버?�이??
   if [[ "${phase_raw}" == "cleanup" && "${event_raw}" == *"done"* ]]; then
       step_str="done"
   fi
 
-  # 3. 물리 용량 계산
+  # 3. 물리 ?�량 계산
   vm_total_phys=$(jq -r '[.disks[] | (.vmdk.physical_bytes // 0)] | add' "${manifest}" 2>/dev/null || echo 0)
   if [[ "${vm_total_phys}" -le 0 && -f "${govc_env}" ]]; then
     export GOVC_URL=$(grep "GOVC_URL=" "${govc_env}" | cut -d'=' -f2- | tr -d '"' | tr -d "'")
@@ -517,7 +517,7 @@ v2k_fleet_calculate_detailed_status() {
   local display_total
   display_total=$(awk "BEGIN {printf \"%.1f\", ${vm_total_phys}/1024/1024/1024}")
 
-  # [우선순위 1] 에러/실패 감지
+  # [?�선?�위 1] ?�러/?�패 감�?
   if [[ "${level_raw}" == "ERROR" || "${event_raw}" == *"failed"* || "${event_raw}" == "fail" ]]; then
       jq -cn \
         --arg step "${step_str}" \
@@ -528,7 +528,7 @@ v2k_fleet_calculate_detailed_status() {
       return 0
   fi
 
-  # [우선순위 2] 완료 감지
+  # [?�선?�위 2] ?�료 감�?
   local is_cutover_done
   is_cutover_done=$(jq -r '.phases.cutover.done // false' "${manifest}" 2>/dev/null)
   
@@ -542,10 +542,10 @@ v2k_fleet_calculate_detailed_status() {
       return 0
   fi
 
-  # [우선순위 3] 진행 상태 용량 계산 (Logic Fix)
-  # - 기본적으로 Phase 2 힌트가 있으면 Delta 모드로 동작하지만,
-  # - Bootstrap, Cleanup 등 "동기화 이후" 단계에서는 0.0G가 아닌 전체 용량(100%)을 보여주기 위해
-  #   강제로 Base Mode(Done)로 취급합니다.
+  # [?�선?�위 3] 진행 ?�태 ?�량 계산 (Logic Fix)
+  # - 기본?�으�?Phase 2 ?�트가 ?�으�?Delta 모드�??�작?��?�?
+  # - Bootstrap, Cleanup ??"?�기???�후" ?�계?�서??0.0G가 ?�닌 ?�체 ?�량(100%)??보여주기 ?�해
+  #   강제�?Base Mode(Done)�?취급?�니??
   local sync_mode="base"
   local target_phase_key="sync.base"
   local force_full_display=0
@@ -566,7 +566,7 @@ v2k_fleet_calculate_detailed_status() {
   fi
 
   local is_base_done=$(jq -r '.phases.base_sync.done // false' "${manifest}" 2>/dev/null)
-  local history_json="{}" # (History 로직은 생략하거나 필요시 기존 유지)
+  local history_json="{}" # (History 로직?� ?�략?�거???�요??기존 ?��?)
 
   if [[ "${sync_mode}" == "base" ]]; then
     if [[ "${is_base_done}" == "true" || "${force_full_display}" -eq 1 ]]; then
@@ -610,7 +610,7 @@ v2k_fleet_calculate_detailed_status() {
     if [[ "${sync_mode}" == "delta" ]]; then vm_sync_pct=100; else vm_sync_pct=0; fi
   fi
   
-  # Delta 모드인데 0.0G/0.0G (100%) 로 나오면 보기 싫으므로, 부트스트랩/완료 단계면 display_total(원본크기) 사용
+  # Delta 모드?�데 0.0G/0.0G (100%) �??�오�?보기 ?�으므�? 부?�스?�랩/?�료 ?�계�?display_total(?�본?�기) ?�용
   if [[ "${force_full_display}" -eq 1 ]]; then
      display_current="${display_total}"
   fi
@@ -1148,16 +1148,16 @@ v2k_fleet_cmd_run() {
 
   # --------------------------------------------------------------------------
   # [FIX START] Idempotency Check: Filter out completed VMs
-  # VM 데이터는 'fleet' 폴더가 아닌 '/var/lib/ablestack-v2k/<VM_NAME>'에 있습니다.
+  # VM ?�이?�는 'fleet' ?�더가 ?�닌 '/var/lib/ablestack-v2k/<VM_NAME>'???�습?�다.
   # --------------------------------------------------------------------------
   local -a pending_vms=()
   
-  # [수정] VM 데이터가 있는 실제 루트 디렉토리 지정
+  # [?�정] VM ?�이?��? ?�는 ?�제 루트 ?�렉?�리 지??
   local data_root="${V2K_WORKDIR:-/var/lib/ablestack-v2k}"
 
   for vm in "${vms[@]}"; do
       local skip=0
-      # [수정] VM별 디렉토리 경로 수정 (fleet 제외)
+      # [?�정] VM�??�렉?�리 경로 ?�정 (fleet ?�외)
       local current_vm_dir="${data_root}/${vm}"
       
       # 최신 Run ID 조회
@@ -1171,16 +1171,16 @@ v2k_fleet_cmd_run() {
           if [[ -f "${current_manifest}" ]]; then
               local is_done="false"
               
-              # Split 변수에 따라 검사할 JSON 키 분기
+              # Split 변?�에 ?�라 검?�할 JSON ??분기
               if [[ "${split}" == "phase1" ]]; then
-                  # Phase 1 요청 -> Base Sync 완료 여부 확인
+                  # Phase 1 ?�청 -> Base Sync ?�료 ?��? ?�인
                   is_done=$(jq -r '.phases.base_sync.done // false' "${current_manifest}" 2>/dev/null)
               else
-                  # Phase 2 요청 -> Cutover 완료 여부 확인
+                  # Phase 2 ?�청 -> Cutover ?�료 ?��? ?�인
                   is_done=$(jq -r '.phases.cutover.done // false' "${current_manifest}" 2>/dev/null)
               fi
               
-              # 해당 단계가 이미 완료되었고, 강제 실행 플래그가 없으면 스킵
+              # ?�당 ?�계가 ?��? ?�료?�었�? 강제 ?�행 ?�래그�? ?�으�??�킵
               if [[ "${is_done}" == "true" && "${V2K_FORCE:-0}" != "1" ]]; then
                   echo "[Fleet] Skipping VM '${vm}': Already completed (${split})."
                   skip=1
@@ -1193,13 +1193,13 @@ v2k_fleet_cmd_run() {
       fi
   done
 
-  # 모든 VM이 완료된 경우 종료
+  # 모든 VM???�료??경우 종료
   if (( ${#pending_vms[@]} == 0 )); then
       echo "All requested VMs are already completed for ${split}. Nothing to do."
       exit 0
   fi
 
-  # 필터링된 VM 목록으로 vms 배열 및 vm_raw 문자열 갱신
+  # ?�터링된 VM 목록?�로 vms 배열 �?vm_raw 문자??갱신
   vms=("${pending_vms[@]}")
   vm_raw=$(IFS=,; echo "${vms[*]}")
   
@@ -1208,7 +1208,7 @@ v2k_fleet_cmd_run() {
   # [FIX END]
   # --------------------------------------------------------------------------
 
-  # Fleet 실행 로그는 기존대로 fleet 폴더에 저장
+  # Fleet ?�행 로그??기존?��?fleet ?�더???�??
   local fleet_id
   fleet_id="$(v2k_fleet_mk_fleet_id)"
   local out_dir
@@ -1252,7 +1252,7 @@ v2k_fleet_cmd_run() {
   fi
 
   (
-    # 필터링된 vm_raw를 넘겨줍니다.
+    # ?�터링된 vm_raw�??�겨줍니??
     _v2k_fleet_run_core "${fleet_id}" "${split}" "${vm_raw}" "${extra_args[@]+"${extra_args[@]}"}"
   ) > /dev/null 2>&1 & disown
 
@@ -1705,49 +1705,49 @@ v2k_fleet_cmd_status() {
 
       # --------------------------------------------------------------------------
       # [FIX 3] Phase Promotion Logic (Strict Inclusion - Incr Excluded)
-      # 'incr sync'는 Phase 1으로 유지하고, 
-      # 실제 Cutover 및 Final Sync 관련 작업만 Phase 2로 승격합니다.
+      # 'incr sync'??Phase 1?�로 ?��??�고, 
+      # ?�제 Cutover �?Final Sync 관???�업�?Phase 2�??�격?�니??
       # --------------------------------------------------------------------------
       local is_phase2_activity=0
       
-      # 1) 최종 동기화(final) 및 스냅샷 (증분 incr 제외!)
+      # 1) 최종 ?�기??final) �??�냅??(증분 incr ?�외!)
       if [[ "${step}" == *"final"* ]]; then
           is_phase2_activity=1
       fi
       
-      # 2) 컷오버 및 종료
+      # 2) 컷오�?�?종료
       if [[ "${step}" == *"cutover"* || "${step}" == *"shut"* ]]; then
           is_phase2_activity=1
       fi
       
-      # 3) 부트스트랩 관련 (initramfs, mount, lvm, winpe)
+      # 3) 부?�스?�랩 관??(initramfs, mount, lvm, winpe)
       if [[ "${step}" == *"bootstrap"* || "${step}" == *"initramfs"* || "${step}" == *"mount"* || "${step}" == *"lvm"* || "${step}" == *"winpe"* ]]; then
           is_phase2_activity=1
       fi
       
-      # 4) 클린업 및 완료
+      # 4) ?�린??�??�료
       if [[ "${step}" == *"clean"* || "${step}" == "success" || "${step}" == "done" ]]; then
-          # 단, Phase 1 완료 상태(done)가 아니라 실제 작업 완료(done)인 경우여야 함.
-          # 이는 p2_done 체크와 결합되어 처리됨.
+          # ?? Phase 1 ?�료 ?�태(done)가 ?�니???�제 ?�업 ?�료(done)??경우?�야 ??
+          # ?�는 p2_done 체크?� 결합?�어 처리??
           if [[ "${p2_done}" == "true" ]]; then
               is_phase2_activity=1
           fi
       fi
 
-      # 조건 충족 시 승격
+      # 조건 충족 ???�격
       if [[ "${is_phase2_activity}" -eq 1 ]]; then
           phase="phase2"
       fi
 
-      # [Phase 1 완료 상태 오버라이드]
-      # 승격되지 않고 여전히 phase1 상태라면 (즉, incr sync나 대기 상태),
-      # 완료 플래그를 확인하여 상태를 표시합니다.
+      # [Phase 1 ?�료 ?�태 ?�버?�이??
+      # ?�격?��? ?�고 ?�전??phase1 ?�태?�면 (�? incr sync???��??�태),
+      # ?�료 ?�래그�? ?�인?�여 ?�태�??�시?�니??
       if [[ "${phase}" == "phase1" && "${p1_done}" == "true" && "${state}" != "failed" ]]; then
-          # 증분 동기화(incr) 중일 때는 'started/running' 상태를 그대로 보여줌 (덮어쓰기 방지)
+          # 증분 ?�기??incr) 중일 ?�는 'started/running' ?�태�?그�?�?보여�?(??��?�기 방�?)
           if [[ "${step}" == *"incr"* ]]; then
               : # Keep current state (e.g., Phase 1 | started | incr sync)
           else
-              # 그 외의 경우(run, Ready 등 유휴 상태)에는 'Phase2 Ready'로 표시
+              # �??�의 경우(run, Ready ???�휴 ?�태)?�는 'Phase2 Ready'�??�시
               state="done"
               step="Phase2 Ready"
           fi
diff --git a/lib/v2k/manifest.sh b/lib/v2k/manifest.sh
index 0c21823..a0d3ed7 100644
--- a/lib/v2k/manifest.sh
+++ b/lib/v2k/manifest.sh
@@ -29,7 +29,7 @@ v2k_manifest_path() {
 
 # ---------------------------------------------------------------------
 # Runtime helpers (split-run/state machine)
-# [추가됨] 이 섹션이 새로 들어갑니다.
+# [추�??? ???�션???�로 ?�어갑니??
 # ---------------------------------------------------------------------
 
 v2k_manifest_runtime_set() {
@@ -69,11 +69,11 @@ v2k_manifest_init() {
   local created_at
   created_at="$(date +"%Y-%m-%dT%H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/')"
 
-  # VDDK(vCenter 중심) 메타데이터/오버라이드
+  # VDDK(vCenter 중심) 메�??�이???�버?�이??
   # - V2K_VDDK_SERVER: vCenter host/ip (권장)
   # - V2K_VDDK_THUMBPRINT: vCenter SSL SHA1 thumbprint (권장)
-  # - V2K_VDDK_USER: 선택(cred_file 내부의 VDDK_USER/VDDK_PASSWORD가 실사용)
-  # - V2K_VDDK_CRED_FILE: workdir 하위에 복사된 vddk.cred 경로
+  # - V2K_VDDK_USER: ?�택(cred_file ?��???VDDK_USER/VDDK_PASSWORD가 ?�사??
+  # - V2K_VDDK_CRED_FILE: workdir ?�위??복사??vddk.cred 경로
   local vcenter_host vddk_server vddk_thumbprint vddk_user vddk_cred_file
   vcenter_host="$(printf '%s' "${vcenter}" | sed -E 's#^[a-zA-Z]+://##; s#/.*$##; s#^.*@##; s#:[0-9]+$##')"
   vddk_server="${V2K_VDDK_SERVER-}"
@@ -109,7 +109,7 @@ v2k_manifest_init() {
     *) echo "Unsupported storage type: ${storage_type}" >&2; return 2;;
   esac
 
-  # inventory JSON이 단일 JSON 객체인지 정규화 (여기서 깨지면 즉시 실패)
+  # inventory JSON???�일 JSON 객체?��? ?�규??(?�기??깨�?�?즉시 ?�패)
   local inv_compact
   if ! inv_compact="$(printf '%s' "${inv_json}" | jq -c '.' 2>/dev/null)"; then
     echo "[ERR] inv_json is not a single valid JSON object." >&2
@@ -119,7 +119,7 @@ v2k_manifest_init() {
     return 2
   fi
 
-  # storage_map JSON도 정규화
+  # storage_map JSON???�규??
   local map_compact
   if ! map_compact="$(printf '%s' "${storage_map_json}" | jq -c '.' 2>/dev/null)"; then
     echo "[ERR] V2K_TARGET_STORAGE_MAP_JSON is not valid JSON: ${storage_map_json}" >&2
@@ -130,7 +130,7 @@ v2k_manifest_init() {
   vmhash="$(jq -r '.vm.name // ""' <<<"${inv_compact}" | sha256sum | awk '{print substr($1,1,8)}')"
   [[ -n "${vmhash}" ]] || vmhash="00000000"
 
-  # ✅ inv_json을 stdin으로 jq에 전달 (검증된 패턴)
+  # ??inv_json??stdin?�로 jq???�달 (검증된 ?�턴)
   printf '%s' "${inv_compact}" | jq -c \
     --arg schema "ablestack-v2k/manifest-v1" \
     --arg run_id "${run_id}" \
@@ -158,14 +158,14 @@ v2k_manifest_init() {
 
     . as $inv
 
-    # inventory 검증
+    # inventory 검�?
     | if ($inv.disks|type) != "array" then error("inventory_json .disks is not array") else . end
     | if ($inv.disks|length) == 0 then error("inventory_json .disks is empty") else . end
 
-    # 확장자(파일 타입에서만 사용)
+    # ?�장???�일 ?�?�에?�만 ?�용)
     | ($fmt) as $ext
 
-    # VM 이름 정규화 + 해시
+    # VM ?�름 ?�규??+ ?�시
     | ($inv.vm.name|tostring) as $vmname_raw
     | ($vmname_raw
         | gsub("[/\\\\]"; "_")
@@ -178,7 +178,7 @@ v2k_manifest_init() {
     | (if ($vmname_norm|length) > 0 then $vmname_norm else "vm" end) as $vmname
     | ($vmname + "-" + $vmhash) as $vmname_file
 
-    # 디스크 변환: to_entries는 {key,value} 이므로 key를 인덱스로 사용
+    # ?�스??변?? to_entries??{key,value} ?��?�?key�??�덱?�로 ?�용
     | ($inv.disks
         | to_entries
         | map(
@@ -210,21 +210,21 @@ v2k_manifest_init() {
           )
       ) as $disks
 
-    # block/rbd 타입이면 map이 필수
+    # block/rbd ?�?�이�?map???�수
     | if ($st=="block" or $st=="rbd") then
         if ([ $disks[] | select(.transfer.target_path=="" or .transfer.target_path=="null") ] | length) > 0 then
           error("target.storage.type=" + $st + " requires target.storage.map for all disks")
         else . end
       else . end
 
-    # rbd 타입이면 각 target_path가 rbd: 로 시작해야 함
+    # rbd ?�?�이�?�?target_path가 rbd: �??�작?�야 ??
     | if $st=="rbd" then
         if ([ $disks[] | select((.transfer.target_path|tostring|startswith("rbd:"))|not) ] | length) > 0 then
           error("target.storage.type=rbd requires transfer.target_path to start with rbd:")
         else . end
       else . end
 
-    # target_path 중복 방지
+    # target_path 중복 방�?
     | ( [ $disks[] | .transfer.target_path ] as $paths
         | if (($paths|length) != (($paths|sort|unique)|length)) then
             error("Duplicate transfer.target_path detected")
@@ -246,9 +246,9 @@ v2k_manifest_init() {
           esxi_thumbprint: ($inv.esxi_thumbprint // ""),
 
           # VDDK access (vCenter 중심)
-          # - server: 기본 vCenter host (override 가능)
-          # - thumbprint: vCenter SSL SHA1 thumbprint (override 가능)
-          # - cred_file: VDDK_USER/VDDK_PASSWORD[/VDDK_SERVER/VDDK_THUMBPRINT] 포함
+          # - server: 기본 vCenter host (override 가??
+          # - thumbprint: vCenter SSL SHA1 thumbprint (override 가??
+          # - cred_file: VDDK_USER/VDDK_PASSWORD[/VDDK_SERVER/VDDK_THUMBPRINT] ?�함
           vddk: {
             server: (if ($vddk_server|length) > 0 then $vddk_server else $vcenter_host end),
             thumbprint: (if ($vddk_thumbprint|length) > 0 then $vddk_thumbprint else "" end),
@@ -513,7 +513,7 @@ v2k_manifest_status_summary() {
   local manifest="$1" events="${2:-}"
   local msum
   msum="$(jq -c '
-    # runtime.sync_issues는 engine.sh가 incr/final guard에서 기록(제품화 관측용)
+    # runtime.sync_issues??engine.sh가 incr/final guard?�서 기록(?�품??관측용)
     (.runtime // {}) as $rt
     | ($rt.sync_issues // []) as $issues
     | {
@@ -536,7 +536,7 @@ v2k_manifest_status_summary() {
           last_sync_issue:(if ($issues|length) > 0 then $issues[-1] else null end)
         },
 
-        # 사람이 보기 쉬운 "상태 요약 힌트" (UI/CLI 공통 활용)
+        # ?�람??보기 ?�운 "?�태 ?�약 ?�트" (UI/CLI 공통 ?�용)
         hints:{
           has_sync_issues:(($issues|length) > 0),
           last_issue_code:(if ($issues|length) > 0 then ($issues[-1].code // null) else null end),
@@ -557,7 +557,7 @@ v2k_manifest_fetch_and_save_base_change_ids() {
   local manifest="$1" py_script="$2"
   local count i disk_id vm_name snap_name json_out new_id
 
-  # Python 스크립트 실행을 위한 환경변수 설정 (Govc 환경변수 활용)
+  # Python ?�크립트 ?�행???�한 ?�경변???�정 (Govc ?�경변???�용)
   export VCENTER_HOST="${GOVC_URL:?missing GOVC_URL}"
   export VCENTER_USER="${GOVC_USERNAME:?missing GOVC_USERNAME}"
   export VCENTER_PASS="${GOVC_PASSWORD:?missing GOVC_PASSWORD}"
@@ -566,18 +566,18 @@ v2k_manifest_fetch_and_save_base_change_ids() {
   vm_name="$(v2k_manifest_get_vm_name "${manifest}")"
   count="$(jq -r '.disks|length' "${manifest}")"
 
-  # Base 스냅샷 이름 조회
+  # Base ?�냅???�름 조회
   snap_name="$(jq -r ".disks[0].snapshots.base.name" "${manifest}")"
 
   for ((i=0;i<count;i++)); do
     disk_id="$(jq -r ".disks[$i].disk_id" "${manifest}")"
     
-    # --change-id "*"를 넘겨서 현재 시점의 Change ID (new_change_id)만 받아온다.
+    # --change-id "*"�??�겨???�재 ?�점??Change ID (new_change_id)�?받아?�다.
     json_out="$(python3 "${py_script}" --vm "${vm_name}" --snapshot "${snap_name}" --disk-id "${disk_id}" --change-id "*" 2>/dev/null || true)"
     new_id="$(echo "${json_out}" | jq -r '.new_change_id // empty')"
 
     if [[ -n "${new_id}" && "${new_id}" != "null" ]]; then
-      # 조회된 ID를 last_change_id로 저장 (다음 Incr의 기준점이 됨)
+      # 조회??ID�?last_change_id�??�??(?�음 Incr??기�??�이 ??
       v2k_manifest_set_disk_last_change_id "${manifest}" "${i}" "${new_id}"
     fi
   done
diff --git a/lib/v2k/nbd_utils.sh b/lib/v2k/nbd_utils.sh
index 6b9df2b..2a9f7aa 100644
--- a/lib/v2k/nbd_utils.sh
+++ b/lib/v2k/nbd_utils.sh
@@ -16,7 +16,7 @@
 # ---------------------------------------------------------------------
 set -euo pipefail
 
-# [전역 설정] 모든 VM이 공유하는 예약 디렉토리
+# [?�역 ?�정] 모든 VM??공유?�는 ?�약 ?�렉?�리
 V2K_NBD_LOCK_ROOT="/var/lock/ablestack-v2k/reservations"
 
 # ---------------------------
@@ -133,32 +133,32 @@ v2k_nbd_alloc() {
     lock_dir="${V2K_NBD_LOCK_ROOT}/nbd${i}.lock.d"
     pid_file="${lock_dir}/pid"
 
-    # 1. 원자적(Atomic) 예약 시도: mkdir
+    # 1. ?�자??Atomic) ?�약 ?�도: mkdir
     if mkdir "${lock_dir}" 2>/dev/null; then
-      # 예약 성공! 내 PID 기록
+      # ?�약 ?�공! ??PID 기록
       echo "$$" > "${pid_file}"
       
-      # 2. 커널 상태 이중 체크 (이미 사용 중인지)
+      # 2. 커널 ?�태 ?�중 체크 (?��? ?�용 중인지)
       if v2k_nbd_is_in_use "${dev}" || v2k_nbd_has_dm_children "${dev}"; then
-        # 사용 중이면 예약 취소하고 다음으로
+        # ?�용 중이�??�약 취소?�고 ?�음?�로
         rm -rf "${lock_dir}"
         continue
       fi
       
-      # 최종 할당 성공
+      # 최종 ?�당 ?�공
       echo "${dev}"
       return 0
     else
-      # 예약 실패 (이미 락이 존재함). 좀비 락인지 확인
+      # ?�약 ?�패 (?��? ?�이 존재??. 좀�??�인지 ?�인
       if [[ -f "${pid_file}" ]]; then
         owner_pid="$(cat "${pid_file}" 2>/dev/null || true)"
-        # 프로세스가 죽었고($owner_pid 없음) + 커널에서도 사용 안 함 -> 좀비 락
+        # ?�로?�스가 죽었�?$owner_pid ?�음) + 커널?�서???�용 ????-> 좀�???
         if [[ -n "${owner_pid}" ]] && ! kill -0 "${owner_pid}" 2>/dev/null; then
            if ! v2k_nbd_is_in_use "${dev}"; then
-             # 좀비 락 청소 후 재시도
+             # 좀�???�?�� ???�시??
              rm -rf "${lock_dir}"
-             # 이번 루프(i)를 다시 시도하기 위해 i를 하나 줄이거나, 그냥 다음으로 넘어감.
-             # 안전하게 다음 디바이스 탐색 (다음 실행 시엔 청소되어 있을 것임)
+             # ?�번 루프(i)�??�시 ?�도?�기 ?�해 i�??�나 줄이거나, 그냥 ?�음?�로 ?�어�?
+             # ?�전?�게 ?�음 ?�바?�스 ?�색 (?�음 ?�행 ?�엔 �?��?�어 ?�을 것임)
            fi
         fi
       fi
@@ -174,15 +174,15 @@ v2k_nbd_free() {
   local base lock_dir
   [[ -z "${dev}" ]] && return 0
   
-  # 연결 해제 (기존 로직 수행)
+  # ?�결 ?�제 (기존 로직 ?�행)
   v2k_nbd_disconnect "${dev}"
 
-  # 전역 예약 해제
+  # ?�역 ?�약 ?�제
   base="$(basename "${dev}")"
   lock_dir="${V2K_NBD_LOCK_ROOT}/${base}.lock.d"
   if [[ -d "${lock_dir}" ]]; then
-     # 내 락인지 확인하고 지우는 것이 가장 안전하지만, 
-     # 보통 free를 호출하는 건 주인이므로 강제 삭제
+     # ???�인지 ?�인?�고 지?�는 것이 가???�전?��?�? 
+     # 보통 free�??�출?�는 �?주인?��?�?강제 ??��
      rm -rf "${lock_dir}"
   fi
 }
diff --git a/lib/v2k/orchestrator.sh b/lib/v2k/orchestrator.sh
index e28f93c..c3909cd 100644
--- a/lib/v2k/orchestrator.sh
+++ b/lib/v2k/orchestrator.sh
@@ -126,7 +126,7 @@ v2k_build_govc_url_from_vcenter_host() {
 }
 
 v2k_generate_run_id() {
-  # engine.sh init과 동일한 형식(호환성 유지)
+  # engine.sh init�??�일???�식(?�환???��?)
   # YYYYMMDD-HHMMSS-<4bytes hex>
   printf '%s-%s\n' \
     "$(date +%Y%m%d-%H%M%S)" \
@@ -165,7 +165,7 @@ v2k_keep_vddk_cred_in_workdir() {
 v2k_source_kv_env() {
   local path="$1"
   [[ -f "${path}" ]] || return 0
-  # key=value 파일을 현재 쉘에 로드 + export
+  # key=value ?�일???�재 ?�에 로드 + export
   set -a
   # shellcheck disable=SC1090
   source "${path}"
@@ -188,7 +188,7 @@ v2k_shell_quote_args() {
 }
 
 # -----------------------------------------------------------------------------
-# Foreground worker (기존 파이프라인)
+# Foreground worker (기존 ?�이?�라??
 # -----------------------------------------------------------------------------
 v2k_cmd_run_foreground() {
   v2k_run_defaults
@@ -650,7 +650,7 @@ v2k_cmd_run_foreground() {
 }
 
 # -----------------------------------------------------------------------------
-# Background launcher (default): run_id 반환 후 워커를 nohup로 분리 실행
+# Background launcher (default): run_id 반환 ???�커�?nohup�?분리 ?�행
 # -----------------------------------------------------------------------------
 v2k_cmd_run() {
   # If user explicitly wants foreground
diff --git a/lib/v2k/target_libvirt.sh b/lib/v2k/target_libvirt.sh
index a98204a..e437940 100644
--- a/lib/v2k/target_libvirt.sh
+++ b/lib/v2k/target_libvirt.sh
@@ -164,7 +164,7 @@ v2k_target_generate_libvirt_xml() {
     local vars_path="${fw[2]:-}"
     local vars_fmt="${fw[3]:-}"
 
-    # 방어(필수): 비어있으면 즉시 실패
+    # 방어(?�수): 비어?�으�?즉시 ?�패
     if [[ -z "${code_path}" || -z "${code_fmt}" || -z "${vars_path}" || -z "${vars_fmt}" ]]; then
       echo "OVMF pick returned empty fields: code_path='${code_path}' code_fmt='${code_fmt}' vars_path='${vars_path}' vars_fmt='${vars_fmt}'" >&2
       return 41
@@ -303,24 +303,24 @@ v2k_target_set_uefi_secureboot() {
     code="${base}/OVMF_CODE.fd"
     vars="${base}/OVMF_VARS.fd"
     secure_attr="no"
-    firmware_block=""  # WinPE용: firmware feature block 제거(가장 호환성 좋음)
+    firmware_block=""  # WinPE?? firmware feature block ?�거(가???�환??좋음)
   fi
 
   [[ -f "${code}" ]] || { echo "Missing OVMF code: ${code}" >&2; return 1; }
   [[ -f "${vars}" ]] || { echo "Missing OVMF vars: ${vars}" >&2; return 1; }
 
-  # 1) <loader> 완전 제거
+  # 1) <loader> ?�전 ?�거
   perl -0777 -pe "s#<loader[^>]*>[^<]*</loader>##s" \
     "${tmp}.in" > "${tmp}.mid"
 
-  # 2) <firmware> 블록도 완전 제거 (남아있으면 on/off 불일치의 근본 원인)
+  # 2) <firmware> 블록???�전 ?�거 (?�아?�으�?on/off 불일치의 근본 ?�인)
   perl -0777 -i -pe "s#<firmware>.*?</firmware>\s*##s" "${tmp}.mid"
 
-  # 3) <type> 뒤에 loader + (필요 시) firmware block 삽입
+  # 3) <type> ?�에 loader + (?�요 ?? firmware block ?�입
   perl -0777 -i -pe "s#(<type[^>]*>[^<]*</type>)#\$1\n    <loader readonly='yes' type='pflash' format='qcow2' secure='${secure_attr}'>${code}</loader>${firmware_block}#s" \
     "${tmp}.mid"
 
-  # 4) nvram 정규화 (template/format 일관 유지)
+  # 4) nvram ?�규??(template/format ?��? ?��?)
   perl -0777 -i -pe "s#<nvram[^>]*>#<nvram template='${vars}' templateFormat='qcow2' format='qcow2'>#s" \
     "${tmp}.mid"
 
@@ -342,11 +342,11 @@ v2k_target_set_boot_cdrom_only() {
 
   _v2k_trace_cmd "virsh-dumpxml-boot" virsh dumpxml "${vm}" > "${tmp}.in"
 
-  # 1) 기존 <boot .../> 전부 제거
+  # 1) 기존 <boot .../> ?��? ?�거
   perl -0777 -pe "s#\s*<boot[^>]*/>\s*##sg" "${tmp}.in" > "${tmp}.mid"
 
-  # 2) <os> 내부에 <boot dev='cdrom'/> 1개만 삽입
-  #    - <type ...> 바로 뒤에 넣는다.
+  # 2) <os> ?��???<boot dev='cdrom'/> 1개만 ?�입
+  #    - <type ...> 바로 ?�에 ?�는??
   perl -0777 -i -pe "s#(<os[^>]*>\s*<type[^>]*>[^<]*</type>)#\$1\n    <boot dev='cdrom'/>#s" \
     "${tmp}.mid"
 
@@ -365,10 +365,10 @@ v2k_target_set_boot_hd() {
 
   _v2k_trace_cmd "virsh-dumpxml-boot" virsh dumpxml "${vm}" > "${tmp}.in"
 
-  # 1) 기존 <boot .../> 전부 제거
+  # 1) 기존 <boot .../> ?��? ?�거
   perl -0777 -pe "s#\s*<boot[^>]*/>\s*##sg" "${tmp}.in" > "${tmp}.mid"
 
-  # 2) <os> 내부에 <boot dev='hd'/> 1개만 삽입
+  # 2) <os> ?��???<boot dev='hd'/> 1개만 ?�입
   perl -0777 -i -pe "s#(<os[^>]*>\s*<type[^>]*>[^<]*</type>)#\$1\n    <boot dev='hd'/>#s" \
     "${tmp}.mid"
 
@@ -441,7 +441,7 @@ v2k_target_wait_shutdown() {
   done
 }
 
-# CDROM 후보: sdv..sdz -> sdaa..sdaz -> sdba..sdbz (정방향)
+# CDROM ?�보: sdv..sdz -> sdaa..sdaz -> sdba..sdbz (?�방??
 _v2k_target_gen_dev_candidates_cdrom() {
   local c b
   for c in v w x y z; do echo "sd${c}"; done
@@ -449,7 +449,7 @@ _v2k_target_gen_dev_candidates_cdrom() {
   for b in {a..z}; do echo "sdb${b}"; done
 }
 
-# virsh dumpxml에서 현재 사용중 target dev 목록 추출
+# virsh dumpxml?�서 ?�재 ?�용�?target dev 목록 추출
 _v2k_target_list_used_devs_from_xml() {
   local vm="$1"
   virsh dumpxml "${vm}" 2>/dev/null \
@@ -457,7 +457,7 @@ _v2k_target_list_used_devs_from_xml() {
     | sort -u
 }
 
-# 이번 run에서 이미 할당한 cdrom dev 기록 파일(덤프 반영 지연도 방어)
+# ?�번 run?�서 ?��? ?�당??cdrom dev 기록 ?�일(?�프 반영 지?�도 방어)
 _v2k_target_cdrom_alloc_file() {
   local vm="$1"
   echo "${V2K_WORKDIR:-/tmp}/artifacts/.cdrom_devs.${vm}.txt"
@@ -474,7 +474,7 @@ _v2k_target_pick_free_cdrom_dev() {
   used_xml="$(_v2k_target_list_used_devs_from_xml "${vm}" || true)"
   used_run="$(cat "${alloc_file}" 2>/dev/null || true)"
 
-  # 두 목록 합쳐서 membership 검사
+  # ??목록 ?�쳐??membership 검??
   used_all="$(printf "%s\n%s\n" "${used_xml}" "${used_run}" | sed '/^$/d' | sort -u)"
 
   while read -r dev; do
@@ -502,7 +502,7 @@ v2k_target_attach_cdrom() {
     return 3
   }
 
-  # ✅ SATA로 강제 (드라이버 중립) + persistent
+  # ??SATA�?강제 (?�라?�버 중립) + persistent
   _v2k_trace_cmd "virsh-attach-disk-cdrom" \
     virsh attach-disk "${vm}" "${iso}" "${dev}" \
       --type cdrom --mode readonly --persistent --targetbus sata >/dev/null
diff --git a/lib/v2k/transfer_base.sh b/lib/v2k/transfer_base.sh
index c7ea4bc..5f71c30 100644
--- a/lib/v2k/transfer_base.sh
+++ b/lib/v2k/transfer_base.sh
@@ -130,7 +130,7 @@ v2k_transfer_base_one() {
     if [[ "${st}" == "file" && "${fmt}" == "qcow2" ]]; then
       kind="file-qcow2"
       mkdir -p "$(dirname "${target_path}")"
-      # qcow2는 먼저 만들어둬야 qemu-nbd attach 가능
+      # qcow2??먼�? 만들?�둬??qemu-nbd attach 가??      
       if [[ ! -f "${target_path}" ]]; then
         qemu-img create -f qcow2 "${target_path}" "${size_bytes}" >/dev/null
       fi
@@ -142,10 +142,10 @@ v2k_transfer_base_one() {
       fi
     elif [[ "${st}" == "block" ]]; then
       kind="block-device"
-      # target_path는 /dev/sdX 등 “디바이스 자체”
+      # target_path는 /dev/sdX 같은 디바이스 자체    
     elif [[ "${st}" == "rbd" ]]; then
       kind="rbd"
-      # target_path는 rbd:pool/image (manifest에서 강제)
+      # target_path??rbd:pool/image (manifest?�서 강제)
     else
       echo "Unsupported target: storage=${st} format=${fmt}" >&2
       exit 31
@@ -200,7 +200,7 @@ v2k_transfer_base_one() {
     # - V2K_BASE_METHOD=nbdcopy : nbdcopy
     base_method="${V2K_BASE_METHOD:-nbdcopy}"
 
-    # normalize: trim + lowercase (whitespace/newline 방지)
+    # normalize: trim + lowercase (whitespace/newline 방�?)
     base_method="$(echo -n "${base_method}" | tr -d '[:space:]' | tr '[:upper:]' '[:lower:]')"
 
     run_str=""
diff --git a/lib/v2k/transfer_patch.sh b/lib/v2k/transfer_patch.sh
index 62653be..df39e3a 100644
--- a/lib/v2k/transfer_patch.sh
+++ b/lib/v2k/transfer_patch.sh
@@ -258,6 +258,9 @@ v2k_transfer_patch_one() {
     bytes_total="$(echo "${areas_json}" | jq -r '[.areas[].length] | add // 0')"
     new_change_id="$(echo "${areas_json}" | jq -r '.new_change_id // empty')"
 
+    # Debug logging
+    echo "DEBUG: areas_json for disk ${disk_id}: ${areas_json}" >&2
+
     # No changed areas is a valid no-op incremental/final sync.
     if [[ "${areas_count}" -eq 0 ]]; then
       v2k_event INFO "sync.${which}" "${disk_id}" "no_changes" "{}"
diff --git a/lib/v2k/v2k_target_device.sh b/lib/v2k/v2k_target_device.sh
index f61713d..2a087a6 100644
--- a/lib/v2k/v2k_target_device.sh
+++ b/lib/v2k/v2k_target_device.sh
@@ -127,54 +127,54 @@ v2k_assert_block_device_safe() {
 
   [[ -b "$dev" ]] || v2k_die "target block device not found: $dev"
 
-  # 0) 반드시 'whole disk'만 허용 (partition/dm/loop 등 거부)
+  # 0) 반드??'whole disk'�??�용 (partition/dm/loop ??거�?)
   local dtype
   dtype="$(lsblk -dn -o TYPE "$dev" 2>/dev/null || true)"
   if [[ "$dtype" != "disk" ]]; then
     v2k_die "target must be a whole disk device (TYPE=disk). got TYPE=${dtype} dev=${dev}"
   fi
 
-  # 1) 마운트 여부 체크 (디바이스 자체 또는 파티션)
+  # 1) 마운???��? 체크 (?�바?�스 ?�체 ?�는 ?�티??
   if findmnt -rn -S "$dev" >/dev/null 2>&1; then
     v2k_die "target device is mounted: $dev"
   fi
 
-  # 2) lsblk로 자식 파티션/마운트포인트 확인
+  # 2) lsblk�??�식 ?�티??마운?�포?�트 ?�인
   local out
   out="$(lsblk -nr -o NAME,TYPE,MOUNTPOINT "$dev" 2>/dev/null || true)"
 
-  # mountpoint가 하나라도 있으면 실패
+  # mountpoint가 ?�나?�도 ?�으�??�패
   if echo "$out" | awk '$3 != "" { exit 0 } END { exit 1 }'; then
     v2k_die "target device or its partitions are mounted: $dev"
   fi
 
-  # 3) 파티션 존재 시 차단 (통째 디바이스만 허용)
+  # 3) ?�티??존재 ??차단 (?�째 ?�바?�스�??�용)
   if lsblk -nr -o NAME "$dev" | tail -n +2 | grep -q .; then
     v2k_die "target device has partitions; refuse for safety: $dev (wipe/replace disk required)"
   fi
 
-  # 4) holders(상위 dm/raid 등이 잡고 있는지) 체크
+  # 4) holders(?�위 dm/raid ?�이 ?�고 ?�는지) 체크
   local base
   base="$(basename "$dev")"
   if [[ -d "/sys/class/block/${base}/holders" ]] && find "/sys/class/block/${base}/holders" -mindepth 1 -maxdepth 1 | read -r _; then
     v2k_die "target device has holders (in use by dm/raid/etc): $dev"
   fi
 
-  # 5) swap 사용 중이면 실패
+  # 5) swap ?�용 중이�??�패
   if command -v swapon >/dev/null 2>&1; then
     if swapon --noheadings --raw --output=NAME 2>/dev/null | awk '{print $1}' | grep -qx "$dev"; then
       v2k_die "target device is used as swap: $dev"
     fi
   fi
 
-  # 6) mdraid 멤버 시그니처 탐지
+  # 6) mdraid 멤버 ?�그?�처 ?��?
   if command -v mdadm >/dev/null 2>&1; then
     if mdadm --examine "$dev" >/dev/null 2>&1; then
       v2k_die "target device looks like mdraid member: $dev"
     fi
   fi
 
-  # 7) LVM PV 여부
+  # 7) LVM PV ?��?
   if command -v pvs >/dev/null 2>&1; then
     if pvs --noheadings -o pv_name 2>/dev/null \
       | awk '{gsub(/^[ \t]+|[ \t]+$/,""); print}' \
@@ -183,8 +183,8 @@ v2k_assert_block_device_safe() {
     fi
   fi
 
-  # 8) blkid 시그니처가 있으면 기본 차단 (FS/RAID/LUKS 등)
-  #    단, --force-block-device 사용 시(=V2K_FORCE_BLOCK_DEVICE=1) 이 체크만 예외 허용
+  # 8) blkid ?�그?�처가 ?�으�?기본 차단 (FS/RAID/LUKS ??
+  #    ?? --force-block-device ?�용 ??=V2K_FORCE_BLOCK_DEVICE=1) ??체크�??�외 ?�용
   local force="${V2K_FORCE_BLOCK_DEVICE:-0}"
 
   if command -v blkid >/dev/null 2>&1; then
@@ -197,7 +197,7 @@ v2k_assert_block_device_safe() {
     fi
   fi
 
-  # 9) 프로세스 점유 탐지 (열려있으면 차단)
+  # 9) ?�로?�스 ?�유 ?��? (?�려?�으�?차단)
   if command -v fuser >/dev/null 2>&1; then
     if fuser "$dev" >/dev/null 2>&1; then
       v2k_die "target device is opened by some process (fuser): $dev"
@@ -210,7 +210,7 @@ v2k_assert_block_device_safe() {
     fi
   fi
 
-  # 10) 최소 크기 조회 가능해야 함 (소스 size 비교는 호출자가 수행)
+  # 10) 최소 ?�기 조회 가?�해????(?�스 size 비교???�출?��? ?�행)
   blockdev --getsize64 "$dev" >/dev/null 2>&1 || v2k_die "cannot read size of $dev"
 }
 
@@ -218,9 +218,9 @@ v2k_rbd_precheck() {
   local rbd_uri="$1"   # rbd:pool/image
   local spec="${rbd_uri#rbd:}"  # pool/image
 
-  # rbd CLI가 있으면 선제 확인(없으면 스킵)
+  # rbd CLI가 ?�으�??�제 ?�인(?�으�??�킵)
   if command -v rbd >/dev/null 2>&1; then
-    # 존재/권한/클러스터 접근성 확인
+    # 존재/권한/?�러?�터 ?�근???�인
     if ! rbd info "$spec" >/dev/null 2>&1; then
       v2k_die "RBD precheck failed: rbd info ${spec} (check ceph.conf/keyring/permissions or image existence)"
     fi
@@ -335,7 +335,7 @@ prepare_target_device() {
       ;;
 
     rbd)
-      # path: rbd:pool/image (권장/표준). 혹은 --rbd-uri로 rbd:... 전체 지정 가능
+      # path: rbd:pool/image (권장/?��?). ?��? --rbd-uri�?rbd:... ?�체 지??가??
       format="${format:-raw}"
       [[ "$format" == "raw" ]] || v2k_die "rbd requires format=raw"
       if [[ -n "${rbd_uri}" ]]; then
diff --git a/lib/v2k/vmware_changed_areas.py b/lib/v2k/vmware_changed_areas.py
index 3ef2353..6830920 100644
--- a/lib/v2k/vmware_changed_areas.py
+++ b/lib/v2k/vmware_changed_areas.py
@@ -307,6 +307,9 @@ def main() -> None:
         if not new_change_id:
             new_change_id = _disk_backing_change_id(disk) or ""
 
+        # Debug logging
+        sys.stderr.write(f"DEBUG: Queried {len(areas)} changed areas for disk {args.disk_id}, change_id={effective_change_id}\n")
+
         print(json.dumps({
             "disk_id": args.disk_id,
             "change_id": effective_change_id,
diff --git a/lib/v2k/vmware_govc.sh b/lib/v2k/vmware_govc.sh
index ce303f7..ee79455 100644
--- a/lib/v2k/vmware_govc.sh
+++ b/lib/v2k/vmware_govc.sh
@@ -179,7 +179,7 @@ v2k_vmware_vm_poweroff() {
   v2k_vmware_vm_wait_poweroff "${manifest}" "${timeout}"
 }
 
-# Best-effort “guest shutdown” (only if govc supports it on this build).
+# Best-effort ?�guest shutdown??(only if govc supports it on this build).
 # - If unsupported or fails, caller may fallback to poweroff.
 v2k_vmware_vm_shutdown_guest_best_effort() {
   local manifest="$1"
@@ -218,13 +218,13 @@ v2k_require_govc_env() {
 v2k_is_ipv4() {
   local s="${1:-}"
   [[ "${s}" =~ ^([0-9]{1,3}\.){3}[0-9]{1,3}$ ]] || return 1
-  # 0-255 범위는 엄격 체크 안 함(필요 시 보강)
+  # 0-255 범위???�격 체크 ?????�요 ??보강)
   return 0
 }
 
 v2k_resolve_ipv4() {
   local host="$1"
-  # DNS/hosts 기반 IPv4 1개만 선택
+  # DNS/hosts 기반 IPv4 1개만 ?�택
   getent ahostsv4 "${host}" 2>/dev/null | awk 'NR==1{print $1; exit}'
 }
 
@@ -239,7 +239,7 @@ v2k_vmware_inventory_json() {
   vm_info="$(govc vm.info -json "${vm}")"
   dev_info="$(govc device.info -json -vm "${vm}")"
 
-  # 1) VM이 올라간 HostSystem MoRef 추출
+  # 1) VM???�라�?HostSystem MoRef 추출
   host_moref="$(
     printf '%s' "${vm_info}" | jq -r '
       .virtualMachines[0] as $v
@@ -247,24 +247,24 @@ v2k_vmware_inventory_json() {
     ' 2>/dev/null || echo ""
   )"
 
-  # 2) host.info로 management IP + thumbprint 추출 (DNS 의존 제거)
+  # 2) host.info�?management IP + thumbprint 추출 (DNS ?�존 ?�거)
   esxi_mgmt_ip=""
   esxi_thumbprint=""
   hostinfo_json=""
 
-  # 2-1) MoRef 우선 조회
+  # 2-1) MoRef ?�선 조회
   if [[ -n "${host_moref}" && "${host_moref}" != "null" ]]; then
     hostinfo_json="$(govc host.info -json -host "${host_moref}" 2>/dev/null || true)"
   fi
 
-  # 2-2) 파싱
+  # 2-2) ?�싱
   if [[ -n "${hostinfo_json}" ]]; then
     host_name="$(printf '%s' "${hostinfo_json}" | jq -r '.hostSystems[0].summary.config.name // empty' 2>/dev/null || true)"
     esxi_thumbprint="$(printf '%s' "${hostinfo_json}" | jq -r '.hostSystems[0].summary.config.sslThumbprint // empty' 2>/dev/null || true)"
     esxi_mgmt_ip="$(v2k_vmware_esxi_mgmt_ip_from_hostinfo_json "${hostinfo_json}" 2>/dev/null | head -n1 || true)"
   fi
 
-  # 3) fallback: management IP가 비어있으면 host_name이 IP인지/resolve 가능한지 확인
+  # 3) fallback: management IP가 비어?�으�?host_name??IP?��?/resolve 가?�한지 ?�인
   if [[ -z "${esxi_mgmt_ip}" && -n "${host_name}" ]]; then
     if v2k_is_ipv4 "${host_name}"; then
       esxi_mgmt_ip="${host_name}"
@@ -286,7 +286,7 @@ v2k_vmware_inventory_json() {
     def BOOT: (CFG.bootOptions // {});
     def HWDEVS: (HW.device // []);    
 
-    # device.info 스키마: 현재 환경은 루트가 {"devices":[...]}
+    # device.info ?�키�? ?�재 ?�경?� 루트가 {"devices":[...]}
     def DEVICES:
       ( $devinfo.devices
         // $devinfo.virtualMachines[0].devices
@@ -347,7 +347,7 @@ v2k_vmware_inventory_json() {
         | sort_by(.key)
       );
 
-    # 컨트롤러 분류: deviceInfo.label 우선
+    # 컨트롤러 분류: deviceInfo.label ?�선
     def is_scsi_ctrl($o):
       (lbl($o) | ascii_downcase | test("^scsi controller"));
 
@@ -357,7 +357,7 @@ v2k_vmware_inventory_json() {
     def is_nvme_ctrl($o):
       (lbl($o) | ascii_downcase | test("^nvme controller"));
 
-    # fallback: label이 비어있거나 예상과 다를 때 type 패턴으로 보조 식별
+    # fallback: label??비어?�거???�상�??��? ??type ?�턴?�로 보조 ?�별
     def is_scsi_ctrl_by_type($o):
       (typ($o) | test("SCSIController$"))
       or (typ($o) | test("LsiLogic"))
@@ -456,7 +456,7 @@ v2k_assign_target_paths() {
   format="$(jq -r '.target.format // "qcow2"' "${manifest}")"
   storage_type="$(jq -r '.target.storage.type // "file"' "${manifest}")"  # file|block
 
-  # 확장자 결정 (file 타입만)
+  # ?�장??결정 (file ?�?�만)
   local ext=""
   if [[ "${storage_type}" == "file" ]]; then
     case "${format}" in
@@ -467,7 +467,7 @@ v2k_assign_target_paths() {
   fi
 
   # per-disk override map (optional): .target.storage.map : { "scsi0:0": "/dev/sdb", "scsi0:1": "/dev/sdc" }
-  # file 타입에서도 override 가능하게 함(예: 특정 파일명 강제)
+  # file ?�?�에?�도 override 가?�하�????? ?�정 ?�일�?강제)
   jq -c --arg dst_root "${dst_root}" --arg ext "${ext}" --arg st "${storage_type}" '
     .target.storage.type = (.target.storage.type // "file")
     | .target.format = (.target.format // "qcow2")
@@ -485,7 +485,7 @@ v2k_assign_target_paths() {
                   $override
                 else
                   if $st == "block" then
-                    # block 타입은 반드시 map으로 지정하도록 강제 (자동 할당 위험)
+                    # block ?�?��? 반드??map?�로 지?�하?�록 강제 (?�동 ?�당 ?�험)
                     ("")
                   else
                     ($dst_root + "/disk" + $idx + "." + $ext)
@@ -497,7 +497,7 @@ v2k_assign_target_paths() {
       )
   ' "${manifest}" > "${manifest}.tmp" && mv -f "${manifest}.tmp" "${manifest}"
 
-  # block 타입이면 반드시 override가 채워져야 함
+  # block ?�?�이�?반드??override가 채워?�야 ??
   if [[ "${storage_type}" == "block" ]]; then
     local missing
     missing="$(jq -r '.disks[] | select(.transfer.target_path=="" or .transfer.target_path=="null") | .disk_id' "${manifest}" | wc -l)"
@@ -508,7 +508,7 @@ v2k_assign_target_paths() {
     fi
   fi
 
-  # 유니크 체크
+  # ?�니??체크
   local dup
   dup="$(jq -r '.disks[].transfer.target_path' "${manifest}" | sort | uniq -d | wc -l)"
   if [[ "${dup}" -ne 0 ]]; then
@@ -527,7 +527,7 @@ v2k_vmware_snapshot_create() {
   local vm
   vm="$(jq -r '.source.vm.name' "${manifest}")"
   v2k_event INFO "snapshot.${which}" "" "snapshot_create_start" "{\"name\":$(v2k_json_s "${name}")}"
-  govc snapshot.create -vm "${vm}" -m=false -q=false "${name}" >/dev/null
+  govc snapshot.create -vm "${vm}" -m=false -q=true "${name}" >/dev/null
   v2k_event INFO "snapshot.${which}" "" "snapshot_create_done" "{\"name\":$(v2k_json_s "${name}")}"
 }
 
@@ -655,7 +655,7 @@ v2k_vmware_esxi_mgmt_ip_from_hostinfo_json() {
       # netConfig 배열
       (.hostSystems[0].config.virtualNicManagerInfo.netConfig // []) as $nc
 
-      # 1) nicType=="management" 블록에서 selectedVnic 우선
+      # 1) nicType=="management" 블록?�서 selectedVnic ?�선
       | ( $nc | map(select(.nicType=="management"))[0] // {} ) as $m
       | ( ($m.selectedVnic[0] // "") | tostring ) as $sel
       | ( $m.candidateVnic // [] ) as $c
@@ -672,7 +672,7 @@ v2k_vmware_esxi_mgmt_ip_from_hostinfo_json() {
     ' 2>/dev/null
   )"
 
-  # 2) fallback: 위에서 못 찾으면 selectedVnic가 있는 netConfig에서 후보 중 첫 IP
+  # 2) fallback: ?�에??�?찾으�?selectedVnic가 ?�는 netConfig?�서 ?�보 �?�?IP
   if [[ -z "${ip}" ]]; then
     ip="$(
       printf '%s' "${hostinfo_json}" | jq -r '
@@ -685,7 +685,7 @@ v2k_vmware_esxi_mgmt_ip_from_hostinfo_json() {
     )"
   fi
 
-  # 3) 방어적으로 IPv4만 필터링(여러 줄/잡음 섞임 제거)
+  # 3) 방어?�으�?IPv4�??�터�??�러 �??�음 ?�임 ?�거)
   if [[ -n "${ip}" ]]; then
     ip="$(printf '%s\n' "${ip}" | grep -Eo '([0-9]{1,3}\.){3}[0-9]{1,3}' | head -n1 || true)"
   fi
@@ -733,16 +733,16 @@ v2k_vmware_snapshot_remove_migr() {
   for ((round=1; round<=max_round; round++)); do
     local tree_json names
     
-    # [수정 1] 에러 메시지를 stderr로 출력하도록 2>/dev/null 제거, 실패 시 loop continue 대신 에러 체크 강화
+    # [?�정 1] ?�러 메시지�?stderr�?출력?�도�?2>/dev/null ?�거, ?�패 ??loop continue ?�???�러 체크 강화
     if ! tree_json="$(govc snapshot.tree -vm "${vm}" -json 2>&1)"; then
-       # govc 명령 자체가 실패한 경우 (예: 연결 끊김, VM Busy)
+       # govc 명령 ?�체가 ?�패??경우 (?? ?�결 ?��?, VM Busy)
        echo "[WARN] Failed to list snapshots (round ${round}): ${tree_json}" >&2
        sleep 2
        continue
     fi
 
     if [[ -z "${tree_json}" ]]; then
-      # 스냅샷이 정말 없는 경우
+      # ?�냅?�이 ?�말 ?�는 경우
       return 0
     fi
 
@@ -752,11 +752,11 @@ v2k_vmware_snapshot_remove_migr() {
       | sort -u || true)"
 
     if [[ -z "${names}" ]]; then
-      # 패턴 매칭되는 스냅샷이 없으면 완료
+      # ?�턴 매칭?�는 ?�냅?�이 ?�으�??�료
       return 0
     fi
 
-    # [수정 2] 삭제 수행 및 에러 로깅
+    # [?�정 2] ??�� ?�행 �??�러 로깅
     local delete_failed=0
     while IFS= read -r snap_name; do
       [[ -n "${snap_name}" ]] || continue
@@ -770,13 +770,13 @@ v2k_vmware_snapshot_remove_migr() {
       fi
     done <<< "${names}"
 
-    # 삭제 실패 건이 있었다면 잠시 대기 후 재시도 (vCenter Task Busy 완화)
+    # ??�� ?�패 건이 ?�었?�면 ?�시 ?��????�시??(vCenter Task Busy ?�화)
     if [[ "${delete_failed}" -eq 1 ]]; then
       sleep 3
     fi
   done
 
-  # [수정 3] 루프 종료 후에도 남아있는지 확인
+  # [?�정 3] 루프 종료 ?�에???�아?�는지 ?�인
   local remain
   remain="$(govc snapshot.tree -vm "${vm}" -json 2>/dev/null \
       | jq -r '.. | objects | (.name? // .Name? // empty)' 2>/dev/null \
diff --git a/payload/windows/ablestack-runonce.ps1 b/payload/windows/ablestack-runonce.ps1
index 00f9111..7b7e112 100644
--- a/payload/windows/ablestack-runonce.ps1
+++ b/payload/windows/ablestack-runonce.ps1
@@ -19,16 +19,16 @@
 #>
 
 # ABLESTACK - Windows RunOnce one-shot installer
-# 요구사항:
-# - ISO 루트에 install.bat 존재
-# 동작:
-# - 모든 파일시스템 드라이브를 순회하여 루트에 install.bat이 있는 드라이브를 탐색
-# - 찾으면 조용히 실행(관리자 권한 컨텍스트)
+# ?�구?�항:
+# - ISO 루트??install.bat 존재
+# ?�작:
+# - 모든 ?�일?�스???�라?�브�??�회?�여 루트??install.bat???�는 ?�라?�브�??�색
+# - 찾으�?조용???�행(관리자 권한 컨텍?�트)
 
 $scriptName = "install.bat"
 $targetPath = $null
 
-# 1) 라벨 기반으로 빠르게 탐색(선택적) → 실패 시 전체 드라이브 검색
+# 1) ?�벨 기반?�로 빠르�??�색(?�택?? ???�패 ???�체 ?�라?�브 검??
 try {
     $labelCandidates = @("ABLESTACK-Tools", "ABLESTACK","ablestack","ablestack-qemu-exec-tools")
     $labelDrive = Get-PSDrive -PSProvider FileSystem | ForEach-Object {
@@ -44,7 +44,7 @@ try {
     }
 } catch {}
 
-# 2) 라벨로 못 찾았으면, 전체 드라이브 루트에서 install.bat 탐색
+# 2) ?�벨�?�?찾았?�면, ?�체 ?�라?�브 루트?�서 install.bat ?�색
 if (-not $targetPath) {
     $targetPath = Get-PSDrive -PSProvider FileSystem | ForEach-Object {
         $p = Join-Path ($_.Name + ":\") $scriptName
@@ -54,10 +54,10 @@ if (-not $targetPath) {
 
 if ($null -ne $targetPath -and (Test-Path $targetPath)) {
     try {
-        # RunOnce는 보통 관리자 컨텍스트로 수행됨. 조용히 실행 후 종료.
+        # RunOnce??보통 관리자 컨텍?�트�??�행?? 조용???�행 ??종료.
         Start-Process -FilePath "cmd.exe" -ArgumentList "/c `"$targetPath`"" -Wait
     } catch {
-        # 실패해도 RunOnce 특성상 재시도는 OS 레벨에서 안 하므로 조용히 반환
+        # ?�패?�도 RunOnce ?�성???�시?�는 OS ?�벨?�서 ???��?�?조용??반환
     }
 }
-# RunOnce는 실행 후 자동으로 키 제거됨(추가 정리 불필요)
+# RunOnce???�행 ???�동?�로 ???�거??추�? ?�리 불필??
diff --git a/rpm/ablestack-qemu-exec-tools.spec b/rpm/ablestack-qemu-exec-tools.spec
index 58c636f..3b8c163 100644
--- a/rpm/ablestack-qemu-exec-tools.spec
+++ b/rpm/ablestack-qemu-exec-tools.spec
@@ -28,7 +28,7 @@ Requires:       bash
 Requires:       jq
 Requires:       libvirt-client
 Requires:       cloud-init
-#Requires:       qemu-guest-agent   # 필요시 추가
+#Requires:       qemu-guest-agent   # 필요 시 추가
 
 %description
 ablestack-qemu-exec-tools is a Bash-based tool that enables remote execution 
@@ -89,7 +89,7 @@ _is_ablestack_host() {
 
 if _is_ablestack_host; then
     echo "[INFO] ABLESTACK Host detected - skip guest cloud-init customization (agent_policy_fix, cloud_init_auto, dhcpcd, dhcp.py patch)."
-    # 여기서 바로 종료 → 아래 기존 guest용 작업은 실행 안 함
+    # 여기서 바로 종료하고, 아래 기존 guest 후속 작업은 실행하지 않음
     exit 0
 fi
 
@@ -152,4 +152,4 @@ fi
 #Wants=cloud-init-local.service sshd-keygen.service sshd.service network-online.target
 #After=cloud-init-local.service systemd-networkd-wait-online.service network-online.target
 #Before=sshd-keygen.service sshd.service systemd-user-session.service
-#EOF
\ No newline at end of file
+#EOF
diff --git a/rpm/ablestack_v2k.spec b/rpm/ablestack_v2k.spec
index 89e071f..95b95fe 100644
--- a/rpm/ablestack_v2k.spec
+++ b/rpm/ablestack_v2k.spec
@@ -44,8 +44,8 @@ Assets such as VDDK and govc are handled by the offline ISO installer.
 
 %install
 # NOTE:
-# - lib/v2k/fleet.sh 는 기존 cp -a lib/v2k/* 로 자동 포함됩니다.
-# - completions/ablestack_v2k 는 아래 bash-completion 경로로 별도 설치합니다.
+# - lib/v2k/fleet.sh 는 기존 cp -a lib/v2k/* 에 자동 포함됩니다.
+# - completions/ablestack_v2k 는 표준 bash-completion 경로에 별도 설치합니다.
 
 # Binaries (explicit path: /usr/local/bin)
 mkdir -p %{buildroot}/usr/local/bin
diff --git a/windows/README.windows.md b/windows/README.windows.md
index 0a8212e..bb763cb 100644
--- a/windows/README.windows.md
+++ b/windows/README.windows.md
@@ -2,9 +2,9 @@
 
 ## 개요
 
-이 디렉토리는 Windows 가상머신(VM)의 클라우드 자동화 환경을 구축하기 위해
+이 디렉토리는 Windows 가상머신(VM)의 클라우드 초기화 환경 구축하기 위해
 Cloudbase-Init(윈도우용 cloud-init) 자동 설치, 설정, Sysprep, Unattend 자동화
-및 템플릿 배포에 필요한 스크립트, 설정, 샘플 파일을 포함합니다.
+및 템플릿 배포에 필요한 스크립트, 설정, 템플 파일들을 포함합니다.
 
 ---
 
@@ -13,53 +13,53 @@ Cloudbase-Init(윈도우용 cloud-init) 자동 설치, 설정, Sysprep, Unattend
 ```
 windows/
   cloudbase-init/
-    CloudbaseInitSetup_x64.msi           # cloudbase-init 공식 설치파일(동봉)
+    CloudbaseInitSetup_x64.msi           # cloudbase-init 공식 설치파일(포함)
   scripts/
-    install_cloudbase_init.ps1           # 모든 자동화 통합 PowerShell 스크립트
-    cloudbase-init.conf.template         # cloudbase-init conf 템플릿(설정 가능)
-    unattend.xml                         # Sysprep용 무인응답파일(한국어, 범용)
-  README.windows.md                      # (본 문서)
+    install_cloudbase_init.ps1           # 모든 자동화를 통합 PowerShell 스크립트
+    cloudbase-init.conf.template         # cloudbase-init conf 템플릿 설정 가이드
+    unattend.xml                         # Sysprep용 무인응답파일(한국어 범용)
+  README.windows.md                      # (이 문서)
 ```
 
 ---
 
-## 주요 자동화/템플릿 특징
+## 주요 자동화 및 템플릿 특징
 
-* **Cloudbase-Init** 자동 설치(MSI 무인설치)
-* **메타데이터 데이터소스:** ConfigDrive, None 우선
-* **호스트네임/네트워크/사용자(Administrator) 자동설정**
-* **cloudbase-init.conf 자동 배포/확장가능**
-* **sysprep + unattend.xml(한국어, 완전 무인) 자동실행**
-* **SID, 환경, OOBE, 비밀번호, 클론/템플릿 환경 완벽 지원**
-* **Windows Server 2016/2019/2022, Windows 10/11 등 범용 지원**
+* **Cloudbase-Init** 자동 설치(MSI 무인 설치)
+* **메타데이터 소스 선택** ConfigDrive, None 선택
+* **네트워크/사용자(Administrator) 자동 설정**
+* **cloudbase-init.conf 자동 배포/환경가이드**
+* **sysprep + unattend.xml(한국어 완전 무인) 자동 실행**
+* **SID, 컴퓨터명, OOBE, 비밀번호, 아이콘/바탕화면 초기화 지원**
+* **Windows Server 2016/2019/2022, Windows 10/11 범용 지원**
 
 ---
 
 ## 설치 및 사용법
 
-### 1. (필수) 모든 파일/폴더를 Windows VM에 복사
+### 1. (필수) 모든 파일/디렉토리를 Windows VM에 복사
 
-* MSI, conf.template, unattend.xml, install\_cloudbase\_init.ps1 포함
+* MSI, conf.template, unattend.xml, install_cloudbase_init.ps1 포함
 
-### 2. **관리자 권한 PowerShell**로 아래 스크립트 실행
+### 2. **관리자 권한 PowerShell**에서 다음과 같이 스크립트 실행
 
 ```powershell
 cd [scripts 디렉토리 경로]
 powershell.exe -ExecutionPolicy Bypass -File .\install_cloudbase_init.ps1
 ```
 
-### 3. 동작 흐름
+### 3. ?�작 ?�름
 
-* cloudbase-init 무인 설치
-* conf 템플릿 배포
-* 서비스 자동 재시작
+* cloudbase-init 무인 ?�치
+* conf ?�플�?배포
+* ?�비???�동 ?�시??
 * unattend.xml 배포
-* sysprep 실행(템플릿화, SID/환경 재설정, VM 자동종료)
-* 이후 VM을 **이미지/템플릿**으로 등록 후 자유롭게 클론/배포
+* sysprep ?�행(?�플릿화, SID/?�경 ?�설?? VM ?�동종료)
+* ?�후 VM??**?��?지/?�플�?*?�로 ?�록 ???�유�?�� ?�론/배포
 
 ---
 
-## 주요 설정/템플릿 설명
+## 주요 ?�정/?�플�??�명
 
 ### cloudbase-init.conf.template
 
@@ -67,32 +67,32 @@ powershell.exe -ExecutionPolicy Bypass -File .\install_cloudbase_init.ps1
 * username=Administrator
 * set\_host\_name=true
 * network\_adapter\_enabling\_method=automatic
-* plugins=...UserDataPlugin...(부팅시 커맨드/runcmd 지원)
+* plugins=...UserDataPlugin...(부?�시 커맨??runcmd 지??
 
 ### unattend.xml
 
-* 완전 무인설치, 모든 질문/제품키 생략
-* 언어/키보드: 한국어(ko-KR)
-* SID, Hostname, 계정 등 sysprep에 의해 자동 재설정
-* 모든 Windows 버전(서버/데스크탑) 범용 사용 가능
+* ?�전 무인?�치, 모든 질문/?�품???�략
+* ?�어/?�보?? ?�국??ko-KR)
+* SID, Hostname, 계정 ??sysprep???�해 ?�동 ?�설??
+* 모든 Windows 버전(?�버/?�스?�탑) 범용 ?�용 가??
 
 ---
 
-## 참고/유의사항
+## 참고/?�의?�항
 
-* 반드시 VM 환경에서 **최초 1회만 실행**
-  (Sysprep 후 VM이 종료됨 → 이 상태로 이미지/템플릿 제작)
-* 관리자 권한 PowerShell 사용 필수
-* cloudbase-init.conf, unattend.xml 등 **필요시 직접 커스터마이징** 가능
-* 특수 환경(네트워크, 키보드, 제품키 등) 적용 필요시 템플릿 수정
+* 반드??VM ?�경?�서 **최초 1?�만 ?�행**
+  (Sysprep ??VM??종료???????�태�??��?지/?�플�??�작)
+* 관리자 권한 PowerShell ?�용 ?�수
+* cloudbase-init.conf, unattend.xml ??**?�요??직접 커스?�마?�징** 가??
+* ?�수 ?�경(?�트?�크, ?�보?? ?�품???? ?�용 ?�요???�플�??�정
 
 ---
 
-## 추가 문의/확장 요청
+## 추�? 문의/?�장 ?�청
 
-* cloudbase-init.conf 옵션 추가, unattend.xml 세부 커스터마이즈
-* 사용자 정의 스크립트(FirstLogonCommands 등) 적용
-* 한글/영문 이중화, 다중 윈도우 버전 자동화 등
+* cloudbase-init.conf ?�션 추�?, unattend.xml ?��? 커스?�마?�즈
+* ?�용???�의 ?�크립트(FirstLogonCommands ?? ?�용
+* ?��?/?�문 ?�중?? ?�중 ?�도??버전 ?�동????
 
-ablestack-qemu-exec-tools 윈도우 자동화 템플릿은
-실제 VM 운영/배포 환경에 맞춰 자유롭게 확장/응용이 가능합니다!
+ablestack-qemu-exec-tools ?�도???�동???�플릿�?
+?�제 VM ?�영/배포 ?�경??맞춰 ?�유�?�� ?�장/?�용??가?�합?�다!
diff --git a/windows/cloudbase-init/CloudbaseInitSetup_x64.msi b/windows/cloudbase-init/CloudbaseInitSetup_x64.msi
index 1dba549..f96386a 100644
Binary files a/windows/cloudbase-init/CloudbaseInitSetup_x64.msi and b/windows/cloudbase-init/CloudbaseInitSetup_x64.msi differ
diff --git a/windows/msi/Product.wxs b/windows/msi/Product.wxs
index fe26057..14ca600 100644
--- a/windows/msi/Product.wxs
+++ b/windows/msi/Product.wxs
@@ -12,7 +12,7 @@
     <MediaTemplate />
     <MajorUpgrade DowngradeErrorMessage="A newer version is already installed." />
 
-    <!-- 버전/릴리즈/깃해시를 MSI Property로 저장 -->
+    <!-- 버전/릴리�?깃해?��? MSI Property�??�??-->
     <Property Id="PRODUCT_VERSION" Value="$(var.ProductVersion)" />
     <Property Id="PRODUCT_RELEASE" Value="$(var.ProductRelease)" />
     <Property Id="PRODUCT_GITHASH" Value="$(var.GitHash)" />
@@ -41,7 +41,7 @@
     </Feature>
 
     <!-- ========== Reboot policy (Manual / Auto) ========== -->
-    <!-- 기본: Manual → 재부팅 억제(3010 반환). Auto 요청 시 강제 재부팅 -->
+    <!-- 기본: Manual ???��????�제(3010 반환). Auto ?�청 ??강제 ?��???-->
     <Property Id="REBOOTMODE" Value="Manual" />
     <SetProperty Id="SetRebootManual"
                 Value="ReallySuppress"
@@ -49,36 +49,36 @@
                 Sequence="execute"
                 Condition="REBOOTMODE=&quot;Manual&quot;" />
 
-    <!-- Auto: 설치 종료 직후 자동 재부팅 -->
+    <!-- Auto: ?�치 종료 직후 ?�동 ?��???-->
     <SetProperty Id="SetRebootAuto"
                 Value="Force"
                 Before="InstallValidate"
                 Sequence="execute"
                 Condition="REBOOTMODE=&quot;Auto&quot;" />
 
-    <!-- 설치/제거 끝에서 재부팅 필요 플래그 설정 -->
+    <!-- ?�치/?�거 ?�에???��????�요 ?�래�??�정 -->
     <InstallExecuteSequence>
       <ScheduleReboot Before="InstallFinalize"
                       Condition="(NOT Installed) OR (REMOVE=&quot;ALL&quot;)" />
     </InstallExecuteSequence>
 
     <!-- ========== Scheduled Tasks via schtasks.exe + WixQuietExec ========== -->
-    <!-- 작업 이름 -->
+    <!-- ?�업 ?�름 -->
     <Property Id="TASK_NAME_BOOT"  Value="AbleStack-CloudInit-PhaseRunner-Boot"/>
     <Property Id="TASK_NAME_LOGON" Value="AbleStack-CloudInit-PhaseRunner-Logon"/>
 
-    <!-- ===== Properties를 설정하는 CustomAction들 ===== -->
-    <!-- Boot 트리거 -->
+    <!-- ===== Properties�??�정?�는 CustomAction??===== -->
+    <!-- Boot ?�리�?-->
     <CustomAction Id="SetCreateBootTask"
       Property="CreateBootTask"
       Value="&quot;[System64Folder]schtasks.exe&quot; /Create /TN &quot;[TASK_NAME_BOOT]&quot; /SC ONSTART /RU SYSTEM /RL HIGHEST /TR &quot;%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe -NoProfile -ExecutionPolicy Bypass -File \&quot;[INSTALLDIR]phase-runner.ps1\&quot; -SysprepAfterPhase2&quot; /F" />
 
-    <!-- Logon 트리거 -->
+    <!-- Logon ?�리�?-->
     <CustomAction Id="SetCreateLogonTask"
       Property="CreateLogonTask"
       Value="&quot;[System64Folder]schtasks.exe&quot; /Create /TN &quot;[TASK_NAME_LOGON]&quot; /SC ONLOGON /RU SYSTEM /RL HIGHEST /TR &quot;%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe -NoProfile -ExecutionPolicy Bypass -File \&quot;[INSTALLDIR]phase-runner.ps1\&quot; -SysprepAfterPhase2&quot; /F" />
 
-    <!-- 삭제 -->
+    <!-- ??�� -->
     <CustomAction Id="SetDeleteBootTask"
       Property="DeleteBootTask"
       Value="&quot;[System64Folder]schtasks.exe&quot; /Delete /TN &quot;[TASK_NAME_BOOT]&quot; /F" />
@@ -89,8 +89,8 @@
 
 
 
-    <!-- ===== 실제 실행하는 QuietExec CustomAction들 (기존과 동일) ===== -->
-    <!-- 이미 사용 중인 WixQuietExec 기반 CA 정의를 유지합니다. -->
+    <!-- ===== ?�제 ?�행?�는 QuietExec CustomAction??(기존�??�일) ===== -->
+    <!-- ?��? ?�용 중인 WixQuietExec 기반 CA ?�의�??��??�니?? -->
     <CustomAction Id="CreateBootTask"
       BinaryRef="Wix4UtilCA_$(sys.BUILDARCHSHORT)"
       DllEntry="WixQuietExec" Execute="deferred" Impersonate="no" Return="check" />
@@ -108,15 +108,15 @@
       DllEntry="WixQuietExec" Execute="deferred" Impersonate="no" Return="check" />
 
 
-    <!-- ===== 실행 순서 (기존 흐름 유지; 필요 시 아래처럼 명시) ===== -->
+    <!-- ===== ?�행 ?�서 (기존 ?�름 ?��?; ?�요 ???�래처럼 명시) ===== -->
     <InstallExecuteSequence>
-      <!-- 설치/업그레이드 -->
+      <!-- ?�치/?�그?�이??-->
       <Custom Action="SetCreateBootTask"   After="InstallFiles"       Condition="NOT REMOVE" />
       <Custom Action="CreateBootTask"      After="SetCreateBootTask"  Condition="NOT REMOVE" />
       <Custom Action="SetCreateLogonTask"  After="CreateBootTask"     Condition="NOT REMOVE" />
       <Custom Action="CreateLogonTask"     After="SetCreateLogonTask" Condition="NOT REMOVE" />
 
-      <!-- 제거 -->
+      <!-- ?�거 -->
       <Custom Action="SetDeleteLogonTask"  Before="RemoveFiles"       Condition="REMOVE" />
       <Custom Action="DeleteLogonTask"     After="SetDeleteLogonTask" Condition="REMOVE" />
       <Custom Action="SetDeleteBootTask"   After="DeleteLogonTask"    Condition="REMOVE" />
diff --git a/windows/msi/SourceDir/assets/99-reset-cbi-plugin-state.ps1 b/windows/msi/SourceDir/assets/99-reset-cbi-plugin-state.ps1
index deb4461..b2b3a6e 100644
--- a/windows/msi/SourceDir/assets/99-reset-cbi-plugin-state.ps1
+++ b/windows/msi/SourceDir/assets/99-reset-cbi-plugin-state.ps1
@@ -21,10 +21,10 @@
 $BaseKey = 'HKLM:\SOFTWARE\Cloudbase Solutions\Cloudbase-Init'
 $Targets = @()
 
-# 1) 루트 \Plugins (instance_id가 없는 경우에 대비)
+# 1) 루트 \Plugins (instance_id가 ?�는 경우???��?
 $Targets += Join-Path $BaseKey 'Plugins'
 
-# 2) 모든 인스턴스ID 하위의 \Plugins
+# 2) 모든 ?�스?�스ID ?�위??\Plugins
 if (Test-Path $BaseKey) {
     Get-ChildItem -Path $BaseKey -ErrorAction SilentlyContinue | ForEach-Object {
         $pluginsKey = Join-Path $_.PSPath 'Plugins'
@@ -35,20 +35,20 @@ if (Test-Path $BaseKey) {
 foreach ($k in $Targets) {
     if (Test-Path $k) {
         try {
-            # 방법 A: 키 전체 삭제 (가장 확실)
+            # 방법 A: ???�체 ??�� (가???�실)
             Remove-Item -Path $k -Recurse -Force -ErrorAction Stop
-            # 방법 B(보수적): 값만 0으로 리셋하고 싶다면 아래 주석을 사용
+            # 방법 B(보수??: 값만 0?�로 리셋?�고 ?�다�??�래 주석???�용
             # $item = Get-Item -Path $k
             # foreach ($vn in ($item.GetValueNames())) {
             #     New-ItemProperty -Path $k -Name $vn -PropertyType DWord -Value 0 -Force | Out-Null
             # }
         } catch {
-            # 일부 값/권한 문제는 무시
+            # ?��? �?권한 문제??무시
         }
     }
 }
 
-# 로그 흔적 남기기(디버깅용)
+# 로그 ?�적 ?�기�??�버깅용)
 try {
     $logDir = 'C:\ProgramData\AbleStack\CloudInit'
     if (-not (Test-Path $logDir)) { New-Item -ItemType Directory -Path $logDir -Force | Out-Null }
diff --git a/windows/msi/SourceDir/assets/CloudbaseInitSetup_x64.msi b/windows/msi/SourceDir/assets/CloudbaseInitSetup_x64.msi
index 1dba549..f96386a 100644
Binary files a/windows/msi/SourceDir/assets/CloudbaseInitSetup_x64.msi and b/windows/msi/SourceDir/assets/CloudbaseInitSetup_x64.msi differ
diff --git a/windows/msi/SourceDir/assets/install_cloudbase_init.ps1 b/windows/msi/SourceDir/assets/install_cloudbase_init.ps1
index 4a55320..63f511b 100644
--- a/windows/msi/SourceDir/assets/install_cloudbase_init.ps1
+++ b/windows/msi/SourceDir/assets/install_cloudbase_init.ps1
@@ -368,7 +368,7 @@ function Run-Sysprep {
         Write-Host "[INFO] Removing Appx - $PackageFullName"
         $baseName = ($PackageFullName -split '_')[0]  # e.g. Microsoft.WindowsTerminal
 
-        # (1) 설치본 제거 (모든 사용자)
+        # (1) ?�치�??�거 (모든 ?�용??
         try {
             $pkgs = Get-AppxPackage -AllUsers | Where-Object {
                 $_.PackageFullName -eq $PackageFullName -or
@@ -381,7 +381,7 @@ function Run-Sysprep {
             }
         } catch { Write-Host "[WARN] Remove-AppxPackage - $($_.Exception.Message)" }
 
-        # (2) 프로비저닝 제거
+        # (2) ?�로비�????�거
         try {
             $prov = Get-AppxProvisionedPackage -Online | Where-Object {
                 $_.DisplayName -eq $baseName -or $_.PackageName -like "$baseName*"
diff --git a/windows/msi/SourceDir/assets/unattend-windows11.xml b/windows/msi/SourceDir/assets/unattend-windows11.xml
index 53d8662..7eaba41 100644
--- a/windows/msi/SourceDir/assets/unattend-windows11.xml
+++ b/windows/msi/SourceDir/assets/unattend-windows11.xml
@@ -8,7 +8,7 @@
                versionScope="nonSxS"
                xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-      <!-- PersistAllDeviceInstalls 제거: Windows 11에서 호환성 문제 방지 -->
+      <!-- PersistAllDeviceInstalls ?�거: Windows 11?�서 ?�환??문제 방�? -->
     </component>
   </settings>
 
@@ -22,9 +22,9 @@
       <OOBE>
         <HideEULAPage>true</HideEULAPage>
         <NetworkLocation>Work</NetworkLocation>
-        <!-- Windows 11에서는 ProtectYourPC=3 (자동 업데이트 활성화) 권장 -->
+        <!-- Windows 11?�서??ProtectYourPC=3 (?�동 ?�데?�트 ?�성?? 권장 -->
         <ProtectYourPC>3</ProtectYourPC>
-        <!-- SkipMachineOOBE / SkipUserOOBE 제거: Windows 11 OOBE 충돌 방지 -->
+        <!-- SkipMachineOOBE / SkipUserOOBE ?�거: Windows 11 OOBE 충돌 방�? -->
       </OOBE>
     </component>
   </settings>
diff --git a/windows/msi/SourceDir/phase-runner.ps1 b/windows/msi/SourceDir/phase-runner.ps1
index 1416ff4..3f560eb 100644
--- a/windows/msi/SourceDir/phase-runner.ps1
+++ b/windows/msi/SourceDir/phase-runner.ps1
@@ -132,7 +132,7 @@ function Invoke-Phase2 {
     throw "Phase2 failed (installer exit $($proc.ExitCode))"
   }
 
-  # If you still want a guard to run extra sysprep, keep it – installer already does sysprep.
+  # If you still want a guard to run extra sysprep, keep it ??installer already does sysprep.
   if ($SysprepAfterPhase2.IsPresent) {
     Write-Log "SysprepAfterPhase2 requested, but install script already performs sysprep. Skipping."
   }
@@ -141,7 +141,7 @@ function Invoke-Phase2 {
 # ---- Main ----
 try {
   if (Test-SetupInProgress) {
-    Write-Log "Setup/OOBE in progress → Phase-Runner exits."
+    Write-Log "Setup/OOBE in progress ??Phase-Runner exits."
     exit 0
   }
   
diff --git a/windows/msi/build-msi.ps1 b/windows/msi/build-msi.ps1
index 5856c54..52c3749 100644
--- a/windows/msi/build-msi.ps1
+++ b/windows/msi/build-msi.ps1
@@ -28,10 +28,10 @@ param(
 
 $ErrorActionPreference = "Stop"
 
-# 0) wix CLI 확인
+# 0) wix CLI ?�인
 $wix = (Get-Command wix -ErrorAction Stop).Source
 
-# 1) 출력/소스 경로
+# 1) 출력/?�스 경로
 $out = Join-Path $PSScriptRoot "out"
 if (-not (Test-Path $out)) { New-Item -ItemType Directory -Path $out | Out-Null }
 
@@ -39,7 +39,7 @@ $src = Join-Path $PSScriptRoot "SourceDir"
 $wxs = Join-Path $PSScriptRoot "Product.wxs"
 if (-not (Test-Path $wxs)) { throw "WiX source not found: $wxs" }
 
-# 2) 필요한 WiX 확장(Extensions) 등록
+# 2) ?�요??WiX ?�장(Extensions) ?�록
 $requiredExts = @(
   "WixToolset.Util.wixext/4.0.6",
   "WixToolset.Bal.wixext/4.0.6",
@@ -51,7 +51,7 @@ foreach ($ext in $requiredExts) {
   } catch { }
 }
 
-# 3) 빌드: 버전/릴리즈/깃해시 변수 전달
+# 3) 빌드: 버전/릴리�?깃해??변???�달
 $outMsi = Join-Path $out "ablestack-qemu-exec-tools-$Version-$Release-$GitHash.msi"
 & $wix build $wxs `
   -arch x64 `
diff --git a/windows/scripts/cloudbase-init.conf.template b/windows/scripts/cloudbase-init.conf.template
index 8273e42..5846ce9 100644
--- a/windows/scripts/cloudbase-init.conf.template
+++ b/windows/scripts/cloudbase-init.conf.template
@@ -1,24 +1,24 @@
 [DEFAULT]
-# 1. Metadata 제공자
+# 1. Metadata ?�공??
 metadata_services=cloudbaseinit.metadata.services.configdrive.ConfigDriveService,cloudbaseinit.metadata.services.nocloudservice.NoCloudService
 
-# 2. 사용자(Administrator)
+# 2. ?�용??Administrator)
 username=Administrator
 groups=Administrators
 inject_user_password=true
 
-# 3. 호스트명 설정(메타데이터 적용)
+# 3. ?�스?�명 ?�정(메�??�이???�용)
 set_host_name=true
-# Windows 컴퓨터 이름 정책 설정(옵션)
+# Windows 컴퓨???�름 ?�책 ?�정(?�션)
 # computer_name_format={hostname}
 
-# 4. 네트워크 정보 설정 (자동/metadata 기반)
-# cloudbase-init은 기본적으로 메타데이터 네트워크 정보를 사용함
-# 예시: DHCP/Static 처리 자동 활성화
+# 4. ?�트?�크 ?�보 ?�정 (?�동/metadata 기반)
+# cloudbase-init?� 기본?�으�?메�??�이???�트?�크 ?�보�??�용??
+# ?�시: DHCP/Static 처리 ?�동 ?�성??
 network_adapter_enabling_method=automatic
 
-# 5. 부팅시 사용자 스크립트(runcmd와 유사)
-# cloudbase-init 플러그인에서 'user_data' (리눅스 runcmd와 동등)
+# 5. 부?�시 ?�용???�크립트(runcmd?� ?�사)
+# cloudbase-init ?�러그인?�서 'user_data' (리눅??runcmd?� ?�등)
 plugins=cloudbaseinit.plugins.common.mtu.CloudbaseInitSetMTUPlugin,
     cloudbaseinit.plugins.common.sethostname.SetHostNamePlugin,
     cloudbaseinit.plugins.common.createuser.CreateUserPlugin,
@@ -28,7 +28,7 @@ plugins=cloudbaseinit.plugins.common.mtu.CloudbaseInitSetMTUPlugin,
     cloudbaseinit.plugins.common.sshpublickeys.SetUserSSHPublicKeysPlugin,
     cloudbaseinit.plugins.common.localscripts.LocalScriptsPlugin
 
-# 6. 기타(옵션)
+# 6. 기�?(?�션)
 allow_reboot=true
 first_logon_behaviour=always
 logdir=C:\Program Files\Cloudbase Solutions\Cloudbase-Init\log\
diff --git a/windows/scripts/install_cloudbase_init.ps1 b/windows/scripts/install_cloudbase_init.ps1
index 47a0217..af38f5b 100644
--- a/windows/scripts/install_cloudbase_init.ps1
+++ b/windows/scripts/install_cloudbase_init.ps1
@@ -138,23 +138,23 @@ function Run-Sysprep {
         param([datetime]$Since)
 
         Write-Host "[INFO] Start sysprep - $SysprepExe $SysprepArgs"
-        # sysprep는 프리-검증 실패시에도 0으로 끝날 수 있으므로 ExitCode는 참고만
+        # sysprep???�리-검�??�패?�에??0?�로 ?�날 ???�으므�?ExitCode??참고�?
         $p = Start-Process -FilePath $SysprepExe -ArgumentList $SysprepArgs -PassThru -Wait
         Write-Host "[INFO] Sysprep exited with code $($p.ExitCode)"
 
-        # 성공 신호1 - tag 파일
+        # ?�공 ?�호1 - tag ?�일
         if (Test-Path $SuccessTag) {
             Write-Host "[INFO] Sysprep_succeeded.tag detected."
             return @{ Success = $true; Offenders = @() }
         }
 
-        # 성공 신호2/실패 신호 - 최신 로그 구간 분석
+        # ?�공 ?�호2/?�패 ?�호 - 최신 로그 구간 분석
         $offenders = Get-OffendingPackages -Since $Since
         if ($offenders.Count -gt 0) {
             return @{ Success = $false; Offenders = $offenders }
         }
 
-        # Error가 없고 tag도 없으면 불확실 -> 실패로 처리
+        # Error가 ?�고 tag???�으�?불확??-> ?�패�?처리
         return @{ Success = $false; Offenders = @() }
     }
 
@@ -162,7 +162,7 @@ function Run-Sysprep {
         param([datetime]$Since)
 
         if (-not (Test-Path $PantherLog)) { return @() }
-        # 라인 앞의 타임스탬프를 파싱 - "2025-08-30 14:01:17, Error SYSPRP Package ..."
+        # ?�인 ?�의 ?�?�스?�프�??�싱 - "2025-08-30 14:01:17, Error SYSPRP Package ..."
         $rxTime = '^(?<ts>\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}),'
         $rxPkg  = [regex]'Package\s+([^\s]+)\s+was\s+installed\s+for\s+a\s+user'
         $list = New-Object System.Collections.Generic.List[string]
@@ -189,7 +189,7 @@ function Run-Sysprep {
         Write-Host "[INFO] Removing Appx - $PackageFullName"
         $baseName = ($PackageFullName -split '_')[0]  # e.g. Microsoft.WindowsTerminal
 
-        # (1) 설치본 제거 (모든 사용자)
+        # (1) ?�치�??�거 (모든 ?�용??
         try {
             $pkgs = Get-AppxPackage -AllUsers | Where-Object {
                 $_.PackageFullName -eq $PackageFullName -or
@@ -202,7 +202,7 @@ function Run-Sysprep {
             }
         } catch { Write-Host "[WARN] Remove-AppxPackage - $($_.Exception.Message)" }
 
-        # (2) 프로비저닝 제거
+        # (2) ?�로비�????�거
         try {
             $prov = Get-AppxProvisionedPackage -Online | Where-Object {
                 $_.DisplayName -eq $baseName -or $_.PackageName -like "$baseName*"