扫码加入微信群article
README
🚀 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 进行依赖管理和开发流程。开发时请按上述基础用法中的步骤进行操作。
如何贡献
欢迎任何贡献！请遵循以下步骤提交拉取请求：
- 叉项目仓库。
- 创建功能分支（例如：
git checkout -b feature/amazing-feature）。 - 设置开发环境使用 UV。
- 进行修改。
- 执行测试和代码规范检查。
- 提交更改（如：
git commit -m '添加神奇的功能'）。 - 推送到分支（如：
git push origin feature/amazing-feature）。 - 创建拉取请求。
📄 许可证
该项目在 Apache 许可证下，详细信息请查看 LICENSE 文件。
开发人员：Stefanie Jane 🌠
如果您觉得 DroidMind 有用，请通过 Ko-fi 购买一杯 Monster Ultra Violet ⚡️ 支持我！