【免费下载链接】EtaSystem-level Android AI Agent with direct OS access. | Android 系统级 AI Agent——越过沙盒让模型访问底层API、屏幕、终端与你的数据项目地址https://gitcode.com/gh_mirrors/eta9/Eta点击查看免费下载Eta 是一款运行在 Android 上的系统级 AI Agent它最实用的能力之一就是让 AI 直接读写手机文件。Eta 内置了七大文件工具读取、写入、精确编辑、元数据查询、目录列举、路径匹配与全文搜索read_file、write_file、edit_file、stat_file、list_directory、glob_files、grep_files。你不需要敲任何命令只用自然语言告诉 AI帮我把这个文件里的端口改成 8080它就能在 Android 工作区或 Linux 环境里安全、可验证地完成操作。本手册面向新手用大白话讲清这七个文件工具各自能做什么、怎么用、以及几条必须知道的边界规则。为什么 Eta 的 AI 文件工具比普通终端更省心桌面端的 Coding Agent 早已能自由读写文件系统而普通 App 在 Android 沙盒里只能碰到自己的一亩三分地。Eta 的解法是给模型一套结构化文件工具模型不再拼接cat、sed这类 Shell 命令而是调用有明确参数和返回合同的结构化工具由 FileToolDispatcher.kt 分派、AgentFileOperations.kt 执行。这样做的好处对新手非常直接更安全编辑文件时要求旧内容精确匹配匹配不到或有歧义就直接失败不会写入猜测结果有边界读取、写入、搜索都有明确的字节与条数上限不会一口气吞掉整个磁盘可验证每次操作返回文件版本revision与实际作用范围AI 知道我读到哪了、改的是不是最新内容。七个工具的声明集中在 AgentFileToolCatalog.kt完整合同见官方文档 docs/AGENT_RUNTIME.md 的结构化文件工具一节。七大文件工具一览表每个工具负责什么工具一句话说明典型说法直接对 AI 说read_file读取 UTF-8 文本支持按字节或按行号定位续读把这个文件第 100 行往后读给我看write_file新建、整份覆盖或追加写文件自动创建父目录把这份总结保存成 notes/summary.mdedit_file精确替换文件中指定片段默认要求唯一匹配把配置里的 timeout 从 30 改成 60stat_file查询文件的路径、类型、大小和版本不读正文这个文件多大是文件还是目录list_directory分页列出目录下的直接子项看看 workspace 里有哪些文件glob_files按*、?、**模式递归查找文件找出所有 .json 配置文件grep_files在文本中搜索字面内容返回路径与行号哪些文件里写了eta-workspace七个工具覆盖了读、写、改、查、找全部日常场景。对新手来说你只需要描述目标AI 会自己决定调用哪个工具、按什么顺序调用——比如先grep_files定位再read_file确认上下文最后用edit_file修改。快速上手三步让 AI 开始读写你的文件第 1 步配置模型。使用 AI 功能需要自备模型服务的 API KeyBYOK。安装 Eta 后在模型提供商中填写 Key 并选择支持工具调用Tool Calling的默认模型具体流程见 README.md 的快速开始。第 2 步准备文件可选。手机里的文件可以通过 Eta 的文件页面导入到私有工作区。注意一个关键细节选择器导入得到的是工作区副本AI 修改副本不会自动写回来源文档。相关界面实现见 WorkspaceScreen.kt。第 3 步直接对话。在聊天页用自然语言下达任务即可例如读一下工作区里的 config.yaml告诉我里面有哪些字段把所有 .json 文件列出来按大小排一下把 README 里的版本号 1.2.3 改成 1.3.0任务执行过程中你可以在消息流里看到 AI 调用了哪些工具、实际作用于哪个路径任务支持随时停止和接管结果会归档在本机会话中。逐个理解七个工具的行为细节读文件read_file有界、可续读单次最多返回 16000 字节文本AI 会拿着返回的next_offset_bytes自动续读大文件也能完整读完无需你操心分页。它只接受 UTF-8 文本遇到二进制内容会返回明确错误而不是乱码——图片和压缩包请交给对应的媒体工具。写文件write_file覆盖 / 追加 / 新建支持整份覆盖和追加两种模式父目录不存在会自动创建。单次内容上限512 KiB超出时应拆分或改用终端脚本处理。Android 普通身份下写入采用暂存 原子移动避免写到一半留下坏文件。改文件edit_file精确替换宁缺毋滥这是最体现可靠的一个工具old_text必须与文件内容逐字一致且默认只能匹配到唯一一处否则拒绝写入。想批量替换同一片段要显式说明全部替换。写前还会再次核对文件版本防止覆盖你刚才手动改过的内容。查文件stat_file 与 list_directorystat_file不读正文只回答这是什么、多大、什么版本适合让 AI 先确认再动手。list_directory对大目录自动分页默认每页 80 条has_morefalse才代表列举完成目录中途变化会让游标失效并重新枚举。找文件glob_files 与 grep_files按名找 / 按内容找glob_files按路径模式递归查找例如找出**/*.log默认跳过隐藏目录与符号链接结果有界可续查grep_files在 UTF-8 文本中做字面文本搜索不是正则返回文件路径、行号与匹配片段且不依赖设备上是否安装了rg。搜索结果会如实说明覆盖了哪些范围、跳过了哪些二进制文件没搜到不会被夸大成肯定不存在。关键规则路径、身份与环境三要素Eta 的每个文件工具都共享三个公共概念理解它们能让你和 AI 沟通更高效路径path只接受文件系统路径不接受content://这类文档 URI。所以想让 AI 处理手机里某个 App 选出来的文件请先在 Eta 中导入到工作区。身份identityAndroid 环境默认以Eta App 的 UIDuser访问工作区与已授权存储涉及受保护文件时 AI 需显式使用root身份且你的设备必须实际拥有 Root。普通身份不等同于 ADB Shell也不会因为某次失败就自动升权。环境environmentandroid操作手机文件系统linux则在你安装的 Alpine/Debian 环境中操作默认工作目录是/workspaceLinux 内的路径不能拿宿主机的路径代替。两种 Linux 后端PRoot/chroot的安装方式见 docs/TERMINAL_NATIVE.md。各环境的默认基准目录cwdAndroid 普通身份为 Eta 私有工作区Root 为/data/local/tmp/etaLinux 为/workspace。所有文件操作还受20 秒时间预算与随时取消的约束长任务请及时查看进度。新手常见问题FAQQAI 修改的文件会变回原来的样子吗不会变回去但也别期待它直接改原文件——选择器导入的是副本修改作用在工作区副本上需要时再由你导出或复制回原位置。Q一次能写多大的文件单次写入与精确编辑的上限是 512 KiB读取单次 16 KiB 但会自动续读。更大的文件建议让 AI 走 Linux 环境用脚本处理。Q搜索没结果是不是文件里真没有不一定。搜索默认跳过隐藏项、二进制文件和不可访问项结果中会带上不完整范围标记AI 收到不完整结果时不会把它当成全部文件都查过了。Q这些功能要 Root 吗基础文件工具在无需 Root的 Android 13 设备上即可使用工作区 已授权存储Root 只是让受保护目录、系统级文件等操作成为可能详见 docs/ROOTLESS_SUPPORT.md。延伸阅读与源码位置工具合同与边界细节docs/AGENT_RUNTIME.md结构化文件工具章节七大工具声明AgentFileToolCatalog.kt执行层实现FileToolDispatcher.kt、AgentFileOperations.ktLinux 环境与共享目录docs/TERMINAL_NATIVE.md、SharedFolderMounts.kt在 App 内浏览 Linux 文件LinuxFilesScreen.kt把文件操作交给有合同、有边界、可验证的结构化工具是 Eta 让手机 AI 从能聊天走向能干活的关键一步。下一步不妨就从让 AI 读一份文件并总结开始试起 赞分享【免费下载链接】EtaSystem-level Android AI Agent with direct OS access. | Android 系统级 AI Agent——越过沙盒让模型访问底层API、屏幕、终端与你的数据项目地址https://gitcode.com/gh_mirrors/eta9/Eta点击查看免费下载相关推荐Renamer文件重命名工具完整使用手册Renamer文件重命名工具完整使用手册 在现代数据处理和文件管理中批量重命名文件是一个常见但繁琐的任务。Renamer作为一款基于Node.js开发的命令行NSC_BUILDERNintendo Switch文件管理工具完整使用手册NSC_BUILDERNintendo Switch文件管理工具完整使用手册 NSC_BUILDER作为基于hacbuild和Nut Python库开发的综合开发工具逆向工程密码学给 ESP32 装上耳朵和嘴巴ES8311 音频方案接线、跑通与调优避坑给 ESP32 装上耳朵和嘴巴ES8311 音频方案接线、跑通与调优避坑 xiaozhi esp32 是一个基于 ESP32 的 MCP 聊天机器人固件设备人工智能大模型语音交互助手嵌入式物联网智能硬件MCP 服务创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考