업데이트로 돌아가기
New releaseAug 19, 2026

SuperDiagnosticTool v1.0.5

Google Gemini를 활용한 AI 기반 Windows 진단 및 자동 복구 도구. 충돌 감지, 성능 최적화, 맬웨어 스캔 및 PowerShell 복구 스크립트 생성. 모든 하드웨어 지원 (1-128+ 코어). 무료 및 오픈소스.

공유

SuperDiagnosticTool

SuperDiagnosticTool Icon

AI 기반 Windows 진단 및 자가 치료 도구

Release License Stars

SuperDiagnosticTool은 실시간 하드웨어 원격 측정과 Google Gemini AI를 결합하여 Windows 시스템 문제를 분석, 진단 및 자동으로 복구하는 지능형 시스템 진단 유틸리티입니다. 안전 우선 아키텍처로 제작되어 모든 Windows 구성에서 프로덕션 수준의 진단을 제공합니다.

스크린샷

Main Interface

스캔 모드 선택 및 문제 설명 입력을 보여주는 메인 인터페이스

주요 기능

범용 하드웨어 지원

  • 동적 확장: 1~128개 이상의 모든 CPU 구성에 자동으로 적응
  • 하드웨어 독립적 로직: 레거시 시스템(Intel Pentium)부터 고성능 워크스테이션(AMD Threadripper, Intel Xeon)까지 완벽하게 작동
  • 정상적인 폴백: 지원되지 않는 기능(CPU 주파수, 배터리 감지, 스왑 메모리)을 안전하게 처리
  • 저사양 최적화: 경량 실행으로 리소스가 제한된 하드웨어에서도 시스템 지연 방지

지능형 AI 분석

  • Google Gemini 통합: 고급 AI 기반 시스템 분석 및 진단
  • 컨텍스트 인식 권장 사항: 사용자가 보고한 문제를 시스템 원격 측정과 연계
  • 보안 감사: 의심스러운 프로세스, 리소스 누수 및 잠재적 악성 코드 스캔
  • 수정 후 검증: 수정된 항목과 수동 처리가 필요한 항목을 보여주는 완료 보고서 생성

안전 우선 아키텍처

프로덕션 등급 보안 (85%)

다중 레이어 검증

  • 지식 기반 매칭: AI 솔루션을 성공률이 있는 5가지 테스트된 알려진 솔루션과 비교 검증
  • 드라이 런 시뮬레이션: 변경 사항 미리보기 (서비스, 파일, 레지스트리)
  • 다중 레벨 스크립트 검증: 블랙리스트, 화이트리스트 및 위험 점수 (0-100)
  • 시스템 복원 지점: 모든 수정 전 자동 복원 지점 생성

향상된 모니터링

  • 수정 전후 스냅샷: 변경 전후의 전체 시스템 상태 캡처
  • 변경 감지: 모든 수정 사항 자동 추적 (서비스, 레지스트리, 시작 항목)
  • 롤백 생성: 필요시 변경 사항을 취소하는 자동 생성 스크립트
  • 실행 로깅: 모든 작업에 대한 포괄적인 로그

PowerShell 안전

  • 관리자 권한 확인: 모든 복구 스크립트에 권한 상승 확인 포함
  • 변수 살균: $env: 변수를 보존하면서 정규식 기반 이스케이프로 오류 방지
  • 서비스 안전 점검: 작업 전 서비스 존재 여부 확인
  • 샌드박스 실행: 타임아웃 보호 기능이 있는 모니터링 환경
  • 오류 처리: 안전 장치가 포함된 포괄적인 try-catch 블록

포괄적인 시스템 스캔

  • 성능 메트릭: CPU 사용률 (전체 + 코어별), 메모리 분석, 상위 리소스 소비자
  • 네트워크 인텔리전스: 활성 인터페이스, DNS 구성, Wi-Fi 신호 강도, 연결 테스트
  • 보안 무결성: 안티바이러스 상태, 방화벽 프로필, Windows 업데이트 기록
  • 하드웨어 상태: 디스크 SMART 상태, GPU 정보, 배터리 상태 (노트북)
  • 시스템 서비스: 시작 프로그램, 실패한 서비스, 중요 이벤트 로그
  • 프로세스 감사: 리소스 사용량 및 위치를 기반으로 의심스러운 프로세스 식별

인간 중심 보고

  • 전문적인 HTML 보고서: 어두운 테마의 반응형 진단 보고서 및 시각적 메트릭
  • 과거형 완료 언어: 보고서는 [FIXED], [CLEANED], [DISABLED] 태그를 사용하여 완료된 작업 표시
  • 수동 주의 섹션: 자동 수정 사항과 사용자 개입이 필요한 항목을 명확히 구분
  • 타임스탬프 보관: 모든 보고서는 AI_Reports/ 디렉터리에 저장되어 기록 추적 가능

