共享文件与最终产物

先说结论

“文件产物”页面集中展示 Agent 在协作过程中写入的共享文件，并区分仍在加工的工作文件与已被任务结果引用的最终产物。它是跨 Agent、Workflow 和后续对话复用结果的中转站，不是整个项目目录的通用文件浏览器。

怎么理解

页面从共享文件 dashboard 一次读取三组事实：文件列表、最终产物引用和 retention 状态。

文件列表可按全部、最终产物、工作文件筛选，也可按更新时间或路径排序，并搜索文件名、更新者和已加载内容。

怎么使用

1. 从桌面活动栏进入“文件产物”，查看全部文件、最终产物、工作文件和可清理文件计数。
2. 使用搜索、分类和排序定位目标文件。
3. 对文本文件选择“打开”，页面会读取最新详情并展示路径、来源、更新时间、格式和正文；JSON、类 JSON 以及 Markdown fenced code 会进行可读格式化。
4. 对视频等二进制媒体选择“打开”，系统通过原生文件入口打开，不把二进制内容当作文本读取。
5. 需要带出产品时选择“导出”；页面读取最新内容后，通过本机保存入口写出副本。
6. 选择“用此文件继续对话”时，系统把该路径带入 Composer：存在来源 Thread 时形成继承式 draft，没有来源 Thread 时创建普通新 draft。
7. 只删除确认不再需要、且未被 retention 保护的工作文件；删除确认框明确提示该操作不可恢复。

常见问题

• 首次加载失败：页面显示阻断错误并提供重试，不构造空的成功响应。
• 后台同步失败但已有缓存：保留上次成功列表并显示同步警告，避免把瞬时断线误报成文件消失。
• 打开或导出失败：保留原列表与选择状态，重试具体动作；不要用列表中的摘要代替最新文件详情。
• 最终产物无法删除：这是引用保护，不是按钮故障。先确认上游 Run/DAG/Node 结果与 retention policy，而不是绕过 UI 删除。
• 继续对话后文件不可用：检查共享文件详情仍能读取；空响应或缺少 path 会在 schema 边界直接失败。

适用范围

• 文件页面只管理产品共享文件面，不等价于源码仓库树，也不承诺编辑任意项目文件。
• “最终产物”来自显式结果引用；文件名或扩展名不会自动赋予最终产物身份。
• 页面不会按固定间隔轮询；共享文件 revision、重新进入页面或手动重试会触发刷新。
• 导出创建本机副本，不改变共享文件的规范真源或 retention 状态。
• 受保护文件不能从当前页面直接删除；普通删除成功后也不可从页面恢复。

延伸阅读

了解文件如何成为持久任务结果，阅读 Workflow、DAG 与调度；需要用结果启动后续工作时阅读 Threads 与 Turns。