Floe Docs

Floe Agent 使用手册

English · 文档目录 · 版本与验证状态 · 官网文档

更新于 2026-10-08。适用于 iPad 优先、同时支持 iPhone 的 Floe 1.7,系统要求 iOS/iPadOS 26 或更高。不同安装版本的入口和功能可能不同;本文包含 1.7.21(262)的终端及网页服务操作、1.7.23(264)的媒体工作台,以及为 1.7.24(265)准备的二维 CAD/图纸助手、Office 与手记共享 AI 能力。Build 265 已完成签名上传:内部 TestFlight(Floe QA)可用,已于 2026-10-08 提交至现有 publictest1 组,正在等待 Apple 审核,尚未外部批准。安装资格、Apple 处理和公测审核进度请查看版本与验证状态,以 TestFlight 实际显示为准。 实体设备验收须单独完成。

1. 安装与首次使用

  1. 优先通过你已获得资格的 TestFlight 组安装;打开 TestFlight 查看构建号、到期时间及“测试内容”。公开链接显示的是 Apple 已批准且仍有效的构建。
  2. 如果使用 GitHub 或 Feather/AltStore,核对发布页的版本、哈希和来源。GitHub IPA 为未签名开发者包,需要你自己的签名方式,不能当作 TestFlight 安装包。
  3. 首次打开完成引导。iPad 可使用多栏;iPhone 通过侧栏按钮切换入口,编辑器可全屏打开。
  4. 无需模型即可先使用手记、文件整理和画布的核心功能;要调用 AI,先连接自己的模型服务商。
  5. 在“设置 → 诊断与关于”确认实际版本。反馈时始终提供这里的版本和构建号。

推荐第一次操作:配置模型 → 新建一个测试任务 → 添加无敏感内容的文本 → 请求总结 → 打开工具记录检查实际结果 → 在文件面板检查输出。先用合成样例熟悉流程,再处理重要资料。

2. 配置模型与辅助能力

云端模型

  1. 打开“设置 → 模型服务商”,添加服务商。
  2. 按服务商提供的信息填写接口地址、协议、模型 ID 和密钥;模型显示名不等于真实模型 ID。
  3. 测试连接,启用服务商与模型,选择默认 Agent 模型。
  4. 返回“新建任务”,确认输入框附近的模型标签显示预期模型。
  5. 如果列表中没有模型,检查服务商开关、模型开关以及“在主模型列表中隐藏”。隐藏与停用不同:隐藏可保留辅助用途,停用会阻止新的选择。

服务调用可能产生第三方费用。密钥保存在系统钥匙串;不要将密钥放入工作区、聊天截图或公开问题单。

识图、生成图片、图片编辑

在“设置 → 辅助模型”分别配置识图、生图和图片编辑。能进行文字对话不代表支持这三种能力。图片编辑需要可编辑的原图附件;只有安装资源或列出模型名称,不代表服务调用已经成功。

Apple 系统模型与下载式模型

3. 新建任务与选择工作区

  1. 打开“新建任务”。发送前检查模型、项目、执行目标、Skills 和权限。
  2. 不选择项目时,任务使用 App 内部私有工作区;选择项目时,文件操作归属于该项目。
  3. 添加所需附件并说明目标、输出格式、保存位置和完成条件。例如:“读取附件,生成一页摘要和待办清单,保存到当前工作区,完成后给出文件链接。”
  4. 点击发送。草稿会成为持续任务;后续消息继续使用该任务的上下文。
  5. 对外部文件夹,通过系统文件选择器授权。仅有路径文字不等于已获得目录访问权限。

删除私有任务可能清理其内部工作区;删除项目任务与删除项目文件不是同一操作。重要结果先导出或保存到明确的项目位置。手记有独立资料存储,不随聊天删除。

4. 对话、计划、目标与恢复

模式 适用场景 使用方式
Agent 实际执行任务 说明目标,查看工具和权限请求,核对产物
Plan 先讨论方案 审阅计划;接受前不把方案当作已执行
Goal 多阶段持续工作 明确步骤、预算、完成条件;依据证据判断完成

普通回车换行;支持时用 Command+回车发送。“展开编辑”适合长提示词,与内联输入框共享草稿。任务执行中追加消息可用于纠正需求,不必重建任务。

