结果文件和自动化：Artifact、版本恢复与计划
这一章解决两个问题：任务完成后，怎样确认结果真的成为了可以继续使用的文件；以及怎样把重复工作保存成计划，在 Echo 保持打开时按设定执行。
Artifact 和普通回答有什么区别
对话中的一段文字只是回答；Artifact 是已经写入 Workspace、可以预览、查看源码、继续修改和恢复历史版本的结果。你要求 Agent“写一份报告”时，最好同时说清文件名、格式、目录和是否允许覆盖原稿。
例如：
阅读
原始资料/访谈记录.md，生成输出/访谈摘要.md。保留原文件，不要创建目录以外的其他文件。
任务完成后，对话中应出现 Artifact 卡片，显示文件名、相对路径和版本信息。不要只根据回答里出现“已保存”就认为写入成功；打开卡片或文件树确认文件真实存在。
录屏结果和视频 Artifact
从 Composer 选择“录屏”后，Echo Capture 会把录制结果交回当前 Workspace。录制完成后，Echo 会整理屏幕视频、可选的摄像头和音频轨道，并将可预览的视频注册为 Artifact。
录屏相关文件位于当前 Workspace 的：
Inkflow/Artifacts/recordings/
这里保存的是本次录制的结果和后续处理所需的素材。录制完成后，先在对话或 Artifact 列表中检查视频是否出现，再通过文件树核对相对路径和文件时长。不要在录制仍显示进行中时移动或删除目录，也不要根据暂时没有预览就重复录制。
如果视频 Artifact 没有出现，先检查录制是否真正停止、Workspace 是否仍可用，以及 recordings 目录中是否已经有新文件。录制可能已经产生本地文件但尚未完成注册；确认当前状态后再决定恢复或重试。
视频创作的成片、项目和字幕
通过“视频创作”制作的视频，最终 MP4 保存到当前 Workspace 的 Inkflow/Artifacts/；具体文件名由任务决定。HyperFrames 的可编辑项目、素材、分镜和中间结果也保存在 Workspace，项目目录以本次交付说明为准。它们与 Echo Capture 的 recordings/ 录屏素材目录用途不同。
交付时逐项检查：
- 成片：能实际播放，时长、横竖画幅、画面、声音和字幕符合要求；回答里写着“渲染完成”不等于文件已交付。
- 项目：有可编辑源码和素材路径，后续能定位到同一项目继续修改。
- Studio：需要一起审阅时，有可打开的项目链接；本机服务停止后可从原对话重新启动。
- 字幕：分清单独的字幕文件、MP4 内可选择的字幕轨，以及已经固定显示在画面中的字幕。软字幕可能默认关闭，也可能在上传平台后丢失；发布前需要用目标播放器或平台核对。
- 素材来源：保留使用的图片、视频、音乐、字体和配音来源，以及需要的许可说明。
修改时优先保留已完成素材和未改动镜头，导出 product-intro-v2.mp4 等新文件，保留上一版。不要把文本 Artifact 的版本恢复能力等同于视频文件的自动备份；同名覆盖不保证可以恢复旧媒体内容。
来自外部视频服务的结果如果尚未下载完成，先恢复原任务，不因缺少本地成片而直接重新生成。
查看 Artifact
点击对话中的 Artifact 卡片，右侧面板会打开结果。不同格式可提供不同视图：
- 预览：查看最终排版或渲染效果。
- 源码：查看实际写入的文本、Markdown 或 HTML。
- 大纲：快速检查标题层级和结构。
- 版本/差异与恢复：查看以前的版本，并在确认后恢复。
HTML 预览可能在受限沙盒中显示，某些外部脚本、网络资源或浏览器特性不会运行。预览正常不代表所有外部资源都会在发布环境正常显示；源码才是最终可迁移的内容。
从列表重新打开
在对话顶栏或 Artifact 面板选择“查看所有 Artifacts”，列表通常按当前 Workspace 显示文件。选择前核对文件名、相对路径、更新时间和版本，不要只按标题猜测。切换 Workspace 后列表也会改变，因为 Artifact 属于创建它的 Workspace。
如果列表为空，先确认当前 Workspace，刷新文件树，再检查文件是否真的由 Echo 创建。普通手工文件不一定自动显示为 Artifact；它仍可以在文件树中打开，但可能没有 Artifact 版本历史。
版本和恢复
每次生成或修改可能产生新的 Artifact 版本。打开“差异与恢复”后先选择一个历史版本，比较新增、删除和修改的内容。恢复旧版本会覆盖当前文件，因此必须明确确认。
推荐的安全恢复流程：
- 停止可能正在写入该文件的 Run 或计划。
- 复制当前文件或创建备份。
- 打开目标历史版本并查看差异。
- 确认文件路径、版本时间和要保留的内容。
- 点击恢复并确认覆盖。
- 返回预览和源码，检查恢复结果，再刷新文件树。
恢复失败时，不要反复点击覆盖。保留当前文件和错误信息，检查文件权限、文件是否被外部程序占用、Workspace 是否仍然可用，再重新执行。普通文件没有 Artifact 历史时，Echo 不能保证自动恢复；请使用系统备份或手工副本。
小 Tip：重要文档采用“原始资料只读、输出目录可写”的结构。需要尝试不同版本时创建副本，比不断覆盖唯一文件更容易追溯。
不同格式的注意事项
Markdown 最适合版本比较和继续编辑；HTML 适合预览，但要检查相对资源路径和沙盒限制；Word、PDF 等导出格式要单独检查分页、字体、图片和中文显示。某一种格式生成成功，不代表其他格式也成功。
如果任务只返回源码，没有 Artifact 卡片，可能是 Agent 没有执行写入、写入被权限拒绝、目标目录不在 Workspace，或者只要求了“给我内容”而没有要求保存。先检查任务原文和工具活动，再决定是否重新执行。
PPT 模板和导出结果
使用 Echo Design 模板完成任务后，结果可能包含 HTML PPT 和 PDF。先打开 HTML 预览检查页序、文字、图片和版式，再确认 PDF 是否出现在结果列表或目标目录。
HTML 预览适合快速检查和继续调整；PDF 适合发送或留档。两者是不同的结果，不要只看到其中一个就认为另一种格式也已经生成。当前流程不提供直接下载 PPTX 的操作；如果需要可编辑文件，先确认任务实际生成的格式和后续处理方式。
如果任务过程中要求你选择模板，确认卡片会显示已选模板。选择“提交并继续”后再等待结果，不要在模板尚未确认时重复启动任务。模板选择方法见《用设计资源和 PPT 模板完成任务》。
创建计划
计划用于保存一个可以重复执行的任务。进入“计划”，点击“新建计划”，填写名称和目标，并明确读取范围、输出位置、频率和时区。
一个清楚的计划示例：
每天工作日 18:00，读取当前 Workspace 的
原始资料/今日记录/，生成一份摘要，保存到输出/日报/日期.md。只读取该目录，不删除或覆盖原始资料。
创建时依次确认：
- 计划名称是否能区分项目和用途。
- 目标是否说明输入、动作和输出。
- 读取范围是否限制在必要目录。
- 是否允许写入、联网或调用外部能力。
- 输出文件名是否避免每天覆盖同一个文件。
- 频率、时间和时区是否正确。
- 保存后列表是否显示下一次运行时间。
计划运行依赖 Echo 保持打开。关闭应用期间不会像云端定时任务一样自动执行；重新打开后，应查看计划状态和是否有错过的运行，不要假设它已经补跑。
计划权限和能力
计划可能读取 Workspace、写入文件、使用 Skill/MCP/Plugin 或调用模型。保存前完成预检，查看缺少的模型、能力、权限或连接。计划中使用的能力应是明确且稳定的，不要把临时测试 MCP 或来源不明的 Skill 直接放进长期计划。
如果计划需要写入文件，建议先在测试 Workspace 手动执行一次。确认输出路径、文件名、内容和权限都正确后，再启用周期运行。涉及外部发送、发布、删除或付费操作的计划应格外谨慎，最好要求每次人工确认。
手动运行和历史
在计划列表点击播放或“执行”，会进入关联计划对话并显示本次 Run。状态可能是等待、生成中、等待批准、已完成或失败。计划列表中的“最近状态”只是摘要；需要知道具体错误和输出时，打开关联对话和运行历史。
执行后检查：
- 是否使用了正确 Workspace；
- 是否读到了预期目录；
- 是否创建了新文件而不是覆盖旧文件；
- 是否调用了预期模型和能力；
- 是否有部分结果或等待人工批准；
- 是否产生了第三方费用。
计划失败时先暂停或禁用，避免连续失败和重复写入。修改目标、权限、模型或连接后，再手动执行一次验证。不要在错误原因未明确时反复点击播放。
暂停、恢复和删除
暂停计划只影响之后的自动触发，不应删除历史结果。恢复前检查模型、Workspace、能力和权限是否仍然可用。删除计划前确认不再需要它，并保留重要的历史 Artifact；删除计划不会自动删除已经生成的文件，但关联对话和入口可能不再显示。
常见问题
Artifact 卡片没有出现：检查任务是否明确要求保存、是否有写入权限、目标路径是否在当前 Workspace。
预览空白但源码有内容：可能是 HTML 资源、脚本或样式不适合沙盒；先看源码和实际文件，不要直接判断文件损坏。
恢复后内容又被改回去：检查是否仍有 Run 或计划正在写入；先停止它们，再恢复并刷新。
计划没有运行：确认 Echo 当时是否打开、计划是否启用、时区是否正确、模型和 Workspace 是否可用。
计划重复生成或覆盖：暂停计划，检查输出文件名是否固定、上一次运行是否其实已经成功，再决定如何恢复。
数据和费用提醒
Artifact 写入 Workspace 会改变本地文件；恢复会覆盖当前内容；计划会在未来自动触发模型和工具调用。长上下文、图片、视频、网页解析和外部 MCP 可能产生费用。计划不是云端备份，也不是无限可靠的自动化服务。