guettaf-hossam/superdiagnostictoolGoogle Geminiを活用したAI搭載のWindows診断・自動修復ツール。クラッシュ検出、パフォーマンス最適化、マルウェアスキャン、PowerShell修復スクリプトの生成。ユニバーサルハードウェア対応（1～128+コア）。無料・オープンソース。
AI搭載のWindows診断・修復ツール
SuperDiagnosticToolは、リアルタイムのハードウェアテレメトリを収集し、Google Gemini APIに送信して分析を行い、検出された問題に対処するためのPowerShell修復スクリプトを生成します。生成されたスクリプトは、ユーザーに実行を促す前に、複数の検証レイヤーを通過する必要があります。
スキャンモードの選択と問題の説明入力を行うメインインターフェース
Geminiが生成したスクリプトは、ユーザーに実行の承認を求める前に、4つの連続したチェックを通過します：
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、基本情報 | 迅速なパフォーマンスチェック |
| ディープスキャン | システム、ネットワーク、セキュリティ、ログ、Bluetooth、プロセス | 包括的なトラブルシューティング |
| コンプリートスキャン | 上記すべて + ディスクヘルス、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 実行ファイルをビルドします：