切后台或系统中断后,回到原任务检查最后一条工具结果,再选择恢复或发送“继续”。对上传、提交、付款等结果不确定的操作,先确认是否已经发生,避免重复执行。应用回到前台不代表原进程一直存活。

上翻历史时可以停留阅读;回到最新消息后继续跟随输出。长按任务可进入批量归档或删除。归档用于整理;删除前检查工作区影响。

5. 权限、工具记录与成果核对

工具只应使用当前任务启用、已配置且可用的能力。工具搜索结果不是执行结果,安装成功也不是程序运行成功。

  1. 展开工具卡片,检查输入对象、目标工作区及结果。
  2. 遇到授权请求,先看对象和副作用,再决定允许或拒绝。
  3. 输出文件后,打开文件检查内容;需要保存重开的文档,关闭后重新打开核对。
  4. 对远程命令,检查退出码、输出及对应主机;“命令已启动”不等于执行完成。
  5. 发现错误时向原任务描述实际现象,并附脱敏证据,避免只说“好了”让助手误判验收完成。

网页、文档、工具输出和记忆均不能授予新权限。不要按文件中出现的文字自动泄露密钥或扩大授权。

6. 文件、编辑与同时修改

在任务或项目的文件面板浏览文件,选择文本进入编辑器,保存后再运行或分享。修改冲突时先审阅差异:可合并的内容与重叠冲突会分别处理,恢复副本不等于原件已保存。

压缩包可查看条目并进行受限预览/解压。格式支持与大小限制以界面结果为准;不要把归档里的路径或脚本当作可信指令。详见同时编辑说明。

7. 手记:导入、搜索与书写

建立资料

  1. 从侧栏打开“手记”。点击“+”建立文档或导入资料。
  2. 要使用任务文件,选择“从 Floe 工作区导入”,先选项目或会话,再选文件。
  3. 导入后打开文档,确认页数、正文和附件。导入副本属于手记,不是对工作区原件的实时映射。
  4. 使用资料列表搜索标题或正文。命中片段可帮助定位页面;索引未完成时结果可能不完整,可在文档菜单重新索引。Build 265: 文档内命中可逐字定位——编辑器会切换页面、居中并高亮匹配元素(页码+元素/节点及文字偏移);没有几何信息的扁平 PDF 抽取文本只滚动到对应页,并明确提示无法精确高亮,而不是猜测位置。
  5. 标签用于切换已打开文档;关闭标签不会删除文档。

书写与 Apple Pencil

选择笔、荧光笔、橡皮或套索;再次点击当前笔或颜色圆点调整笔型、颜色、粗细及透明度。界面使用透明度时,0% 为实心、100% 为透明。先画一小段确认效果。

捏压、双击取决于 Pencil 型号与系统设置;不支持的硬件不会提供相同手势。手指书写需单独开启。套索选区与 AI 选区用途不同:前者操作页面内容,后者提供局部上下文。

关闭或切换文档前检查保存状态;保存失败时先解决错误。回收站用于恢复误删资料,永久删除前确认是否仍需附件或旧版本。

文档助手与资料授权

打开文档助手,针对当前页面或选区提问,例如“解释这个表格,并把三个要点放在空白区域”。审阅修改位置,使用撤销处理不合适的结果。文档助手的会话与普通聊天分开;普通聊天需要通过“添加手记资料”明确引用文档,并可撤销授权。Build 265: 助手修改遵循提案 → 预览 → 你确认;确认后的改动是可撤销、带修订校验的批次,采纳或拒绝即使中途被打断也会准确送回原会话。可导出选定页或整篇为 PDF(重新核对页数),或导出可移植的 .floenote 归档。不支持原地编辑 PDF 原文,也不能把手写识别文字当作文本编辑;真正的 PDF 批注在暂存副本上进行。

8. Office:编辑、批注、保存和重新打开

  1. 导入或打开 DOCX、XLSX、PPTX,等待实际内容出现。封面摘要不等于完整排版预览。
  2. 进入编辑,在小型测试副本上检查文本、表格或幻灯片操作。
  3. 开启“画笔批注”,先取消已有绘图对象的选中状态,再选颜色、线宽和透明度。
  4. 在文档中实际画一笔。仅点批注开关不应被当作已经完成批注。
  5. 检查引擎是否确认设置;“尚未确认生效”不表示设置已应用。
  6. 保存并等待完成,关闭文档,重新打开核对文字、笔迹和页数;需要导出时另行检查导出文件。

