AndroidHarness 是一款驻留在您手机上的编码代理。它可以直接在设备上处理真实项目:读取和编辑文件、运行 shell 命令、驱动 Git、控制浏览器以及运行 MCP 工具。无需电脑。
采用 MIT 许可证开源:https://github.com/Sanuu7/AndroidHarness
代理运行时
与编码代理聊天:实时回复、思维导图和交互式工具卡片。附加技能、代码和 PDF 文件。在运行期间排队跟进或通过通知批准操作。检查点在应用重启后仍然存在。双重规划会在执行前进行检查和规划。前台服务可在屏幕关闭时保持运行。
57 个内置工具
- 文件:read_file、write_file、edit_file、multi_edit(模糊查找替换)、带回滚功能的 apply_patch、grep、search_files、file_info、批量复制、移动、删除。
- Shell:支持超时和进程组清理的 shell,后台守护进程管理器(shell_background、bg_list、bg_kill)。
- Git:git_status、git_diff、git_log、git_show(补丁视图)、git_commit、git_branch、git_branch_manage、git_checkout、支持上游修复的 git_push、git_pull。
- 系统与诊断:支持包和标签过滤的 read_logcat、doctor 自检套件、env_status 探测。
- 视觉与 Web:用于视觉模型的 read_image、PDF 文本提取、web_search(无密钥、Brave、Tavily)、web_fetch、支持二进制检测的 http_request。
- 代理与内存:memory_read、memory_write、memory_search、todo_write 实时跟踪、ask_user 提示、任务(并行子代理)、pkg_search、pkg_install、pkg_list。
模型上下文协议 (MCP)
通过 MCP 连接外部工具生态系统:
- 通过标准 I/O、HTTP 和服务器发送事件 (SSE) 连接服务器。
- 通过粘贴 Claude Desktop 或 MCP JSON 文件导入配置。
- 服务器可动态地向代理运行时公开自定义工具。
- 通过 Chrome 自定义标签页内置 OAuth 2.0,用于已认证的服务。
- 基于工作区的审批和 HMAC 完整性验证可保护执行安全。
代理浏览器(13 个工具)
支持 13 个工具的无头浏览器自动化:browser_navigate、browser_click、browser_type、browser_scroll、browser_wait_for、browser_eval、browser_get_logs、browser_screenshot、browser_back、browser_forward、browser_refresh、browser_get_url 和 browser_get_dom。使用 DevTools、设备框架预览 Web 应用,并可一键修复错误并返回给代理。
文件、编辑器、终端
工作区文件管理器,支持多选和批量操作。代码编辑器,支持语法高亮(Kotlin、Java、Python、JS、TS、HTML、Shell)、行号显示、无限撤销、正则表达式搜索和编码保留保存。并排可视化差异查看器。交互式终端会话。
自动化和构建
通过 WorkManager 实现定时后台自动化:计划任务、预设间隔、运行历史记录、警报。构建和测试仪表板,用于 Gradle 命令和测试套件,提供实时日志和一键式代理修复失败构建。
模型和缓存
通过内置 Harness 提供程序实现无密钥访问,或提供 Anthropic、Gemini、OpenAI 的 API 密钥或自定义 URL。实时目录,提供延迟探测、精确定价和实时成本跟踪。快速缓存监控:命中、未命中、读/写令牌、命中率。从关闭到超高,各种缓存设置。
安全设计
执行层级:Shizuku、Linux 工具链(bash、git、python、node)、toybox sh 备用方案。Shell 策略将操作限制在工作区内。密钥编辑器会清理 API 密钥。四种权限模式:全部确认、确认风险、全自动、完全访问。生物识别应用锁。
技能与内存
23 个内置 Markdown 技能(规划、TDD、调试、架构)以及自定义技能。实时待办事项跟踪、代码库映射索引、Groq Whisper 语音输入、会话分叉、持久内存。
入门指南
1. 授予项目文件的存储访问权限。
2. 使用内置的无密钥提供程序或在设置中输入 API 密钥。
3. 可选:连接 Shizuku 以进行特权 shell 执行。
零分析、零广告、零追踪。数据仅流向已配置的端点。请在 GitHub 上报告问题。
设备上的 AI 编码工具:shell、文件、代码编辑器、git 和 MCP。