交付物 Artifacts｜生成、交接与复用成果
从约定输出到核对、交接、修订和复用，完成成果全流程。
任务成果最终要能打开、核对和继续使用。Orrery 会在聊天里显示文件交接，也会在右侧工作区列出支持格式的成果；两处展示范围并不完全相同。
工作开始时就约定成果，收尾时才能判断是否交付。把“帮我想想”改成明确的文件要求，会更容易检查结果。
给出输出约定
例如：
- 最终产出一份 Markdown 分享提纲，保存在当前项目的讲稿目录。包括三个观点、讨论问题和来源；先写新草稿，不覆盖现有正式稿。完成后给出实际文件入口。
这个要求包含用途、格式、位置、内容和覆盖边界。需要图片、HTML、表格或其他文件时，逐项说明；不要把一段聊天答复当成已经落盘的文件。
先确认文件真的保存了
Agent 宣布完成后，要求说明实际创建或修改了什么、保存到哪里、哪些部分仍待核实。打开文件确认，然后再决定是否继续修改或作为正式成果使用。
收到文件卡只说明有一项文件交接；路径、内容质量和引用仍需要检查。生成过程中停止或失败时，可能已经留下部分文件，先核对再重跑。
文件是否成功保存、是否交接给你、是否进入列表，是三个不同结果。代码或办公格式可能不进入侧栏自动登记，生图工具也不保证触发同一登记钩子。
当前会话的“本次产出”依据成功的文件写入、编辑或显式交接记录整理。同一路径的文件可以被合并显示，修改一份已有稿件不一定产生第二个独立文件。
- 聊天文字、图表与文件分别看
- 一段正文或对话中的交互图表可以直接阅读，但不因此自动成为磁盘中的文件。需要保存、分享或交付时，明确要求生成对应文件，并核对实际路径。
从哪里打开
- 聊天里的本次产出或文件卡：查本轮交给你的文件，包括可能不进入侧栏的格式。
- 右侧工作区的交付物：集中查看 Markdown、HTML 和图片等支持格式。
- 项目空间文件树：按关联目录查真实文件，不限于本轮新增成果。
- 文件管理器：使用可用的“在文件夹中显示”入口，核对磁盘路径。
当前自动登记覆盖 Markdown、文本、PDF、常见图片、HTML、音频、视频、JSON、CSV 与 XLSX 等格式；能否在侧栏直接预览还取决于格式。
代码文件（如 .py、.ts）、DOCX 和 PPTX 不在当前自动登记白名单内，实际文件可以已经生成，但不因此出现在同一交付物列表。显式交接文件和侧栏自动登记也要分别核对。
工作区的交付物入口。此图为空状态，不能用它证明已有文件产出。
预览并检查内容
- 点击支持格式的文件，进入右侧预览。
- 看标题和相对路径，确认是本次所需文件。
- 阅读正文、图片或页面，不只看缩略图。
- 文件已被其他地方修改时，使用刷新重新读取。
- 需要回到辅助信息时，点击“返回工作区列表”。
检查结果是否覆盖任务要求、是否引用真实材料、关键数字与链接是否正确。完成图标和验证标识不代替你对最终用途的检查。
继续修改同一份成果
在当前对话引用文件，指出具体段落与要求。需要保留旧版时，要求先复制成新文件；只改一段时，明确保留其他内容。
外部编辑器也可能修改文件。请 Agent 在写入前重新读取最新内容，避免按旧记忆覆盖。预览中显示文件已删除时，先核对磁盘和移动位置，再决定恢复或重新交接。
复用和导出
Markdown 可以复制文字、继续在笔记工具中编辑或放回项目；HTML 可以在预览或浏览器查看；图片与其他文件按实际路径交付。当前文件预览提供复制内容，但不要假设所有格式都有同一套“导出PDF/Word/PPT”按钮。
需要某种新格式时，明确要求 Agent 转换并保存为新文件。是否能成功取决于工具、依赖和所选方法。最后打开转换后的文件检查，不能仅凭扩展名判断转换已完成。
显式发送已有文件只是在聊天里交接它，不是自动上传、发布到网站或发送给其他人。对外分享前另行说明目的、接收方和范围。
收尾
接回项目
重要成果可以在项目 moc.md 中建立入口；关键决定与完成状态按项目记录留下简短日志。需要复用流程时，先完成一次检查，再考虑 Skill 或调度。
将确认的成果接入项目导航，并记下仍待核实的问题。之后需要重复生成同类内容，再到 Automation复用方法或安排时间。
图片与移动后的文件
自动登记还取决于成功的工具路径。当前登记钩子覆盖 write_file、edit_file 与 send_file_to_user；generate_image 直接返回图片不保证登记到侧栏，图片在聊天可见也不代表已保存到目标目录。需要正式交付时，明确保存位置并核对实际文件。
同一运行期间的文件移动或重命名可通过文件事件更新读取位置。移动映射主要保存在内存，重启后不能承诺旧交付物记录仍能自动跟到新路径。找不到时先在磁盘核对新位置，再重新交接，不急于再生成一份。
文档核对说明
- 查看编写与验证范围
- 对应操作截图待补
- 当前配图是交付物入口的空状态，尚未展示文件生成后的卡片、已有成果列表和正文预览。这两篇合并前的操作验证缺口都保留，未将合并计作验收。
内容来自 Orrery Desktop 的 Wiki，文档仍在持续完善。功能开放情况以当前版本为准。