Droidmind

🚀 DroidMind

DroidMind 是一款強大的工具，它能讓 AI 助手藉助 ADB（Android Debug Bridge）與 Android 設備進行交互。該工具為設備操作、文件管理、截圖、日誌查看等功能提供了安全接口，還支持多種 ADB 命令。

🚀 快速開始

DroidMind 使用 UV 作為依賴管理工具。請按照以下步驟安裝：

# 初始化項目
uv init

# 安裝所有依賴
uv install

✨ 主要特性

• 設備控制：支持設備重啟、進入 recovery 模式等高級操作。
• 文件管理：可以在設備和計算機之間上傳/下載文件，以及創建/刪除目錄。
• UI 交互：提供了模擬點擊、滑動、輸入文本等功能，實現自動化操作。
• 日誌分析：方便查看設備的日誌信息，並進行錯誤檢測。
• 安全性：內置命令驗證機制，防止惡意操作，確保使用安全。

💻 使用示例

以下是 AI 助手可以通過 DroidMind 執行的一些示例命令：

• "列出所有連接的 Android 設備及其詳細信息"
• "檢查我的手機電池狀態並報告給我"
• "為我的 Pixel 手機拍攝一張屏幕快照並展示當前顯示內容"
• "查看設備剩餘存儲空間"
• "顯示最近的 ANR 和崩潰日誌"

🔧 技術細節

DroidMind 提供了全面的安全保護機制，確保設備安全：

• 命令驗證：所有 shell 命令都經過允許列表檢查。
• 風險評估：按照安全等級（安全、低風險、中風險、高風險、嚴重風險）分類執行。
• 輸入 sanitization：防禦命令注入攻擊。
• 受保護路徑：系統目錄和關鍵路徑被禁止修改。
• 全面日誌記錄：所有操作都被記錄，便於審計。
• 異常模式檢測：識別並阻止潛在危險的命令。

📚 詳細文檔

開發信息

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 ⚡️ 支持我！