Floe Agent：iPad 优先的端侧 AI 智能体

项目简介

Floe Agent 是一款开源、以 iPad 为先的 iOS AI Agent，针对 iOS / iPadOS 优化，同时原生支持 iPhone，并提供独立的 Android alpha 版本。它把 AI 任务、笔记、Office 文档、创意工具、开发环境、语音对话与技能整合在一个 App 里：设备上可以运行真实的 Linux 环境（执行代码、安装软件包、启动服务），支持部分本地模型在设备端推理，也能用自己的 API Key（BYOK）调用云端模型。

核心主张是「Your models. Your files. Your machines.」——模型、文件与运行环境都掌握在自己手里。

主要功能

• AI 任务：把素材、工具操作和产出文件放在同一个任务中持续跟进。
• 设备端 Linux：任务专属的持久 Linux 环境，可使用 shell、Python、Node 与 apt 软件包，支持后台任务与本地 Web 预览。
• 设备端 AI：用系统模型或下载的模型在设备上推理（Beta），可用性取决于设备与模型状态。
• 笔记：导入 PDF 与图片、搜索、用 Pencil 批注，并针对文档提问。
• Office：创建、编辑、保存 DOCX、XLSX、PPTX。
• 画布与媒体：在画布上整理素材，使用图像、视频、音频工作台。
• 图纸与 3D：查看工程文件、编辑受支持的实体、使用 Drawing Assistant，具体操作因格式而异。
• 代码与远程：编辑代码、跟踪 Git 变更、连接已授权的远程主机。
• 语音：听写可编辑草稿、语音对话、朗读最终答案（iOS 可用，Android 尚未支持）。
• 技能与 Skill Hub：安装带依赖声明与版本管理的技能，并结合 MCP 服务与邮件动作做自动化（Skill Hub 商店在 iOS 提供）。

安装与使用

iOS / iPadOS 有多个渠道，具体版本、地区与资格以官网和各渠道说明为准（https://www.floe-agent.com/#download）：

• TestFlight：需要有效的 beta 权限。
• Feather / AltStore：先安装对应 App，再用按钮添加源并自行签名。
• GitHub IPA：从 Releases 下载未签名 IPA 与校验和，需要自己签名。

手动添加源的地址：

https://raw.githubusercontent.com/JiangNanGenius/floe-agent/main/feather.json

Android alpha 需要 Android 9+（ARM64），从 Android release 页面安装已签名的 APK。

首次使用流程：

• iOS / iPadOS：安装 → 连接模型 → 创建任务 → 打开结果。核心笔记、文件整理与 Canvas 不配置 AI 提供商也能用。
• Android：安装 → 填入云端模型 Key → 开始对话。

从源码构建需要 macOS、完整 Xcode 安装、Swift 与 XcodeGen：

 git clone https://github.com/JiangNanGenius/floe-agent.git
cd floe-agent/FloeAgent
bash scripts/gen_project.sh
open FloeAgent.xcodeproj

当前 iOS 27 构建路径需要 Xcode 27，iOS / iPadOS 26 仍是兼容目标。

注意事项

• 功能可用性因平台和版本而异：Android alpha 不提供本地模型推理，语音、只读 CAD/3D 与完整 Skill Hub 客户端仍在路线图中。
• 云端模型请求直接发送到你选择的提供商；凭据保存在设备上的受保护存储中。
• 本地模型与 Linux 环境共享内存。
• 设备端 Linux 需要先下载经过校验的镜像，安装的软件包需匹配该环境的架构。
• 文件、上传与远程操作遵循任务权限，重要操作需按当前策略确认。
• 许可证为 MPL-2.0。

---

本作品整理自 GitHub 开源项目 JiangNanGenius/floe-agent，原作者 @JiangNanGenius，许可证 MPL-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。