빠른 시작

다운로드

SuperDiagnosticTool.exe 다운로드 - 독립 실행형 실행 파일 (Python 필요 없음)

요구 사항

  • Windows 10 또는 Windows 11
  • 관리자 권한
  • Google Gemini API 키 (무료 키 받기)

첫 실행

  1. SuperDiagnosticTool.exe 다운로드 및 실행
  2. 메시지가 표시되면 Google Gemini API 키 입력
  3. 시스템 문제 설명
  4. 스캔 모드 선택 (빠른/심층/전체)
  5. AI 분석 및 복구 스크립트 검토
  6. 수정 실행 또는 상세 HTML 보고서 보기

설치 (개발자용)

전제 조건

  • Python 3.8 이상
  • pip 패키지 관리자

의존성 설치

pip install psutil google-generativeai rich

소스에서 실행

python super_diagnose_v2.py

사용법

API 키 설정

옵션 A: 대화식 입력 (처음 사용자 권장)

  • 도구가 첫 실행 시 API 키 입력을 요청
  • 키는 추후 사용을 위해 gemini.key에 로컬로 저장

옵션 B: 환경 변수

set GEMINI_API_KEY=your_api_key_here

옵션 C: 수동 키 파일 같은 디렉터리에 gemini.key 생성:

your_api_key_here

스캔 모드

모드스캔 대상사용 사례
빠른 스캔CPU, RAM, 기본 정보빠른 성능 확인
심층 스캔시스템, 네트워크, 보안, 로그, 블루투스, 프로세스포괄적인 문제 해결
전체 스캔위 모든 항목 + 디스크 상태, GPU, 시작 앱전체 시스템 감사

예시 워크플로

# 1. 도구 실행
SuperDiagnosticTool.exe

# 2. 문제 설명
> CPU 사용률이 높고 성능이 느림

# 3. 스캔 모드 선택
> 3 (전체 시스템 스캔)

# 4. AI 분석 대기
[Scanning system layers...]
[Processing telemetry logic...]

# 5. 복구 스크립트 검토
[PowerShell script displayed]
> Execute? (y/n)

# 6. HTML 보고서 보기
> Open detailed report? (y/n)

기술 세부 사항

코드 아키텍처

  • 각 진단 범주별 별도 함수로 모듈식 설계
  • try-except 블록을 사용한 포괄적인 오류 처리
  • 정상적인 폴백이 있는 하드웨어 독립적 쿼리
  • 전문적인 독스트링 및 명확한 변수 명명

PowerShell 스크립트 생성

  • 실행 전 관리자 권한 확인
  • 정규식 기반 변수 이스케이프로 구문 오류 방지
  • 환경 변수 ($env:TEMP, $env:PATH) 올바르게 보존
  • 존재 확인이 있는 안전한 서비스 관리
  • -ErrorAction SilentlyContinue를 사용한 오류 억제

Gemini AI 통합

  • 일관된 출력 파싱을 위한 구조화된 프롬프트
  • 신뢰할 수 있는 추출을 위한 구분 섹션 ([ANALYSIS_START], [FIX_START])
  • 시스템 원격 측정 기반 컨텍스트 인식 분석
  • 완료된 복구 작업에 대한 과거형 보고

보안 및 개인정보

  • 데이터 수집 없음: 모든 분석은 로컬에서 이루어지며, 시스템 원격 측정만 Gemini API로 전송
  • API 키 보안: 키는 로컬에 저장되며 버전 관리에 커밋되지 않음
  • 관리자 투명성: 사용자가 모든 복구 스크립트를 명시적으로 승인해야 함
  • 비파괴적: 사용자 동의 없이 파일 삭제 또는 레지스트리 수정 없음
  • 오픈 소스: 보안 감사를 위한 전체 소스 코드 제공

자세한 보안 정보는 SECURITY.md를 참조하세요.

문제 해결

"API Key Invalid" 오류

  • API 키가 올바르고 활성 상태인지 확인
  • 숨겨진 문자나 공백 확인
  • 키에 Gemini API 액세스가 활성화되어 있는지 확인
  • https://makersuite.google.com/app/apikey 에서 키 재생성

"Not Running as Administrator" 오류

  • 실행 파일을 마우스 오른쪽 버튼으로 클릭하고 "관리자 권한으로 실행" 선택
  • 또는 도구가 자동으로 권한 상승할 때 UAC 프롬프트 허용

