
SuperDiagnosticTool v1.0.5
Google Geminiを活用したAI搭載のWindows診断・自動修復ツール。クラッシュ検出、パフォーマンス最適化、マルウェアスキャン、PowerShell修復スクリプトの生成。ユニバーサルハードウェア対応(1~128+コア)。無料・オープンソース。
SuperDiagnosticTool
AI搭載のWindows診断・自己修復ツール
SuperDiagnosticTool は、リアルタイムのハードウェアテレメトリと Google Gemini AI を組み合わせて、Windows システムの問題を分析、診断し、自動的に修復するインテリジェントなシステム診断ユーティリティです。安全性を最優先したアーキテクチャで構築されており、あらゆる Windows 構成に対応したプロダクショングレードの診断を提供します。
スクリーンショット
スキャンモードの選択と問題説明の入力を表示するメインインターフェース
主な機能
ユニバーサルハードウェアサポート
- 動的スケーリング: あらゆる CPU 構成(1~128+ コア)に自動適応
- ハードウェア非依存のロジック: レガシーシステム(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 Update 履歴
- ハードウェアヘルス: ディスク SMART ステータス、GPU 情報、バッテリーステータス(ノートパソコン)
- システムサービス: スタートアップアプリケーション、失敗したサービス、重要なイベントログ
- プロセス監査: リソース使用量と場所に基づいて不審なプロセスを識別
人間中心のレポート
- プロフェッショナルな HTML レポート: ダークテーマ、視覚的なメトリクスを備えたレスポンシブな診断レポート
- 過去形の完了言語: レポートでは
[FIXED]、[CLEANED]、[DISABLED]タグを使用して完了アクションを表示 - 手動注意セクション: 自動修正とユーザー介入が必要な項目を明確に分離
- タイムスタンプ付きアーカイブ: すべてのレポートを
AI_Reports/ディレクトリに保存し、履歴を追跡
クイックスタート
ダウンロード
SuperDiagnosticTool.exe をダウンロード - スタンドアロン実行ファイル(Python 不要)
要件
- Windows 10 または Windows 11
- 管理者権限
- Google Gemini API キー(無料キーを取得)
初回実行
SuperDiagnosticTool.exeをダウンロードして実行- プロンプトが表示されたら Google Gemini API キーを入力
- システムの問題を説明
- スキャンモードを選択(クイック/ディープ/コンプリート)
- AI 分析と修復スクリプトを確認
- 修正を実行するか、詳細な 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、基本情報 | パフォーマンスの簡単な確認 |
| ディープスキャン | システム、ネットワーク、セキュリティ、ログ、Bluetooth、プロセス | 包括的なトラブルシューティング |
| コンプリートスキャン | 上記すべて+ディスクヘルス、GPU、スタートアップアプリ | 完全なシステム監査 |
ワークフロー例
# 1. ツールを実行
SuperDiagnosticTool.exe
# 2. 問題を説明
> CPU使用率が高く、動作が遅い
# 3. スキャンモードを選択
> 3(コンプリートシステムスキャン)
# 4. AI分析を待つ
[システムレイヤーをスキャン中...]
[テレメトリーロジックを処理中...]
# 5. 修復スクリプトを確認
[PowerShellスクリプトが表示されます]
> 実行しますか? (y/n)
# 6. HTMLレポートを表示
> 詳細レポートを開きますか? (y/n)
技術詳細
コードアーキテクチャ
- 各診断カテゴリごとに別個の関数を持つモジュール設計
- try-except ブロックによる包括的なエラーハンドリング
- グレースフルフォールバックを備えたハードウェア非依存のクエリ
- プロフェッショナルなドキュメント文字列と明確な変数名
PowerShell スクリプト生成
- 実行前の管理者権限確認
- 構文エラーを防ぐ正規表現ベースの変数エスケープ
- 環境変数(
$env:TEMP、$env:PATH)は正しく保持 - 存在確認による安全なサービス管理
-ErrorAction SilentlyContinueを使用したエラー抑制
Gemini AI 統合
- 一貫した出力解析のための構造化プロンプト
- 確実な抽出のための区切りセクション(
[ANALYSIS_START]、[FIX_START]) - システムテレメトリに基づくコンテキスト認識分析
- 完了した修復アクションに対する過去形レポート
セキュリティとプライバシー
- データ収集なし: すべての分析はローカルで行われ、システムテレメトリのみが Gemini API に送信されます
- API キーのセキュリティ: キーはローカルに保存され、バージョン管理にコミットされることはありません
- 管理者の透明性: すべての修復スクリプトはユーザーが明示的に承認する必要があります
- 非破壊的: ユーザーの同意なしにファイル削除やレジストリ変更は行いません
- オープンソース: セキュリティ監査のための完全なソースコードが利用可能です
セキュリティの詳細については SECURITY.md を参照してください。
トラブルシューティング
「API キーが無効」エラー
- API キーが正しくアクティブであることを確認
- 隠し文字や空白がないか確認
- キーが Gemini API アクセスを有効にしていることを確認
- https://makersuite.google.com/app/apikey でキーを再生成
「管理者として実行されていません」
- 実行ファイルを右クリックして「管理者として実行」を選択
- または、ツールが自動昇格する際の UAC プロンプトを許可
「モジュールが見つかりません」エラー(Python バージョン)
pip install --upgrade psutil google-generativeai rich
PowerShell スクリプトが失敗する
- Windows PowerShell 5.1 以降を実行していることを確認
- 実行ポリシーがスクリプトの実行を許可していることを確認
AI_Reports/remediation.ps1のスクリプトを確認
ソースからのビルド
自動ビルド(推奨)
このプロジェクトは GitHub Actions を使用して、バージョンタグがプッシュされたときに Windows 実行ファイルを自動的にビルドします:
- 変更をメインブランチにプッシュ
- バージョンタグを作成してプッシュ:
git tag -a v1.0.2 -m "リリースノート" && git push origin v1.0.2 - GitHub Actions が自動的に .exe をビルドし、リリースを作成
- リリースページ からダウンロード
詳細な手順については 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 # メイン診断スクリプト
├── build.py # EXE ビルド用スクリプト
├── icon.ico # アプリケーションアイコン
├── .github/workflows/ # GitHub Actions ワークフロー
│ └── release.yml # 自動ビルドとリリース
├── docs/
│ ├── icon.png # README 用アイコン
│ └── screenshot_main.png # メインインターフェースのスクリーンショット
├── src/ # ソースモジュール
│ ├── safety/ # 安全性と検証モジュール
│ └── security/ # セキュリティ機能
├── AI_Reports/ # 生成された HTML レポート
├── README.md # このファイル
├── RELEASE_PROCESS.md # リリースプロセスのドキュメント
├── LICENSE # GPL-3.0 ライセンス
├── SECURITY.md # セキュリティドキュメント
└── .gitignore # Git 除外ルール
免責事項
重要: システム変更に関する警告
このツールは、システムサービス、構成、設定を変更する PowerShell スクリプトを生成および実行します。安全性を最優先に設計されていますが:
- 実行前に生成された PowerShell スクリプトを 常に確認 してください
- 自動修復を実行する前に 重要なデータをバックアップ してください
- 可能であれば 本番環境以外のシステムで最初にテスト してください
- システムに加えられる 変更を理解 してください
このツールの使用に起因するシステム損傷、データ損失、または意図しない結果について、作成者は責任を負いません。自己責任で使用してください。
貢献
貢献を歓迎します! 以下の手順に従ってください:
- リポジトリをフォーク
- 機能ブランチを作成 (
git checkout -b feature/improvement) - 変更をコミット (
git commit -m '改善を追加') - ブランチにプッシュ (
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
謝辞
- Google Gemini AI - インテリジェントなシステム分析
- psutil ライブラリ - クロスプラットフォームのシステムモニタリング
- Rich ライブラリ - 美しいターミナル出力
バージョン 1.0 | 最終更新: 2026年1月
Knight の献身により制作 | Akli Mohand Oulhadj University