文件、图片与任务结果

把文件作为输入

在发起任务的消息中附上文件或图片，并在正文里说明用途。文件内容只作为任务的材料，不会自动扩大任务范围。例如：

比较附件中的两个 CSV，只按员工编号对齐，输出新增、删除和字段变化三张表。

如果文件来自较早的消息，请说明能帮助找到它的信息，例如文件名、发送人或大致时间。ZAI 可以读取这里能看到的历史和附件，但“没有搜索到”不一定证明内容从未出现，见能读到哪些历史。

文件只在它所在的那个聊天里可用。其他聊天里的文件，包括 ZAI 在那里生成的文件，在这里一般不可用；需要时请在这里重新附加。ZAI 发到你私信里的文件（包括同事请 ZAI 转给你的）在这段私信里可以继续使用。

单个文件有大小上限。附件超过上限时，ZAI 读不到内容，通常只能看到文件名；请压缩、拆分，或把关键内容直接发给它。上限见常用限制。

• 在消息列里上传的文件，ZAI 能直接读取；超过上限的文件，ZAI 只能看到名称和大小，并知道它超出了上限。超过上限的图片，ZAI 改为读取 Slack 生成的缩略图，分辨率较低；需要看清细节时，请裁剪或压缩后重新发送。
• 转发到这里的消息带的文件，ZAI 也能读取；Slack 没有把文件分享到当前聊天时，ZAI 只能看到文件名。
• 其他应用消息里显示的 Slack 图片，ZAI 读取消息历史时作为附件取得；Slack 没有把图片分享到当前聊天时，ZAI 只能看到图片的标题和说明。
• 文件设置了与文件名不同的标题、或图片写了描述（替代文本）时，ZAI 也能看到标题和描述。
• 外部文件（例如 Google Drive、Dropbox 里的文件）与 Slack 的列表，ZAI 能看到名称和打开它的链接，但不读取其中的内容；需要时请把关键内容直接发给它。已删除的文件只显示名称。
• 消息里分享的 Slack 画布，应用获准读取画布时（见应用配置与权限），ZAI 在需要时读取画布正文；读到的是读取那一刻的内容，之后画布的修改它看不到，需要时请重新分享。没有获准时，ZAI 只能看到画布的名称和链接。
• 转发进 Slack 的邮件，ZAI 能看到主题、发件人、收件人和正文的开头部分；邮件自带的附件只能看到文件名、大小和类型。
• 语音和视频片段怎样交给 ZAI，见ZAI 能读到的历史。
• 其他应用 @zai 的消息里带的文件，ZAI 收到时不下载，处理中需要时再读取，同样受大小上限约束。
• 读不到或还没读取的代码片段和帖子，ZAI 能看到 Slack 显示的开头几行。

获取生成的文件

需要表格、图片或文档时，直接说明文件格式和检查标准。完成后应在原消息列里看到真实的附件，而不是只有一个你打不开的文件路径，或一句“已生成”。

推荐写法：

生成 release-checklist.md，检查标题、链接和列表格式后，把文件发回给我。

ZAI 发回的单个文件也受同样的大小上限约束；超过时它会说明上限，并在不影响用途时拆分或压缩。在这个上限之内、但超过 Slack 自己能作为附件收下的大小时，文件照常生成，只是发不成附件，见下一段与常用限制。

如果 Slack 收不下某个文件，例如文件超过了这个聊天能接收的大小，或者工作区、组织的设置不允许发送它，ZAI 会在文件原来的位置发一条说明，写明文件名、大小和原因，回复里其他的文字和文件照常发出。开启了下载链接时，文件太大或这个聊天不接受这类文件的说明里带着这个文件的下载链接；其他说明里没有文件本身，需要时按说明的原因处理后再让 ZAI 发送，见失败时怎么做。

网页看板、图表页面和较长的报告这类更适合在浏览器里阅读的结果，可以让 ZAI 发布成 Artifact：回复里是一个链接，组织成员登录后直接在浏览器里查看和下载。怎样请求、谁能打开、怎样更新和移除，见用 Artifact 交付网页和文档。需要编辑、继续加工，或要转给组织外的人的文件，仍然用附件。

生成的文件以 Slack 文件发到对应的消息列。

