guettaf-hossam/superdiagnostictoolGoogle Gemini를 활용한 AI 기반 Windows 진단 및 자동 복구 도구. 충돌 감지, 성능 최적화, 맬웨어 스캔 및 PowerShell 복구 스크립트 생성. 모든 하드웨어 지원 (1-128+ 코어). 무료 및 오픈소스.
AI 기반 Windows 진단 및 복구 도구
SuperDiagnosticTool은 실시간 하드웨어 텔레메트리를 수집하여 Google Gemini API로 전송해 분석하고, 감지된 문제를 해결하기 위한 PowerShell 복구 스크립트를 생성합니다. 생성된 스크립트는 사용자에게 실행 승인을 요청하기 전에 반드시 통과해야 하는 여러 검증 계층을 포함합니다.
스캔 모드 선택과 문제 설명 입력을 보여주는 메인 인터페이스
Gemini가 생성한 스크립트는 사용자에게 실행 승인을 요청하기 전에 네 가지 순차적 검사를 통과합니다:
ScriptValidator): 3단계 검사 — 블랙리스트(파괴적 패턴에 대한 강제 차단), 의심스러운 패턴 감지(별칭 및 난독화 인식), 0~100 척도의 위험 점수 산정CriticalPathInterceptor): HKLM/HKCU 레지스트리 키나 System32 경로를 건드리는 모든 스크립트를 사용자가 명시적으로 확인할 때까지 중단하는 제로 트러스트 게이트%TEMP%\superdiagnostic_execution_*.log에 기록$env: 변수를 보존합니다subprocess.run을 통해 실행되며, 5분의 하드 타임아웃, 전체 stdout/stderr 캡처, 자동 임시 파일 정리를 포함합니다. 이는 VM이나 컨테이너 격리가 아닌 호스트 수준의 직접 실행입니다. 위의 검증 계층이 주요 안전 경계입니다.[FIXED], [CLEANED], [DISABLED] 태그를 사용합니다AI_Reports/에 저장됩니다SuperDiagnosticTool.exe 다운로드 — 독립 실행형 실행 파일(Python 불필요)
이 실행 파일은 서명되지 않았습니다. Windows SmartScreen은 첫 실행 시 경고를 표시합니다. 진행 방법은 TRUST_GUIDE.md를 참조하세요. 실행 전에 검증하는 것을 선호한다면 대신 소스에서 빌드하세요.
SuperDiagnosticTool.exe를 다운로드하고 실행합니다도구의 종속성이 다른 Python 프로젝트와 격리되도록 가상 환경을 생성하세요:
python -m venv .venv
Windows 명령 프롬프트에서 활성화한 다음, 저장소에 나열된 종속성을 설치하세요:
.venv\Scripts\activate
pip install -r requirements.txt
PowerShell에서는 다음 명령으로 환경을 활성화합니다:
.\.venv\Scripts\Activate.ps1
PowerShell이 활성화 스크립트를 차단하는 경우, 사용자 권한으로 PowerShell을 열고 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned를 한 번 실행한 다음, 활성화 명령을 다시 시도하세요.
python super_diagnose_v2.py
소스 트리와 종속성이 스캔을 시작하기 전에 준비되었는지 확인하려면 다음을 실행하세요:
python -m compileall src super_diagnose_v2.py
명령은 오류 없이 완료되어야 합니다. 이 도구는 실행 시 여전히 Windows와 관리자 권한이 필요합니다. 여러 진단이 PowerShell과 보호된 시스템 정보를 사용하기 때문입니다.
옵션 A: 대화형 입력 (처음 사용 시 권장)
keyring)를 통해 안전하게 저장됩니다옵션 B: 환경 변수 명령 프롬프트:
set GEMINI_API_KEY=your_api_key_here
PowerShell:
$env:GEMINI_API_KEY = "your_api_key_here"
옵션 C: 수동 키 파일
도구 디렉터리에 gemini.key를 생성합니다:
your_api_key_here
| 모드 | 스캔 항목 | 사용 사례 |
|---|---|---|
| 빠른 스캔 | CPU, RAM, 기본 정보 | 빠른 성능 점검 |
| 심층 스캔 | 시스템, 네트워크, 보안, 로그, 블루투스, 프로세스 | 종합적인 문제 해결 |
| 전체 스캔 | 위의 모든 항목 + 디스크 상태, GPU, 시작 프로그램 | 전체 시스템 감사 |
1. Run the tool
> SuperDiagnosticTool.exe
2. Describe your issue
> High CPU usage and slow performance
3. Select scan mode
> 3 (Complete System Scan)
4. Wait for AI analysis
[Scanning system layers...]
[Processing telemetry...]
5. Review the generated remediation script
> Execute? (y/n)
6. View the HTML report
> Open detailed report? (y/n)
$env:TEMP, $env:PATH)가 올바르게 보존됨[ANALYSIS_START], [FIX_START])이 포함된 구조화된 프롬프트keyring)를 통해 저장됩니다. 버전 관리에 커밋되지 않습니다.CriticalPathInterceptor를 통과하고 명시적인 사용자 확인을 받아야 합니다.추가 보안 문서는 SECURITY.md를 참조하십시오.
pip install --upgrade psutil google-generativeai rich
AI_Reports/remediation.ps1에 저장됩니다 — 오류가 있는지 직접 검토하세요이 프로젝트는 버전 태그 푸시 시 GitHub Actions를 사용하여 Windows 실행 파일을 빌드합니다: