Floe Agent
English下载 Floe Agent
文档

Floe Android 使用指南

本指南介绍 Floe Android（Floe Agent 的安卓版本）的实际功能与操作步骤，重点是低版本安卓的本机 ADB 激活。本页按 1.0.0（versionCode 108）整理；截至 2026-11-12，该版本在 GitHub 标记为预发布，渠道状态以版本中心为准，仅通过 Full APK 独立分发；Google Play 线已于 2026-11-10 停止。最低要求 Android 9（API 28）、ARM64 设备。任务使用你自己配置的云端模型，不提供本地模型推理。

English · 文档目录 · 官网版本中心 · GitHub Releases

Floe Android 把手机变成一个轻量 Agent 工作台：云端模型任务、项目文件、设备控制、项目级 ARM64 Linux 终端与图形应用、网络工具和定时任务。本指南按实际发布的界面与文案编写；不同版本的菜单词句可能略有差异，以你安装版本的界面为准。

目录

入门

工作区与工具

1. 安装与更新

1.1 安装

  1. 在官网版本中心或 GitHub Releases 下载最新 Android Full APK（应用 ID com.floe.agent.full）。
  2. 打开 APK 安装。覆盖安装会保留已有任务、项目和文件，无需卸载旧版。
  3. 首次使用时，Floe 会提示安装 Linux 运行组件（与主应用同一次发布的配套组件包）。按系统安装器的提示确认即可；组件与主应用版本一一对应，请始终使用同一次发布的两个包。

1.2 应用内更新

打开 设置 → 诊断与关于 → 应用更新：

1.3 旧客户端升级

很久未更新的旧版本客户端如果应用内更新失败，直接从发布页下载最新完整 APK 覆盖安装一次即可，无需卸载，数据保留。

2. 第一个云端模型与任务

服务商配置、任务描述、成果检查与反馈方式见模型、任务与文件（共通）。以下说明 Android 的实际菜单与操作。

Floe Android 不提供本地模型推理，任务使用你自己配置的云端模型服务。

2.1 配置模型提供商

  1. 打开 设置 → 模型与供应商。
  2. 点添加提供商，先选择用途（聊天模型 / 图像生成与编辑 / 视频生成）。
  3. 填写供应商、协议、Base URL 和 API key。API key 只保存在本机安全存储中；如使用本地或私有地址的明文 HTTP，需单独开启对应选项。
  4. 点测试连接确认可用，然后在管理模型中添加或刷新模型列表。
  5. 模型路由（同一设置页入口）可分别指定主模型、辅助模型、视觉模型等角色；不单独设置时按默认继承。

2.2 运行第一个任务

  1. 在首页（新建任务）输入你的指令，例如“总结工作区里这份 PDF 的第三章”。
  2. 在输入框的模型入口选择已配置的模型。
  3. 发送后，Floe 会按计划执行任务；涉及工具调用时按任务授权，你可以查看每一步的产出。

3. 本机 ADB：内嵌 ADB 访问

内嵌 ADB 访问是 Floe 自带的本机 shell 权限服务：它让 Floe 在你这台手机本机获得 shell 级文件和系统操作能力。它不是 Root，不是 Shizuku 应用，也不是让电脑远程管理手机；服务由 Floe App 自己持有和调用。

请先分清三种互不相同的权限，按需只开启你需要的：

能力 入口 作用
设备操作（无障碍） 设置 → 设备 → 设备操作（无障碍） 观察并操作你选定的应用界面（见第 5 节）
内嵌 ADB 访问 设置 → 设备 → 内嵌 ADB 访问 shell 级文件、系统文件夹（只读）、应用管理等（本节）
Root 访问 设置 → 设备 → Root 访问 设备已有 Root 授权时的最高权限操作（见第 4 节）

仅仅在电脑上“连上 adb”不会给 Floe 任何能力；必须按下面的方式完成配对或初始化，让 Floe 自己的服务运行起来。

开启内嵌 ADB 后可以按需设置：

3.1 Android 11 及以上：无线配对

Android 11+ 使用系统的“无线调试”配对，全程在手机上完成，不需要电脑：

  1. 打开 设置 → 设备 → 内嵌 ADB 访问，开启内嵌 ADB，点与 Android 配对。Floe 会打开系统的开发者选项。
  2. 在系统设置中开启无线调试，进入后点使用配对码配对设备，屏幕显示 6 位配对码和配对端口。配对端口只在配对这一步使用，和下一步连接用的端口不是同一个。
  3. 在 Floe 的配对通知中输入 6 位配对码（让 Android 的配对界面保持在前台）。如果通知被关闭，按提示允许配对通知；也可以使用分屏，在 Floe 页面内直接输入。Floe 会自动查找本机配对端口；找不到时按屏幕提示手动输入。
  4. 配对成功后返回 Floe，点启动服务。Floe 通过本机回环地址（127.0.0.1）和当前实际的连接端口连接这台手机自己的调试服务——连接端口就是无线调试主页面显示的“IP 地址和端口”里的端口号，和配对端口不同。状态显示服务运行中并显示 Shell 身份（UID 2000）即表示成功。

注意：

3.2 Android 9/10：电脑 USB 初始化

