# Floe Agent 使用手册

[English](USER_GUIDE.md) · [文档目录](README.md) · [版本与验证状态](CURRENT_STATUS.md) · [官网文档](https://www.floe-agent.com/docs/zh.html)

更新于 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 处理和公测审核进度请查看[版本与验证状态](CURRENT_STATUS.md)，以 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 系统模型与下载式模型

- Apple 系统模型由系统管理；按界面显示检查设备支持、Apple Intelligence 开关与模型就绪状态。它没有 Floe 的下载按钮。
- 下载式 MLX 模型为 Beta，下载完成、加载成功和实际推理是三个不同阶段。先用短文字验证，再尝试连续对话。
- 下载式模型采用文字路径；附图可通过 OCR 提取文字，但不能据此假定模型能理解图像语义。
- 本地模型和 Linux 共用设备内存。遇到资源冲突，按界面确认释放对象；取消确认不会授权停止其他任务。
- 停用与删除不同：停用保留文件，删除会移除下载资源。反复崩溃时保留当次日志，勿用清空全部数据代替诊断。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- 文本：保存失败或冲突未解决时不要运行旧内容。
- Office：出现冲突时保留两份，预览或导出后再决定采用哪份。
- 手记：冲突内容可保留为独立恢复副本。
- 恢复文件：查看界面提供的 `Recovered Edits` 或对应恢复位置；确认新文件完整之前不要删除副本。

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

## 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 修改先给预览、需你确认，绑定已保存文件的确切修订，提交前重开并校验保存后的包；批次失败时从已验证原件恢复。这些引擎命令已做结构/桥接测试，但仍待真机资格确认，因此不要把“已派发”当作已成功编辑——请保存、关闭、重开核对。能力表见[格式能力表](FLOE_1_7_24_CREATIVE_TOOLS.md)。

## 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](ARCHITECTURE_LOCAL_SHELL.md)与[IDE/语言说明](FLOE_IDE_AND_LANGUAGES.md)。

## 11. Git 与 GitHub Actions

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

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

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

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

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

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

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

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

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

## 14. 工程图纸与图纸助手

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

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

## 15. 画布、图像、音视频

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

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

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

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

## 16. 语音输入与转录

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

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

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

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

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

详见[邮件连接器](MAIL_CONNECTOR.md)、[工具闭环](TOOL_CLOSURE_IMPLEMENTATION.md)和[技能中心](../skill-hub/README.md)。

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

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

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

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

## 19. 常见问题与排查顺序

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

## 20. 提交有效反馈

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

[支持入口](../SUPPORT.md) · [安全说明](../SECURITY.zh-CN.md) · [候选与交付状态](CURRENT_STATUS.md)

历史使用说明、旧版本截图及当时的验收边界见[2026-10-05 归档](history/USER_GUIDE.zh-CN.pre-20261005.md)。

## IDE 网页服务与全屏终端（1.7.21）

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

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

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

## 工作区体验（1.7.22／263）

以下功能随 263 提供；是否已可安装请先看[当前版本状态](CURRENT_STATUS.md)。

### 浏览器接管与交还

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

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

### 终端和端口

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

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

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


## 媒体工作台（1.7.23／264）

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

- 图片：可交互裁剪（拖动裁剪框和四角手柄）、移动、捏合缩放、旋转、图层拖动
  排序、隐藏/锁定/不透明度、文字与手绘图层、基础调色、模糊/锐化、马赛克与
  滤镜。源文件不会被破坏性改写：导出后才产生新文件，工作区预览可把结果写回
  原文件。
- 视频：一条主轨支持多片段（裁剪、在播放头分割、拖动排序、删除、变速、旋转、
  画面裁剪、音量、静音），一条音乐轨（偏移、素材剪辑起点与时长、音量、淡入淡出，
  与原声混音），一条字幕轨（手工字幕或对所选片段使用既有本地转录），以及硬切
  或交叉溶解转场。预览与导出使用同一条渲染管线，渲染后再播放，因此转场、裁剪、
  溶解、烧录字幕与混音效果与导出文件一致。
- 项目与重新打开：每次编辑都会原子写入 JSON 工程并保留撤销历史。工作台工具栏的
  文件夹按钮列出当前归属/工作区下的已保存项目；打开后恢复图层、时间线、编辑
  历史与素材根目录。再次打开同一素材时，若已有保存的工程，会先询问“继续编辑”
  还是“新建项目”。
- 导出：PNG/JPEG/HEIC 可显式设置尺寸、质量、透明度与元数据（无效组合会明确
  报错，绝不静默改写）；视频可导出 H.264 或 HEVC 并显式设置分辨率与帧率。导出
  文件写入工作区的 `Workbench/Exports`，成功后在面板底部直接显示“分享 / 存到文件”
  （系统分享面板，大视频按 URL 处理，不读入内存）；开始新的导出、失败或取消都会
  立即清除上一次的成功结果，不会留下过期文件。项目本身是原子写入的 JSON 文档，
  重启后连同撤销/重做历史一起恢复。
- AI：AI 抽屉只在你主动打开时出现，显示当前选择、待确认的 AI 提案和持久化生成
  任务。提交前可看到模型、素材、参数与费用说明，确认提交的内容与审阅页完全一致
  （包括图生图参考素材、视频时长/画幅/分辨率）；候选结果不会自动替换项目，接受
  后作为新图层或片段导入，且仍可撤销。候选结果与运行中的任务在关闭视图后仍保留。
  图片生成没有可轮询的任务号：若等待期间应用中断或网络失败，会如实显示“已中断／
  结果未知”，不会自动重新提交，避免重复扣费或重复生成。

## 二维 CAD、图纸助手与文档 AI（1.7.24／265）

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

- **二维图纸：** 打开本地可编辑 DWG/DXF，可绘制线、矩形、圆、圆弧、多段线和单行文字，添加原生标注/引线，移动/复制/旋转/缩放/镜像，修剪/延伸/偏移，管理图层并测量。适应/缩放/平移及图层、图元面板在全屏后保留；切换视图时未保存修改会被保留。保存前重新编码并重新解析图纸，再覆盖原件。仅编辑二维模型空间：3D、块、外部参照、样条和代理图形可查看但不编辑、不展平；未定义单位时保持图纸单位。
- **图纸助手：** 可按整图、视口或当前选区提问。回答引用可点按定位/高亮的图元句柄，几何由确定性工具测量；提案用颜色区分新增/修改/删除，仅在你接受后作为一个可撤销事务应用。它不能因提问或预览写文件，有未保存手改时不会应用。
- **Office：** 编辑器与助手共用同一命令集（Word 样式/列表/对齐/表格，Excel 格式/行列/冻结/排序/筛选，幻灯片复制/排序/对齐），另有可靠的包级文本替换、公式、公式错误清单和同格式图片替换。内置引擎做不到的命令会带原因显示为不可用。
- **手记：** 精确文字匹配定位、按页导出 PDF、`.floenote` 归档，以及提案/预览/确认的助手编辑与持久的采纳/拒绝决策。PDF 原文与手写识别文字不能原地编辑。
- **画布：** 图纸节点端到端保持矢量；备份包携带媒体子工程及其素材（已测试）；未应用 CAD 草稿和历史修订素材已纳入并通过 19 项备份定向测试，完整 App 备份交互仍待验收；旧版扁平编辑在首次打开时一次性迁移。

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