Build 260 修复: 开启自由绘制自动插入默认图形的问题已在 Build 260 引擎中修复;连续绘制、原文件写回和实际 iPad 保存重开仍须验收。未显示内容、持续加载或保存失败时,不要删除原件;记录文件类型、具体步骤、构建号和脱敏样例。手记 PDF 笔迹与 Office 原生批注不是同一编辑链路。

Build 265: 编辑器界面与 document.office.edit 助手工具共用同一命令目录。Word 样式、项目符号/编号列表、对齐、插入表格,Excel 数字格式、行列、冻结窗格、排序、自动筛选、跳转单元格、重算,以及演示文稿复制/排序幻灯片、对象对齐走内置原生引擎;文本查找替换、单元格公式、公式错误定位与同格式图片替换走可靠的包级路径。已实现的引擎命令按运行时引擎/格式实际提供(仍待真机验收,但不会因缺少回执而禁用);只有引擎确无实现路径的命令(如引擎层换图)才带原因标记不可用,绝不用截图或 PDF 冒充。AI 修改先给预览、需你确认,绑定已保存文件的确切修订,提交前重开并校验保存后的包;批次失败时从已验证原件恢复。这些引擎命令已做结构/桥接测试,但仍待真机资格确认,因此不要把“已派发”当作已成功编辑——请保存、关闭、重开核对。能力表见格式能力表。

9. 本地终端与 Linux 性能配置

Build 260 入口: 任务工具面板 → 终端 →“本地工作区”;同处可切换“远程 SSH”。已发布旧版还可能通过 IDE 底部终端进入。终端操作当前任务工作区,先确认位置再执行修改命令。

  1. 打开本地终端。缺少 Linux 镜像时,使用明确显示的安装入口并等待校验完成。
  2. 首先执行 pwd、ls 等只读命令确认目录。Linux 程序必须在可用客体环境中运行。
  3. 让助手第一次运行 Linux 前,先检查状态并按任务选择核心数和内存。可以直接说:“先检查 Linux 环境,按并行编译任务选择 2 核,启动后确认实际核心数。”
  4. 核对工具返回的实际资源;资源不足或镜像不支持时,按错误处理,不把请求值当作分配成功。
  5. 完成任务后停止不需要的服务,必要时结束终端或客体。关闭一个面板不一定结束应用级 shell 会话。
任务 核心选择参考 注意事项
查看文件、轻量命令、小型服务 1 核 先避免不必要的资源占用
并行编译、多进程 CPU 计算 2–3 核 只有任务可并行时才有收益,内存另行检查
多任务同时工作 总计不超过 4 核 可分配 3+1、2+2、2+1+1、1+1+1+1

单台最多 3 核;三核依赖经验证的镜像,旧双核镜像仍可能限制为两核。四核池不保证任何设备都能同时启动两台,设备内存和已运行任务仍会限制准入。

Build 260 恢复行为: 成功启动后保存核心数和内存,中断后复用上次配置。首次启动应显式选择;改变正在运行客体的资源可能需要硬重启,会中断命令或服务。升级 App 会优先复用有效镜像,镜像缺失、损坏或不兼容时才需要相应修复;不要为了排错直接删除环境。

10. Python、Node、依赖与运行代码

依赖入口:“设置 → 执行环境 → 选择项目或会话 → Python·PyPI / Node.js·npm”。先确认所选环境,再安装;项目文件依赖与共享环境依赖不是同一写入位置。

本地 Python/Node 主要在 Linux 客体运行,软件包必须适配该客体架构。缺少兼容原生扩展时安装可能失败;不要把桌面 macOS 或 iOS 二进制包强行当作 Linux 包。

代码文件可在完整 IDE 中选择“运行”,先看执行目标与将执行的命令。保存失败或冲突未解决时先处理文件。远程单文件运行不是整项目同步,需要远端具备对应解释器、依赖及所需助手服务。

用 pip list、python3 --version、node --version 等核对真实环境。包安装卡住时检查下载、网络和兼容性;Build 260 已去除本地 Python 服务启动时自动创建虚拟环境的流程,避免无关初始化阻塞服务启动。详见本地 Shell与IDE/语言说明。

