WizTree 디스크 정리 도우미은(는) 무엇을 하나요?

WizTree를 디스크 사용량 사실의 출처로 사용하고 분석, 승인, 실행, 검증을 분리하세요. 보고서에는 사용자의 언어를 사용하세요.

양보할 수 없는 안전 게이트

기본값은 분석 전용입니다. CSV 데이터를 가져오거나 검토하는 동안 디스크를 변경하지 마세요.
계층 1(Tier 1)을 위험이 낮다고 취급하되 승인 없이 진행하지 마세요. 모든 삭제 전에 명시적인 사용자 승인을 요구하세요.
"디스크 정리해 줘"와 같은 일반적인 요청에서 승인이 추론되었다고 간주하지 마세요. 정확한 대상과 작업을 먼저 보여주세요.
모델이 생성한 산문에서 복사한 삭제 명령을 절대 실행하지 마세요. scripts/New-CleanupPlan.ps1로 계획을 수립하고 plan_id를 표시한 후, 사용자가 해당 정확한 계획을 확인한 경우에만 실행하세요.
와일드카드, 상대 경로, 드라이브 루트, 광범위한 사용자 프로필 루트, 시스템 디렉터리, 프로그램 디렉터리 및 계층 3 대상을 거부하세요.
다른 머신에서 내보낸 CSV로 실제 머신을 정리하지 마세요. 로컬 경로 존재 여부와 머신 범위가 확인되지 않으면 분석만 수행하세요.
사용자의 요청 없이 WizTree를 다운로드하거나 설치하지 마세요. 이 스킬과 함께 WizTree 실행 파일을 재배포하지 마세요.
처음부터 끝까지 네이티브 PowerShell 파일 작업만 사용하세요. 재귀 삭제 직전에 정규 대상을 다시 검증하세요.

대상 분류 또는 승인 전에 참조/안전-정책.md를 읽으세요. WizTree 데이터 내보내기 또는 구문 분석 시 참조/wiztree-csv.md를 읽으세요.

워크플로우

1. 최신 CSV 확보

가능하면 현재 머신과 현재 디스크 상태에서 내보낸 CSV를 선호하세요.

사용자가 이미 내보내기 파일을 가지고 있다면, 절대 경로와 타임스탬프를 기록하세요.
WizTree가 설치되어 있고 사용자가 자동화를 원한다면 scripts/Export-WizTree.ps1을 실행하세요.
그렇지 않으면, 사용자에게 WizTree에서 대상 드라이브를 스캔하고 공식 CSV 내보내기를 사용하도록 안내하세요.

CSV 내보내기를 사용할 수 있는 경우 스크린샷을 표준 인벤토리로 사용하지 마세요.

2. 첫 번째 보고서 생성

다음을 실행하세요:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/Analyze-WizTreeCsv.ps1 `
  -CsvPath <csv-파일-절대-경로> `
  -OutputDirectory <보고서-디렉터리-절대-경로>

생성된 JSON을 기계 판독 가능 증거로, Markdown 보고서를 사용자 대상 기록으로 사용하세요. 추가 설명이 필요한 경우 assets/cleanup-report-template.md의 구조를 복사하세요.

정리 전 다음 사항을 확인하세요:

파일 행에서 할당된 바이트를 계산하고 중첩된 폴더 합계는 더하지 마세요.
하드 링크 할당 값에 WizTree의 선행 0 표시가 있으면 추가 할당이 없는 것으로 처리하세요.
캐시와 캐시 이름으로 저장된 사용자 생성 콘텐츠를 구분하세요.
불확실성을 명시적으로 표시하세요. 증거가 불완전한 항목은 더 높은 위험 계층으로 이동하세요.

3. 계층 2 조사

각 주요 계층 2 후보를 제시하기 전에 검사하세요. 가능한 경우 다음을 확인하세요:

소유 애플리케이션 또는 Windows 구성 요소
애플리케이션 또는 서비스가 현재 실행 중인지 여부
수정 최근성 및 파일이 활발히 변경되고 있는지 여부
애플리케이션이 자체 정리 명령을 제공하는지 여부
재생성 비용, 로그인 영향, 오프라인 영향 및 복구 옵션
정확한 경로, 제안된 작업, 예상 바이트 및 예상 부작용

원시 삭제보다는 애플리케이션 자체 정리, Windows 저장소 설정, 디스크 정리, 패키지 관리자 캐시 명령 또는 문서화된 서비스 인식 절차를 선호하세요.

4. 항목별 승인 획득

계층 1을 먼저 제시하세요. 선택 가능한 모든 항목에 대해 다음을 포함하세요:

정확한 경로
작업: clear_directory_contents 또는 delete_file
계층 및 이유
예상 회수 가능 바이트
주목할 만한 부작용

assets/approval-manifest.example.json에서 승인 매니페스트를 생성하세요. 사용자가 명시적으로 선택한 항목만 포함하고 approved를 true로 설정하세요.

5. 계획 미리보기 및 확정

다음을 실행하세요:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/New-CleanupPlan.ps1 `
  -ApprovalFile <승인-json-파일> `
  -PlanFile <계획-json-파일>

검증된 항목, 예상 합계, 거부된 항목 및 plan_id를 표시하세요. 대상이 사용자의 선택보다 더 광범위하거나 보고서와 다른 경우 중단하세요.

6. 확인된 계획만 실행

사용자가 표시된 plan_id를 확인한 후 다음을 실행하세요:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/Invoke-ApprovedCleanup.ps1 `
  -PlanFile <계획-json-파일> `
  -ConfirmPlanId <확인된-계획-id> `
  -Execute

-Execute 없이 스크립트는 시뮬레이션 실행으로 유지됩니다. 정확한 계획 확인이 대화에 표시되기 전에 절대 -Execute를 추가하지 마세요.

7. 검증 및 보고서 업데이트

성공, 건너뜀, 실패 및 감사 로그 경로를 기록하세요.
예상 삭제 바이트와 관찰된 여유 공간 변화를 별도로 기록하세요. 백그라운드 활동으로 인해 차이가 발생할 수 있습니다.
실용적일 때 WizTree를 다시 내보내거나 다시 스캔하세요.
Markdown 보고서의 실행 기록과 남은 계층 2 선택 항목을 업데이트하세요.
계층 2에 대해 승인 주기를 반복하세요. 계층 3을 실행 가능한 계획으로 승격하지 마세요.

리소스 맵

scripts/Export-WizTree.ps1: 공식 WizTree CSV 내보내기를 호출합니다.
scripts/Analyze-WizTreeCsv.ps1: 내보내기를 스트리밍하고 JSON 및 Markdown을 생성합니다.
scripts/New-CleanupPlan.ps1: 선택된 대상을 검증하고 무결성이 보장된 계획을 생성합니다.
scripts/Invoke-ApprovedCleanup.ps1: 확인된 계획을 재검증하고 JSONL 감사 로깅과 함께 실행합니다.
references/safety-policy.md: 분류 및 삭제 경계 정의.
references/wiztree-csv.md: 공식 내보내기 의미론 및 파서 요구 사항.
assets/cleanup-report-template.md: 보고서 구조.
assets/approval-manifest.example.json: 승인 입력 스키마.

WizTree 디스크 정리 도우미