guettaf-hossam/superdiagnostictoolGoogle Gemini를 활용한 AI 기반 Windows 진단 및 자동 복구 도구. 충돌 감지, 성능 최적화, 맬웨어 스캔 및 PowerShell 복구 스크립트 생성. 모든 하드웨어 지원 (1-128+ 코어). 무료 및 오픈소스.
AI 기반 Windows 진단 및 자가 치료 도구
SuperDiagnosticTool은 실시간 하드웨어 원격 측정과 Google Gemini AI를 결합하여 Windows 시스템 문제를 분석, 진단 및 자동으로 복구하는 지능형 시스템 진단 유틸리티입니다. 안전 우선 아키텍처로 제작되어 모든 Windows 구성에서 프로덕션 수준의 진단을 제공합니다.
스캔 모드 선택 및 문제 설명 입력을 보여주는 메인 인터페이스
프로덕션 등급 보안 (85%)
$env: 변수를 보존하면서 정규식 기반 이스케이프로 오류 방지[FIXED], [CLEANED], [DISABLED] 태그를 사용하여 완료된 작업 표시AI_Reports/ 디렉터리에 저장되어 기록 추적 가능SuperDiagnosticTool.exe 다운로드 - 독립 실행형 실행 파일 (Python 필요 없음)
SuperDiagnosticTool.exe 다운로드 및 실행pip install psutil google-generativeai rich
python super_diagnose_v2.py
옵션 A: 대화식 입력 (처음 사용자 권장)
gemini.key에 로컬로 저장옵션 B: 환경 변수
set GEMINI_API_KEY=your_api_key_here
옵션 C: 수동 키 파일
같은 디렉터리에 gemini.key 생성:
your_api_key_here
| 모드 | 스캔 대상 | 사용 사례 |
|---|---|---|
| 빠른 스캔 | CPU, RAM, 기본 정보 | 빠른 성능 확인 |
| 심층 스캔 |
# 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)
$env:TEMP, $env:PATH) 올바르게 보존-ErrorAction SilentlyContinue를 사용한 오류 억제[ANALYSIS_START], [FIX_START])자세한 보안 정보는 SECURITY.md를 참조하세요.
pip install --upgrade psutil google-generativeai rich
AI_Reports/remediation.ps1에서 스크립트 검토하여 오류 확인이 프로젝트는 GitHub Actions를 사용하여 버전 태그가 푸시될 때 Windows 실행 파일을 자동으로 빌드합니다:
git tag -a v1.0.2 -m "Release notes" && git push origin v1.0.2자세한 지침은 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 스크립트를 생성하고 실행합니다. 안전 우선 원칙으로 설계되었지만:
이 도구 사용으로 인한 시스템 손상, 데이터 손실 또는 의도하지 않은 결과에 대해 작성자는 책임을 지지 않습니다. 사용자는 본인의 책임 하에 사용하세요.
기여를 환영합니다! 다음 단계를 따라주세요:
git checkout -b feature/improvement)git commit -m 'Add improvement')git push origin feature/improvement)이 프로젝트는 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
버전 1.0 | 마지막 업데이트: 2026년 1월
Knight의 헌신으로 제작됨 | Akli Mohand Oulhadj University
| 시스템, 네트워크, 보안, 로그, 블루투스, 프로세스 |
| 포괄적인 문제 해결 |
| 전체 스캔 | 위 모든 항목 + 디스크 상태, GPU, 시작 앱 | 전체 시스템 감사 |