11. Git 与 GitHub Actions

  1. 在文件检查器打开“源码管理”,查看是否为仓库及当前分支。
  2. 检查逐文件差异,只暂存本次需要的修改,填写提交说明后提交。
  3. 推送前确认远端和分支;有冲突时审阅并解决,不将失败的同步视为成功。
  4. 在“设置 → GitHub 与源码管理”通过设备授权或 Token 连接账户;凭据只进入安全存储。
  5. 在 IDE“运行 → GitHub Actions”选择仓库、分支和工作流,审阅上传快照后提交。安装工作流模板会写入仓库,需明确操作。
  6. 返回运行面板检查状态、日志与产物。关闭 App 不会取消 GitHub 构建,取消也要等服务器确认。

云端 Linux/macOS 产物不能直接作为 iOS 程序运行。源码管理的恢复副本用于挽回误操作,不能替代长期备份。详见云端构建说明。

12. 远程设备、桌面与网络诊断

在“设置 → 主机与远程会话”保存设备及所需协议。SSH、VNC、经 SSH 隧道的 VNC、Telnet、TCP 和 BLE GATT 能力按配置分别启用;只有设备名称不能产生连接能力。

“作为远端执行环境”开关决定是否按执行环境路径检查和安装 Floe 远程助手;普通管理目标不应被强制安装。连接前确认主机身份、目标目录与认证。Telnet/普通 TCP 不提供加密,应使用可信网络或已配置隧道。

诊断时按顺序检查:设备可达 → DNS → 端口 → 身份认证 → 命令与目录权限。长命令需用其返回的任务标识查询;不要为找结果而重复启动命令。临时连接与已保存设备的持久性不同。BLE GATT 不等于任意传统蓝牙串口支持。

13. 浏览器、网页预览与登录

任务浏览器可显示助手操作的页面。在工具记录中核对实际网址和操作结果。涉及登录或人工验证时在可见页面操作;不要把验证码或密钥写入工作区。

本地网页预览使用当前工作区的文件服务。服务启动、浏览器加载与页面功能可用须分别确认。外部资源、跨域请求和网络策略可能导致页面缺项。浏览器的登录会话不等于远程 SSH 凭据。详见浏览器协议。

14. 工程图纸与图纸助手

  1. 从文件面板打开支持的 DXF/DWG、三维网格或 PCB 制造文件,等待真实内容显示。
  2. 点击“全屏预览”,检查图层、缩放和方向。出现“无法预览”时保留原件和错误文本。
  3. 本地可编辑 DXF/DWG 可进入“编辑”,选择图元或新增线、矩形、圆、圆弧、多段线、单行文字、原生标注与引线,并进行图层、对象捕捉、测量、修剪/延伸/偏移以及按数值移动/复制/旋转/缩放/镜像。先在副本上验证保存重开。
  4. CAD 画笔与 Office 画笔不同;格式、线宽和保存能力以当前引擎及实际输出为准。保存会重新编码并重新校验后才覆盖原件;3D、块、外部参照、样条和代理内容保持只读,绝不展平;未定义单位时保持图纸单位。
  5. 该入口现为图纸助手(Drawing Assistant),绑定当前图纸(单位、图层、当前图层、选区、未保存修订),可定位/高亮被引用图元、测量和检查几何,依据确定性几何而非截图猜测回答。它会用颜色显示新增/修改/删除的提案,经你确认后作为一个可撤销事务执行;提问或预览不写原件,有未保存手改时拒绝应用。265 的完整能力见创作工具契约。

Build 260: 本地预览首次连接遇到特定临时错误时,只恢复一次;已加载或有未保存修改的编辑器不会因此自动重载。Build 260 已通过完整 App CI 和发布资格验证,独立手记工程所需源码依赖也已补齐并验证。详见工程查看器。

15. 画布、图像、音视频

从“创意模式”建立画布,添加文字、图片及生成节点,连接输入后检查当前模型支持的能力。生成文件后确认实际素材与节点状态;工具返回成功文本不替代打开成果检查。

在媒体工作台选择文件,设置裁剪、剪辑区间、字幕或导出格式。先预览,再执行导出,最后播放输出检查时长、声音、字幕位置和画面。保留原文件,避免只保留缩略图。