下载链接

这项功能需要 Z Tag 管理员开启。这套 Z Tag 服务没有开启时，ZAI 不给出下载链接，被要求时说明尚未开启并改用附件；Slack 收不下的文件只有上面那条说明。

下载链接是一个文件的下载入口：组织成员点开、登录后下载原文件，没有预览、标题和版本。要在浏览器里阅读的结果仍然用 Artifact。下载链接在两种情况下出现：

• 你请 ZAI 给出某个文件的链接，例如要在别的设备或浏览器里下载，或要转给不在这个聊天里的同事。链接写在 ZAI 新发的消息里。
• 回复里的某个文件 Slack 收不下，例如文件超过了这个聊天能接收的大小，或这个聊天不接受这类文件：原处是「这个文件超过了这个聊天能接收的附件大小，已改为下载链接：」加上文件名、大小和「组织成员可见」，下面有 下载 按钮。

拿到链接的组织成员登录后都能下载，不限这个聊天里的人；在私信里发出的链接也一样，那里的说明多一句「拿到链接的组织成员都能打开，不要转给不该看的人。」所以标明保密、仅限本频道或涉及个人隐私的文件，ZAI 不主动给链接，这类文件大到 Slack 收不下时会先问你怎样交付。谁能打开、什么时候失效，见下载链接的访问。

以下情况只有说明、没有链接：

• 文件被 Slack 的设置或审查拒收，或被平台在上传后移除。换个名字重新发送也拿不到链接；ZAI 不会为了绕开拒收改格式或压缩，会照实说明。
• 这个聊天的设置不允许下载或转发文件，或者文件来自这样的聊天。
• 文件是 ZAI 在没有人在场时交付的，例如免确认介入发出的结果；需要时在聊天里再请 ZAI 给出链接。

默认可用的文件处理能力

ZAI 的沙箱默认可直接处理 CSV 和 Excel 数据，生成中文统计图、PDF、Word 文档和 PowerPoint 演示文稿，也能提取带文本层的 PDF 内容、合并页面和生成页面预览。还预装了 Office 转 PDF、中英文 OCR、Markdown 文档转换、关系图生成、音视频转换、PDF 压缩、7z 压缩包处理和无头浏览器，可读取获准访问的网页、截图或输出网页 PDF。通常无需先安装依赖。

内置技能会按文件和任务选择读取、编辑、校验与交付流程，也可制作独立 HTML 报告、海报、水彩图形和 GIF。新建的演示文稿默认用主题和版式搭建，之后在 PowerPoint 里改配色或版式会作用到整份文稿。让 ZAI 测试网页应用时，它会在沙箱里启动项目、用浏览器操作页面并截图，再把发现的问题和截图发回。可以要求同时交付可编辑文件和预览图。HTML 文件默认作为附件发回；想让同事打开链接就能看到页面时，请让 ZAI 把它发布成 Artifact，见用 Artifact 交付网页和文档。

ZAI 的沙箱预装常用中文原版字体、Office 字体、设计与编程字体，以及覆盖多种文字的 Noto 字体。ZAI 按回复语言选字体，繁体中文、日文和韩文的汉字用各自的字形；文件要用别的语言时，请在任务里说明。也可以指定宋体、微软雅黑、Arial、Calibri 等字体，并要求 ZAI 先核实字体可用、字形正确再生成文档。可编辑文档在对方电脑上仍可能因缺少字体而改变版式；需要固定外观时，可以同时要求 PDF 预览。

生成文件后仍需检查内容和格式。Excel 公式写入不代表已经计算结果，可以要求 ZAI 重算并核对关键单元格。Office 转换结果可能与 Microsoft Office 的排版有所差异，OCR 准确率也受原图影响；请说明需要核对的页面、字段或公式。

浏览器只能打开这个聊天允许访问的网站。打不开时，在频道或群聊里请联系组织 Owner；在私信里可以在控制台 我的资源 里检查自己的 沙箱配置，见在控制台管理自己的资源。

ZAI 在某些聊天里可能改在一台远程设备上执行命令（见命令在哪里执行），这时能用的工具取决于那台电脑装了什么，上面这些预装能力不保证都有，依赖它们的技能也不提供；这样的聊天里也不能发布 Artifact。

