完成一次 AI 工作：对话、附件、能力与任务状态
这一章解决最常见的问题：我有一些资料，想让 Echo 帮我做一件事，应该怎么开始，怎样知道它真的做完了，失败后怎样避免重复或丢失结果。
先把任务说清楚
好的任务至少包含四件事：要完成什么、使用哪些资料、结果要长什么样、结果保存在哪里。例如：
阅读当前 Workspace 的
原始资料/访谈记录.md，提炼 5 条用户需求，保存为输出/需求摘要.md。不要修改原文件。如果资料中没有依据，请明确标注“未找到”。
如果你只说“帮我整理一下”，Echo 可能需要追问范围、格式或目标位置。面对多个可能的 Skill 或连接器时，它也可能给出能力建议。补充一句“只使用当前 Workspace”“只读不写”“需要保存为 Markdown”等信息，通常比反复修改结果更省时间。
新建或选择对话
在对话区点击 + 创建新对话，点击已有标签切换。建议按项目和目标命名，例如“客户访谈整理”“每周内容摘要”，不要长期使用“新对话”。同一对话可以继续追问，后续任务 会保留此前的上下文；但每一轮仍然有自己的输入、附件、能力选择和终态。
删除对话前确认没有尚未保存的结果。删除对话不会自动删除已经写入 Workspace 的文件，但文件在历史消息中的引用可能不再显示。计划运行会有自己的关联对话，不要把计划对话当作普通临时对话删除。
小 Tip：一个对话适合围绕一个稳定目标持续推进；换了项目、Workspace 或完全不同的任务，建议新建对话，减少上下文混淆。
添加文件、图片和文件夹
点击输入框左下角的 +，选择“添加文件或图片”，也可以把文件拖入输入区或粘贴图片。选择整个文件夹时，Echo 会把它作为一组内容处理。发送前，附件标签会显示文件名、来源和解析状态。
- 处理中：正在准备内容，等待完成后再发送依赖正文的任务。
- 已解析：当前任务可以尝试读取该文件的内容，但仍应检查结果是否准确。
- 格式未知：可以作为文件引用，但不能保证模型读取正文。
- 解析失败：本次任务不应假设模型读到了正文；先换格式、使用 OCR 或直接说明限制。
- 不可用：原文件可能被移动、删除、改名或超出当前 Workspace 范围。
单个内联附件和本次内联附件总量受客户端限制，超过时以输入区提示为准。运行附件校验上限为 512 MB，但这不是所有入口的通用上传上限。图片、PDF、音频和视频还会受到解析器和 Provider 能力限制。取消输入区附件只会取消本次发送，不会删除电脑上的原文件。
通过附件入口添加 Workspace 外的本地文件时，Echo 会把它复制到当前 Workspace 的附件目录；已经位于当前 Workspace 内的文件按引用使用。移除输入区的附件不会删除原文件，也不要把移除附件当作清理已导入副本。
添加较大的本地视频
v1.4.0 修复了手动选择或拖入较大 MOV 等本地视频时，附件消失或只发送文字的问题。直接选择或拖入视频文件即可。粘贴图片与选择本地视频的大小限制不同，遇到限制时按输入区提示处理。
- 选择当前 Workspace，使用“添加文件或图片”或把视频文件直接拖入输入区。
- 等待导入结束。导入中或有不可用附件时，发送按钮及 Enter 发送会被阻止，草稿会保留。
- 如果导入失败，阅读附件错误提示，移除失败项后重新添加。批量添加过程中移除文件导致整批取消时，按“批量添加已取消，请重新添加”的提示重新选择。
- 确认附件仍在输入区并可用，再发送任务。视频可能不能提取普通文本，但原文件仍可交给适用的媒体工具；这不等于对话模型已经理解全部画面和声音。
直接粘贴的内容仍受单文件 25 MiB、总计 50 MiB 的大小限制；一次添加整个文件夹也有独立限制。更大的磁盘文件能导入，不代表所有模型都接受同样大小，后续运行校验和服务商限制仍然有效。
截图与截图取字
点击相机图标，选择“截图”或“截图取字”。“截图”会把选区作为图片附件；“截图取字”会把 OCR 文本放进输入框，之后你可以修改文字再发送。
第一次使用时，macOS 可能要求“屏幕录制”权限；截图取字还可能需要“辅助功能”。请到“系统设置 → 隐私与安全性”中允许 Echo，修改后完全退出并重新打开应用。没有选区时，先确认 Echo 窗口在前台、权限已启用且没有被全屏应用阻挡。
截图前检查密码、API Key、二维码、私人聊天、客户个人信息和未公开内容。OCR 后重点核对金额、日期、数字、英文专有名词和表格顺序；截图取字不是人工校对的替代品。
录制屏幕或窗口
如果你要记录一段操作、制作演示素材或把屏幕过程交给后续任务处理，可以从输入框的捕捉入口选择“录屏”。Echo 会打开 Echo Capture 工具条，录制结果保存到当前 Workspace，而不是另建一个独立应用。
基本流程：
- 在输入框点击相机/捕捉入口，选择“录屏”。
- 在 Echo Capture 中选择要录制的屏幕或窗口。
- 按需要打开系统声音、麦克风和摄像头；首次使用时按系统提示授予对应权限。
- 如需调整录制画面，打开录制设置，选择光标样式和分辨率；摄像头开启后可以调整浮层形状和大小。
- 点击录制。录制中可以暂停、恢复、重新开始或取消；完成后点击停止。
- 等待录制结果完成并回到 Echo，检查视频 Artifact 和 Workspace 中的文件。
打开“录屏”后，底部会出现 Echo Capture 工具条。工具条上可以直接看到录制来源、麦克风、摄像头、光标/交互效果、设置和录制控制；开始录制前先确认这些开关的状态。
选择来源时，先在“屏幕”或“窗口”中选择一个录制目标，再点击“分享”。“屏幕”会录下整个屏幕；“窗口”只录指定窗口，适合避免把 Echo 或其他窗口录进去。
在录制设置中可以选择鼠标样式和分辨率。分辨率越高，视频越清晰，也越占用存储空间；如果只是记录操作，优先使用能看清内容的较低分辨率。
打开摄像头后，画面会出现摄像头浮层。你可以切换浮层形状并选择 S、M、L 尺寸；不需要露脸时请关闭摄像头。
录制进行中，工具条会显示计时，并提供暂停、继续、重新开始、取消和停止控制。点击“停止”后不要立即退出 Echo，等待文件整理完成。
录制整个屏幕会包含 Echo 窗口；如果不希望把 Echo 录进去，选择具体窗口。录制时 Echo 主窗口仍可使用，但不要在目标窗口中输入密码、API Key 或其他不应出现在视频里的内容。
录屏不是截图的替代品：截图适合保存一帧画面，截图取字适合把选区文字放入输入框，录屏适合保留连续操作和声音。录制完成后先确认视频已经保存，再把它交给后续任务或移动到其他位置。
使用 / 和 +
输入框中输入 / 会打开快速指令列表，适合已经知道能力名称时快速选择；点击 + 会打开可见菜单，适合浏览附件、Plugins、Skills、MCP 和管理能力。两种入口都只影响当前任务。
选择后，输入区会出现能力标签或命令标记。发送前检查名称是否正确，是否有红色错误提示。任务启动后，本轮选择通常会清除；下一轮需要重新选择。找不到项目时，先确认 Workspace、能力是否已安装和启用、MCP 是否连接，再重新打开菜单。
能力推荐和确认
当你的任务可能需要外部工具、特定方法或知识应用时，Echo 可能显示推荐。推荐只说明“可能适合”，并不表示已经安装、已经启用或已经调用。选择前看清能力会读取什么、写入什么、是否联网；有多个选项时，选择最小且最明确的一个。
Plugin Command 是明确命令。用户没有选择时，Agent 不应擅自执行；命令依赖的 Skill 或 MCP 不可用时，应显示缺项并让用户处理，而不是静默替换成另一个命令。
需要确认后继续
当任务需要先确定受众、篇幅、模板或优先顺序时，Echo 会在对话中显示确认卡片，顶部可能显示“等待你的选择”。卡片标题随问题变化，例如“先做哪个”或“需要确认后继续”。
阅读问题和选项说明，选择符合目标的一项。如果还有限制或偏好，在“其他补充（可选）”里说明，再选择“提交并继续”。“推荐”表示建议，并不等于你已经选中；没有选中答案时，提交按钮可能不可用。暂时不作选择时，可以使用“跳过”。
提交后，卡片会保留答案和补充说明，方便回看。检查 Echo 随后的回复是否正确理解了要求。例如，选项里是“精简 6–8 页”，但补充说明要求“2 页”，需要检查后续回复是否确认按 2 页制作。
卡片中的“任务已完成”不能单独证明 PPT 或文件已经产出。仍要继续查看后续回答和结果文件。任务结束后，回到对话说明新的要求，不要重复操作旧卡片。
发送任务和查看进度
确认 Workspace、模型、附件和能力后点击“发送”。任务运行时，中央区域可能显示工具活动。常见状态如下：
- 排队：请求已接受，正在等待执行资源；不要连续点击发送。
- 生成中：模型或工具正在工作；可以等待或点击停止。
- 等待批准：任务需要你确认具体文件、命令、域名或 MCP 工具；先阅读目标和风险。
- 已完成：回答和工具活动均有终态；仍需检查文件路径和内容。
- 失败：本次执行未完成，可能已经产生部分输出；先检查 Workspace 和 Artifact。
- 已取消：用户或系统停止了任务；不要假设没有任何写入。
- 已恢复：Echo 从可恢复位置继续，检查恢复后的最终结果。
成功不能只看对话里出现了一段文字。如果任务要求写文件，打开 Workspace 检查文件是否存在、路径是否正确、版本是否更新；如果任务要求修改内容，比较修改范围并确认原文件是否被覆盖。
对话中的“执行过程”会汇总一组操作。摘要显示“已完成 16 项操作 · 2 项失败”时，表示这一组包含失败操作，并不等于整项任务已经失败，也不代表最终文件已经完成。
模型思考或工具执行期间，可能有一小段时间没有新的正文。此时如果时间线末尾仍显示动态三点，表示当前任务 还在继续，不要因为暂时没有文字就重复发送同一任务。若出现权限卡或确认卡，以卡片为准；三点会在任务完成、失败、取消或中断时消失。
点击摘要右侧箭头，再展开“查看其他 … 项操作”，可以查看读取文件、执行命令等记录。绿色勾表示对应操作完成，红色感叹号提示该操作失败；继续展开具体记录了解原因。先看 Echo 是否已经采取后续处理，再决定是否重试，避免重复执行写入操作。
复制较长的消息
较长的用户消息会提供“展开全文”和“收起全文”。需要把原始要求带到其他地方时，可以选择“复制 TXT”；按钮显示“已复制 TXT”后，再粘贴到目标位置检查文字是否完整。复制失败时，先展开全文再重试，不要重复发送任务。
刷新或切换对话后检查历史
如果你在任务运行期间切换了对话、刷新窗口或稍后重新打开 Echo，先等待历史记录加载完成，再判断结果是否完整。历史消息可能需要短暂恢复；不要在旧内容还没显示完时重复发送。
检查三件事：用户消息是否只出现一次、助手最终回答是否完整、执行过程和文件结果是否与最后状态一致。如果看到“历史记录加载失败”，选择“重试”；如果回答或文件已经存在，先核对 Workspace 和 Artifact，再决定是否继续任务。任务状态仍为“生成中”时，回到对应对话等待它进入终态。
停止、取消和重试
生成时间较长时点击停止。停止后等待状态变成“已取消”或其他终态，再检查是否有文件、Artifact 或外部任务已经产生。不要在状态仍为“生成中”时重复发送同一个写入或发布请求。
网络错误或模型超时通常可以重试，但外部同步、转存、发布、付费和创建异步媒体任务可能已经部分成功。重试前先看任务历史、目标目录和第三方平台记录。若不确定，先保留当前结果并向用户说明可能的重复风险。
工具活动和权限
工具活动应让你看懂“正在访问什么、为什么访问、结果是什么”。读取文件、写入文件、执行命令、访问网络或调用 MCP 时，可能出现权限审批。只批准具体且必要的目标；永久允许也只针对明确命令、路径或域名。
拒绝权限后，任务可能失败或降级为纯对话。不要因为任务着急就允许整个终端、所有文件或未知域名。允许一个命令不代表允许同类所有命令。
常见问题
发送按钮不可用：回到第 1 章的初始化检查，确认账号、Workspace、模型和本地配置；再看附件是否仍在处理中。
回答没有用到附件：检查附件状态和任务消息中是否真的带有附件；格式未知或解析失败时改用可读格式或 OCR。
能力菜单为空：确认当前 Workspace、能力是否安装并启用，MCP 是否连接；切换 Workspace 后能力列表可能不同。
任务看起来完成但文件不存在：检查任务是否真的要求写文件、目标路径是否在当前 Workspace、是否只生成了文本建议；不要根据一句“已保存”就跳过磁盘核对。
任务失败后出现半个文件：保留文件，记录路径和修改时间，先复制备份，再决定恢复、继续或删除。
长对话、后台运行和窗口恢复
v1.4.0 改善了长回复持续输出时的滚动、执行过程展开，以及切换到其他应用再回到 Echo 时的响应；大 Workspace 中调整面板宽度也更顺畅。切回前台后，历史和新内容可能需要短暂恢复，不要因画面一时未更新就重复发送同一任务。
发生界面自动恢复后，先核对原对话的运行状态、最终回答、工具活动和已经生成的文件。界面恢复不代表中断的任务已经重新执行，也不能据此判断远端生成已停止。若出现“历史记录加载失败”，使用“重试”；若任务已中断，先检查部分结果，再决定继续。外部视频任务优先按模型与多模态能力中的步骤恢复原任务。