生图、图像编辑、视频生成与本地转换是不同能力,可能需要不同服务商及额度。模型能力和参数以配置页面与实际接口为准。详见画布架构。

Build 265: 图纸(.dwg/.dxf)节点可从节点菜单和双击打开同一个矢量 CAD 编辑器;“完成”更新原节点且不栅格化,“制作变体”创建带来源的新节点。未保存的 CAD 修改在关闭时作为持久草稿保留,重开时继续;保存失败不会被悄悄丢弃。画布备份包现在包含媒体子工程及其素材(媒体备份/恢复已有测试并防护不安全路径);现已包含未应用的 CAD 草稿和已采用修订素材,19 项备份定向测试通过;完整 App 备份恢复交互尚未单独验收。旧版扁平图片/视频编辑在首次打开时一次性迁移为类型化子工程。图片新增矩形/椭圆/套索选区及加选/减选/反相/羽化、非破坏蒙版与复制/剪切/填充;视频新增音乐波形/淡入淡出与按帧对齐的精确边缘裁切。画布仍是工程管理者,编辑器只是其下属工具。

16. 语音输入与转录

  1. 在聊天中点麦克风,按系统提示授权。
  2. 等待准备状态结束,再开始说话;观察波形是否跟随音量变化。
  3. 结束录音后检查转写内容,再发送。噪声、语言混合与专有名词可能需要人工修正。
  4. 启动长时间灰色或无响应时先停止,再重试一次;仍失败则记录时间、设备、麦克风路由及构建号。
  5. 在设置中管理识别资源。下载完成不代表识别质量已验收;Apple 回退路径依赖系统实际可用性。

文件转录、实时语音输入和视频字幕是不同入口。导出 SRT/VTT/JSON 后检查时间轴和文字;设备端资源安装与真实录音成功分别验证。

17. Skills、MCP、邮件与自动任务

Skills 提供任务方法,安装或启用并不自动授予文件、网络或账户权限。只启用任务需要的技能,检查来源和版本。MCP 连接按实际服务器配置与工具目录决定能力;不可用的服务器不会因为被提及而自动可用。

邮件连接器配置后,先用只读检查核对账户与文件夹;发送邮件须确认收件人、主题、正文和附件。自动任务需要明确触发条件、动作和停止方式,查看执行记录,不把创建计划当作动作已成功。

详见邮件连接器、工具闭环和技能中心。

18. 后台、PiP、通知与数据管理

iOS 后台执行受系统限制。启用后台模式或 PiP 不等于无限持续运行;回到前台检查任务和服务的真实状态。通知需要系统授权,点击通知后的页面也须确认是否属于目标任务。

在设置中管理字体、资料、环境和诊断。字体导入只改善支持该字体的渲染路径,不保证所有 Office 排版一致。升级前导出重要文档和恢复副本;不要为了清理空间删除仍在用的环境或模型。

诊断日志等级只影响后续采集,不会补回此前缺失的日志。分享诊断前遮去正文、地址、令牌及私人附件。

19. 常见问题与排查顺序

现象 先检查 下一步
模型不在列表 服务商/模型启用、隐藏开关 返回新建任务重新选择
模型说做完但无文件 工具记录和保存路径 要求打开实际产物核对
Linux 每次似乎重装 构建号、所选环境、镜像状态 保留环境,导出安装日志;Build 260 优先复用有效镜像
请求三核失败 镜像上限、四核池、内存 释放不需要的任务,按实际错误调整
Office 一点批注就有图形 安装构建、原件副本 Build 260 引擎包含修复;保留样例并测试实际笔画/重开
图纸全屏离线 是否为本地预览、错误文本 重试一次,保留诊断;259 自动恢复尚待验收
灰色语音波形 授权、输入设备、准备状态 停止后重试一次,仍失败记录诊断
文档正文搜不到 索引状态、文件类型 重新索引;核对扫描/OCR结果
保存后内容不一致 冲突提示、恢复副本 比较版本,不覆盖唯一原件
App 闪退 当前构建、重现时间及步骤 提供对应设备诊断;不要用旧日志推断本次原因

20. 提交有效反馈