"Module Not Found" 오류 (Python 버전)

pip install --upgrade psutil google-generativeai rich

PowerShell 스크립트 실패

  • Windows PowerShell 5.1 이상을 실행 중인지 확인
  • 실행 정책이 스크립트 실행을 허용하는지 확인
  • AI_Reports/remediation.ps1에서 스크립트 검토하여 오류 확인

소스에서 빌드

자동 빌드 (권장)

이 프로젝트는 GitHub Actions를 사용하여 버전 태그가 푸시될 때 Windows 실행 파일을 자동으로 빌드합니다:

  1. main 브랜치에 변경 사항 푸시
  2. 버전 태그 생성 및 푸시: git tag -a v1.0.2 -m "Release notes" && git push origin v1.0.2
  3. GitHub Actions가 자동으로 .exe를 빌드하고 릴리스 생성
  4. Releases 페이지에서 다운로드

자세한 지침은 RELEASE_PROCESS.md를 참조하세요.

수동 빌드 (테스트용)

Windows에서:

pip install pyinstaller
pip install -r requirements.txt
python build.py

이렇게 하면 아이콘과 종속성이 포함된 dist/SuperDiagnosticTool.exe가 생성됩니다.

참고: "Windows에서 PC를 보호했습니다" 경고가 표시되면, 빠른 수정 또는 앱을 영구적으로 허용 목록에 추가하는 방법은 TRUST_GUIDE.md를 읽어주세요.

참고: Linux/Mac에서 빌드하면 Windows .exe 파일이 아닌 플랫폼별 바이너리가 생성됩니다. 공식 Windows 릴리스는 GitHub Actions를 사용하세요.

파일 구조

SuperDiagnosticTool/
├── super_diagnose_v2.py    # Main diagnostic script
├── build.py                # Build script for creating EXE
├── icon.ico                # Application icon
├── .github/workflows/      # GitHub Actions workflows
│   └── release.yml        # Automated build and release
├── docs/
│   ├── icon.png           # Icon for README
│   └── screenshot_main.png # Main interface screenshot
├── src/                    # Source modules
│   ├── safety/            # Safety and validation modules
│   └── security/          # Security features
├── AI_Reports/             # Generated HTML reports
├── README.md               # This file
├── RELEASE_PROCESS.md      # Release process documentation
├── LICENSE                 # GPL-3.0 License
├── SECURITY.md             # Security documentation
└── .gitignore              # Git ignore rules

면책 조항

중요: 시스템 수정 경고

이 도구는 시스템 서비스, 구성 및 설정을 수정하는 PowerShell 스크립트를 생성하고 실행합니다. 안전 우선 원칙으로 설계되었지만:

  • 항상 실행 전 생성된 PowerShell 스크립트를 검토하세요
  • 자동 복구를 실행하기 전에 중요 데이터를 백업하세요
  • 가능하면 비프로덕션 시스템에서 먼저 테스트하세요
  • 시스템에 적용되는 변경 사항을 이해하세요

이 도구 사용으로 인한 시스템 손상, 데이터 손실 또는 의도하지 않은 결과에 대해 작성자는 책임을 지지 않습니다. 사용자는 본인의 책임 하에 사용하세요.

기여

기여를 환영합니다! 다음 단계를 따라주세요:

  1. 저장소를 포크합니다
  2. 기능 브랜치를 생성합니다 (git checkout -b feature/improvement)
  3. 변경 사항을 커밋합니다 (git commit -m 'Add improvement')
  4. 브랜치에 푸시합니다 (git push origin feature/improvement)
  5. Pull Request를 엽니다

라이선스

이 프로젝트는 GNU General Public License v3.0에 따라 라이선스가 부여됩니다 - 자세한 내용은 LICENSE 파일을 참조하세요.

Copyright (C) 2026 GUETTAF HOUSSEM EDDINE

저자

Knight
전기공학과 학생
Akli Mohand Oulhadj University, Bouira, Algeria
이메일: [email protected]
GitHub: @Guettaf-hossam

감사의 말

  • Google Gemini AI - 지능형 시스템 분석
  • psutil 라이브러리 - 크로스 플랫폼 시스템 모니터링
  • Rich 라이브러리 - 아름다운 터미널 출력

버전 1.0 | 마지막 업데이트: 2026년 1월

Knight의 헌신으로 제작됨 | Akli Mohand Oulhadj University

더 읽기

카테고리

General Purpose UtilitiesVulnerability AnalysisScripting & AutomationConfiguration AuditingForensicsMalware AnalysisMachine LearningIncident ResponseAI SecurityLog Analysis