回复的形式

ZAI 的回复默认像同事间的交流：先给结论，篇幅随问题而定，不列工具调用的过程。即使你要求简短，回复也会保留影响判断的限制和不确定性；完整报告、文档和代码按任务要求交付，不会因为聊天回复简短而省略。在同一个消息列里追问时，回复重点说明这次的结果和变化，通常不重贴已经交付的内容；需要完整重发时，直接说明。

超过约一屏的内容，例如调研、完整的审阅和长清单，ZAI 整理成文档交付：作为附件发回，适合在浏览器里阅读的也可以发布成 Artifact。聊天里只写结论、需要你处理的事和打开文档的入口，不拆成几条长消息，也不在文档旁边再贴一遍全文。

需要特定的结构、篇幅或文体，或者要保留核查步骤、来源和未核实的部分时，直接写进请求，例如：

先用两句话给结论，再用表格列出方案差异，保留来源和未核实项。

说明你如何确认迁移结束，列出核验步骤，并保留尚未处理的记录和数据覆盖范围。

聊天里的格式会按 Slack 的阅读方式简化，代码、路径、数值、链接和提及会保留；需要完整排版时，可以要求同时发回文件。紧跟中文的网址只链接网址本身，不会把后面的标点和文字算进链接；无法打开的链接（如相对路径）显示为文字。回复里的图片作为附件单独发出，排在前后文字之间；网上的图片以链接给出，无法打开的图片地址（如相对路径）可能按原文显示。

需要用图展示走势、构成或对比时，可以直接要求，例如：

用柱状图对比各区域这个季度的收入，并用一句话说明结论。

ZAI 可以在回复里画柱状图、折线图、面积图和饼图。需要能下载、转发或放进文档的图片时，请说明要图片文件，ZAI 会生成图片作为附件发回。ZAI 修改一条带图表的消息时，只更新图表的数据和周围的文字，图表的数量和种类不变；需要新的图表时，它会另发一条消息。

• 回复以 Slack 的富文本发送，表格使用 Slack 表格。很长的表格会拆成几条消息并重复表头，过宽的表格改为逐条列出。
• 图表画成 Slack 的原生图表，鼠标移到图上可以查看数值。环形图显示为实心饼图，横向柱状图显示为纵向柱状图。堆叠柱状图，以及一条消息里超出可画数量的图表，显示为标题加表格或逐行数据；Slack 不接受这条消息时，其中的图表都改为这样显示。消息通知里，每张图表显示为标题和各项数值。
• ZAI 的回复不会触发 @channel、@here 这类全员提醒。
• Artifact 功能开启后，ZAI 回复里的链接不再显示 Slack 的链接预览；Artifact 链接的预览由随后的 Artifact 消息给出，见用 Artifact 交付网页和文档。

回复、页脚与失败

• 每次任务的最后一条消息带一行页脚，写明本次使用的 Engine 与 Model（见你会看到的词）；开启用量展示后，还有耗时、tokens 与工具调用统计。在频道和群聊里，页脚另附「控制台」链接，私信里没有。ZAI 只添加表情回复或保持安静时，不发页脚。
• 任务失败时，ZAI 发一条说明原因的消息，附错误代码和同样的页脚，并提示「如需重试，请在这个消息列里 @ 我。」Slack 里没有重试按钮。

用量记在哪里、在哪里查看，见在控制台管理自己的资源。

没发回的文件保留多久

没发回消息列的文件和临时安装的依赖，在这段工作结束或沙箱出故障后不保证保留。消息列空闲多久后这段工作会结束，见ZAI 会记住一个消息列多久。需要之后继续使用的成果，请让 ZAI 作为附件发回消息列、发布成 Artifact，或保存到其他获准使用的资源里（例如 Git 仓库），并确认之后能通过文件或链接重新取得。

ZAI 在远程设备上执行命令时，它生成的文件留在那台电脑上这段工作的目录里，这段工作结束后也不删除；你发给它的附件下载到这个目录里的临时位置，这段工作结束时删除。要留下附件，请让 ZAI 存到其他位置，见工作目录与文件。

失败时怎么做

文件可能包含敏感信息。只提供完成任务所需的最小内容，不在消息里粘贴密码、令牌或私钥。