Droidmind

🚀 DroidMind

DroidMind 是一款强大的工具，它让 AI 助手借助 ADB（Android Debug Bridge）实现与 Android 设备的交互。该工具提供了安全接口，涵盖设备操作、文件管理、截图、日志查看等功能，还支持多种 ADB 命令。

🚀 快速开始

DroidMind 可助力 AI 助手与 Android 设备进行交互。以下是一些 AI 助手能通过 DroidMind 执行的示例命令：

• "列出所有连接的 Android 设备及其详细信息"
• "检查我的手机电池状态并报告给我"
• "为我的 Pixel 手机拍摄一张屏幕快照并展示当前显示内容"
• "查看设备剩余存储空间"
• "显示最近的 ANR 和崩溃日志"

✨ 主要特性

• 设备控制：支持设备重启、进入 recovery 模式等高级操作。
• 文件管理：能够在设备和计算机之间上传/下载文件，还能创建/删除目录。
• UI 交互：提供模拟点击、滑动、输入文本等功能，可实现自动化操作。
• 日志分析：便于查看设备的日志信息，并进行错误检测。
• 安全性：内置命令验证机制，可防止恶意操作，保障使用安全。

📦 安装指南

DroidMind 使用 UV 作为依赖管理工具。请按照以下步骤进行安装：

# 初始化项目
uv init

# 安装所有依赖
uv install

🔧 技术细节

DroidMind 提供了全面的安全保护机制，确保设备安全：

• 命令验证：所有 shell 命令都经过允许列表检查。
• 风险评估：按照安全等级（安全、低风险、中风险、高风险、严重风险）分类执行。
• 输入 sanitization：防御命令注入攻击。
• 受保护路径：系统目录和关键路径被禁止修改。
• 全面日志记录：所有操作都被记录，便于审计。
• 异常模式检测：识别并阻止潜在危险的命令。

💻 使用示例

基础用法

以下是开发 DroidMind 时的一些常用命令：

# 更新依赖
uv sync

# 运行测试
pytest

# 检查代码规范
ruff check .

# 执行类型检查
mypy .

📚 详细文档

开发信息

DroidMind 使用 UV 进行依赖管理和开发流程。开发时请按上述基础用法中的步骤进行操作。

如何贡献

欢迎任何贡献！请遵循以下步骤提交拉取请求：

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