产物管理

产物是 Poco Agent 执行后留下的可交付结果，包括代码变更、Markdown 文档、HTML 页面、图片、表格、压缩包和其他工作区文件。

产物和最终回复不同。最终回复是对话消息，产物是写入工作区并可预览、下载、分享或发布的文件。需要交付给团队的内容，建议明确要求 Poco Agent 生成文件，而不是只在消息里输出正文。

产物面板

任务执行中或完成后，打开会话右侧的产物面板，可以查看：

• 文件变化：新增、修改、删除了哪些文件。
• 文件预览：直接查看 Markdown、HTML、图片、PDF 等内容。
• 工作区文件：浏览任务工作区中的结果文件。
• 下载入口：下载单个文件或导出整个工作区。

如果任务完成后没有看到产物，通常说明 Agent 没有写入文件，或者任务只需要文本回复。

如果 Poco Agent 提示有产物但面板里没有相关文件，通常是没有把文件写入工作区。可以直接追问：

请将刚才的结果保存为工作区文件，文件名为 `result.md`，便于我查看和下载。

如果你需要 HTML 页面、Markdown 报告或表格，最好在第一次任务里就写清楚文件名：

请生成两个文件：
1. `report.html`：用于发布和预览。
2. `summary.md`：用于团队内部阅读。

查看文件差异

对于已采集到文本差异的文件，可以展开“查看差异”，通过旧、新行号以及新增、删除标记核对具体修改；文件预览展示的是运行结束后的最终内容，两者用途不同。

历史会话直接读取任务执行期间保存的差异，不会在打开页面时重新计算。没有文本差异的文件仍会保留变更状态和行数统计；差异内容超过采集限制时，页面会提示当前内容已截断。

HTML 和页面预览

当 Agent 生成 HTML 页面或前端产物时，优先使用预览入口检查效果。重点看：

1. 首屏是否完整。
2. 文本是否溢出或重叠。
3. 图片、图表、交互是否正常。
4. 移动端是否还能阅读。

示例追问：

请检查刚才生成的 HTML 页面，优化移动端布局，并确保按钮文字不会换行溢出。

文件下载与工作区导出

对于需要交付给他人的结果，建议先预览，再下载。多个文件需要一起交付时，使用工作区导出。

工作区导出在任务结束后异步进行。任务状态变成“已完成”后，文件清单可能还会短暂显示处理中，这是正常情况。等导出状态变为 ready 后，再下载压缩包、分享文件或等待自动发布。

适合导出的场景：

• 生成了完整项目或多文件页面。
• 需要把分析报告、图片和数据表一起交给团队。
• 需要把 Agent 的修改结果拿到本地继续处理。

导出时系统会忽略一些运行时文件和缓存，例如 .git、依赖目录、隐藏配置、临时缓存、输入附件目录、插件目录等。这样可以避免把无关内容、敏感运行数据或体积很大的依赖包一起导出。

上传附件通常位于 inputs/，它是输入材料，不是最终产物。需要交付时，请让 Poco Agent 基于附件另存一份结果文件。

智能产物推荐

如果系统判断某个 HTML 或 Markdown 产物具有复用价值，会在产物面板中展示推荐卡片。你可以：

• 预览产物。
• 发布到案例库。
• 忽略推荐。

适合发布到案例库的内容：

• 完整的业务分析报告。
• 可复用的展示页或原型。
• 面向团队的操作手册。
• 有参考价值的方案总结。

不建议发布：

• 草稿、半成品、占位模板。
• 包含敏感信息的内容。
• 纯技术调试文件。
• 只有个人上下文才看得懂的结果。

推荐卡片通常在工作区导出完成后出现，不一定和任务完成同时出现。如果没有推荐，不代表没有产物，只是系统没有判断出适合公开沉淀的 HTML 或 Markdown 文件。

分享与复用

产物支持三种常用交付方式：

文件和工作区分享链接默认无需登录即可访问，可以设置有效期。HTML 或 Markdown 文件还可以开启 允许继续探索，让登录用户基于当前产物创建隔离对话。

具体操作、访问权限和继续探索规则，请阅读 分享与继续探索。需要固定地址、历史版本或自动更新时，请阅读 发布页。

使用技巧

• 重要产物先预览再分享，不要只看文件名。
• 文档类产物要检查标题、结论、行动项是否完整。
• 页面类产物要检查移动端和桌面端两个视图。
• 发布前确认没有客户信息、账号、密钥、内部链接等敏感内容。
• 如果产物不完整，直接在同一会话要求 Agent 基于当前文件继续完善。
• 需要团队复用时，优先生成结构清晰的 Markdown 或 HTML，不要只生成聊天结论。
• 自动发布任务要固定入口文件名，避免每次运行生成不同路径。
• 下载前等工作区导出 ready，避免拿到不完整的文件清单。