Android 9/10 没有系统无线配对，需要借助电脑做一次 USB 初始化。这里的目的是让 Floe 连接这台手机自己的内嵌服务，不是把电脑变成这台手机的管理器：

  1. 在电脑上安装 Android platform-tools（官方说明见 Android 调试桥文档）。

  2. 手机开启开发者选项和 USB 调试，用 USB 连接电脑，并在手机上允许这台电脑的调试授权。

  3. 手机上打开 设置 → 设备 → 内嵌 ADB 访问，先开启内嵌 ADB，再点复制 USB 初始化命令。命令已复制到剪贴板。

  4. 在电脑上先确认手机已就绪。在终端执行：

    adb devices

    正常情况下列表里只有这台手机且状态为 device。如果显示 unauthorized，请在手机上允许这台电脑的调试授权后重试；如果显示 offline，重新插拔 USB 或重新开启 USB 调试；如果列出了多台设备，请先断开其他设备，或在第 5 步把命令开头的 adb 换成 adb -s <序列号>（序列号就是上一步列表中该设备的第一列）。

  5. 在电脑的 POSIX shell（macOS/Linux 终端；Windows 请使用 Git Bash 等 POSIX 环境，并确认 adb 在该 shell 的 PATH 中）粘贴剪贴板中的命令并执行一次。

  6. 命令会通过手机上的 adb 会话启动 Floe 自带的系统服务（shell 身份）。回到手机，Floe 状态显示服务运行中（Shell 身份 UID 2000）即成功。

关于这条命令，需要知道：

3.3 验证、撤销与排查

4. Root 访问（可选）

Root 访问默认关闭，只使用这台设备已经存在的 Root 授权；Floe 不会为手机获取 Root，也不会把 ADB 提升为 Root。

  1. 打开 设置 → 设备 → Root 访问。
  2. 点检查 Root 授权，按提示确认使用设备已有的 Root 授权；成功后即可启用 Root 访问。找不到授权时会明确提示“无 Root 授权”。
  3. 开启后，只以 Root 执行你主动启动的操作；随时可以再次关闭。

内嵌 ADB 与 Root 同时只有一个作为活动后端：Root 成为活动后端时，已运行的 ADB 服务转为待命状态，反之亦然。

5. 设备控制（无障碍）

设备控制让任务在你选定的应用内观察界面并执行操作，基于 Android 无障碍服务。

5.1 开启与选择应用

  1. 打开 设置 → 设备 → 设备操作（无障碍），点打开无障碍设置，启用 Floe 的设备控制服务。如果系统阻止该服务，按提示在应用信息中允许“受限设置”后重新启用。
  2. 在Agent 可控制的应用中选择应用：只有你选择的应用可以被查看或操作，不存在“全部应用”授权；前台切换到未选择的应用会被拒绝。
  3. 屏幕内容选择当前任务何时可以查看屏幕：关闭 / 仅此任务 / 直到停止。不会持续录制；仅在任务请求时截取正在观察的页面。

5.2 任务中使用与接管

5.3 为任务自动解锁（已知密码）

如果你愿意，任务可以在本机输入你保存的设备 PIN 或密码来解锁：

6. 项目 Linux：终端与图形会话

6.1 安装本地环境

  1. 打开 设置 → 执行环境 → 本地环境，按提示下载并安装 Linux 环境。首次使用需先安装第 1.1 节的 Linux 运行组件。
  2. 安装完成后显示环境已安装；终端任务即可用。如果显示不可用，按提示打开一次任务终端或点重新检查（只重新测量，不会重装或重新下载）。

6.2 任务终端

6.3 图形会话（Linux 应用）

  1. 在任务的工作区文件页，点标题栏的更多 → Linux 应用。
  2. 首次使用按提示安装一次基础图形组件；之后选择单应用或桌面模式，点启动会话。
  3. 可打开所选文件、选择应用或安装新软件；返回应用在会话与 Floe 之间切换。
  4. 关闭窗口不会结束会话；停止会话会关闭 Linux 应用并回传已保存的文件——请先在其中保存修改。

7. 文件与外部编辑器

7.1 工作区文件

任务的工作区文件页提供：新建文件/文件夹、文件操作（移动等）、源码（Git）、网络存储（WebDAV/SMB 服务器连接、复制与回传）、恢复副本和实时预览。Office 文档可直接在 Floe 内离线预览和编辑；CAD/三维文件提供预览查看。

Office 与 CAD 预览使用可选预览组件：首次打开这类文件时按提示安装，或到 设置 → 数据管理 → 可选预览组件 中安装。组件从发布渠道下载并校验后，经系统安装器确认；它与你的文件分开保存，卸载组件不影响文档。应用更新后 CAD 预览组件可能需要重新下载一次。

7.2 使用其他应用编辑

轻量文本、Markdown 和代码默认直接在 Floe 内编辑；专业编辑可交给安卓上的其他应用：

  1. 在工作区文件页点更多 → 使用其他应用编辑，选择要编辑的项目文件。
  2. 选择编辑器：有默认应用时直接打开，否则显示系统选择器；也可选择其他应用手动指定。
  3. 在对方应用中保存后，修改会自动回传到项目；返回 Floe 可查看原始版本对比。
  4. 如果原文件同时也被改动，两个版本都会保留，供你选择保留当前文件或使用编辑副本；处理完点结束编辑释放占用。

没有合适的安卓应用时，可改用第 6.3 节的 Linux 图形应用编辑。

8. 网络工具（更多 → 网络）

网络工作台在侧边栏 更多 → 网络（或 设置 → 系统能力 → 网络诊断）。所有测量都只在你点开始后执行，结果保存在本机；首次使用按提示允许网络/本地网络权限后重新开始。

9. 定时与条件任务

在任务中心（或首页的定时任务卡片）进入定时任务：

10. 语音、记忆与技能

11. 版本、诊断与反馈

12. 当前限制

搜索文档

    搜索结果会跳到对应章节。