Droidmind

🚀 DroidMind

DroidMindは、AIアシスタントがADB（Android Debug Bridge）を介してAndroidデバイスと相互作用できる強力なツールです。これは、デバイス操作、ファイル管理、スクリーンショット、ログ表示などの機能に安全なインターフェースを提供し、さまざまなADBコマンドをサポートしています。

✨ 主な機能

• デバイス制御：デバイスの再起動やrecoveryモードへの移行などの高度な操作をサポートします。
• ファイル管理：デバイスとコンピュータ間でのファイルのアップロード/ダウンロードや、ディレクトリの作成/削除が可能です。
• UI インタラクション：クリック、スワイプ、テキスト入力などの操作をシミュレートし、自動化操作を実現します。
• ログ分析：デバイスのログ情報を簡単に確認し、エラー検出を行うことができます。
• 安全性：組み込みのコマンド検証メカニズムにより、悪意のある操作を防止し、安全な使用を保証します。

📦 インストール

DroidMindはUVを依存関係管理ツールとして使用しています。以下の手順でインストールしてください。

# プロジェクトを初期化する
uv init

# すべての依存関係をインストールする
uv install

💻 使用例

基本的な使用法

以下は、AIアシスタントがDroidMindを通じて実行できるいくつかのサンプルコマンドです。

• "接続されているすべてのAndroidデバイスとその詳細情報をリストアップする"
• "私の携帯電話のバッテリー状態を確認し、報告してくれ"
• "私のPixel携帯電話のスクリーンショットを撮り、現在の表示内容を表示する"
• "デバイスの残りのストレージ容量を確認する"
• "最近のANRとクラッシュログを表示する"

🔧 技術詳細

DroidMindは、デバイスの安全性を確保するための包括的なセキュリティ保護メカニズムを提供します。

• コマンド検証：すべてのシェルコマンドは許可リストでチェックされます。
• リスク評価：セキュリティレベル（安全、低リスク、中リスク、高リスク、重大リスク）に従って分類して実行されます。
• 入力サニタイズ：コマンドインジェクション攻撃から防御します。
• 保護されたパス：システムディレクトリや重要なパスは変更が禁止されています。
• 全面的なログ記録：すべての操作が記録され、監査が容易になります。
• 異常モード検出：潜在的に危険なコマンドを識別してブロックします。

開発情報

DroidMindはUVを使用して依存関係管理と開発プロセスを行っています。以下の手順で開発を行ってください。

# 依存関係を更新する
uv sync

# テストを実行する
pytest

# コード規約をチェックする
ruff check .

# 型チェックを実行する
mypy .

貢献の方法

どんな貢献も歓迎します！以下の手順に従ってプルリクエストを送信してください。

1. プロジェクトリポジトリをフォークする
2. 機能ブランチを作成する（例：git checkout -b feature/amazing-feature）
3. UVを使用して開発環境を設定する
4. 変更を加える
5. テストとコード規約のチェックを実行する
6. 変更をコミットする（例：git commit -m '素晴らしい機能を追加する'）
7. ブランチにプッシュする（例：git push origin feature/amazing-feature）
8. プルリクエストを作成する

📄 ライセンス

このプロジェクトはApacheライセンスの下で提供されています。詳細については、LICENSEファイルを参照してください。

開発者: Stefanie Jane 🌠

もしDroidMindが役に立ったと思ったら、Ko-fiでMonster Ultra Violet ⚡️を購入してサポートしてください！