用 Artifact 交付网页和文档
让 ZAI 把网页、报告或文档发布成一个链接，组织成员登录后在浏览器里查看和下载，以及怎样更新和移除。
Artifact 是 ZAI 发布的一份文件和它的固定链接：组织成员打开链接并登录后，在浏览器里查看内容、下载原文件。看板、图表页面、原型和较长的报告这类更适合在浏览器里阅读的结果，可以让 ZAI 发布成 Artifact；需要编辑、继续加工，或要转给组织外的人的文件，仍然用附件，见获取生成的文件。Artifact 是发布那一刻的内容，不运行服务端程序，也不保存提交的数据。
开始之前
- 这项功能需要 Z Tag 管理员开启。没有开启时，ZAI 不会主动提出发布 Artifact；你要求发布时，它会说明没有生成链接，并改用附件交付。
- 在远程设备上执行命令的聊天里不能发布 Artifact，见在远程设备上执行时。
- 拿到链接的每一位组织成员登录后都能打开，不限于这个群里的人；组织外的人打不开。谁能打开、页面会显示哪些信息，见Artifact 的访问。
- 标明保密、只给这里的人看，或涉及个人隐私的材料，不要发布成 Artifact，请让 ZAI 用附件发回。
让 ZAI 发布
在任务里说明你要一个能在浏览器里看的链接，例如：
把本周各渠道的数据做成一个网页看板，发布成 Artifact，把链接发在这里。
把这份调研整理成一篇长报告，我想在手机上看，发一个链接给我。
在群的话题里，没有说明交付形式的长文档，ZAI 能新建飞书云文档时默认用云文档，见回复的形式；要 Artifact 时，请直接说“发布成 Artifact”。
你发在这里的文件，也可以让 ZAI 原样发布。能发布的文件和打开后的样子：
| 文件 | 打开链接后 |
|---|---|
网页（.html、.htm） | 直接显示页面，页面里的交互可以使用 |
Markdown（.md、.markdown） | 显示排版后的文档 |
PDF（.pdf） | 在页面里翻页和缩放；打开需要密码的 PDF 只提供下载 |
Word（.docx）、PowerPoint（.pptx） | 显示转换出的预览，并可以下载原文件；预览可能与 Office 里的显示不同 |
Excel（.xlsx） | 只提供下载 |
其他类型不能发布，包括 .doc、.ppt、.xls 等旧格式和带宏的 Office 文件；ZAI 会改用附件，或在你需要在线阅读时转成 PDF 再发布，并说明这是转换后的版本。大小和数量的上限见Artifact 的限制。
你会看到什么
ZAI 的回复里有一两句结论和一个链接，链接文字是 Artifact 的标题，例如「渠道周报」。
Artifact 卡片
ZAI 的消息第一次把某个 Artifact 的链接带进一个话题时，它会紧接着在同一个话题里附上 Artifact 卡片：上面有标题、文件类型、版本和发布时间、第一屏的预览图，能下载原文件的另有「下载」按钮（网页和 Markdown 没有）。点卡片打开查看页。
- 同一个话题里，同一个 Artifact 只附一次；它的链接在另一个话题里第一次出现时，会再附一次。
- 一条消息里第一次出现的 Artifact 超过 3 个时，只为前 3 个附上，其余只有文字链接。
- 这些情况不会附上，链接本身照常可以点开：你或同事自己贴的链接、在别的群里发布的 Artifact、已经移除的 Artifact，以及写在代码块里的链接。
- 标题和预览图对这个话题里的每个人可见，包括打不开链接的人。第一屏不适合出现在聊天里时，让 ZAI 发布时不要附预览图。
Artifact 卡片不能转发。要转给同事，请转发 ZAI 那条带链接的消息，或复制链接。
打开链接
点回复里的链接或 Artifact 卡片，打开的是同一个查看页。
- 还没有登录时，页面会自动跳转到飞书登录，完成后回到这个 Artifact。
- 页面顶部一行是标题和版本号。点标题打开详情，里面写着这是第几版、什么时候更新，它来自哪里、是谁请求的（例如「多人聊天 · 请求人：……」），以及文件类型、大小和「组织成员可见」。这里的「多人聊天」指群，「一对一聊天」指某位成员和 ZAI 的私聊；定时任务这类没有具体请求人的写「自动任务」。
- 页面上的按钮和提示按你的个人语言显示（简体中文或英文），你和组织都没有设置语言时按浏览器的语言，见回复语言；下文引用的是简体中文界面的文字。
- Markdown 的预览按文档本身的语言排版，日文、繁体中文和韩文显示各自的字形。Word、PowerPoint 的预览和 Artifact 卡片里的预览图中，由系统决定的日期、数字和货币格式（例如表格的默认短日期）按发布它的那个聊天的回复语言和办公地区显示；少数组合没有现成的格式，这时按回复语言常用地区的格式显示，例如中文配美国按中国大陆。
- 「下载」取回原文件，「复制链接」复制这个 Artifact 的链接，「全屏」让查看页铺满屏幕，浏览器不支持全屏时（例如 iPhone）没有这个按钮。在手机上，「复制链接」和「全屏」收在右上角的「更多操作」里。
- 详情里写着「由 Z Tag 发布，内容未经平台核实。」；网页的顶栏上另有「勿在页面中输入密码」。
- 向下滚动内容时顶栏收起，向上滚动或回到顶部时回来。网页收起顶栏后，右上角留着一个提示按钮，点它也能让顶栏回来。
在飞书里打开时，「下载」把文件交给手机或电脑上的系统浏览器下载，浏览器里不需要再登录；「更多操作」里的「在浏览器中打开」也是这样交给系统浏览器。点卡片上的「下载」进来时，页面先列出文件，再点一次「下载」才开始。「下载」暂时变灰时，先点一下它，等它恢复后再点一次。
打不开、无法预览或登录没有完成时，见Artifact 打不开或显示不正常。
更新
回到发布它的地方让 ZAI 更新，例如「把看板更新到今天的数据」。
- 链接不变，打开看到的总是最新一版；页面和 Artifact 卡片上都写着这是第几版。ZAI 也可以只改标题。
- 网页是发布那一刻的内容，不会自己更新；数据变了，请让 ZAI 再更新一次。
- 最近若干个版本的内容会保留，需要时可以让 ZAI 取回其中一版重新发布；更早版本的内容不再保留，保留几个见Artifact 的限制。
- 换一种文件格式时，ZAI 会发布一个新的 Artifact，链接也是新的。
- 已经发出的 Artifact 卡片会随新版本和新标题更新。同一个 Artifact 出现在很多话题里时，只更新最近发出的那一部分；发出超过 14 天的卡片飞书不再允许修改。没有更新的会停在当时的版本，上面写着第几版，点开看到的仍是最新一版。
移除
让 ZAI 移除，例如「把刚才那个看板的 Artifact 移除」。可能对应不止一个时，ZAI 会先和你确认是哪一个。
- 移除后链接立刻失效：组织成员打开时只看到「这个 Artifact 已被移除」；组织外的人仍和移除前一样打不开。
- 移除不能撤销。还需要这份内容时，只能重新发布，得到的是一个新链接。
- 移除满 60 天后，文件被永久删除。
移除之后，聊天里还会留下这些：
- ZAI 之前发的那条带链接的消息不会改动，链接还在，但已经打不开。
- 已经发出的 Artifact 卡片会改成「Artifact 已移除」，不再显示标题、预览图和按钮。
- 发出超过 14 天的卡片飞书不允许修改，会继续显示原来的标题和预览图；点开时同样提示已被移除。
- 发卡片时网络长时间异常、ZAI 没能确认卡片已经发出的，这张卡片移除后也会保留原来的标题和预览图。
谁可以要求更新或移除
- 这个群里任何能和 ZAI 对话的人，都可以让它更新或移除在这里发布的 Artifact，不限于当初提出请求的人。
- ZAI 只能处理在这里发布的 Artifact。在别处发布的，请回到那里让 ZAI 处理；想不起链接时，可以让 ZAI 列出这里发布过的 Artifact。
- 组织 Owner 和 Admin 可以在控制台移除本组织的任何一个 Artifact，见管理 Artifact。
- 定时任务和事件订阅也可以发布和更新 Artifact，见定时任务和订阅事件。
网页里来自其他网站的内容
发布的网页可以加载其他网站上的脚本、样式、图片和字体，也可以向其他网站请求数据。
- 打开页面时，你的浏览器会直接访问这些网站，它们能看到你的 IP 地址和浏览器信息。
- 你所在的网络访问不到这些网站时，页面可能显示不全或长时间空白，页面上方会提示「页面仍在加载外部资源。长时间空白时，可以下载后查看，或在浏览器中打开。」可以让 ZAI 把用到的库和图片都放进页面里重新发布。
- 页面里的链接在新标签页打开，跳到本页某个位置的链接（如目录）仍在页面里跳转；页面不能把查看页换成别的网站。
- 页面里的复制按钮、页面自带的全屏和自动播放不可用；全屏请用查看页上的「全屏」。
- 页面内容来自发布它的那段工作，Z Tag 不核实。不要在 Artifact 页面里输入密码或验证码。
限制
单个文件的大小、一次任务能发布几个、旧版本保留多少，见Artifact 的限制。Artifact 没有对外公开的链接，不能只开放给指定的人，也没有评论、到期时间和访问统计。