Floe Agent

你的模型，你的文件，你的电脑。

Floe Agent 是以 iPad 为先、为 iOS / iPadOS 深度优化的开源 AI 智能体工作空间，原生支持 iPhone，并提供独立 Android Alpha 版本。把 AI 任务、手记、Office 文档、创作、开发、语音对话与技能放进同一处——设备端 Linux 环境可直接运行代码、软件包与网页服务，支持的本地模型可在设备端完成推理，云端 AI 使用你自己准备的 API Key（BYOK）。

English · 官网 · 使用手册 · 文档中心

安装 · 功能 · 演示 · 文档 · 开发 · 参与贡献

开始使用

从官网选择安装方式；各渠道的版本、地区和资格分别以当前状态及安装页面为准。也可查看 iOS AI Agent 与 iPad 工作空间介绍。

下载发布版本

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

iOS / iPadOS 首次使用：安装 → 配置模型 → 新建任务 → 打开成果。核心手记、文件整理和画布无需 AI 服务商；AI 功能使用你配置的服务商或设备支持的本地模型。Android 首次使用：安装 → 添加云端模型 Key → 开始对话；手记基础编辑无需配置模型；AI功能使用自备云端服务。Office 文档、文件工作区、Linux 终端、代码 IDE 和网络工作台已在当前测试版中可用。

详细安装步骤 · 模型配置 · 软件源与签名

iOS 设置向导提供四种推荐配置，帮助预填模型、搜索、语音和工作空间等选择，仍可逐项调整。下载语音包、模型或运行环境时可以继续设置，稍后再查看进度；Apple Intelligence 对新用户默认关闭。

主要功能

下表介绍 Floe 的核心工作流程，具体可用性因平台与发布版本而异；Android 测试版现状请见上方安装说明与 Android 发布记录。

云端模型请求直接发送至你选择的服务商；支持的本地模型在设备端完成推理。密钥保存在设备的受保护存储中。文件、上传与远程操作遵循任务权限，重要操作按当前策略确认。详见安全说明。

看看 Floe 如何工作

演示视频基于 iOS 版录制；Android 测试版已包含对话、Office、文件、终端、IDE 与网络诊断等工作流，并持续扩展。

在 B 站观看 · Watch on YouTube · 官网功能介绍

文档导航

从源码构建

需要 macOS、完整 Xcode、Swift 与 XcodeGen。当前源码的 iOS 27 路径需使用 Xcode 27；iOS/iPadOS 26 保持兼容目标。

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

依赖准备、构建参数与定向测试见工程指南。Android 应用见 FloeAndroid/README.md。Gitee 仅用于源码与发行记录同步，见同步说明。

贡献与许可证

提交问题或参与开发前，请阅读贡献指南；一般问题见支持入口，安全问题请按安全策略私下报告。

Floe 原创代码采用 MPL 2.0。第三方组件保留各自许可证与声明，App 内可在“设置 → 诊断与关于 → 第三方开源许可”查看。