文件、图片与任务结果

把文件作为输入

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

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

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

文件只在它所在的那个聊天里可用。其他聊天里的文件，包括 ZAI 在那里生成的文件，在这里一般不可用；需要时请在这里重新附加。ZAI 发到你私聊里的文件（包括同事请 ZAI 转给你的）在这段私聊里可以继续使用；在私聊里，ZAI 还能读取你和它都在的群里的文件，见ZAI 能读到哪些消息。

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

语音消息、合并转发的聊天记录和位置、投票这类消息怎样交给 ZAI，见ZAI 能读到哪些消息。

获取生成的文件

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

推荐写法：

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

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

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

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

• 超出飞书图片限制的图片（例如整页长截图、很大的 GIF），以及飞书无法按图片显示的格式，会作为文件发回，打开文件即可查看原图。
• MP4 视频和 Opus 音频会作为飞书视频、语音消息发回，可以直接播放；其他格式的音视频作为文件发回。

下载链接

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

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

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

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

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

• 文件被飞书的设置或审查拒收，或被平台在上传后移除。换个名字重新发送也拿不到链接；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。聊天里只写结论、需要你处理的事和打开文档的入口，不拆成几条长消息，也不在文档旁边再贴一遍全文。

在群的话题里，ZAI 能以应用身份新建飞书云文档时（见飞书应用身份），这类文档默认建成飞书云文档，并直接设为飞书企业内拿到链接的人都能阅读，不先问你，谁能打开、怎样收回见群话题里的飞书云文档；文档归应用所有，需要编辑时可以让 ZAI 把你加为协作者。标明保密、仅限本群或涉及个人隐私的材料仍用附件发回；私聊里也用附件。

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

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

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

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

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

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

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

• 标题、重点、列表、引用、任务列表和链接会保留，行内代码以代码字体显示；独立代码块保留原文和缩进，列表中的代码块和文件紧跟所在条目单独显示。
• 表格直接显示在消息里：宽表可以横向滚动，很长的表格折叠后可以展开；表格中的链接和 @成员 仍可使用。
• 飞书网页版会改写中文行里的个别字符，例如 ~ 显示为 ～、a[0] 显示为 a [0]，复制出来的也是改写后的文字。ZAI 会把文件路径、命令和标识符写成行内代码，行内代码里的内容原样显示。
• 带图表的回复以卡片展示：鼠标移到图上可以查看数值，点开图表可以放大查看；数据点较多时不逐个标注数值。卡片里的表格按内容分配列宽，宽表可以横向滚动，长表按页查看。
• 一条回复里的图表太多、超出卡片的上限，或所在群不支持卡片时，这部分改为普通消息，每张图表写成标题加表格。

回复、页脚与失败

• 回复默认不带用量信息，可以开启用量展示；卡片里的统计位于可展开的「本次用量」中，见在回复里显示用量。
• 任务失败时，话题里会出现「这次请求未完成」卡片，说明原因并带「重试」按钮；错误代码与较长的错误说明可以在「错误详情」中展开查看。

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

没发回的文件保留多久

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

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

失败时怎么做

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