请提供:设备型号、系统版本、App 版本/构建号、操作入口、最短复现步骤、预期结果、实际结果,以及可公开的截图或合成样例。涉及崩溃时附对应时间的诊断;涉及保存时说明是否保存成功、是否关闭重开及原件是否改变。

支持入口 · 安全说明 · 候选与交付状态

历史使用说明、旧版本截图及当时的验收边界见2026-10-05 归档。

IDE 网页服务与全屏终端(1.7.21)

打开工作区内的 .py、.js 或 .sh 文件,点“运行”,选择“作为网页服务运行”。确认所属任务和端口后启动。脚本需读取 PORT 并监听该端口;出现“预览”按钮表示已获得 HTTP 响应。启动失败时查看服务日志。关闭窗口保留服务;使用“停止”结束,也可在环境的本地服务列表管理。App 被系统结束后需重新启动服务。

终端状态栏的展开按钮进入全屏,“隐藏”返回原工作区并保留会话。运行终端没有输出时会明确显示等待输出;进程错误与退出状态显示在窗口内。

普通“运行”适合有明确结束点的脚本;HTTP 服务请选“作为网页服务运行”,以便查看健康状态、预览并单独停止。仅有日志不代表端口已就绪。端口被占用时先检查已有服务,避免重复启动;工作区或任务不可用时按窗口错误修正,不要在其他目录盲目重试。全屏终端与原面板使用同一会话,隐藏窗口不会主动终止它;Ctrl-C 用于中断当前前台命令。

工作区体验(1.7.22/263)

以下功能随 263 提供;是否已可安装请先看当前版本状态。

浏览器接管与交还

地址栏展示真实地址,本地网页也包含协议、主机、端口和路径。点地址可修改,菜单可复制地址。全屏按钮保留当前标签、页面和表单;全屏切换不重新打开网页。

接管后,模型仍可分析、读写已授权文件和使用其他工具,但不能点击、输入或导航当前浏览器。完成手动操作后点击“完成并交还模型”。“已通知原任务”表示通知已进入原任务输入通道,不代表模型已完成后续工作。模型应重新观察页面后继续。原任务已经结束时,点击“继续任务”明确恢复原任务;失败提示可重试,不必反复新建会话。交接通知不包含密码或表单内容。

终端和端口

终端工具栏提供字体缩放、复制输出、粘贴、清屏、Ctrl-C、Tab、Esc 和方向键。清屏保留进程;结束会话才会关闭终端。向上查看历史时不自动追随新输出。粘贴超过输入队列上限时会提示分段输入。

在端口管理中先选择环境,再添加或编辑规则。来宾端口是 Linux 中服务监听的端口;请求主机端口留空表示自动分配。实际绑定端口可能因冲突改变,应复制当前显示的可用地址。选择“仅允许本机访问”可限制为设备回环地址,关闭此选项才允许局域网访问。

“已保存”不等于已监听:需要虚拟机已启动,且网页服务正在对应来宾端口运行。停止虚拟机后规则保留,但地址不可访问。模型使用 linux.port 时先查询,再在当前任务环境中修改规则;不能据此宣称网页服务已经启动。

媒体工作台(1.7.23/264)

图像与视频编辑现已合并为一个工作台,可从文件页、工作区文件预览和画布进入。 横屏宽屏 iPad 上左侧是素材/图层,中间是大预览,右侧是属性,底部是视频时间线; 竖屏 iPad、窄分屏与 iPhone 会优先展示大预览,其余面板收进抽屉,避免预览被挤成 窄条。

二维 CAD、图纸助手与文档 AI(1.7.24/265)

以下能力随 265 提供;是否已可安装请先查看当前版本状态。它们与媒体工作台遵循同一规则:AI 改动都是需要你确认的提案,原件受保护,成功文字不是证据——请保存、关闭、重开核对。

已证实程度如实区分:CAD 引擎、命令、备份、Office 包级路径和手记契约均已实现,并由本地测试覆盖;保存时的校验是同一引擎重新解析自身输出,而独立 LibreDWG 读取是构建/QA 在代表性文件上离线进行的发布资格交叉核对(不是应用内每次保存都跑,也不代表普遍支持所有 DWG)。原生 Office 引擎命令与真机性能仍待设备资格确认,未声称任何真实付费模型运行。详见创作工具契约与格式能力表。